Ir para o conteúdo

OUT1515% off na primeira cobrança com o cupom OUT15.15% off na 1ª cobrançaVer planos

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.

Rainer R. · FundadorAtualizado em 3 min de leitura

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

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

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

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

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

Base: https://api.emitfy.com/v1. Contrato completo no OpenAPI 3.1 em api.emitfy.com/openapi.yaml.
OperaçãoEndpoint
EmitirPOST /companies/{companyId}/nfe
ConsultarGET /companies/{companyId}/nfe/{id}
XML e PDFGET /companies/{companyId}/nfe/{id}/xml e /pdf
Carta de correção (CC-e)POST /companies/{companyId}/nfe/{id}/correction
Inutilizar numeraçãoPOST /companies/{companyId}/nfe/inutilizations
CancelarPOST /companies/{companyId}/invoices/{id}/cancel
NF-e recebidasGET /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.