# 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}](https://integracao.gitbook.io/invoisys/endpoints/recebimento-notas/ct-e/api-entrada-de-nf-e-xml-resumido-obtido) ## APIs Opcionais 🥈 * **Realizar Envio de XML de CT-e:** [/v1/cte-entrada/enviar-xml](https://integracao.gitbook.io/invoisys/endpoints/recebimento-notas/ct-e/api-entrada-de-nf-e-por-xml) * **Realizar Consulta XML por Chave de Acesso:** [/v1/cte-entrada/obter-xml-chave/{ambiente}/{chaveDeAcesso}](https://integracao.gitbook.io/invoisys/endpoints/recebimento-notas/ct-e/api-entrada-de-nf-e-xml-resumido-obtido-2) * **Realizar Consulta XML por ID:** [/v1/cte-entrada/obter-xml-chave/{ambiente}/{id}](https://integracao.gitbook.io/invoisys/endpoints/recebimento-notas/ct-e/api-entrada-de-nf-e-xml-resumido-obtido-2) * **Realizar Consulta do PDF por Chave de Acesso:** [/v1/cte-entrada/obter-pdf-chave/{ambiente}/{chaveDeAcesso}](https://integracao.gitbook.io/invoisys/endpoints/recebimento-notas/ct-e/api-entrada-de-nf-e-xml-resumido-obtido-3) * **Realizar Consulta do PDF por ID:** [/v1/cte-entrada/obter-pdf-chave/{ambiente}/{id}](https://integracao.gitbook.io/invoisys/endpoints/recebimento-notas/ct-e/api-entrada-de-nf-e-xml-resumido-obtido-3) * **Realizar Envio de Anexo:**[/v1/cte-entrada/anexar](https://integracao.gitbook.io/invoisys/endpoints/recebimento-notas/ct-e/api-entrada-de-nf-e-por-xml-1) * **Realizar Consulta de Anexo:** [/v1/cte-entrada/obter-anexo/{ambiente}/{idArquivo}](https://integracao.gitbook.io/invoisys/endpoints/recebimento-notas/ct-e/api-entrada-de-nf-e-xml-resumido-obtido-4) * **Realizar consulta de documentos por NSUI com Campos Customizados:** [**/**v1/cte-entrada/eventos-nsui/nsui-custom-fields-lote](https://integracao.gitbook.io/invoisys/endpoints/recebimento-notas/ct-e/api-entrada-de-nf-e-xml-resumido-obtido-1) ## 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. ![](https://3525778293-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lmo0dH8REcSzSboskDA%2Fuploads%2FlSS6fkQCQ6vaZCSTjgax%2FFLUXO1-Page-2.jpg?alt=media\&token=e4d56061-c192-4452-a029-e5626519e184) ### 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;](https://integracao.gitbook.io/invoisys/endpoints/recebimento-notas/ct-e/api-entrada-de-nf-e-xml-resumido-obtido-2)\ [b) Consulta do PDF de CT-e;
](https://integracao.gitbook.io/invoisys/endpoints/recebimento-notas/ct-e/api-entrada-de-nf-e-xml-resumido-obtido-3)\ [c) Consulta por NSUi.](https://integracao.gitbook.io/invoisys/endpoints/recebimento-notas/ct-e/api-entrada-de-nf-e-xml-resumido-obtido) #### 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.