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

• iGest
• acinGov
• b-Online
• Moloni
• Medidata Sigma-SNC
• XISConnect
• Microsoft Dynamics NAV (Arquiconsult)
• Primavera (requer conector)
• iFREG-SNC-AP
• airc SNC-AP
• Fresoft ERP
• SAGE X3 (F5IT)
• PHC (WinSig)
• WorkInNet
• Altmaia Faturação
• MicroDigital
• SIAG
• Facturama
• XD
• PHC (Antúrio)
• Artsoft
• PHC (Novos canais)
• KeyInvoice
• iDok
• Tripoint
• Ediprinter
• SigPor
• Forense
• Sendys
• R2 Informática
• PHC (Norma6)
• PHC (BetaSystemsPHC)
• DigiSoft
• PHC (NSOFT)
• Protótipo
• Quidgest
• Rentway (ChallengeIT)
• Protótipo
• Aquamatrix
• Fcore Fapricela
• eDocuments - Flowinn
• Webdoc Ambisig
• NewHotel
• GRID
• Golfinhosoft

Brokers EDI

• Saphety
• Yetspace
• Edicom
• SERES
• Generix
• IndraMinsait
• FE-AP
• Pagero
• eFaturaGov
• Seeburger
• Inposia
• Compacer
• Montova

*Lista atualizada a 2023-06-29

Enquadramento Legal

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

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.