> ## Documentation Index
> Fetch the complete documentation index at: https://docs.invo.work/llms.txt
> Use this file to discover all available pages before exploring further.

# Introdução

> APIs REST da Invo para emissão e gestão de NF-e (Nota de Produto, modelo 55) e NFS-e (Nota de Serviço).

A Invo expõe **duas APIs REST** que cobrem o ciclo de vida completo das suas notas fiscais — emissão, consulta, cancelamento e download de documentos:

<CardGroup cols={2}>
  <Card title="API NF-e" icon="box" href="/api-reference/notas-de-produto/listar-notas-de-produto-nf-e">
    **Nota de Produto, modelo 55.** Emissão, consulta, cancelamento, XML/DANFE e inutilização de faixa de numeração.

    `https://invo.work/api/nfe/v1`
  </Card>

  <Card title="API NFS-e" icon="receipt" href="/api-reference/notas-de-servico/listar-notas-de-servico-nfs-e">
    **Nota de Serviço.** Emissão (via RPS), consulta e cancelamento, integrada à prefeitura do município.

    `https://invo.work/api/nfse/v1`
  </Card>
</CardGroup>

As duas **compartilham as mesmas credenciais e a mesma seleção de empresa**: uma única conta opera os dois produtos. O que muda é o domínio fiscal (produto × serviço) e alguns detalhes de cada ciclo de vida.

## Conceitos compartilhados

<CardGroup cols={2}>
  <Card title="Autenticação HTTP Basic" icon="key">
    `api_key` / `api_secret` da conta em HTTP Basic, idênticas para NF-e e NFS-e. Veja [Autenticação](/autenticacao).
  </Card>

  <Card title="Seleção de empresa" icon="building">
    O cabeçalho **`X-Empresa-CNPJ`** define qual empresa emite. Ausente, usa a primeira empresa da conta.
  </Card>

  <Card title="Emissão assíncrona" icon="clock">
    `POST` persiste e enfileira a nota, retornando `201` com `situacao: "pendente"`. Acompanhe pelo `GET` de detalhes. Veja o [Ciclo de vida](/ciclo-de-vida).
  </Card>

  <Card title="Respostas em JSON" icon="brackets-curly">
    Todos os corpos são `application/json` (exceto os downloads de XML/DANFE da NF-e). `Accept` não-JSON recebe `406`.
  </Card>
</CardGroup>

## O que difere entre as APIs

|                    | API NF-e                                                                  | API NFS-e                                                                   |
| ------------------ | ------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| **Documento**      | Nota de Produto (modelo 55)                                               | Nota de Serviço                                                             |
| **Identificador**  | `uuid` (o `id` nunca é exposto)                                           | `id`                                                                        |
| **Emissão**        | Direto à SEFAZ; veredito terminal `autorizada` / `rejeitada` / `denegada` | Via **RPS** enviado em lote à prefeitura; depois `nfse.situacao: "emitida"` |
| **Extras**         | Inutilização **síncrona** de faixa; download de XML (nfeProc) e DANFE     | `codigo_verificacao` da NFS-e na resposta                                   |
| **Acompanhamento** | Polling **ou** [webhooks](/webhooks) `nfe_*`                              | Polling (sem webhooks)                                                      |

## Primeiros passos

<Steps>
  <Step title="Autentique">
    Use a `api_key` / `api_secret` da conta em HTTP Basic, e opcionalmente o cabeçalho `X-Empresa-CNPJ`. Veja [Autenticação](/autenticacao).
  </Step>

  <Step title="Emita uma nota">
    * **NF-e:** `POST /notas` com destinatário e itens — a resposta traz `uuid` e `chave_acesso` estáveis (aba **API NF-e**).
    * **NFS-e:** `POST /notas` com tomador e serviço — a resposta traz o `id` e gera o RPS (aba **API NFS-e**).
  </Step>

  <Step title="Acompanhe o resultado">
    Faça polling no `GET` de detalhes (`/notas/{uuid}` ou `/notas/{id}`). A NF-e também emite [webhooks](/webhooks) (`nfe_*`); a NFS-e é acompanhada por polling. Entenda os estados no [Ciclo de vida](/ciclo-de-vida).
  </Step>

  <Step title="Baixe os documentos">
    Após a autorização da NF-e, baixe o XML autorizado (nfeProc) e o DANFE (PDF). A NFS-e expõe o `codigo_verificacao` para conferência na prefeitura.
  </Step>
</Steps>