Notare API
API REST de emissão de NFS-e. Schema único, idempotência por idIntegracao, webhooks com retry automático, suporte nativo à reforma tributária.
Comece em 3 passos
- Autentique-se — gere uma API key no portal Notare.
- Emita uma NFS-e —
POST /v1/nfsecom o JSON canônico. - Receba o webhook — status final no seu ERP com assinatura HMAC.
URLs
| Item | URL |
|---|---|
| Base da API | https://api.notare.nexosos.com |
| OpenAPI 3.1 | /v1/openapi.json |
| Status | status.notare.nexosos.com |
| Portal cliente | app.notare.nexosos.com |
Convenções
A API segue padrões REST modernos pra reduzir surpresas:
- JSON em request e response, encoding UTF-8
- Bearer Token no header
Authorization - Valores monetários em centavos (
int) — evita float - Alíquotas em basis points (
int) — 300 = 3,00% - Timestamps em ISO 8601 com timezone (
2026-06-13T22:00:00Z) - IDs UUID v4
idIntegracaotraz idempotência — reenvio devolve a mesma nota, sem duplicar
Status codes
| Code | Quando |
|---|---|
200 OK | Operação síncrona concluída |
202 Accepted | Aceita em fila — webhook traz o resultado |
400 Bad Request | Validação Zod falhou — errors[] lista os campos |
401 Unauthorized | API key ausente ou inválida |
403 Forbidden | Sem permissão pra essa operação |
404 Not Found | Recurso não existe ou fora do escopo da chave |
409 Conflict | Conflito de estado (ex: idempotência colidiu com outra nota) |
422 Unprocessable Entity | Regra de negócio bloqueou |
429 Too Many Requests | Rate limit — header Retry-After em segundos |
5xx | Erro do nosso lado — retentável com backoff |
Dúvidas? suporte@notare.com.br · Status do sistema