Pular para conteúdo

Importação de NFS-e Através do InvoiCy OCR

Neste artigo explicaremos sobre como realizar a importação de NFS-es através da extensão InvoiCy OCR. Abordando os processos de importação de NFS-e via tela, e-mail, SOAP e API REST.

Inicialmente, é necessário esclarecer que para mais informações sobre a importação de NFS-e através do OCR via tela ou e-mail, acesse os seguintes artigos:

No entanto, as explicações sobre a importação de NFS-e via SOAP e API REST, serão descritas a seguir:

Importação via SOAP

O seu ERP deve realizar a integração com o Web Service aimportacao.aspx, disponibilizado pelo InvoiCy. Este Web Service é único, e deve ser utilizado apenas para efetuar a importação de documentos no InvoiCy, independentemente do tipo de documento que pretende importar.

É importante destacar, que para realizar a importação de documentos através deste Web Service, a empresa precisa ter a extensão Importação de Documentos ativa, além de estabelecer uma comunicação com o Web Service apropriado. Primeiramente, visualize a estrutura WSDL do mesmo:

Em seguida, será necessário realizar o consumo do Web Service para efetuar a integração.

A importação de NFS-e via Web Service pode ser realizada através do envio do arquivo PDF ou imagem, enviado no formato base64 através de comunicação com o Web Service. A estrutura abaixo exemplifica uma importação OCR, através do envio de um arquivo em base64:

<soapenv:Envelope xmlns:soapenv="[http://schemas.xmlsoap.org/soap/envelope/](http://schemas.xmlsoap.org/soap/envelope/)" xmlns:inv="InvoiCy">
   <soapenv:Header/>
   <soapenv:Body>
      <inv:recepcao.Execute>
         <inv:Invoicyrecepcao>
            <inv:Cabecalho>
               <inv:EmpPK>ABCabcCBAcbaA+CabcCBAc==</inv:EmpPK>
               <inv:EmpCK>178698c047810000fabdd6f2d14c87ff</inv:EmpCK>
               <inv:EmpCO>99999999999999</inv:EmpCO>
            </inv:Cabecalho>
            <inv:Informacoes>
               <inv:Texto></inv:Texto>
            </inv:Informacoes>
            <inv:Dados>
               <inv:DadosItem>
                  <inv:Documento><!-- (1) --></inv:Documento>
                  <inv:Parametros></inv:Parametros>
               </inv:DadosItem>
            </inv:Dados>
         </inv:Invoicyrecepcao>
      </inv:recepcao.Execute>
   </soapenv:Body>
</soapenv:Envelope>
  1. Neste campo, informe o XML de envio. Para visualizar um exemplo de envio, clique aqui.

Na tag Base64Arquivo será possível enviar um arquivo XML, PDF ou imagem do documento no formato base64. Enquanto que no campo MimeTypeArquivo é necessário informar a extensão do documento e também pode ser informado o nome do arquivo que será importado na tag NomeArquivo, no entanto, este campo não é obrigatório.

Importação via REST

Para a realização da importação via API REST é necessário a geração de um token com os dados da chave de parceiro. Sendo assim, para a chave de parceiro deve ser enviada no parâmetro "sub" e o parâmetro "partnerkey" não deve ser informado. Além disso, os demais campos seguem a mesma estrutura da geração de token para empresas.

Mais informações sobre a geração do token podem ser conferidas, clicando aqui.

É importante ressaltar que o InvoiCy OCR está preparado para importar arquivos PDF onde o mesmo documento ocupa duas ou três páginas. No entanto, o sistema não importará arquivos PDF que contenham várias páginas, nas quais cada página representa um documento diferente.

Além disso, o sistema não fará leitura de arquivos PDF com senha, visto que não é possível extrair o conteúdo criptografado.

Clique aqui, para visualizar um exemplo no formato JSON de envio da importação de NFS-e via API REST.