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
- Não entrega
Campos do corpo
chaveobrigatório44 dígitos
Chave de acesso de 44 dígitos, com ou sem espaços.
referenciaopcionalTexto, até 80
Seu identificador. Volta na resposta, no webhook e no histórico.
filtroopcionalObjeto
Devolve só os itens de
detalhe.itensque batem:{"campo": valor}.ordenaropcionalNome de um campo do item
-na frente para a ordem decrescente.limiteopcionalInteiro 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çãoambienteAutorizacaoAmbiente da autorizaçãomodeloModeloserieSérienumeroNúmeroversaoLeiauteVersão do leiauteemissaoEmissãoentradaOuSaidaEntrada ou saídanaturezaOperacaoNatureza da operaçãotipoOperacaoTipo de operaçãofinalidadeEmissaoFinalidade da emissãoformaEmissaoForma de emissãoprocessoEmissaoProcesso de emissãoformaPagamentoForma de pagamentoformatoImpressaoDanfeFormato de impressão do DANFEvalorTotalNotaValor total da notavalorProdutosValor dos produtosfreteFreteseguroSegurodescontosDescontosoutrasDespesasAcessoriasOutras despesas acessóriasbaseCalculoIcmsBase de cálculo do ICMSicmsICMSicmsDesoneradoICMS desoneradofundoCombatePobrezaFcpFundo de combate à pobreza (FCP)icmsFcpICMS do FCPicmsInterestadualParaUfDestinoICMS interestadual para a UF de destinoicmsInterestadualParaUfRemetenteICMS interestadual para a UF do remetentebaseCalculoIcmsPorSubstituicaoTributariaBase de cálculo do ICMS por substituição tributáriaicmsPorSubstituicaoTributariaICMS por substituição tributáriafcpRetidoPorSubstituicaoTributariaFCP retido por substituição tributáriafcpRetidoAnteriormentePorSubstituicaoTributariaFCP retido anteriormente por substituição tributáriaimpostoImportacaoImposto de importaçãoipiIPIipiDevolvidoIPI devolvidopisPIScofinsCOFINSvalorAproximadoTributosValor aproximado dos tributosinformacoesAdicionaisInformações adicionaisnfReferenciadasNF-e referenciadasemitenteEmitentenomeFantasiaEmitenteNome fantasia do emitentedocumentoEmitenteDocumento do emitentelogradouroEmitenteLogradouro do emitentebairroEmitenteBairro do emitentemunicipioEmitenteMunicípio do emitenteufEmitenteUF do emitentecepEmitenteCEP do emitentepaisEmitentePaís do emitentetelefoneEmitenteTelefone do emitenteinscricaoEstadualEmitenteInscrição estadual do emitenteinscricaoEstadualSubstitutoTributarioInscrição estadual do substituto tributárioinscricaoMunicipalEmitenteInscrição municipal do emitentemunicipioFatoGeradorIcmsMunicípio do fato gerador do ICMSatividadePrincipalEmitenteCnaeAtividade principal do emitente (CNAE)regimeTributarioEmitenteRegime tributário do emitentedestinatarioDestinatárionomeFantasiaDestinatarioNome fantasia do destinatáriodocumentoDestinatarioDocumento do destinatáriologradouroDestinatarioLogradouro do destinatáriobairroDestinatarioBairro do destinatáriomunicipioDestinatarioMunicípio do destinatárioufDestinatarioUF do destinatáriocepDestinatarioCEP do destinatáriopaisDestinatarioPaís do destinatáriotelefoneDestinatarioTelefone do destinatárioeMailDestinatarioE-mail do destinatárioindicadorInscricaoEstadualDestinatarioIndicador de inscrição estadual do destinatárioinscricaoEstadualDestinatarioInscrição estadual do destinatárioinscricaoSuframaDestinatarioInscrição na Suframa do destinatárioinscricaoMunicipalDestinatarioInscrição municipal do destinatáriolocalRetiradaLocal de retiradadocumentoLocalRetiradaDocumento do local de retiradalogradouroRetiradaLogradouro da retiradabairroRetiradaBairro da retiradamunicipioRetiradaMunicípio da retiradaufRetiradaUF da retiradacepRetiradaCEP da retiradapaisRetiradaPaís da retiradatelefoneRetiradaTelefone da retiradaeMailRetiradaE-mail da retiradainscricaoEstadualRetiradaInscrição estadual da retiradalocalEntregaLocal de entregadocumentoLocalEntregaDocumento do local de entregalogradouroEntregaLogradouro da entregabairroEntregaBairro da entregamunicipioEntregaMunicípio da entregaufEntregaUF da entregacepEntregaCEP da entregapaisEntregaPaís da entregatelefoneEntregaTelefone da entregaeMailEntregaE-mail da entregainscricaoEstadualEntregaInscrição estadual da entregamodalidadeFreteModalidade do fretetransportadoraTransportadoradocumentoTransportadoraDocumento da transportadorainscricaoEstadualTransportadoraInscrição estadual da transportadoraenderecoTransportadoraEndereço da transportadorabairroTransportadoraBairro da transportadoramunicipioTransportadoraMunicípio da transportadoraufTransportadoraUF da transportadoracepTransportadoraCEP da transportadorafaturaFaturaduplicatasDuplicataspagamentoPagamentolocalEmbarqueLocal de embarqueufEmbarqueUF de embarquelocalDespachoLocal de despachomensagemFonteMensagem da fonte
detalhe.itens, um por registro
produtoProdutoitemItemcodigoProdutoCódigo do produtoncmNCMcestCESTcfopCFOPcodigoExTipiCódigo EX da TIPIquantidadeQuantidadeunidadeUnidadevalorValoreanComercialEAN comercialunidadeComercialUnidade comercialquantidadeComercialQuantidade comercialvalorUnitarioComercialValor unitário comercialeanTributavelEAN tributávelunidadeTributavelUnidade tributávelquantidadeTributavelQuantidade tributávelvalorUnitarioTributavelValor unitário tributáveldescontoDescontofreteFreteseguroSegurooutrasDespesasOutras despesasvalorTributosValor dos tributosescalaRelevanteEscala relevantecnpjFabricanteCNPJ do fabricantecodigoBeneficioFiscalCódigo do benefício fiscalpedidoCompraPedido de compraitemPedidoCompraItem do pedido de compranumeroFciNúmero da FCIorigemMercadoriaOrigem da mercadoriatributacaoIcmsTributação do ICMSmodalidadeBaseCalculoIcmsModalidade da base de cálculo do ICMSbaseCalculoIcmsBase de cálculo do ICMSaliquotaIcmsPercentualAlíquota do ICMS (%)icmsICMSfcpPercentualFCP (%)fcpFCPipiSituacaoTributariaIPI: situação tributáriaipiClasseEnquadramentoIPI: classe de enquadramentoipiCodigoEnquadramentoIPI: código de enquadramentoipiCodigoSeloIPI: código do seloipiQuantidadeSelosIPI: quantidade de selosipiCnpjProdutorIPI: CNPJ do produtoripiBaseCalculoIPI: base de cálculoipiAliquotaPercentualIPI: alíquota (%)ipiQuantidadeTotalIPI: quantidade totalipiValorPorUnidadeIPI: valor por unidadeipiIPIpisSituacaoTributariaPIS: situação tributáriapisBaseCalculoPIS: base de cálculopisAliquotaPercentualPIS: alíquota (%)pisPIScofinsSituacaoTributariaCOFINS: situação tributáriacofinsBaseCalculoCOFINS: base de cálculocofinsAliquotaPercentualCOFINS: alíquota (%)cofinsCOFINSeventoEventoprotocoloProtocoloautorizacaoAutorizaçãoinclusaoInclusãotipoEventoTipo do eventodescricaoEventoDescrição do eventosequencialSequencialdataEventoData do eventoautorEventoAutor do eventoidentificacaoEventoIdentificação do eventoorgaoRecepcaoÓrgão de recepçãoambienteAmbienteversaoVersãovolumeVolumeespecieEspéciemarcaMarcapesoLiquidoPeso líquidopesoBrutoPeso 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_divergentese não é cobrada.