Skip to content

Emitir NF-e ​

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

Endpoint ​

http
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 ​

json
{
  "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 ​

json
{
  "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 ​

CampoDescriçãoValidação
ide.natOpNatureza da operaçãomín 1 char
ide.nNFNúmero sequencialobrigatório e único por série
dest.cnpj ou dest.cpfDocumento do destinatário14 ou 11 dígitos
det[]Lista de produtosmín 1 item
det[].prod.NCMClassificação NCM8 dígitos (consulta em portalunico.siscomex.gov.br)
det[].prod.CFOPCódigo Fiscal4 dígitos (5102 = venda intermunicipal)

PIS e COFINS ​

O grupo aceita as duas formas: a aninhada do leiaute e a achatada.

json
"PIS":    { "PISAliq": { "CST": "01", "vBC": "100.00", "pPIS": "1.65", "vPIS": "1.65" } },
"COFINS": { "CST": "01", "vBC": "100.00", "pCOFINS": "7.60", "vCOFINS": "7.60" }
CSTGrupo no XMLO que informar
01, 02PISAliq / COFINSAliqvBC, pPIS ou pCOFINS, vPIS ou vCOFINS
03PISQtde / COFINSQtdeqBCProd, vAliqProd, vPIS ou vCOFINS
04 a 09PISNT / COFINSNTsó o CST
49, 50 a 56, 60 a 67, 70 a 75, 98, 99PISOutr / COFINSOutrbase e alíquota ou quantidade e alíquota por unidade, mais o valor
  • Base e alíquota omitidas saem zeradas no XML.
  • Valor do imposto omitido é calculado da base e da alíquota. Para declarar imposto zero, informe "0.00".
  • Use ponto como separador decimal.
  • Os valores vão para o XML com 2 casas (4 na alíquota e na quantidade). Envie os valores já com as casas do leiaute. O total de PIS e de COFINS é a soma do que foi para os itens.

Entrada inválida é recusada antes de numerar, com 422 e codigo: "PISCOFINS_ENTRADA_INVALIDA". A mensagem diz o item e o campo. Casos: CST ausente ou fora da tabela, número com vírgula, valor negativo, imposto destacado num CST que não tributa (04 a 09). O CST 05 (substituição tributária) é aceito sem o valor: o grupo PISST / COFINSST ainda não é emitido.

Códigos CSOSN (Simples Nacional) ​

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

Próximos passos ​

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

Emissão ilimitada em todos os planos.