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

# Gestão de Clientes (Tenants)

> Cadastre e gerencie seus clientes — empresas que usam o BulkRoute para orquestrar suas entregas.

No BulkRoute, cada empresa cliente é um **Tenant**. Esta tela é onde você cadastra novos clientes, acompanha cotações e gerencia configurações de cada um.

<Note>
  Acesso: **Parceiros** > **Clientes** (`/admin/tenants`). Manager e Viewer veem apenas o próprio tenant.
</Note>

## KPIs no topo

| KPI                   | Descrição                                 |
| :-------------------- | :---------------------------------------- |
| **Total de Clientes** | Quantidade de tenants cadastrados         |
| **Cotações Hoje**     | Cotações feitas hoje por todos os tenants |
| **Total de Cotações** | Soma de todas as cotações já feitas       |

## Cadastrando um novo cliente

1. Vá em **Parceiros** > **Clientes**
2. Clique em **Novo Tenant**
3. Preencha:

| Campo                     | Descrição                                   | Exemplo                                                            |
| :------------------------ | :------------------------------------------ | :----------------------------------------------------------------- |
| **CNPJ**                  | CNPJ da empresa (autocompleta razão social) | "12.345.678/0001-90"                                               |
| **Nome Fantasia**         | Nome de exibição                            | "Móveis Premium"                                                   |
| **E-mail do Responsável** | E-mail do responsável pela empresa          | "[joao@moveispremium.com.br](mailto:joao@moveispremium.com.br)"    |
| **Webhook URL**           | URL para receber notificações               | "[https://atelier.com.br/webhook](https://atelier.com.br/webhook)" |

4. Clique em **Salvar**

O CNPJ autocompleta a razão social automaticamente.

## Editando um cliente

1. Clique no cliente na lista
2. Você é levado ao detalhe do tenant (`/admin/tenants/:id`)
3. Lá você pode configurar:

| Seção                     | O que faz                                     |
| :------------------------ | :-------------------------------------------- |
| **Geral**                 | Dados cadastrais, endereço, status            |
| **Chaves de API**         | Gera e gerencia API keys do cliente           |
| **Transportadoras**       | Ativa/desativa carriers para este tenant      |
| **Regras & Orquestração** | Configura regras de envio e fluxos            |
| **Planos & Faturas**      | Plano contratado, cobrança, preço customizado |
| **SSO Corporativo**       | Login via SAML (Enterprise)                   |

## Excluindo um cliente

<Warning>
  Excluir um cliente é **irreversível**. Todos os dados (cotações, envios, motoristas) são apagados.
</Warning>

1. Clique no ícone de lixeira ao lado do cliente
2. Digite o nome do cliente para confirmar
3. Clique em **Excluir**

## Webhook de status

Cada tenant pode ter uma **Webhook URL** configurada. O BulkRoute envia um `POST` para essa URL sempre que o status de um shipment muda, com assinatura HMAC no header para validação.

<Tip>
  Configure o webhook do cliente para que o ERP dele (Bling, Tiny, Omie) receba as atualizações de status automaticamente, sem precisar de polling.
</Tip>

## Quem vê o quê

| Perfil      | O que vê                                  |
| :---------- | :---------------------------------------- |
| **Manager** | Apenas o próprio tenant                   |
| **Viewer**  | Apenas o próprio tenant (somente leitura) |