Integração ilink

Âmbito

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.

O ilink é uma plataforma EDI que permite o envio e recepção de documentos de faturação, nos formatos legalmente exigidos e de forma autónoma. Atualmente está integrado com os seguintes programas:

Sistemas de faturação / ERP's / Gestão Documental

Brokers EDI

*Lista atualizada a 2024-06-17

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

img info

Ver Enquadramento Legal atualizado

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.

Canais de integração

O ilink permite integrar directamente através de 2 canais principais:

  • API REST (+ Webhooks opcionais)
  • Ligação AS2

Antes de iniciar o processo de integração, será necessário primeiro decidir o canal mais apropriado para o vosso sistema.

Nota: Para negociar a integração com canais alternativos, contacte a nossa equipa comercial.

API REST

É o método mais utilizado por ERP's, softwares de faturação e sistemas de gestão autárquica. A integração via REST funciona por HTTPS (webservice) e permite o envio e consulta de documentos, bem como a comunicação e consulta de estados dos mesmos. Ver Detalhes de implementação do API REST.

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, ficando o ilink responsável pela geração do XML.
  • Permite aceder a todos os documentos previamente recebidos por um cliente
  • 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 chega um novo documento
  • 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

AS2

É o protocolo preferencial de integração por outros brokers EDI, e funciona exclusivamente por transferência de ficheiros XML. Obriga a implementação de um cliente AS2 para a troca de documentos e mensagens de estado. Ver Detalhes de implementação de AS2.

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 face à troca de certificados 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.