Guia
API de NF-e da Emitfy
Como emitir NF-e pela API da Emitfy: credenciais, companyId no path, Idempotency-Key, XML/PDF, carta de correção e recebimento de NF-e de fornecedores.
Quando usar a API em vez do painel
Se o pedido já nasce no seu ERP ou checkout, alguém copiando dados para emitir à mão é retrabalho e fonte de erro. A API cria a nota, envia à SEFAZ e devolve o status; XML e PDF ficam disponíveis por endpoint próprio.
Toda nota emitida pela API aparece no painel da Emitfy. O time técnico integra; o financeiro acompanha e trata exceções sem abrir ferramenta de desenvolvedor.
O contrato completo, com campos e exemplos, está em docs.emitfy.com/reference/nfe. Esta página explica quando e como usar.
Fluxo mínimo de emissão
Gere as credenciais
No painel, em API & Webhooks, gere o par X-Api-Key e X-Api-Secret. O secret aparece só na geração ou rotação. A mesma credencial serve para todas as empresas da assinatura.
Cadastre ou envie cliente e produtos
Use os endpoints de catálogo (/customers e /products da empresa) ou mande os dados completos no corpo da emissão.
Emita com Idempotency-Key
POST /v1/companies/{companyId}/nfe com um identificador único da operação no header Idempotency-Key. Se a chamada for repetida, a API devolve a nota já criada em vez de emitir de novo.
Acompanhe e baixe os arquivos
Consulte GET /nfe/{id}, baixe /nfe/{id}/xml e /nfe/{id}/pdf, ou receba o evento nfe.authorized por webhook.
Endpoints de NF-e mais usados
| Operação | Endpoint |
|---|---|
| Emitir | POST /companies/{companyId}/nfe |
| Consultar | GET /companies/{companyId}/nfe/{id} |
| XML e PDF | GET /companies/{companyId}/nfe/{id}/xml e /pdf |
| Carta de correção (CC-e) | POST /companies/{companyId}/nfe/{id}/correction |
| Inutilizar numeração | POST /companies/{companyId}/nfe/inutilizations |
| Cancelar | POST /companies/{companyId}/invoices/{id}/cancel |
| NF-e recebidas | GET /companies/{companyId}/received-nfes |
Checklist técnico
- Empresa emissora com certificado A1 válido
- CFOP, NCM e CST coerentes com a operação (confirme com o contador)
- Destinatário com documento e endereço válidos
- Ambiente de homologação validado antes de produção
- Webhook ou consulta de status definidos para atualizar o seu sistema
Perguntas frequentes
Como recebo as NF-e emitidas contra o meu CNPJ?
Pelos endpoints de NF-e recebidas: listar, sincronizar com a SEFAZ, baixar o XML e registrar a manifestação do destinatário. Útil para ERPs que conciliam compras e estoque.
Nota autorizada pode ser alterada pela API?
Não. Nota autorizada ou cancelada é imutável. Para corrigir dados permitidos, use a carta de correção; para desfazer, cancele dentro do prazo e emita outra.
Onde está o OpenAPI?
Em api.emitfy.com/openapi.yaml (OpenAPI 3.1). Para agentes de IA, há também a versão em texto em api.emitfy.com/llms-full.txt.
Há SDK?
Sim: Node.js/TypeScript, PHP, Python, .NET e Java, todos oficiais. Pacotes e instalação em /guias/api-sdk.
Próximo passo
Automatize a emissão fiscal com a Emitfy
Conecte sua plataforma ou use a API REST. 10 notas grátis para testar, sem cartão.
Continue lendo
Leitura relacionada
API de NFS-e da Emitfy
Como emitir NFS-e pela API da Emitfy quando o checkout é seu: credenciais, endpoint, erros de validação, retentativa e quando preferir a integração nativa.
2 min · 23/10/2026Ler o guia GuiaAPIWebhooks da API Emitfy
Como receber webhooks da Emitfy com o status de cada nota: eventos, headers de autenticação, retentativas e a diferença para o webhook de entrada.
2 min · 23/10/2026Ler o guia GuiaAPIExemplos de API Emitfy
Exemplos de chamadas à API Emitfy: autenticação, emissão de NFS-e, NF-e e CT-e, idempotência, erros e NF-e recebidas. Contrato completo no OpenAPI.
3 min · 23/10/2026Ler o guia