A API de NFS-e que seu produto precisa.
Integre emissão de NFS-e Nacional pra MEI, ME e EPP ao seu SaaS, ERP ou marketplace com um POST. Conexão direta com a Receita Federal, sem depender de prefeituras.
“Construa em uma tarde o que levaria 3 meses lendo manual da ABRASF.”
Sandbox sem cadastro · Trial grátis · Sem cartão de crédito
curl -X POST https://api.emitirnotafacil.com.br/v1/nfse \
-H "Authorization: Bearer $NF_API_KEY" \
-H "Content-Type: application/json" \
-d @nota.json3 linhas. Sem SOAP, sem XSD. JSON + Bearer.
curl -X POST https://api.emitirnotafacil.com.br/v1/nfse \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"tomador": {
"cnpj": "12345678000190",
"razao_social": "Cliente LTDA"
},
"servico": {
"descricao": "Consultoria em software",
"valor": 1500.00,
"codigo_nbs": "01.01.01.10"
},
"webhook_url": "https://meusite.com/webhooks/nfse"
}'{ "nota_id": "uuid", "status": "PROCESSANDO" }
→ webhook nfse.autorizada chega em segundos com PDF + XML
Como funciona
Cadastre a empresa
Registre o MEI ou ME que irá emitir as notas, faça upload do certificado A1 e receba a API Key (sk_live_ ou sk_test_) em segundos.
Emita via POST
Um POST /v1/nfse com tomador, serviço e webhook_url. A gente assina o XML, manda pra Receita e devolve 202 Accepted.
Receba via webhook
Evento nfse.autorizada assinado (HMAC-SHA256) com número da NFS-e, links de PDF e XML direto no seu endpoint.
Segurança & Conformidade
Infraestrutura pensada para compliance fiscal desde o primeiro dia.
Certificado A1 nunca em disco
Armazenado e decriptado em memória via AWS Secrets Manager. Zero exposição em disco ou logs.
API Keys hasheadas (SHA-256)
A chave real nunca é armazenada no banco. Apenas o hash irreversível.
Conforme LGPD
Dados processados exclusivamente em servidores no Brasil (sa-east-1).
mTLS com a Receita Federal
Conexão mutuamente autenticada com o sistema oficial NFS-e Nacional v1.2.
Infraestrutura de nível enterprise
Construa em 1 tarde o que levaria 6 meses.
A Receita Federal não tem API amigável. Nós traduzimos isso pra você.
Integração direta com a Receita Federal
- —3–6 meses de desenvolvimento
- —Manter biblioteca ABRASF atualizada
- —Gerenciar certificado A1 com segurança
- —Lidar com variações por município
- —Monitorar uptime do serviço federal
- —Suporte quando a Receita muda o padrão
NotaFácil API
- ✓Integrado em 1 tarde com o SDK
- ✓Atualizações automáticas quando a Receita muda
- ✓Certificado gerenciado com AWS KMS
- ✓5.000+ municípios cobertos
- ✓99,9% uptime SLA monitorado
- ✓Suporte técnico em português
Integre em qualquer linguagem
Bibliotecas oficiais mantidas pela ScantelburyDevs. Suporte garantido. Atualizações automáticas com cada versão da API.
Precisa de uma linguagem não listada?
Todos os SDKs inclusos em qualquer plano · Suporte técnico garantido
Por que o NotaFácil API?
Comparado com integração direta na Receita Federal e com APIs genéricas de NFS-e.
| Recurso | Direto Receita | APIs genéricas | NotaFácil API |
|---|---|---|---|
| Integração em menos de 1 dia | ✗ | varia | ✓ |
| Suporta MEI, ME e EPP nativamente | ✗ | varia | ✓ |
| Simples Nacional, Lucro Presumido e Lucro Real | ✗ | varia | ✓ |
| Cálculo de ISS + retenção por regime | ✗ | ✗ | ✓ |
| Certificado A1 gerenciado na nuvem | ✗ | ✗ | ✓ |
| Cancelamento e substituição (e101101/e105102) | ✗ | varia | ✓ |
| Sandbox incluso sem custo adicional | ✗ | varia | ✓ |
| SDK Node.js, Python e PHP mantidos | ✗ | varia | ✓ |
| Webhooks assinados (HMAC-SHA256) com retry | ✗ | varia | ✓ |
| NFS-e Nacional v1.01 (set/2026) | ✗ | varia | ✓ |
| Suporte técnico em pt-BR | ✗ | varia | ✓ |
“APIs genéricas” refere-se a APIs de NFS-e de uso geral, sem suporte específico ao compliance fiscal brasileiro (regime tributário, CRegTrib, cTribNac, IM municipal). Funcionalidades variam por fornecedor — consulte cada produto.
Preços
Sandbox sempre incluso. Escale conforme cresce.
Sandbox
Para prototipar e testar a integração antes de qualquer compromisso.
- ✓Ambiente de homologação ilimitado
- ✓Mesma API e webhooks da produção
- ✓SDKs Node, Python e PHP
- ✓Sem cartão · sem expiração
Pay-as-you-go
Você paga só pelo que emite em produção. Sem mensalidade, sem mínimo.
- ✓Sem mensalidade · só cobra o que emite
- ✓Trial de 30 dias com 5 notas grátis
- ✓Webhooks HMAC-SHA256 com retry
- ✓Dashboard, logs e auditoria fiscal 5 anos
- ✓Suporte por e-mail em até 24h
Enterprise
Para alto volume, SLA dedicado e integração assistida.
- ✓Preço por nota com desconto progressivo
- ✓SLA 99.95% com suporte 24/7
- ✓Múltiplas API Keys e ambientes isolados
- ✓Onboarding e integração assistida
- ✓Contrato anual com NF-e
Sandbox sempre incluso · Trial 30 dias com 5 notas · Sem fidelidade
Perguntas frequentes
Quanto tempo leva para integrar?+
Em média uma tarde. A API segue padrões REST com JSON. Você faz um POST, recebe 202 Accepted com nota_id, e o resultado chega via webhook assinado. Há SDKs prontos para Node.js e Python.
A API funciona em modo sandbox?+
Sim. O ambiente sandbox usa a URL de homologação da Receita Federal e não emite notas reais. Perfeito para integrar, testar e validar sem custo.
Como funciona a autenticação?+
Bearer token — chave sk_live_ (produção) ou sk_test_ (sandbox) no header Authorization. As chaves são geradas no dashboard e nunca ficam em texto puro no banco de dados.
E se a Receita Federal rejeitar a nota?+
O webhook entrega o evento nfse.rejeitada com o código e descrição exata do erro da Receita. Você corrige e resubmete. Há também endpoint GET /v1/nfse/:id para polling de status.
Suportam todos os municípios?+
Suportamos os 5.000+ municípios aderentes à NFS-e Nacional. Prefeituras com sistema próprio não são cobertas — mas a tendência é de migração total para o sistema federal.
Existe rate limit?+
Sliding window por API key: 100 req/min no plano Dev, 500 req/min no Pro, 2.000 req/min no Business. Headers X-RateLimit-* em cada resposta.
Pronto para integrar?
Sandbox grátis. Documentação completa. Sem surpresa na fatura.
Dúvidas de integração? dev@emitirnotafacil.com.br