Fluxo - Recebimento CT-e
O fluxo demonstrado a seguir trata do recebimento de CT-e dentro da integração com a InvoiSys.
APIs Essenciais 💡
Realizar consulta CT-e por NSUi: /v1/cte-entrada/eventos-nsui/{cnpj}/{nsui}
APIs Opcionais 🥈
Realizar Envio de XML de CT-e: /v1/cte-entrada/enviar-xml
Realizar Consulta XML por Chave de Acesso: /v1/cte-entrada/obter-xml-chave/{ambiente}/{chaveDeAcesso}
Realizar Consulta XML por ID: /v1/cte-entrada/obter-xml-chave/{ambiente}/{id}
Realizar Consulta do PDF por Chave de Acesso: /v1/cte-entrada/obter-pdf-chave/{ambiente}/{chaveDeAcesso}
Realizar Consulta do PDF por ID: /v1/cte-entrada/obter-pdf-chave/{ambiente}/{id}
Realizar Envio de Anexo:/v1/cte-entrada/anexar
Realizar Consulta de Anexo: /v1/cte-entrada/obter-anexo/{ambiente}/{idArquivo}
Etapas e suas APIs
Antes de iniciamos a consulta das notas, é necessário estar com um token de acesso válido, pois este será utilizado no cabeçalho da chamada das APIs. Tendo ele em mãos, podemos partir para as devidas operações do fluxo.
1) Requisições e consultas periódicas
A princípio, nossa solução irá fazer a consulta periódica por documentos que foram emitidos contra o seu estabelecimento direto na SEFAZ e os disponibilizará no sistema.
2)Enviar XML de CT-e
Também é possível realizar a carga dos XMLs de CT-e no layout cteProc no formato base64 através da API de Envio de CT-e.
3) Consulta de CT-e por Chave de Acesso, ID e NSUi
Com o documento disponibilizado para você em nossa solução, possuímos duas funcionalidades que estão disponíveis para seu auxílio.
a) Consulta do XML de CT-e; b) Consulta do PDF de CT-e; c) Consulta por NSUi.
a) Consulta do XML de CT-e por Chave de Acesso e Por ID
Está API é utilizada para efetuar a consulta do XML no formato base64 de uma CT-e de Entrada, pela Chave de Acesso do documento ou por seu ID, retornado no momento da carga do documento.
b) Consulta do PDF de CT-e por Chave de Acesso e Por ID
Está API é utilizada para efetuar a consulta do PDF no formato base64 de uma CT-e de Entrada, pela Chave de Acesso do documento ou por seu ID, retornado no momento da carga do documento.
c) Consulta por NSUI
Este e o processo de consulta dos documentos utilizando o Número Sequencial Único Invoisys (NSUi), que são vinculados aos Documentos e Eventos capturados através do webservice da SEFAZ ou importados via API, individualmente por CNPJ.
Cada Consulta Retorna até 50 documentos de acordo com o Numero Sequencial, informando também o ultimo numero consultado e o numero sequencial máximo disponível para consulta.
4) Enviar Anexo
Através desse endpoint é possível enviar um arquivo (imagem, pdf, texto, etc) e vincula-lo a um documento através de seu ID informado no momento de sua carga ou de sua consulta via NSUI.
5) Consultar Anexo
Através desse endpoint é possível obter o arquivo (imagem, pdf, texto, etc) enviado através do enpoint de Envio de Anexo em base64, utilizando o ID do Arquivo devolvido no momento da carga do anexo.
Last updated
