Emitir NFe / NFCe

POST/v1/nfe/emit

POST /v1/nfe/emit emite uma NF-e (mod: "55"). Os dois modelos compartilham exatamente o mesmo schema de campos.

Emitindo NFC-e

Para emitir uma NFC-e, use POST /v1/nfc-e/emit com mod: "65" em vez de /v1/nfe/emit. O endpoint valida que o mod do corpo bate com o tipo da rota — enviar mod: "65" para /v1/nfe/emit (ou vice-versa) retorna 400 Bad Request.

Endpoint assíncrono

Esta chamada retorna 202 Accepted assim que o documento entra na fila de processamento — não espera pela SEFAZ. Uma rejeição da SEFAZ (schema inválido, duplicidade, regra de negócio, etc.) não vira erro HTTP nesta chamada: ela só aparece depois, consultando GET /v1/nfe/{id} com o invoiceId retornado aqui. Use esse endpoint para fazer polling até o status deixar de ser PENDENTE.

Campos pouco óbvios sempre obrigatórios

Além dos campos de identificação, o schema hoje também exige modalidade_frete, veiculo_placa e agropecuario_tipo_guia mesmo quando a operação não envolve transporte de carga própria ou produto agropecuário — nesses casos, envie modalidade_frete: "9" (sem frete) e os outros dois como string vazia.

Parâmetros do corpo

Campos comuns

modstringobrigatório

Valores aceitos: 55 | 65

Modelo do documento: 55 para NF-e, 65 para NFC-e.

natureza_operacaostringobrigatório

Descrição da natureza da operação.

data_emissaostringobrigatório

Data e hora de emissão (ISO 8601).

tipo_documentostringobrigatório

Valores aceitos: 0 | 1

0: Nota de entrada · 1: Nota de saída.

local_destinostringobrigatório

Valores aceitos: 1 | 2 | 3

1: Operação interna · 2: Interestadual · 3: Com o exterior.

finalidade_emissaostringobrigatório

Valores aceitos: 1 | 2 | 3 | 4 | 5 | 6

1: Normal · 2: Complementar · 3: Ajuste · 4: Devolução · 5/6: Nota de crédito/débito (Reforma Tributária).

consumidor_finalstringobrigatório

Valores aceitos: 0 | 1

0: Normal · 1: Consumidor final.

presenca_compradorstringobrigatório

Valores aceitos: 0 | 1 | 2 | 3 | 4 | 5 | 9

Indicador de presença do comprador — ver listagem completa de campos para o significado de cada código.

cnpj_emitentestring | numberobrigatório

CNPJ da empresa emitente.

inscricao_estadual_emitentestringobrigatório

Inscrição Estadual da empresa emitente.

itensarrayobrigatório

Lista de itens da nota.

codigo_produtostringobrigatório

Código interno do produto.

descricaostringobrigatório

Descrição do produto.

cfopstring | numberobrigatório

CFOP do produto.

unidade_comercialstringobrigatório

Unidade comercial (ex: UN, KG).

quantidade_comercialstring | numberobrigatório

Quantidade comercial.

valor_unitario_comercialstring | numberobrigatório

Valor unitário comercial.

icms_origemstringobrigatório

Origem da mercadoria — ver listagem completa de campos.

icms_situacao_tributariastringobrigatório

Situação tributária do ICMS (CST/CSOSN) — ver listagem completa de campos.

Esses são só os campos essenciais para uma emissão simples. Veja a listagem completa de campos de NF-e/NFC-e para todos os grupos opcionais (transporte, exportação, veículos, combustíveis, rastreabilidade, etc).

Resposta

202 Accepted

messagestring

Confirmação de que o documento entrou na fila de processamento.

invoiceIdstring

UUID interno do documento — use nas chamadas de consulta, cancelamento e correção.

accessKeystring

Chave de acesso de 44 dígitos do documento fiscal, quando já pode ser calculada no momento do enfileiramento.

cURL

curl -X POST https://app.nfe.tenzanlabs.com/v1/nfe/emit \
  -H "X-Access-Key: nfe_access_SUA_CHAVE_DE_ACESSO_AQUI" \
  -H "Authorization: Bearer nfe_test_SUA_CHAVE_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "mod": "55",
    "natureza_operacao": "Venda de Mercadoria",
    "data_emissao": "2026-08-19T12:00:00-03:00",
    "tipo_documento": "1",
    "local_destino": "1",
    "finalidade_emissao": "1",
    "consumidor_final": "1",
    "presenca_comprador": "1",
    "modalidade_frete": "9",
    "veiculo_placa": "",
    "agropecuario_tipo_guia": "",
    "cnpj_emitente": "12345678000199",
    "inscricao_estadual_emitente": "123456789",
    "nome_destinatario": "João da Silva",
    "cpf_destinatario": "11122233344",
    "itens": [
      {
        "codigo_produto": "123",
        "descricao": "Caneta Azul",
        "codigo_ncm": "96081000",
        "cfop": "5102",
        "unidade_comercial": "UN",
        "quantidade_comercial": 10,
        "valor_unitario_comercial": 2.50,
        "icms_origem": "0",
        "icms_situacao_tributaria": "102",
        "pis_situacao_tributaria": "07",
        "cofins_situacao_tributaria": "07"
      }
    ]
  }'

