Sign in

v1

latestOpenAPI 3.0.3Proprietary2026-07-26125148541.3 KB
NFe

Pré-visualização de DANFe

Gera uma DANFe de preview para visualização.

A DANFe gerada por este endpoint é apenas para fins de visualização e não possui valor fiscal. Para a emissão de uma NFe com valor fiscal, utilize o processo de emissão padrão.

post/nfe/danfe

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

DANFe gerada com sucesso