Para desenvolvedores
API de NFS-e Nacional inclusa em todos os planos
Uma API REST para emitir, consultar, cancelar e substituir NFS-e no Padrão Nacional, sem lidar com assinatura XML, mTLS e notas técnicas. Sandbox grátis, documentação aberta e webhooks. Você paga pelas notas, não pelo acesso.
14 dias grátis · sem cartão · cancele quando quiser
Comece em minutos
- Crie a conta e gere uma chave de sandbox.
- Envie a primeira nota em homologação, sem valor fiscal.
- Cadastre o certificado A1 da empresa e troque para a chave de produção.
POST /v1/nfse
Authorization: Bearer <sua_chave>
Idempotency-Key: pedido-2026-11-0001
{ "tomador": { "cnpj": "..." }, "servico": { "codigo_tributacao_nacional": "010101", "descricao": "...", "valor": 1500.00 }, "competencia": "2026-11" }O que a API faz por você
- Monta e assina a DPS com o certificado A1 da empresa e conversa com o Sistema Nacional por mTLS.
- Acompanha o leiaute vigente e as notas técnicas, inclusive IBS e CBS.
- Trata reenvio e idempotência: a mesma requisição não gera nota duplicada.
- Devolve erros explicados: o código oficial da Sefin, a mensagem original e uma explicação em português simples.
- Entrega XML e PDF da nota e envia ao tomador por e-mail, se você quiser.
- Emite em lote e para várias empresas, conforme o plano.
Webhooks
Eventos: nfse.emitida, nfse.rejeitada, nfse.cancelada, nfse.substituida, certificado.vencendo, cota.80_porcento. Assinatura HMAC em cada envio, novas tentativas com espera crescente e painel de entregas para reenviar. Funciona com Zapier, Make e n8n.
Sandbox de verdade
O sandbox usa o ambiente de produção restrita (homologação) do Sistema Nacional, então os erros que você vê são os reais. Notas de sandbox não têm valor fiscal e não contam no limite do plano.
Limites por plano
| Plano | Chamadas por minuto | Notas/mês incluídas | Empresas |
|---|---|---|---|
| Essencial | 60 | 30 | 1 |
| Profissional | 120 | 150 | 1 |
| Escala | 600 | 600 | 3 |
| Contador | 600 | 1.500 | 20 |
| Enterprise | Sob medida | Sob medida | Sob medida |
Compare tudo o que cada plano inclui.
Ver planosSegurança
Chaves por ambiente e por empresa, com escopo e revogação; certificado A1 criptografado e nunca exposto pela API; HTTPS obrigatório; auditoria de cada chamada que altera nota.
Perguntas frequentes
A API é gratuita?
Ela está inclusa em todos os planos, sem custo extra. O sandbox é grátis durante o teste e depois dele. Em produção, as notas emitidas pela API contam no limite do seu plano.
Por que usar a API de vocês e não direto a do governo?
A API oficial existe e é gratuita, mas exige montar e assinar a DPS, configurar mTLS com o certificado, tratar centenas de regras de validação e acompanhar cada nota técnica. Nós cuidamos disso e somamos webhooks, PDF, envio por e-mail e painel.
Preciso do certificado de cada empresa?
Sim. O Sistema Nacional exige que a DPS seja assinada com o certificado do próprio emitente. Cada empresa cadastra o seu A1 uma vez.
O que acontece se eu passar do limite de chamadas?
A API responde 429 com o tempo de espera no cabeçalho Retry-After. Nenhuma nota é perdida: reenvie com a mesma chave de idempotência.
Teste por 14 dias, sem cartão.