Node.js

import { NFeClient } from '@tenzanlabs/nfe-node-sdk';

const client = new NFeClient('nfe_access_SUA_CHAVE_DE_ACESSO_AQUI', 'nfe_test_SUA_CHAVE_AQUI');

const resposta = await client.emit({
  mod: '55',
  natureza_operacao: 'Venda de Mercadoria',
  data_emissao: new Date().toISOString(),
  tipo_documento: '1',
  local_destino: '1',
  finalidade_emissao: '1',
  consumidor_final: '1',
  presenca_comprador: '1',
  modalidade_frete: '9',
  veiculo_placa: '',
  agropecuario_tipo_guia: '',
  cnpj_emitente: '12345678000199',
  inscricao_estadual_emitente: '123456789',
  nome_destinatario: 'João da Silva',
  cpf_destinatario: '11122233344',
  itens: [
    {
      codigo_produto: '123',
      descricao: 'Caneta Azul',
      codigo_ncm: '96081000',
      cfop: '5102',
      unidade_comercial: 'UN',
      quantidade_comercial: 10,
      valor_unitario_comercial: 2.5,
      icms_origem: '0',
      icms_situacao_tributaria: '102',
      pis_situacao_tributaria: '07',
      cofins_situacao_tributaria: '07',
    },
  ],
});
console.log(resposta.invoiceId);

Python

from datetime import datetime, timezone
from nfe_sdk import NFeClient

client = NFeClient(access_key='nfe_access_SUA_CHAVE_DE_ACESSO_AQUI', api_key='nfe_test_SUA_CHAVE_AQUI')

resposta = client.emit({
    "mod": "55",
    "natureza_operacao": "Venda de Mercadoria",
    "data_emissao": datetime.now(timezone.utc).isoformat(),
    "tipo_documento": "1",
    "local_destino": "1",
    "finalidade_emissao": "1",
    "consumidor_final": "1",
    "presenca_comprador": "1",
    "modalidade_frete": "9",
    "veiculo_placa": "",
    "agropecuario_tipo_guia": "",
    "cnpj_emitente": "12345678000199",
    "inscricao_estadual_emitente": "123456789",
    "nome_destinatario": "João da Silva",
    "cpf_destinatario": "11122233344",
    "itens": [
        {
            "codigo_produto": "123",
            "descricao": "Caneta Azul",
            "codigo_ncm": "96081000",
            "cfop": "5102",
            "unidade_comercial": "UN",
            "quantidade_comercial": 10,
            "valor_unitario_comercial": 2.50,
            "icms_origem": "0",
            "icms_situacao_tributaria": "102",
            "pis_situacao_tributaria": "07",
            "cofins_situacao_tributaria": "07",
        }
    ],
})
print(resposta["invoiceId"])

Java

import br.com.saascore.nfe.NFeClient;
import br.com.saascore.nfe.model.NfeData;
import java.util.*;

NFeClient client = new NFeClient("nfe_access_SUA_CHAVE_DE_ACESSO_AQUI", "nfe_test_SUA_CHAVE_AQUI");

NfeData nota = new NfeData();
nota.mod = "55";
nota.natureza_operacao = "Venda de Mercadoria";
nota.data_emissao = java.time.Instant.now().toString();
nota.tipo_documento = "1";
nota.local_destino = "1";
nota.finalidade_emissao = "1";
nota.consumidor_final = "1";
nota.presenca_comprador = "1";
nota.modalidade_frete = "9";
nota.veiculo_placa = "";
nota.agropecuario_tipo_guia = "";
nota.cnpj_emitente = "12345678000199";
nota.inscricao_estadual_emitente = "123456789";
nota.nome_destinatario = "João da Silva";
nota.cpf_destinatario = "11122233344";

NfeData.NfeDataItens item = new NfeData.NfeDataItens();
item.codigo_produto = "123";
item.descricao = "Caneta Azul";
item.codigo_ncm = "96081000";
item.cfop = "5102";
item.unidade_comercial = "UN";
item.quantidade_comercial = 10;
item.valor_unitario_comercial = 2.50;
item.icms_origem = "0";
item.icms_situacao_tributaria = "102";
item.pis_situacao_tributaria = "07";
item.cofins_situacao_tributaria = "07";
nota.itens = List.of(item);

var resposta = client.emit(nota);
System.out.println(resposta.invoiceId);

Exemplo de resposta

{
  "message": "Documento enfileirado para processamento",
  "invoiceId": "35f0a1b2-...",
  "accessKey": "35260812345678000199550010000000011000000018"
}