Emitir NF-e

Emite uma Nota Fiscal Eletrônica (modelo 55) para venda de produtos.

Endpoint

POST /api/v1/nfe
Authorization: Bearer {token}
Content-Type: application/json
Idempotency-Key: pedido-8842

Idempotency-Key é opcional, mas use sempre em integração: se a chamada der timeout e você repetir, receberá a mesma nota em vez de emitir uma segunda. Detalhes em Idempotência.

Body mínimo

{
  "ide": { "natOp": "Venda", "serie": 1, "nNF": 1 },
  "dest": {
    "cnpj": "33000167000101",
    "xNome": "Cliente LTDA",
    "email": "cliente@exemplo.com",
    "enderDest": {
      "xLgr": "Rua X", "nro": "100", "xBairro": "Centro",
      "cMun": "3304557", "xMun": "Rio de Janeiro", "UF": "RJ",
      "CEP": "20031170", "cPais": "1058", "xPais": "Brasil"
    }
  },
  "det": [{
    "prod": {
      "cProd": "P001", "cEAN": "SEM GTIN",
      "xProd": "Produto Teste", "NCM": "84713012",
      "CFOP": "6102", "uCom": "UN", "qCom": "1",
      "vUnCom": "100.00", "vProd": "100.00",
      "cEANTrib": "SEM GTIN", "uTrib": "UN",
      "qTrib": "1", "vUnTrib": "100.00", "indTot": "1"
    },
    "imposto": {
      "ICMS":   { "ICMSSN102": { "orig": "0", "CSOSN": "102" } },
      "PIS":    { "PISNT": { "CST": "07" } },
      "COFINS": { "COFINSNT": { "CST": "07" } }
    }
  }],
  "total": { "vProd": "100.00", "vNF": "100.00" },
  "transp": { "modFrete": "9" },
  "pag": [{ "tPag": "01", "vPag": "100.00" }]
}

Resposta 201

{
  "id": "uuid",
  "numero": 1,
  "serie": 1,
  "status": "pendente",
  "message": "NF-e enfileirada. Aguarde autorização SEFAZ (~3-10 segundos)."
}

Em segundos, o status muda para autorizada e o webhook é disparado.

Campos obrigatórios

Campo	Descrição	Validação
ide.natOp	Natureza da operação	mín 1 char
ide.nNF	Número sequencial	obrigatório e único por série
dest.cnpj ou dest.cpf	Documento do destinatário	14 ou 11 dígitos
det[]	Lista de produtos	mín 1 item
det[].prod.NCM	Classificação NCM	8 dígitos (consulta em portalunico.siscomex.gov.br)
det[].prod.CFOP	Código Fiscal	4 dígitos (5102 = venda intermunicipal)

Códigos CSOSN (Simples Nacional)

CSOSN	Descrição
101	Tributada com permissão de crédito
102	Tributada sem permissão de crédito
103	Isenção do ICMS para faixa de receita bruta
201	Com ST e permissão de crédito
400	Não tributada pelo Simples Nacional

Próximos passos

→ Consultar NF-e → Cancelar NF-e → Carta de Correção