Início rápido
Cinco passos, da chave de API à primeira NFS-e autorizada no sandbox. Nada do que você fizer aqui é transmitido à prefeitura nem ao ambiente nacional.
Antes de começar
- Uma conta com acesso à API e ao Sandbox, com permissão para gerenciar chaves.
- cURL ou qualquer cliente HTTP.
- Um endereço HTTPS público para receber webhooks (só no passo 4).
PASSO 1 DE 5
Gere uma chave de sandbox
No painel, abra Configurações › API e integrações e clique em Gerar nova chave. Escolha o ambiente Sandbox e marque a permissão de escrita em NFS-e. A chave aparece uma única vez: copie e guarde num cofre de segredos.
export EDN_KEY="edn_test_SUA_CHAVE"PASSO 2 DE 5
Faça a primeira chamada
O sandbox já vem com uma empresa de teste. Liste as empresas para confirmar que a chave funciona e anote o id dela.
curl https://sandbox.api.emissordenota.com/v1/empresas \ -H "Authorization: Bearer $EDN_KEY"{ "dados": [ { "id": "emp_teste_01", "razao_social": "Empresa de Teste Ltda", "cnpj": "11222333000181" } ], "proximo_cursor": null}PASSO 3 DE 5
Emita uma NFS-e
Envie a empresa emissora, o tomador e o serviço. O cabeçalho Idempotency-Key garante que uma nova tentativa não gere nota duplicada.
curl -X POST https://sandbox.api.emissordenota.com/v1/nfse \ -H "Authorization: Bearer $EDN_KEY" \ -H "Idempotency-Key: pedido-1042" \ -H "Content-Type: application/json" \ -d '{ "empresa_id": "emp_teste_01", "tomador": { "documento": "98765432000198", "nome": "Clínica Bem Viver Ltda", "email": "financeiro@bemviver.com.br" }, "servico": { "codigo_tributacao_nacional": "010701", "descricao": "Suporte técnico em informática - novembro/2026", "valor": 1500.00 } }'A API responde na hora com a nota em processamento. A autorização chega em seguida.
{ "id": "nfse_3Jt9wPz7Qa", "status": "processando", "empresa_id": "emp_teste_01", "valor": 1500.00, "criada_em": "2026-11-09T10:42:07-03:00"}Simulando uma rejeição
PASSO 4 DE 5
Receba o resultado por webhook
Cadastre um endereço para ser avisado quando a nota for autorizada ou rejeitada. Sem webhook, consulte GET /nfse/{id} até o status mudar.
curl -X POST https://sandbox.api.emissordenota.com/v1/webhooks \ -H "Authorization: Bearer $EDN_KEY" \ -H "Content-Type: application/json" \ -d '{ "url": "https://seusistema.com.br/webhooks/emissor", "eventos": ["nfse.autorizada", "nfse.rejeitada"] }'Quando a nota for autorizada, seu endereço recebe:
{ "evento": "nfse.autorizada", "criado_em": "2026-11-09T10:42:11-03:00", "dados": { "id": "nfse_3Jt9wPz7Qa", "numero": "000000127", "status": "autorizada", "xml_url": "https://sandbox.api.emissordenota.com/v1/nfse/nfse_3Jt9wPz7Qa/xml", "pdf_url": "https://sandbox.api.emissordenota.com/v1/nfse/nfse_3Jt9wPz7Qa/pdf" }}PASSO 5 DE 5
Vá para produção
O formato das chamadas não muda. Antes de virar a chave:
- Gere uma chave de produção (prefixo edn_live_) com as permissões que a integração usa, e nada além.
- Troque o endereço base para https://api.emissordenota.com/v1.
- Confira se cada empresa emissora tem certificado A1 válido em GET /certificados.
- Cadastre os webhooks de novo: os endpoints do sandbox não valem em produção.
Produção emite nota de verdade