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

# Centros de Distribuição (CDs)

> Cadastre seus CDs para que o BulkRoute use o CEP de origem correto nas cotações automaticamente.

Os Centros de Distribuição (CDs) definem o **CEP de origem padrão** das suas cotações. Quando um pedido chega sem `originZip`, o BulkRoute busca o CD ativo mais antigo do seu tenant e usa o CEP dele.

<Note>
  Acesso: **Campo** > **CDs** (`/admin/distribution-centers`). Requer perfil Manager.
</Note>

## Por que cadastrar CDs

Sem um CD cadastrado, toda cotação precisa informar o CEP de origem manualmente. Com CDs:

* Cotações via API não precisam enviar `originZip`
* O orquestrador sabe de onde cada carga sai
* Multi-CD: se você tiver mais de um, o sistema usa o primeiro ativo (futuramente: seleção por proximidade)

## KPIs no topo

| KPI          | Descrição                     |
| :----------- | :---------------------------- |
| **Total**    | Quantidade de CDs cadastrados |
| **Ativos**   | CDs com status ativo          |
| **Inativos** | CDs desativados               |

## Cadastrando um CD

1. Vá em **Campo** > **CDs**
2. Clique em **Novo CD**
3. Preencha:

| Campo               | Descrição                       | Exemplo                    |
| :------------------ | :------------------------------ | :------------------------- |
| **Nome**            | Identificação do CD             | "CD São Paulo"             |
| **Código**          | Código único por tenant         | "CD-SP"                    |
| **CEP**             | CEP de origem do CD             | "01000-000"                |
| **Endereço**        | Rua, número, bairro, cidade, UF | Autocompleta via BrasilAPI |
| **Capacidade (m³)** | Capacidade volumétrica          | 5000                       |

4. O CEP autocompleta o endereço automaticamente
5. Clique em **Salvar**

<Note>
  O CEP é o campo mais importante — é ele que o BulkRoute usa como origem nas cotações. A capacidade é informativa.
</Note>

## Como o CD afeta a cotação

```mermaid theme={null}
graph TD
    A[Pedido chega sem originZip] --> B{Tenant tem CD ativo?}
    B -- Não --> X[Erro: CEP de origem obrigatório]
    B -- Sim --> C[Usa CEP do CD mais antigo]
    C --> D[Cotação calculada normalmente]
```

O BulkRoute busca o CD ativo mais antigo do tenant que tenha CEP cadastrado. Se nenhum CD ativo tiver CEP e nenhum `originZip` for enviado, a cotação falha com erro 400.

## Editar e desativar

* **Editar**: clique no CD na lista, altere os campos e salve
* **Desativar**: use a ação de desativar (soft delete) — o CD para de ser usado como origem, mas não é excluído

## Troubleshooting

| Problema                    | Causa                   | Solução                                            |
| :-------------------------- | :---------------------- | :------------------------------------------------- |
| Cotação retorna erro de CEP | Nenhum CD ativo com CEP | Cadastre um CD ou envie `originZip` na API         |
| Cotação usa CEP errado      | CD antigo ainda ativo   | Desative o CD antigo, deixe apenas o correto ativo |
| Endereço não autocompleta   | BrasilAPI indisponível  | Preencha o endereço manualmente                    |