> ## Documentation Index
> Fetch the complete documentation index at: https://docs.validatech.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Consulta Completa

> Consulte todos os dados detalhados de uma NFe, incluindo produtos, impostos e totais

## Endpoint

<api-endpoint method="get" url="/NFe/ConsultarNFeFull/{chave}" />

## Parâmetros

<ParamField path="chave" type="string" required>
  Chave de acesso da NF-e (44 caracteres numéricos)

  **Exemplo:** `35170608530528000184550000000154301000771561`
</ParamField>

## Headers

<ParamField header="X-API-KEY" type="string" required>
  Token de autenticação da API
</ParamField>

<ParamField header="Accept" type="string" default="application/json">
  Tipo de conteúdo aceito na resposta
</ParamField>

## Exemplos de Requisição

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://api.validanfe.com/NFe/ConsultarNFeFull/35170608530528000184550000000154301000771561" \
    -H "Accept: application/json" \
    -H "X-API-KEY: SEU_TOKEN_AQUI"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://api.validanfe.com/NFe/ConsultarNFeFull/35170608530528000184550000000154301000771561',
    {
      method: 'GET',
      headers: {
        'Accept': 'application/json',
        'X-API-KEY': 'SEU_TOKEN_AQUI'
      }
    }
  );

  const nfeCompleta = await response.json();
  ```

  ```python Python theme={null}
  import requests

  url = "https://api.validanfe.com/NFe/ConsultarNFeFull/35170608530528000184550000000154301000771561"
  headers = {
      "Accept": "application/json",
      "X-API-KEY": "SEU_TOKEN_AQUI"
  }

  response = requests.get(url, headers=headers)
  nfe_completa = response.json()
  ```

  ```php PHP theme={null}
  <?php
  $ch = curl_init();

  curl_setopt($ch, CURLOPT_URL, 'https://api.validanfe.com/NFe/ConsultarNFeFull/35170608530528000184550000000154301000771561');
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  curl_setopt($ch, CURLOPT_HTTPHEADER, [
      'Accept: application/json',
      'X-API-KEY: SEU_TOKEN_AQUI'
  ]);

  $response = curl_exec($ch);
  $nfe_completa = json_decode($response, true);

  curl_close($ch);
  ?>
  ```
</CodeGroup>

## Códigos de Resposta

<ResponseField name="200" type="Success">
  NF-e encontrada com todos os dados detalhados
</ResponseField>

<ResponseField name="400" type="Bad Request">
  Chave inválida ou mal formatada
</ResponseField>

<ResponseField name="401" type="Unauthorized">
  Token de autenticação ausente ou inválido
</ResponseField>

<ResponseField name="404" type="Not Found">
  NF-e não encontrada
</ResponseField>

<ResponseField name="429" type="Too Many Requests">
  Limite de requisições excedido (5/min)
</ResponseField>

<ResponseField name="500" type="Internal Server Error">
  Erro interno da API
</ResponseField>

## Estrutura da Resposta

A resposta contém toda a estrutura da NF-e, incluindo:

<Accordion title="📋 Dados Principais">
  * **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
</Accordion>

<Accordion title="🛍️ Produtos e Serviços">
  * **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
</Accordion>

<Accordion title="💰 Impostos e Tributos">
  * **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
</Accordion>

<Accordion title="📊 Totais e Cobrança">
  * **Totais da NF-e**: Valores consolidados
  * **Duplicatas**: Parcelas e vencimentos
  * **Formas de Pagamento**: Detalhamento dos pagamentos
</Accordion>

## Exemplo de Resposta

<CodeGroup>
  ```json 200 - Sucesso (Resumido) theme={null}
  {
      "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
                      }
                  }
              }
          }
      }
  }
  ```

  ```json 400 - Bad Request theme={null}
  {
      "error": "A chave da NF-e é obrigatória."
  }
  ```

  ```json 404 - Not Found theme={null}
  {
      "error": "NF-e não encontrada."
  }
  ```
</CodeGroup>

## Principais Campos

### Identificação (ide)

<ResponseField name="nNF" type="number">
  Número da Nota Fiscal
</ResponseField>

<ResponseField name="dhEmi" type="string">
  Data e hora de emissão
</ResponseField>

<ResponseField name="natOp" type="string">
  Natureza da operação
</ResponseField>

### Produtos (det)

<ResponseField name="prod.xProd" type="string">
  Descrição do produto/serviço
</ResponseField>

<ResponseField name="prod.qCom" type="number">
  Quantidade comercial
</ResponseField>

<ResponseField name="prod.vProd" type="number">
  Valor total do produto
</ResponseField>

### Totais (ICMSTot)

<ResponseField name="vProd" type="number">
  Valor total dos produtos
</ResponseField>

<ResponseField name="vNF" type="number">
  Valor total da Nota Fiscal
</ResponseField>

<ResponseField name="vTotTrib" type="number">
  Valor aproximado total dos tributos
</ResponseField>

## Diferenças da Consulta Resumida

<CardGroup cols={2}>
  <Card title="Consulta Resumida">
    * Dados básicos de protocolo
    * Status da autorização
    * XML simples
    * Resposta mais rápida
  </Card>

  <Card title="Consulta Completa">
    * Todos os produtos detalhados
    * Impostos por item
    * Dados de emitente/destinatário
    * Informações de transporte
  </Card>
</CardGroup>

<Tip>
  **Quando Usar**

  Use a consulta completa quando precisar de:

  * Detalhes de produtos e impostos
  * Dados para emissão de relatórios
  * Informações completas para auditoria
</Tip>