Skip to main content
GET
/
NFe
/
ConsultarNFeFull
/
{chave}
Consulta Completa
curl --request GET \
  --url https://api.validanfe.com/NFe/ConsultarNFeFull/{chave} \
  --header 'X-API-KEY: <x-api-key>'
{
  "200": {},
  "400": {},
  "401": {},
  "404": {},
  "429": {},
  "500": {},
  "nNF": 123,
  "dhEmi": "<string>",
  "natOp": "<string>",
  "prod.xProd": "<string>",
  "prod.qCom": 123,
  "prod.vProd": 123,
  "vProd": 123,
  "vNF": 123,
  "vTotTrib": 123
}

​
Endpoint

​
Parâmetros

​
chave
string
required
Chave de acesso da NF-e (44 caracteres numéricos)Exemplo: 35170608530528000184550000000154301000771561

​
Headers

​
X-API-KEY
string
required
Token de autenticação da API
​
Accept
string
default:"application/json"
Tipo de conteúdo aceito na resposta

​
Exemplos de Requisição

curl -X GET "https://api.validanfe.com/NFe/ConsultarNFeFull/35170608530528000184550000000154301000771561" \
  -H "Accept: application/json" \
  -H "X-API-KEY: SEU_TOKEN_AQUI"

​
Códigos de Resposta

​
200
Success
NF-e encontrada com todos os dados detalhados
​
400
Bad Request
Chave inválida ou mal formatada
​
401
Unauthorized
Token de autenticação ausente ou inválido
​
404
Not Found
NF-e não encontrada
​
429
Too Many Requests
Limite de requisições excedido (5/min)
​
500
Internal Server Error
Erro interno da API

​
Estrutura da Resposta

A resposta contém toda a estrutura da NF-e, incluindo:
  • Identificação (ide): Data, número, série, natureza da operação
  • Emitente (emit): CNPJ, nome, endereço, inscrições
  • Destinatário (dest): CPF/CNPJ, nome, endereço
  • Protocolo (protNFe): Autorização e validação
  • Detalhamento (det): Lista de todos os produtos/serviços
  • Códigos: NCM, CEST, CFOP, código do produto
  • Quantidades: Comercial e tributável
  • Valores: Unitário e total por item
  • ICMS: Alíquotas e valores por situação tributária
  • PIS/COFINS: Cálculos detalhados
  • IPI: Quando aplicável
  • Tributos Totais: Valor aproximado dos tributos
  • Totais da NF-e: Valores consolidados
  • Duplicatas: Parcelas e vencimentos
  • Formas de Pagamento: Detalhamento dos pagamentos

​
Exemplo de Resposta

{
    "nfeProc": {
        "protNFe": {
            "infProt": {
                "chNFe": "35170608530528000184550000000154301000771561"
            }
        },
        "NFe": {
            "infNFe": {
                "Id": "NFe35170608530528000184550000000154301000771561",
                "ide": {
                    "tpNF": 1,
                    "mod": 55,
                    "nNF": 15430,
                    "dhEmi": "2017-06-05T08:31:06-03:00",
                    "natOp": "VENDA"
                },
                "emit": {
                    "xNome": "COMERCIO DE TESTE LTDA EPP",
                    "CNPJ": "56776378000136",
                    "enderEmit": {
                        "xLgr": "AV FICTICIA",
                        "xMun": "SAO PAULO",
                        "UF": "SP"
                    }
                },
                "dest": {
                    "xNome": "MARIA FICTICIA DOS SANTOS",
                    "CPF": 67879577696
                },
                "det": [
                    {
                        "nItem": 1,
                        "prod": {
                            "cProd": 346,
                            "xProd": "SULFITE A4 75GR BOREAL (5000FLS)",
                            "qCom": 5,
                            "vUnCom": 149,
                            "vProd": 745
                        },
                        "imposto": {
                            "vTotTrib": 254.19
                        }
                    }
                ],
                "total": {
                    "ICMSTot": {
                        "vProd": 745,
                        "vNF": 745,
                        "vTotTrib": 254.19
                    }
                }
            }
        }
    }
}

​
Principais Campos

​
Identificação (ide)

​
nNF
number
Número da Nota Fiscal
​
dhEmi
string
Data e hora de emissão
​
natOp
string
Natureza da operação

​
Produtos (det)

​
prod.xProd
string
Descrição do produto/serviço
​
prod.qCom
number
Quantidade comercial
​
prod.vProd
number
Valor total do produto

​
Totais (ICMSTot)

​
vProd
number
Valor total dos produtos
​
vNF
number
Valor total da Nota Fiscal
​
vTotTrib
number
Valor aproximado total dos tributos

​
Diferenças da Consulta Resumida

Consulta Resumida

  • Dados básicos de protocolo
  • Status da autorização
  • XML simples
  • Resposta mais rápida

Consulta Completa

  • Todos os produtos detalhados
  • Impostos por item
  • Dados de emitente/destinatário
  • Informações de transporte
Quando UsarUse a consulta completa quando precisar de:
  • Detalhes de produtos e impostos
  • Dados para emissão de relatórios
  • Informações completas para auditoria