> ## 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.

# Início Rápido

> Configure sua integração com a ValidaNFe em poucos minutos

## Comece em 3 passos simples

Faça sua primeira consulta à API ValidaNFe e integre com seus sistemas.

### Passo 1: Obtenha suas credenciais

<AccordionGroup>
  <Accordion title="Crie sua conta ValidaNFe">
    1. Acesse [admin.validanfe.com](https://admin.validanfe.com)
    2. Cadastre-se ou faça login em sua conta
    3. Complete o processo de verificação

    <Tip>Contas novas recebem créditos gratuitos para testes!</Tip>
  </Accordion>

  <Accordion title="Gere seu API Token">
    1. No painel administrativo, vá para **Configurações > API Token**
    2. Clique em "Gerar Novo Token"
    3. Copie e guarde seu token com segurança
    4. Configure variáveis de ambiente em sua aplicação

    <Warning>Mantenha seu token seguro e nunca o compartilhe publicamente.</Warning>
  </Accordion>
</AccordionGroup>

### Passo 2: Faça sua primeira consulta

<AccordionGroup>
  <Accordion title="Teste com cURL">
    Faça uma consulta de teste usando uma chave NFe de exemplo:

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

    <Tip>Use uma das [chaves de teste gratuitas](/validanfe-api/api-nfe/introducao#chaves-de-teste) para experimentar sem custos.</Tip>
  </Accordion>

  <Accordion title="Exemplo com JavaScript">
    ```javascript theme={null}
    const consultarNFe = async (chave) => {
      const response = await fetch(`https://api.validanfe.com/NFe/ConsultarNFe/${chave}`, {
        headers: {
          'Accept': 'application/json',
          'X-API-KEY': process.env.VALIDANFE_API_KEY
        }
      });
      
      return await response.json();
    };

    // Uso
    const nfe = await consultarNFe('35170608530528000184550000000154301000771561');
    console.log(nfe);
    ```
  </Accordion>
</AccordionGroup>

### Passo 3: Integre com sua aplicação

<Accordion title="Implementação em produção">
  1. Configure autenticação segura com variáveis de ambiente
  2. Implemente tratamento de erros e rate limiting
  3. Configure webhooks para notificações automáticas
  4. Teste com dados reais em ambiente de homologação
  5. Deploy para produção
</Accordion>

## Próximos Passos

Agora que você fez sua primeira consulta, explore estes recursos:

<CardGroup cols={2}>
  <Card title="Consulta Completa" href="/validanfe-api/api-nfe/nfe-full">
    Obtenha todos os detalhes da NFe incluindo produtos e impostos
  </Card>

  <Card title="API GuardaNFe" href="/validanfe-api/api-guarda/introducao">
    Armazene suas NFe com segurança na nuvem
  </Card>

  <Card title="Webhooks" href="/integracoes/webhooks">
    Receba notificações automáticas sobre suas consultas
  </Card>

  <Card title="Bibliotecas" href="/integracoes/bibliotecas">
    Use nossas SDKs para principais linguagens
  </Card>
</CardGroup>

## Chaves de Teste Gratuitas

Use estas chaves para testar a API sem custos:

| Chave NFe                                      | Descrição                           |
| ---------------------------------------------- | ----------------------------------- |
| `87878774456468954646464654654546545446579312` | NFe com todos os arrays preenchidos |
| `35220241522703000167550010000001211000225472` | NFe com evento de cancelamento      |
| `22210841816302000110550000000000012824578529` | NFe autorizada fora do prazo        |

<Info>
  **Precisa de ajuda?**

  Entre em contato: [suporte@validanfe.com](mailto:suporte@validanfe.com) ou acesse nossa [documentação completa](/validanfe-api/autenticacao).
</Info>