Nota Fiscal Eletrônica pela Chave — NF-e

Situação, emitente, destinatário, valores e itens de uma Nota Fiscal Eletrônica. Consulta-se pela chave de acesso de 44 dígitos. Vale só para NF-e modelo 55: não lê NFC-e nem nota de serviço.

POST/v1/nfe/consultas

Órgão
Secretaria da Fazenda (portal da NF-e)
Prazo máximo
180 s
PDF
Não entrega

Campos do corpo

  • chaveobrigatório

    44 dígitos

    Chave de acesso de 44 dígitos, com ou sem espaços.

  • referenciaopcional

    Texto, até 80

    Seu identificador. Volta na resposta, no webhook e no histórico.

  • filtroopcional

    Objeto

    Devolve só os itens de detalhe.itens que batem: {"campo": valor}.

  • ordenaropcional

    Nome de um campo do item

    - na frente para a ordem decrescente.

  • limiteopcional

    Inteiro de 1 a 1000

    Quantos itens devolver.

Resultados possíveis

dadossem_registros

Decida pelo campo codigo. Consulta que o órgão não respondeu volta como sem_retorno ou em_processamento e não é cobrada.

O que vem em detalhe

detalhe.dados

  • situacaoSituação
  • ambienteAutorizacaoAmbiente da autorização
  • modeloModelo
  • serieSérie
  • numeroNúmero
  • versaoLeiauteVersão do leiaute
  • emissaoEmissão
  • entradaOuSaidaEntrada ou saída
  • naturezaOperacaoNatureza da operação
  • tipoOperacaoTipo de operação
  • finalidadeEmissaoFinalidade da emissão
  • formaEmissaoForma de emissão
  • processoEmissaoProcesso de emissão
  • formaPagamentoForma de pagamento
  • formatoImpressaoDanfeFormato de impressão do DANFE
  • valorTotalNotaValor total da nota
  • valorProdutosValor dos produtos
  • freteFrete
  • seguroSeguro
  • descontosDescontos
  • outrasDespesasAcessoriasOutras despesas acessórias
  • baseCalculoIcmsBase de cálculo do ICMS
  • icmsICMS
  • icmsDesoneradoICMS desonerado
  • fundoCombatePobrezaFcpFundo de combate à pobreza (FCP)
  • icmsFcpICMS do FCP
  • icmsInterestadualParaUfDestinoICMS interestadual para a UF de destino
  • icmsInterestadualParaUfRemetenteICMS interestadual para a UF do remetente
  • baseCalculoIcmsPorSubstituicaoTributariaBase de cálculo do ICMS por substituição tributária
  • icmsPorSubstituicaoTributariaICMS por substituição tributária
  • fcpRetidoPorSubstituicaoTributariaFCP retido por substituição tributária
  • fcpRetidoAnteriormentePorSubstituicaoTributariaFCP retido anteriormente por substituição tributária
  • impostoImportacaoImposto de importação
  • ipiIPI
  • ipiDevolvidoIPI devolvido
  • pisPIS
  • cofinsCOFINS
  • valorAproximadoTributosValor aproximado dos tributos
  • informacoesAdicionaisInformações adicionais
  • nfReferenciadasNF-e referenciadas
  • emitenteEmitente
  • nomeFantasiaEmitenteNome fantasia do emitente
  • documentoEmitenteDocumento do emitente
  • logradouroEmitenteLogradouro do emitente
  • bairroEmitenteBairro do emitente
  • municipioEmitenteMunicípio do emitente
  • ufEmitenteUF do emitente
  • cepEmitenteCEP do emitente
  • paisEmitentePaís do emitente
  • telefoneEmitenteTelefone do emitente
  • inscricaoEstadualEmitenteInscrição estadual do emitente
  • inscricaoEstadualSubstitutoTributarioInscrição estadual do substituto tributário
  • inscricaoMunicipalEmitenteInscrição municipal do emitente
  • municipioFatoGeradorIcmsMunicípio do fato gerador do ICMS
  • atividadePrincipalEmitenteCnaeAtividade principal do emitente (CNAE)
  • regimeTributarioEmitenteRegime tributário do emitente
  • destinatarioDestinatário
  • nomeFantasiaDestinatarioNome fantasia do destinatário
  • documentoDestinatarioDocumento do destinatário
  • logradouroDestinatarioLogradouro do destinatário
  • bairroDestinatarioBairro do destinatário
  • municipioDestinatarioMunicípio do destinatário
  • ufDestinatarioUF do destinatário
  • cepDestinatarioCEP do destinatário
  • paisDestinatarioPaís do destinatário
  • telefoneDestinatarioTelefone do destinatário
  • eMailDestinatarioE-mail do destinatário
  • indicadorInscricaoEstadualDestinatarioIndicador de inscrição estadual do destinatário
  • inscricaoEstadualDestinatarioInscrição estadual do destinatário
  • inscricaoSuframaDestinatarioInscrição na Suframa do destinatário
  • inscricaoMunicipalDestinatarioInscrição municipal do destinatário
  • localRetiradaLocal de retirada
  • documentoLocalRetiradaDocumento do local de retirada
  • logradouroRetiradaLogradouro da retirada
  • bairroRetiradaBairro da retirada
  • municipioRetiradaMunicípio da retirada
  • ufRetiradaUF da retirada
  • cepRetiradaCEP da retirada
  • paisRetiradaPaís da retirada
  • telefoneRetiradaTelefone da retirada
  • eMailRetiradaE-mail da retirada
  • inscricaoEstadualRetiradaInscrição estadual da retirada
  • localEntregaLocal de entrega
  • documentoLocalEntregaDocumento do local de entrega
  • logradouroEntregaLogradouro da entrega
  • bairroEntregaBairro da entrega
  • municipioEntregaMunicípio da entrega
  • ufEntregaUF da entrega
  • cepEntregaCEP da entrega
  • paisEntregaPaís da entrega
  • telefoneEntregaTelefone da entrega
  • eMailEntregaE-mail da entrega
  • inscricaoEstadualEntregaInscrição estadual da entrega
  • modalidadeFreteModalidade do frete
  • transportadoraTransportadora
  • documentoTransportadoraDocumento da transportadora
  • inscricaoEstadualTransportadoraInscrição estadual da transportadora
  • enderecoTransportadoraEndereço da transportadora
  • bairroTransportadoraBairro da transportadora
  • municipioTransportadoraMunicípio da transportadora
  • ufTransportadoraUF da transportadora
  • cepTransportadoraCEP da transportadora
  • faturaFatura
  • duplicatasDuplicatas
  • pagamentoPagamento
  • localEmbarqueLocal de embarque
  • ufEmbarqueUF de embarque
  • localDespachoLocal de despacho
  • mensagemFonteMensagem da fonte

