> 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/passo-a-passo.md).

# Passo a Passo

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://www.invoisys.com.br/contato/)!‌

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

## Pré-Requisitos <a href="#pre-requisitos" id="pre-requisitos"></a>

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.

| Etapas                                                                                                                                                                      | Descrição                                                                                                                                        |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| ​[Autenticação](https://app.gitbook.com/@integracao/s/invoisys-integracao/~/drafts/-M3fYRVFn3sMz_SpeU5V/apis/autorizacao/autenticacao)​                                     | Utilizado para obter o token de acesso.                                                                                                          |
| [Consulta XML Resumido](https://app.gitbook.com/@integracao/s/invoisys/~/drafts/-MgzgHJnR8TDWMPg2eeH/apis/recebimento-notas/nf-e/api-entrada-de-nf-e-consulta-xml-resumido) | Utilizado para obter as NF-es consultadas automaticamente na SEFAZ, objetivando obter a chave de acesso das mesmas.                              |
| [XML Resumido Obtido](https://app.gitbook.com/@integracao/s/invoisys/~/drafts/-MgzgHJnR8TDWMPg2eeH/apis/recebimento-notas/nf-e/api-entrada-de-nf-e-xml-resumido-obtido)     | Utilizado para flagar as chaves de acessos obtidas na API de consulta de XML resumido, com o intuito de que não retornem a aparecer na consulta. |
| ​[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)                            | Utilizado para realizar a entrada do documento no sistema pela chave de acesso.                                                                  |
| [​Realizar Envio da NF-e por XML](/invoisys/endpoints/recebimento-notas/nf-e/api-entrada-de-nf-e-por-xml.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 o Download da NF-e por ID](/invoisys/endpoints/recebimento-notas/nf-e/api-realizar-download-de-nf-e-na-sefaz.md)                                                  | Utilizado para realizar o download dos dados completos da nota diretamente da SEFAZ utilizando o seu ID.                                         |
| [Consulta XML Completo](https://app.gitbook.com/@integracao/s/invoisys/~/drafts/-MgzgHJnR8TDWMPg2eeH/apis/recebimento-notas/nf-e/api-entrada-de-nf-e-consulta-xml-completo) | Utilizado para obter as NF-es que já possuem o XML completo baixado, a fim de obter a chave de acesso das mesmas.                                |
| [XML Completo Obtido](https://app.gitbook.com/@integracao/s/invoisys/~/drafts/-MgzgHJnR8TDWMPg2eeH/apis/recebimento-notas/nf-e/api-entrada-de-nf-e-xml-completo-obtido)     | Utilizado para flagar as chaves de acessos obtidas na API de consulta de XML completo, com o intuito de que não retornem a aparecer na consulta. |
| [Consulta DANFE da NF-e por ID](/invoisys/endpoints/recebimento-notas/nf-e/api-consulta-danfe-recebimento-nf-e.md)                                                          | Utilizando o ID da nota, é possível consultar detalhadamente os dados da mesma.                                                                  |
| [Consulta XML da NF-e por ID](/invoisys/endpoints/recebimento-notas/nf-e/api-consulta-xml-recebimento-nf-e.md)                                                              | Utilizando o ID da nota, é possível consultar detalhadamente o XML deste documento.                                                              |
| [Realizar o envio da NF-e por e-mail](/invoisys/endpoints/recebimento-notas/nf-e/api-enviar-nf-e-por-email.md)                                                              | Utilizando o ID da NF-e, realizar o envio da mesma por e-mail.                                                                                   |

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/fluxos-operacionais/fluxo-recebimento-nf-e.md) | Etapa principal, onde toda a operação de Recebimento irá ocorrer                                         |
