Pular para o conteúdo principal

ilink Knowledge Base

Bem-vindo à Knowledge Base do ilink! Esta documentação fornece informações detalhadas sobre como integrar e utilizar os serviços disponíveis pelo ilink em sistemas externos. O presente guia técnico destina-se a programadores que pretendem automatizar todo o fluxo de entrega e recepção de faturas eletrónicas pela plataforma ilink.

Disponibilizamos guias passo a passo, exemplos de implementação e melhores práticas para tirar o máximo partido das funcionalidades do ilink.

O ilink é uma plataforma de integração que permite a comunicação eficiente de faturas eletrónicas entre diferentes sistemas e aplicações. Com suporte a múltiplos protocolos e formatos de dados, o ilink facilita a troca de informações de forma segura e confiável.

A plataforma oferece ferramentas para validar, transformar e encaminhar faturas eletrónicas, garantindo conformidade com os requisitos legais e padrões do setor. Além disso, disponibiliza funcionalidades de monitorização e auditoria, permitindo acompanhar o estado das transações e identificar rapidamente quaisquer problemas na comunicação entre sistemas.

Clique aqui para consultar a lista de sistemas atualmente integrados com o ilink.

O diagrama abaixo descreve os prazos para implementar a Faturação Eletrónica na Contratação Pública em Portugal:

img info

Ver Enquadramento Legal em detalhe.

Nota: Para enviar faturas à FE-AP, é necessário primeiro registar o fornecedor (e após esta validação fica este habilitado a enviar para todas as entidades públicas do FE-AP). Como efetuar a adesão?

Formatos e normas técnicas​

O ilink utiliza o formato UBL 2.1 na norma técnica CIUS-PT, implementada pela eSPap, e adaptada da Norma Europeia EN16931 para todos os documentos de vendas (Faturas e Notas de Crédito). No caso dos documentos de compra (Encomendas), utilizamos o standard internacional PEPPOLBIS3, também baseado em UBL 2.1.

Tipos de Integração​

Antes de iniciar o processo de integração, será necessário primeiro decidir o canal mais apropriado para o vosso sistema. Esta documentação cobre os seguintes tipos de integrações disponíveis:

🌐 Integração via API REST​

Documentação completa sobre como utilizar as APIs REST do ilink para integração com sistemas web. Inclui instruções detalhadas sobre autenticação, endpoints disponíveis, formatos de requisição e resposta, exemplos de código e boas práticas de integração.

Vantagens:

  • É de fácil integração para aplicações web, ou programas que permitam comunicar com webservices externos
  • Permite enviar documentos por XML, ou alternativamente enviando o dados do documento em formato estruturado, ficando o ilink responsável pela geração do XML final.
  • Permite aceder a todos os documentos previamente recebidos por um cliente
  • Permite alterar o estado de um documento recebido, incluindo a sua aceitação, rejeição ou regularização
  • Permite consultar o histórico dos documentos

📡 Integração via AS2​

Guia detalhado para a utilização do protocolo preferencial de integração por outros brokers EDI, que funciona exclusivamente por transferência de ficheiros XML. Obriga à implementação de um cliente AS2 para a troca de documentos e mensagens de estado. Este guia cobre os procedimentos de envio e receção de documentos.

Vantagens

  • Standard universalmente aceite de transmissão EDI
  • É de rápida implementação caso o sistema a integrar já possua um cliente AS2 funcional
  • Implementa mecanismos adicionais de segurança usando certificados embutidos no protocolo de comunicação
  • Permite a troca de documentos e mensagens de estado em tempo real, sem necessitar de mecanismos de consulta
  • Permite alterar o estado de um documento (aceitar, rejeitar, regularizar, etc) e enviar esta informação de volta ao emissor do mesmo

Nota: Apenas recomendamos a utilização deste protocolo caso o vosso sistema já o implemente para outros parceiros.

🔔 Webhooks ilink​

Como configurar e utilizar webhooks para receber notificações em tempo real sobre eventos do sistema. A secção explica como registar endpoints, configurar tipos de eventos, autenticar chamadas e tratar as notificações recebidas. Inclui exemplos práticos e boas práticas para garantir fiabilidade e segurança na receção de informações em tempo real.

Vantagens

  • Permite implementar mecanismos de callbacks (Webhooks) em tempo real
    • O emissor pode ser notificado quando um documento muda de estado (aceite, recusado, etc)
    • O receptor pode ser notificado quando recebe um novo documento
  • Mais rápido e eficiente que a consulta periódica de eventos
  • Complementa a integração via REST

Guias Específicos de Integração​

Esta secção detalha como configurar a integração do ilink em algums sistemas em particular. Inclui instruções passo a passo e requisitos de configuração específicos de cada sistema:

🖥️ Integração Moloni​

A integração Moloni permite comunicar os documentos diretamente entre o software Moloni e o ilink.

🗂️ Integração Medidata​

A integração Medidata permite automatizar o envio e receção de documentos nas aplicações da suite Medidata via protocolos SFTP. Este guia contém os pré-requisitos necessários para permitir a integração com este sistema.

Ajuda​

Selecione o tipo de integração que deseja implementar no menu lateral para aceder à documentação específica.

Para suporte técnico, entre em contato com a equipa ilink em apoio@ilink.pt ou em 707 451 451.