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

# NotasX

> API de emissão de NFS-e pelo Padrão Nacional, para quem emite em nome de vários Prestadores.

O NotasX emite **NFS-e pelo Padrão Nacional** (Sefin Nacional + ADN) por uma API HTTP simples.
Você cadastra os Prestadores, envia o Certificado A1 de cada um e cria Notas. O NotasX monta a DPS,
assina, envia à Sefin, guarda o XML e devolve o resultado.

## Como funciona

```mermaid theme={null}
sequenceDiagram
    participant Você
    participant API as API NotasX
    participant W as Emissão (NotasX)
    participant S as Sefin Nacional
    Você->>API: POST /v1/notas (Idempotency-Key)
    API-->>Você: 202 · Nota pendente
    API->>W: fila
    W->>S: DPS assinada (mTLS com o Certificado)
    S-->>W: NFS-e (chave de acesso)
    Você->>API: GET /v1/notas/{id}
    API-->>Você: emitida · chave_acesso · numero_nfse
```

A criação responde na hora (`202`); a emissão acontece em segundo plano, normalmente em segundos.

## Cobertura

* **Padrão Nacional** apenas (municípios conveniados à NFS-e Nacional).
* Emissão comprovada em **homologação** em Natal/RN. Outros municípios conveniados devem funcionar, mas ainda não foram testados.
* Cancelamento, Substituição e DANFSE (PDF) ainda não estão disponíveis.

> [card] [Início rápido](https://docs.notasx.com.br/inicio-rapido.md)
>
> Da Chave de API à primeira NFS-e em homologação.

> [card] [Referência da API](https://docs.notasx.com.br/api-reference/notas/criar-nota.md)
>
> Todas as rotas, campos e erros, com playground.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.