detalhe.itens, um por registro

  • produtoProduto
  • itemItem
  • codigoProdutoCódigo do produto
  • ncmNCM
  • cestCEST
  • cfopCFOP
  • codigoExTipiCódigo EX da TIPI
  • quantidadeQuantidade
  • unidadeUnidade
  • valorValor
  • eanComercialEAN comercial
  • unidadeComercialUnidade comercial
  • quantidadeComercialQuantidade comercial
  • valorUnitarioComercialValor unitário comercial
  • eanTributavelEAN tributável
  • unidadeTributavelUnidade tributável
  • quantidadeTributavelQuantidade tributável
  • valorUnitarioTributavelValor unitário tributável
  • descontoDesconto
  • freteFrete
  • seguroSeguro
  • outrasDespesasOutras despesas
  • valorTributosValor dos tributos
  • escalaRelevanteEscala relevante
  • cnpjFabricanteCNPJ do fabricante
  • codigoBeneficioFiscalCódigo do benefício fiscal
  • pedidoCompraPedido de compra
  • itemPedidoCompraItem do pedido de compra
  • numeroFciNúmero da FCI
  • origemMercadoriaOrigem da mercadoria
  • tributacaoIcmsTributação do ICMS
  • modalidadeBaseCalculoIcmsModalidade da base de cálculo do ICMS
  • baseCalculoIcmsBase de cálculo do ICMS
  • aliquotaIcmsPercentualAlíquota do ICMS (%)
  • icmsICMS
  • fcpPercentualFCP (%)
  • fcpFCP
  • ipiSituacaoTributariaIPI: situação tributária
  • ipiClasseEnquadramentoIPI: classe de enquadramento
  • ipiCodigoEnquadramentoIPI: código de enquadramento
  • ipiCodigoSeloIPI: código do selo
  • ipiQuantidadeSelosIPI: quantidade de selos
  • ipiCnpjProdutorIPI: CNPJ do produtor
  • ipiBaseCalculoIPI: base de cálculo
  • ipiAliquotaPercentualIPI: alíquota (%)
  • ipiQuantidadeTotalIPI: quantidade total
  • ipiValorPorUnidadeIPI: valor por unidade
  • ipiIPI
  • pisSituacaoTributariaPIS: situação tributária
  • pisBaseCalculoPIS: base de cálculo
  • pisAliquotaPercentualPIS: alíquota (%)
  • pisPIS
  • cofinsSituacaoTributariaCOFINS: situação tributária
  • cofinsBaseCalculoCOFINS: base de cálculo
  • cofinsAliquotaPercentualCOFINS: alíquota (%)
  • cofinsCOFINS
  • eventoEvento
  • protocoloProtocolo
  • autorizacaoAutorização
  • inclusaoInclusão
  • tipoEventoTipo do evento
  • descricaoEventoDescrição do evento
  • sequencialSequencial
  • dataEventoData do evento
  • autorEventoAutor do evento
  • identificacaoEventoIdentificação do evento
  • orgaoRecepcaoÓrgão de recepção
  • ambienteAmbiente
  • versaoVersão
  • volumeVolume
  • especieEspécie
  • marcaMarca
  • pesoLiquidoPeso líquido
  • pesoBrutoPeso bruto

Cada campo só é enviado quando o órgão preencheu.

Observações

  • Só NF-e modelo 55. Chave de NFC-e (modelo 65) ou NFS-e volta dados_divergentes e não é cobrada.