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

# Validação de Endereços

> Valide CEPs e endereços completos antes de cotar — evite falha de entrega por endereço incorreto.

A tela de **Validação de Endereços** verifica se um CEP existe e se o endereço completo é consistente antes de você criar a cotação ou o envio. Endereço errado é a principal causa de falha de entrega — validar antes custa segundos.

<Note>
  Acesso direto pela URL: `/admin/address-validation`. A mesma validação também roda automaticamente dentro dos formulários de envio.
</Note>

## Como validar

1. Acesse `/admin/address-validation`
2. Informe o **CEP** — o sistema autocompleta rua, bairro, cidade e estado
3. Complete **número** e **complemento** (se houver)
4. Clique em **Validar**

O resultado mostra um dos 3 status:

| Status         | Significado                                   | O que fazer                                |
| :------------- | :-------------------------------------------- | :----------------------------------------- |
| **Válido**     | CEP existe e o endereço é consistente         | Pode cotar/despachar                       |
| **Inválido**   | CEP não existe ou não corresponde ao endereço | Corrija o CEP ou a rua antes de prosseguir |
| **Incompleto** | CEP válido, mas faltam dados (ex: número)     | Complete os campos e revalide              |

## Indicadores

No topo da tela, contadores da sessão atual:

* **Total** de validações feitas
* **Válidos** / **Inválidos** / **Incompletos**

## Histórico

A tabela no fim da página mostra as últimas 20 validações da sessão: CEP, endereço montado, status e horário.

<Note>
  O histórico é da sessão — ele não é persistido. Ao sair da tela, a lista é limpa.
</Note>

## Via API

A validação também está disponível via API para integrar no seu checkout ou ERP:

| Endpoint                    | Uso                                            |
| :-------------------------- | :--------------------------------------------- |
| `GET /address/validate-cep` | Valida se o CEP existe                         |
| `POST /address/validate`    | Valida o endereço completo                     |
| `GET /address/autocomplete` | Autocompleta rua/bairro/cidade a partir do CEP |
| `GET /address/geocode`      | Retorna coordenadas do endereço                |

Consulte o [Catálogo OpenAPI](/api-reference/openapi) para os schemas completos.