v1

latestOpenAPI 3.0.3Proprietary2026-07-26125148541.3 KB

NFe

Emitir

Recebe o payload da NF-e e inicia o envio para autorização na SEFAZ. Por padrão, o fluxo é assíncrono: a API confirma o recebimento da requisição e a nota segue em fila até o processamento. Quando permitido pelo estado e pela configuração da conta, a emissão pode ocorrer de forma síncrona, com o resultado retornado na mesma requisição. Para acompanhar o status até a autorização, use a consulta da nota ou os webhooks. A NF-e na versão 4.00 admite muitos campos. A referência completa dos campos aceitos pela API, com a correspondência às tags XML, está no link abaixo. Documentação completa dos campos da NF-e (versão 4.00)

post/nfe

Query parameters

refstring required

Example:12345

Referência única da NFe no seu sistema

Request body

natureza_operacaostring required

Descrição da natureza da operação a ser realizada pela nota fiscal

data_emissaostring date-time required

Data da emissão da NFe (formato ISO)

data_entrada_saidastring date-time

Data de entrada ou saída da mercadoria

tipo_documento0 | 1 required

Tipo da NFe:

0: Nota Fiscal de Entrada
1: Nota Fiscal de Saída

local_destino1 | 2 | 3

Local onde a operação irá acontecer:

1: Operação interna
2: Operação interestadual
3: Operação com exterior

finalidade_emissao1 | 2 | 3 | 4 required

Finalidade da emissão da nota:

1: Normal
2: Complementar
3: Nota de ajuste
4: Devolução

consumidor_final0 | 1

Indica se a operação é com consumidor final:

0: Normal
1: Consumidor final

presenca_comprador0 | 1 | 2 | 3 | 4 | 9

Presença do comprador:

0: Não se aplica
1: Operação presencial
2: Operação não presencial, pela Internet
3: Operação não presencial, Teleatendimento
4: NFC-e em operação com entrega em domicílio
9: Operação não presencial, outros

cnpj_emitentestring

CNPJ do emitente (usar este ou cpf_emitente)

cpf_emitentestring

CPF do emitente (usar este ou cnpj_emitente)

nome_emitentestring

Razão social do emitente

nome_fantasia_emitentestring

Nome fantasia do emitente

logradouro_emitentestring

Logradouro do emitente

numero_emitentestring

Número do logradouro do emitente

bairro_emitentestring

Bairro do emitente

municipio_emitentestring

Município do emitente

uf_emitentestring

UF do emitente

cep_emitentestring

CEP do emitente

inscricao_estadual_emitentestring

Inscrição Estadual do emitente

regime_tributario_emitente1 | 2 | 3

Regime tributário do emitente:

1: Simples Nacional
2: Simples Nacional – excesso de sublimite de receita bruta
3: Regime Normal

nome_destinatariostring

Nome completo do destinatário

cnpj_destinatariostring

CNPJ do destinatário (usar este ou cpf_destinatario)

cpf_destinatariostring

CPF do destinatário (usar este ou cnpj_destinatario)

inscricao_estadual_destinatariostring

Inscrição Estadual do destinatário

indicador_inscricao_estadual_destinatario1 | 2 | 9

Indicador da IE do destinatário:

1: Contribuinte ICMS
2: Contribuinte isento
9: Não Contribuinte

logradouro_destinatariostring

Logradouro do destinatário

numero_destinatariostring

Número do logradouro do destinatário

bairro_destinatariostring

Bairro do destinatário

municipio_destinatariostring

Município do destinatário

uf_destinatariostring

UF do destinatário

cep_destinatariostring

CEP do destinatário

pais_destinatariostring

País do destinatário

telefone_destinatariostring

Telefone do destinatário

valor_fretenumber float

Valor total do frete

valor_seguronumber float

Valor total do seguro

valor_descontonumber float

Valor total do desconto

valor_outras_despesasnumber float

Valor das despesas acessórias

valor_totalnumber float

Valor total da nota fiscal

valor_produtosnumber float

Valor total dos produtos

modalidade_frete0 | 1 | 2 | 9

Modalidade do frete:

0: Por conta do emitente
1: Por conta do destinatário
2: Por conta de terceiros
9: Sem frete

Example request

{
  "natureza_operacao": "Remessa",
  "data_emissao": "2024-01-15T12:00:00-03:00",
  "data_entrada_saida": "2024-01-15T12:00:00-03:00",
  "tipo_documento": 1,
  "local_destino": 1,
  "finalidade_emissao": 1,
  "presenca_comprador": 1,
  "cnpj_emitente": "12345678000123",
  "nome_emitente": "ACME LTDA",
  "uf_emitente": "SP",
  "nome_destinatario": "NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
  "pais_destinatario": "Brasil",
  "valor_total": 47.23,
  "valor_produtos": 47.23,
  "items": [
    {
      "numero_item": 1,
      "codigo_produto": "1232",
      "descricao": "Cartões de Visita",
      "cfop": "5923",
      "quantidade_comercial": 100,
      "quantidade_tributavel": 100,
      "valor_unitario_comercial": 0.4723,
      "valor_unitario_tributavel": 0.4723,
      "unidade_comercial": "UN",
      "unidade_tributavel": "UN",
      "valor_bruto": 47.23,
      "codigo_ncm": "49111090",
      "inclui_no_total": 1,
      "icms_situacao_tributaria": "41",
      "pis_situacao_tributaria": "07",
      "cofins_situacao_tributaria": "07"
    }
  ]
}

Response

NFe autorizada (emissão síncrona)

cnpj_emitentestring

CNPJ do emitente

refstring

Referência da emissão

status'autorizado'

Status da NFe

status_sefazstring

Status na SEFAZ

mensagem_sefazstring

Mensagem descritiva da SEFAZ

chave_nfestring

Chave da NFe

numerostring

Número da nota fiscal

seriestring

Série da nota fiscal

caminho_xml_nota_fiscalstring

Caminho para download do XML

caminho_danfestring

Caminho para download do DANFe