# Passo-a-Passo

## Contato Inicial

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 às nossas APIs!

## Pré-Requisitos

Para iniciar os seus testes, você precisará ter em mãos os dados de uma empresa credenciada para emitir NFC-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

Antes de iniciar seu desenvolvimento, separamos algumas APIs para que você possa testar pelo Swagger, afim de que possa conhecer suas características e retornos.

| Etapas                                                                                                                                  | Descrição                                                                                                                                                                         |
| --------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Autenticação](/invoisys/endpoints/autorizacao/autenticacao.md)                                                                         | Utilizado para obter o token de acesso.                                                                                                                                           |
| [Cadastro Empresa](/invoisys/endpoints/cadastros-basicos/empresa-1/empresa.md)                                                          | Você poderá cadastrar uma empresa credenciada. Caso não possua, disponibilizamos a "INVOISYS SISTEMAS" (id: 9015) para testes.                                                    |
| [Cadastro Produto por ID](/invoisys/endpoints/cadastros-basicos/produto/api-cadastrar-produto.md)                                       | Será atribuído a uma empresa para testes. No ambiente de homologação, deverá ser utilizado como nome o literal`NOTA FISCAL EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL` |
| [Cadastro Produto por CNPJ](/invoisys/endpoints/cadastros-basicos/produto/api-consultar-produto-por-id.md)                              | Será atribuído a uma empresa para testes. No ambiente de homologação, deverá ser utilizado como nome o literal`NOTA FISCAL EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL` |
| [Envio Normal da NFC-e \[Completo\]](/invoisys/endpoints/emissao-notas/nfc-e-1/api-envio-normal-completo-da-nfc-e.md)                   | Utilizado para realizar a emissão da nota                                                                                                                                         |
| [Envio Normal da NFC-e \[Híbrido\]](/invoisys/endpoints/emissao-notas/nfc-e-1/api-envio-normal-hibrido-da-nfc-e.md)                     | Usado para realizar a emissão da nota                                                                                                                                             |
| [Envio Contingência da NFC-e \[Completo\]](/invoisys/endpoints/emissao-notas/nfc-e-1/api-envio-contingencia-completo-da-nfc-e.md)       | Usado para realizar a emissão da nota em contingência.                                                                                                                            |
| [Envio Contingência da NFC-e \[Híbrido\]](/invoisys/endpoints/emissao-notas/nfc-e-1/api-envio-contingencia-hibrida-da-nfc-e.md)         | Usado para realizar a emissão da nota em contingência.                                                                                                                            |
| [Consulta da NFC-e por ID](/invoisys/endpoints/emissao-notas/nfc-e-1/api-consulta-nfc-e-por-id.md)                                      | Utilizando o ID da nota, é possível consultar detalhadamente os dados da mesma                                                                                                    |
| [Consulta da NFC-e por Número e Série](/invoisys/endpoints/emissao-notas/nfc-e-1/api-consulta-nfc-e-por-numero-e-serie.md)              | Utilizando o Número e Série, em conjunto do CNPJ da empresa, é possível consultar detalhadamente os dados da mesma                                                                |
| [Consulta da NFC-e por Chave de Acesso](/invoisys/endpoints/emissao-notas/nfc-e-1/api-consulta-nfc-e-por-chave-de-acesso.md)            | Usando a Chave de Acesso do documento, é possível consultar detalhadamente os dados da mesma                                                                                      |
| [Consulta Paginada de NFC-es](/invoisys/endpoints/emissao-notas/nfc-e-1/api-consulta-paginada-de-nfc-es.md)                             | Retorna uma lista de documentos fiscais. Pode ser parametrizada de diversas formas                                                                                                |
| [Cancelamento/Inutilização da NFC-e por ID Estabelecimento](/invoisys/endpoints/emissao-notas/nfc-e-1/api-cancelar-inutilizar-nfc-e.md) | Ambas as operações são realizadas através de uma mesma chamada                                                                                                                    |
| [Cancelamento/Inutilização da NFC-e por CNPJ](/invoisys/endpoints/emissao-notas/nfc-e-1/api-cancelar-inutilizar-nfc-e-por-cnpj.md)      | Ambas as operações são realizadas através de uma mesma cham​ada                                                                                                                   |
| [Consultar Última Numeração por ID](/invoisys/endpoints/emissao-notas/nfc-e-1/api-consultar-ultima-numeracao-por-id.md)                 | Permite checar, por ID do Estabelecimento, a última numeração utilizada                                                                                                           |
| [Consultar Última Numeração por CNPJ](/invoisys/endpoints/emissao-notas/nfc-e-1/api-consultar-ultima-numeracao-por-cnpj.md)             | Permite checar, por CNPJ, a última numeração utilizada                                                                                                                            |

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

## Desenvolvimento

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 - Modelo Completo

| Etapa                                                                                                                                                             | Descrição                                                                                                |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| [Autenticação](/invoisys/endpoints/autorizacao/autenticacao.md#api-token)                                                                                         | A autenticação será utilizada para obter o token de acesso que será passado em todas as chamadas de API. |
| [Envio Normal](/invoisys/getting-started/documentos-fiscais/emissao/nfc-e/fluxo-operacional/envio-normal-nfc-e-fluxo-completo.md)                                 | Tudo o que envolve o envio normal da NFC-e                                                               |
| [Envio Contingência SEFAZ](/invoisys/getting-started/documentos-fiscais/emissao/nfc-e/fluxo-operacional/envio-contingencia-sefaz-nfc-e-flux.md)                   | Todas as chamadas necessárias para validar o envio em contingência SEFAZ                                 |
| [Envio Contingência Off-Line](/invoisys/getting-started/documentos-fiscais/emissao/nfc-e/fluxo-operacional/envio-contingencia-off-line-nfc-e-fluxo-completo.md)   | Todas as chamadas necessárias para validar o envio em contingência Off-Line                              |
| [Cancelamento/Inutilização](/invoisys/getting-started/documentos-fiscais/emissao/nfc-e/fluxo-operacional/envio-cancelamento-inutilizacao-nfc-e-fluxo-completo.md) | Desde o seu envio, até a consulta de seu status na SEFAZ.                                                |

### Checklist - Modelo Híbrido

| Etapa                                                                                                                                                             | Descrição                                                                                                |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| [Autenticação](/invoisys/endpoints/autorizacao/autenticacao.md#api-token)                                                                                         | A autenticação será utilizada para obter o token de acesso que será passado em todas as chamadas de API. |
| [Envio Normal](/invoisys/getting-started/documentos-fiscais/emissao/nfc-e/fluxo-operacional/envio-normal-nfc-e-fluxo-completo.md)                                 | Tudo o que envolve o envio normal da NFC-e                                                               |
| [Envio Contingência Off-Line](/invoisys/getting-started/documentos-fiscais/emissao/nfc-e/fluxo-operacional/envio-contingencia-off-line-nfc-e-fluxo-completo.md)   | Todas as chamadas necessárias para validar o envio em contingência Off-Line                              |
| [Cancelamento/Inutilização](/invoisys/getting-started/documentos-fiscais/emissao/nfc-e/fluxo-operacional/envio-cancelamento-inutilizacao-nfc-e-fluxo-completo.md) | Desde o seu envio, até a consulta de seu status na SEFAZ.                                                |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://integracao.gitbook.io/invoisys/getting-started/documentos-fiscais/emissao/nfc-e/passo-a-passo.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
