API headless

Integre emissão de NFS-e direto no seu sistema. REST + JSON + Bearer token. Zero SDK obrigatório — funciona com qualquer HTTP client.

Referência completa

Portal interativo com try-it-out em cada endpoint (OpenAPI + Scalar).

Abrir /docs/api

1. Gerar tokens de API

Em /app/api/tokens, clique Novo token, nomeie e copie uma vez — o token não é exibido novamente. Revogue via UI se comprometer.

Uso: header Authorization: Bearer nott_... em toda request.

2. Quickstart — emitir uma NFS-e

curl -X POST https://notta.app/api/v1/notas \
  -H "Authorization: Bearer nott_seu_token" \
  -H "Content-Type: application/json" \
  -d '{
    "tomador": {
      "cnpj": "12345678000199",
      "razaoSocial": "ACME LTDA"
    },
    "servico": {
      "valor": 1500.00,
      "codigoMunicipal": "0107",
      "descricao": "Consultoria em TI"
    }
  }'

Resposta 201 com { id, status, urlPdf, xmlUrl }. Emissão síncrona (média 5-30s).

3. Webhooks

Cadastre URLs em /app/api/webhooks para receber eventos:

nota.emitida
nota.cancelada
form.submetido

Payload assinado com HMAC-SHA256 (validar header X-Notta-Signature). Retries automáticos com backoff.

4. Portal completo

Toda a referência da API v1 (schemas Zod, exemplos por endpoint, error codes) está em /docs/api. Renderizado com Scalar — try-it-out interativo direto no browser.