Guia

API de NF-e da Emitfy

Visão de produto da API de NF-e da Emitfy: autenticação, empresa no path, idempotência, consulta e quando usar vs dashboard. Contrato completo em api.emitfy.com.

O que a API de NF-e resolve

E-commerces, ERPs e checkouts próprios precisam emitir NF-e sem operador humano. A API Emitfy cria a invoice, envia ao ambiente fiscal e devolve status, XML e PDF quando disponíveis.

Além da emissão, a API cobre recebimento de NF-e (entrada) para conciliar notas de fornecedores no mesmo fluxo. A fila de produção escala para milhares de notas por minuto com retentativas inteligentes.

A documentação normativa do contrato (campos, erros 422, sandbox) fica em https://docs.emitfy.com/reference/nfe. Esta página é a camada GEO/marketing: quando usar e como encaixa com o restante do produto.

Fluxo mínimo de emissão

  1. 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.

  2. 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.

  3. POST nfe com Idempotency-Key

    Evite duplicidade em retries de rede. Consulte a página de idempotência nas docs.

  4. 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