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}

• Realizar consulta de documentos por NSUI com Campos Customizados: /v1/cte-entrada/eventos-nsui/nsui-custom-fields-lote

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.

Consulta de CT-e através do NSUI

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.

Enviar e vincular Anexo

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.

Obter anexo via Id do Arquivo