# Passo a Passo Fatura

## 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 a entrada de Faturas.‌

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 [(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.

<table data-header-hidden><thead><tr><th width="323">Etapas</th><th>Descrição</th></tr></thead><tbody><tr><td>Etapas</td><td>Descrição</td></tr><tr><td>​<a href="/pages/0nlq6Z5GNVINFFnvuiZ5">Autenticação</a>​</td><td>Utilizado para obter o token de acesso.</td></tr><tr><td><a href="https://app.gitbook.com/o/-Lmo0TUHOztVF3fNCAm-/s/-Lmo0dH8REcSzSboskDA/~/changes/641/endpoints/recebimento-notas/ct-e-2/api-entrada-de-nf-e-xml-resumido-obtido">Obter Documento por NSUI</a></td><td>Utilizando o CNPJ do Contratante e o Numero Sequencial Único Invoisys, é possível obter até 50 faturas recebidas.</td></tr><tr><td><a href="https://app.gitbook.com/o/-Lmo0TUHOztVF3fNCAm-/s/-Lmo0dH8REcSzSboskDA/~/changes/641/endpoints/recebimento-notas/ct-e-2/api-entrada-de-nf-e-por-xml">Enviar XML de Fatura</a></td><td>Usado para Enviar o XML no layout Invoisys de Fatura no formato base64.</td></tr><tr><td><a href="https://app.gitbook.com/o/-Lmo0TUHOztVF3fNCAm-/s/-Lmo0dH8REcSzSboskDA/~/changes/641/endpoints/recebimento-notas/ct-e-2/indicar-cancelamento-de-fatura">Indicar Cancelamento</a></td><td>Usado para atribuir o status de cancelamento para uma fatura por um ID de Documento.</td></tr><tr><td><a href="https://app.gitbook.com/o/-Lmo0TUHOztVF3fNCAm-/s/-Lmo0dH8REcSzSboskDA/~/changes/641/endpoints/recebimento-notas/ct-e-2/api-entrada-de-nf-e-por-xml-2">Enviar Anexo</a></td><td>Usado para enviar Anexo no formato base64 e vincular a uma Fatura existente pelo numero do ID do documento.</td></tr><tr><td><a href="https://app.gitbook.com/o/-Lmo0TUHOztVF3fNCAm-/s/-Lmo0dH8REcSzSboskDA/~/changes/641/endpoints/recebimento-notas/ct-e-2/api-entrada-de-nf-e-xml-resumido-obtido-1">Obter anexo</a></td><td>Utilizando o ambiente(produtivo ou homologação) e o ID do Arquivo Anexo interno Invoisys  é possível obter o Anexo vinculado a uma Fatura presente no Sistema.</td></tr><tr><td>Obter XML da Fatura</td><td>Utilizando o ambiente(produtivo ou homologação) e o ID Invoisys do documento, é possível obter o XML carregado para o Sistema.</td></tr></tbody></table>

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          | A autenticação será utilizada para obter o token de acesso que será passado em todas as chamadas de API. |
| Recebimento de Fatura | Etapa principal, onde toda a operação de Recebimento irá ocorrer                                         |


---

# 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/recebimento/ct-e-3/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.