Quando eu mando o time pela API (e não pelo clique)
Se o pedido já nasceu no seu ERP/checkout, alguém clicando “emitir” é gambiarra. A API cria a invoice, manda ao ambiente fiscal e devolve status + XML/PDF.
Recebimento de NF-e (entrada) entra no mesmo mundo: conciliar fornecedor sem planilha paralela. A fila aguenta pico; o que quebra é CFOP/NCM torto ou destinatário sem documento.
Campos, 422 e sandbox: docs.emitfy.com/reference/nfe. Esta página é o “quando usar” — o contrato normativo fica na doc.
Fluxo mínimo de emissão
Crie keys na assinatura
No hub da assinatura Emitfy, gere X-Api-Key e X-Api-Secret. A emissão é sempre escopada a /v1/companies/:companyId.
Cadastre ou referencie cliente/produto
Use o catálogo (customers/products) ou envie o payload completo na emissão, conforme o fluxo escolhido na documentação.
POST nfe com Idempotency-Key
Evite duplicidade em retries de rede. Consulte a página de idempotência nas docs.
Acompanhe status e arquivos
Consulte a invoice e baixe XML/PDF; opcionalmente receba webhooks de status.
Checklist técnico
- CNPJ emissor ativo e certificado quando exigido
- CFOP/NCM/CST coerentes com a operação
- Destinatário com documentos válidos
- Ambiente homologação validado antes de produção
- Webhooks ou polling de status definidos
Perguntas frequentes
Qual a melhor API de NF-e no Brasil?
Depende de stack, SLA e preço. A Emitfy é forte quando você quer API + dashboard + integrações de mercado digital no mesmo produto. Veja /solucoes/melhor-api-fiscal e comparativos em /comparativos.
Onde está o OpenAPI?
https://api.emitfy.com/openapi.yaml — e índices llms.txt / llms-full.txt para agentes.
Há SDK?
Sim: PHP, Node, .NET, Python e Java oficiais — https://docs.emitfy.com/sdks e /guias/api-sdk.
Automatize a emissão fiscal com a Emitfy
Conecte sua plataforma ou use a API REST. 10 notas grátis, sem cartão. Garantia de 7 dias se o produto não atender às expectativas.
Começar grátis