Integração documentos Primavera através do QrCode

Abstract

A Maeil e uma empresa que fornece soluções e serviços para outras empresas na área de Sistemas de informação. Quando a Autoridade Tributária e Aduaneira (AT) exigiu que todas faturas emitidas em Portugal por softwares de certificação autorizados, tivessem um código de barras bidimensional (QrCode) a partir de 2022, a empresa viu uma oportunidade de criar uma solução que utilize a informação que está neles codificada para fazer a integração automática desses documentos financeiros num ERP (por exemplo o Primavera) ou um software de gestão. Foi também colocado outro desafio, de fazer o mesmo tipo de integração para os documentos de venda que constam no SAF-T e finalmente fazer a exportação/visualização destes documentos em formato PDF. Para atingir os objetivos do projeto, o trabalho foi dividido em três fase. Na primeira fase, implementou-se um leitor de QrCodes das faturas que retorna a string que esta codificada neles. De seguida, criou-se um método que separa todos os parâmetros que vêm na string e cria um objeto com essa informação. Este objeto e usado como argumento de outro método que foi criado para fazer a integração de documentos de compra no Primavera. Na segunda fase, desenvolveu-se um parser para o SAF-T, que vem no formato XML, que retorna um objeto com a informação extraída. Tal como para o documento de compra, criou-se também um método que faz a integração de documentos de venda, que recebe o objeto do SAF-T como argumento. Nesta fase, o serviço de integração teve que ser separado em dois, pois a funcionalidade de exportação de documentos exigia que a versão do serviço fosse .NET 5 e a API do Primavera funciona com .NET framework 4.7.3. Por isso, passou a haver dois serviços, um para processar os documentos (que cria os objetos a partir dos documentos e faz a sua exportação caso seja desejado) e outro para fazer a integração. Depois de separados, desenhou-se os templates para os documentos exportados. Na terceira e última fase, implementou-se popups que aparecem quando um documentos e processado e mostram a informação que consta nele. Esta funcionalidade trouxe ao de cima um problema, porque não é possível serviços do Windows abrirem janelas interativas. Posto isto, a solução com que se seguiu foi tornar o serviço de processamento de documentos uma aplicação, tornando assim possível a abertura dos popups e tornando a experiencia de utilização mais intuitiva.

Maeil is a company that provides solutions and services to other companies in the field of Information Systems. When the Tax and Customs Authority (AT) demanded that all invoices issued in Portugal by authorized certification software have a two-dimensional barcode (QrCode) from 2022 onwards, the company saw an opportunity to create a solution that uses the information it is encoded in them to automatically integrate these financial documents into an ERP (for example or Primavera) or management software. Another challenge was also posed, to carry out the same type of integration for the sales documents contained in the SAF-T and finally to export/view these documents in PDF format. To achieve the project objectives, the work was divided into three phases. In the first phase, a QRCode reader for invoices was implemented, which returns the string that is encoded in them. Next, we created a method that separates all the parameters that come in the string and creates an object with that information. This object is used as an argument of another method that was created to do the integration of purchasing documents in Primavera. In the second phase, a parser was developed for SAF-T, which comes in XML format, which returns an object with the extracted information. As for the purchase document, a method was also created that integrates sales documents, which receives the SAF-T object as an argument. At this stage, the integration service had to be split in two as the document export functionality required the service version to be .NET 5 and the Primavera API works with .NET framework 4.7.3. Therefore, there are now two services, one to process documents (which creates objects from documents and exports them if desired) and another to integrate. Once separated, the templates for the exported documents were designed. In the third and final phase, we implemented popups that appear when a document is processed and show the information contained in it. This functionality brought up a problem, because it is not possible for Windows services to open interactive windows. That said, the solution that followed was to turn the document processing service into an application, thus making it possible to open popups and making the user experience more intuitive.