Criar Rascunho de NF-e

Cria uma NF-e (modelo 55) em modo rascunho com cálculo tributário automático (Smart Mode) ou manual detalhado (Full Mode). Responde em ~50ms.

POSThttps://api.nfer.me/v1/nfe

Chave de API (X-API-Key)

<sua_chave_api>

Headers da Requisição

X-API-Keystringobrigatório

Chave de API da empresa expedida no cadastro ou via /v1/companies.

Content-Typestringobrigatório

application/json

Corpo da Requisição (JSON Body)

natureza_operacaostringobrigatório

Natureza da operação fiscal (ex.: Venda de mercadoria, Devolução).

Exemplo: Venda de mercadoria

ambientestringopcionalpadrão: homologacao

"homologacao" (testes) ou "producao". Padrão da empresa se omitido.

serieintegeropcionalpadrão: 1

Número de série da nota. Se omitido, utiliza a série ativa padrão.

destinatarioobjectobrigatório

Objeto com dados do cliente (CPF/CNPJ, Razão Social, UF, Endereço).

itensarrayobrigatório

Lista de produtos/itens da nota com NCM, CFOP, quantidade e valor unitário.

pagamentoobjectobrigatório

Forma de pagamento (pix, cartao_credito, boleto, etc.) e valor total.

Criar Rascunho de NF-e

curl --request POST \
  --url https://api.nfer.me/v1/nfe \
  --header 'X-API-Key: <sua_chave_api>' \
  --header 'Content-Type: application/json' \
  --data '{
  "natureza_operacao": "Venda de mercadoria",
  "ambiente": "homologacao",
  "serie": "1",
  "destinatario": {},
  "itens": [],
  "pagamento": {}
}'

{
  "id": "b7c2930a-48a1-4fd8-879e-4a671cfbd992",
  "numero": 142,
  "serie": 1,
  "ambiente": "homologacao",
  "status": "rascunho",
  "total_nota": 149.9,
  "icms_total": 26.98,
  "created_at": "2026-09-16T22:30:00.000Z",
  "message": "NF-e criada em rascunho. Pronta para envio via POST /v1/nfe/:id/send."
}