> For the complete documentation index, see [llms.txt](https://integracao.gitbook.io/invoisys/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://integracao.gitbook.io/invoisys/getting-started/documentos-fiscais/recebimento/nf-e-1/passo-a-passo.md).

# Passo a Passo NF-e

Legal! Que bom que você deseja integrar sua solução com a gente! Nesta página nós iremos te auxiliar em como realizar este processo.

## Contato Inicial <a href="#contato-inicial" id="contato-inicial"></a>

Primeiramente precisamos criar um usuário para você. Para isto, basta entrar em contato conosco [através desta página](https://invoisys.com.br/atendimento-invoisys-suporte-e-vendas/)!

Com a criação de um usuário, você terá acesso às nossas APIs!

## Pré-Requisitos

Para iniciar os seus testes, você precisará ter em mãos os dados de uma empresa credenciada para o recebimento de NF-e e o certificado digital da mesma.‌

Após isso, basta seguir os seguintes passos:

* Fazer o login no [Portal InvoiSys](https://sandbox-portal.invoisys.com.br/) com usuário obtido;
* Cadastrar a empresa e incluir o certificado digital [(Você pode conferir aqui como fazer o cadastro)](https://invoisys.freshdesk.com/a/solutions/articles/22000240176)

Tudo em ordem? Então podemos começar os testes!

## Conhecendo as APIs <a href="#conhecendo-as-apis" id="conhecendo-as-apis"></a>

Antes de iniciar seu desenvolvimento, separamos algumas APIs para que você possa testar pelo Swagger, a fim de que possa conhecer suas características e retornos. Hoje contamos com dois ambientes de APIs, portanto estaremos descrevendo os endpoints disponíveis em cada um deles.

| Etapas                                                                                                                                           | Descrição                                                                               |
| ------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------- |
| [​Autenticação​ (2.0)](/invoisys/endpoints/autorizacao/autenticacao.md)                                                                          | Utilizado para obter o token de acesso (2.0).                                           |
| ​[Realizar Entrada de NF-e por Chave de Acesso](/invoisys/endpoints/recebimento-notas/nf-e/api-consulta-recebimento-nf-e-por-chave-de-acesso.md) | Usado para realizar a entrada do documento no sistema diretamente por seu XML completo. |
| [Realizar o Manisfesto da NF-e](/invoisys/endpoints/recebimento-notas/nf-e/api-realizar-manifesto-da-nf-e.md)                                    | Utilizado para efetuar a operação de manifesto em uma NF-e.                             |
| [Realizar Download de NF-e na Sefaz](/invoisys/endpoints/recebimento-notas/nf-e/api-realizar-download-de-nf-e-na-sefaz.md)                       | API para efetuar a requisição do download do XML na SEFAZ, após a manifestação da NF-e. |

| Etapas                                                                                                                                                      | Descrição                                                                                                                                                                                             |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Autenticação (3.0)](/invoisys/endpoints/autorizacao/autenticacao-1.md)                                                                                     | Utilizado para obter o token de acesso (3.0).                                                                                                                                                         |
| [Enviar XML de NF-e](/invoisys/endpoints/recebimento-notas/nf-e/api-entrada-de-nf-e-por-xml-1.md)                                                           | Usado para Enviar o XML de  NF-e no layout ProcNFe no formato base64.                                                                                                                                 |
| ​[Consultar Documento e Evento por NSUI](/invoisys/endpoints/recebimento-notas/nf-e/api-entrada-de-nf-e-xml-resumido-obtido.md)                             | Responsável por possibilitar ao integrador a consulta sequencial de todos os eventos relacionados as NF-es Recebidas para seus CNPJs, incluindo XMLs completos, cancelamentos, CC-es, etc.            |
| [Consultar XML Importado](/invoisys/endpoints/recebimento-notas/nf-e/api-entrada-de-nf-e-xml-resumido-obtido-3.md)                                          | Responsável por permitir ao integrador a consulta dos XMLs no formato base64 relacionados às NF-es recebidas.                                                                                         |
| [Consultar PDF Importado](/invoisys/endpoints/recebimento-notas/nf-e/api-entrada-de-nf-e-xml-resumido-obtido-4.md)                                          | Responsável por permitir ao integrador a consulta dos DANFEs (PDFs) no formato base64 relacionados às NF-es recebidas.                                                                                |
| [Enviar Anexo](/invoisys/endpoints/recebimento-notas/nf-e/api-entrada-de-nf-e-por-xml-2.md)                                                                 | Usado para enviar Anexo no formato base64 e vincular a uma NF-e pelo numero do ID do documento                                                                                                        |
| [Obter Anexo ](/invoisys/endpoints/recebimento-notas/nf-e/api-entrada-de-nf-e-xml-resumido-obtido-5.md)                                                     | Usado para consultar o anexo vinculado a NF-e pelo numero do ID do anexo, obtido no momento do envio do mesmo.                                                                                        |
| [​Consultar Documentos e Eventos por NSUI com Campos Customizados](/invoisys/endpoints/recebimento-notas/nf-e/api-entrada-de-nf-e-xml-resumido-obtido-1.md) | Responsável por possibilitar ao integrador a consulta sequencial de todos os eventos relacionados as NF-es Recebidas para seus CNPJs, incluindo XMLs dos eventos e outros campos relacionados ao XML. |

Testou e entendeu como tudo funciona? Então já podemos iniciar o desenvolvimento.‌

## Desenvolvimento <a href="#desenvolvimento" id="desenvolvimento"></a>

Da mesma forma proposta na etapa de testes, nós deixaremos um passo a passo de desenvolvimento como guia. Nele, você verá todos os fluxos operacionais e as APIs que devem ser utilizadas.‌

### Checklist

| Etapa                                                                                                                                | Descrição                                                                                                |
| ------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------- |
| [Autenticação](/invoisys/endpoints/autorizacao.md)                                                                                   | A autenticação será utilizada para obter o token de acesso que será passado em todas as chamadas de API. |
| [Recebimento NF-e   ](/invoisys/getting-started/documentos-fiscais/recebimento/nf-e-1/fluxos-operacionais/fluxo-recebimento-nf-e.md) | Etapa principal, onde toda a operação de Recebimento irá ocorrer                                         |
