# Passo a Passo

## 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](https://integracao.gitbook.io/invoisys/endpoints/recebimento-notas/nf-e/api-consulta-recebimento-nf-e-por-chave-de-acesso)  | Utilizado para realizar a entrada do documento no sistema pela chave de acesso.                                                                  |
| [​Realizar Envio da NF-e por XML](https://integracao.gitbook.io/invoisys/endpoints/recebimento-notas/nf-e/api-entrada-de-nf-e-por-xml)                                      | Usado para realizar a entrada do documento no sistema diretamente por seu XML completo.                                                          |
| [Realizar o Manisfesto da NF-e](https://integracao.gitbook.io/invoisys/endpoints/recebimento-notas/nf-e/api-realizar-manifesto-da-nf-e)                                     | Utilizado para efetuar a operação de manifesto em uma NF-e.                                                                                      |
| [Realizar o Download da NF-e por ID](https://integracao.gitbook.io/invoisys/endpoints/recebimento-notas/nf-e/api-realizar-download-de-nf-e-na-sefaz)                        | 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](https://integracao.gitbook.io/invoisys/endpoints/recebimento-notas/nf-e/api-consulta-danfe-recebimento-nf-e)                                | Utilizando o ID da nota, é possível consultar detalhadamente os dados da mesma.                                                                  |
| [Consulta XML da NF-e por ID](https://integracao.gitbook.io/invoisys/endpoints/recebimento-notas/nf-e/api-consulta-xml-recebimento-nf-e)                                    | Utilizando o ID da nota, é possível consultar detalhadamente o XML deste documento.                                                              |
| [Realizar o envio da NF-e por e-mail](https://integracao.gitbook.io/invoisys/endpoints/recebimento-notas/nf-e/api-enviar-nf-e-por-email)                                    | 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](https://integracao.gitbook.io/invoisys/endpoints/autorizacao)                                                                              | A autenticação será utilizada para obter o token de acesso que será passado em todas as chamadas de API. |
| [Recebimento NF-e](https://integracao.gitbook.io/invoisys/getting-started/documentos-fiscais/recebimento/nf-e/fluxos-operacionais/fluxo-recebimento-nf-e) | Etapa principal, onde toda a operação de Recebimento irá ocorrer                                         |