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

# Rastreio com sua Marca (Branded Tracking)

> Configure a página de rastreio pública com o logo, cores e domínio da sua empresa.

O BulkRoute permite que cada tenant personalize a página pública de rastreio com sua marca. O cliente final acessa o link de tracking e vê uma página com a identidade visual da sua empresa, não a do BulkRoute.

## Dois níveis de white-label

| Nível                         | URL                                        | O que muda                     | Plano        |
| :---------------------------- | :----------------------------------------- | :----------------------------- | :----------- |
| **Branding na URL BulkRoute** | `bulkroute.com.br/tracking/CODE`           | Logo, cor, CSS, título, rodapé | Planos pagos |
| **Domínio próprio**           | `rastreio.suaempresa.com.br/tracking/CODE` | Tudo acima + domínio próprio   | Enterprise   |

## Nível 1 — Branding na URL do BulkRoute

### Como configurar

1. Acesse **Configurações da Empresa** > **Branding**
2. Preencha os campos:

| Campo                 | Descrição                         | Exemplo                                   |
| :-------------------- | :-------------------------------- | :---------------------------------------- |
| **Logo URL (light)**  | Logo para modo claro              | `https://suaempresa.com.br/logo.png`      |
| **Logo URL (dark)**   | Logo para modo escuro             | `https://suaempresa.com.br/logo-dark.png` |
| **Cor primária**      | Cor principal (HEX ou OKLCH)      | `#2563eb`                                 |
| **Cor de destaque**   | Cor secundária                    | `#3b82f6`                                 |
| **CSS customizado**   | CSS injetado na página (opcional) | —                                         |
| **Título da página**  | Texto no `<title>` e `<h1>`       | "Rastreio - Sua Empresa"                  |
| **Texto do rodapé**   | Texto no rodapé                   | "Powered by Sua Empresa"                  |
| **Link do rodapé**    | URL do link no rodapé             | `https://suaempresa.com.br`               |
| **Página habilitada** | Toggle on/off                     | —                                         |

3. Use o **Preview** para ver como vai ficar
4. Clique em **Salvar e Publicar**

A partir desse momento, todos os links de tracking da sua empresa exibem sua marca.

### O que o cliente vê

```
┌─────────────────────────────────────┐
│  [LOGO DA SUA EMPRESA]              │
│  Rastreio - Sua Empresa             │
├─────────────────────────────────────┤
│                                     │
│  Código: BRFMSF5NRT9S0M             │
│  Status: ● Em rota de entrega       │
│                                     │
│  ● Pedido criado        01/09 14:30 │
│  ● Coletado             01/09 16:00 │
│  ● Em trânsito          02/09 08:00 │
│  ○ Em rota de entrega   03/09 07:30 │
│                                     │
├─────────────────────────────────────┤
│  Powered by Sua Empresa             │
└─────────────────────────────────────┘
```

## Nível 2 — Domínio próprio (Enterprise)

### Como funciona

```
Cliente acessa: rastreio.suaempresa.com.br/tracking/CODE
        │
        ▼
CNAME aponta para: saas.bulkroute.com.br
        │
        ▼
Cloudflare for SaaS termina SSL
        │
        ▼
BulkRoute resolve tenant pelo domínio
        │
        ▼
Aplica branding da sua empresa
```

### Configuração

#### Passo 1 — DNS do cliente

Crie um registro CNAME no DNS do seu domínio:

| Type  | Name       | Content                 |
| :---- | :--------- | :---------------------- |
| CNAME | `rastreio` | `saas.bulkroute.com.br` |

#### Passo 2 — Ativar no Cloudflare

Entre em contato com o suporte do BulkRoute para:

* Adicionar seu domínio como **Custom Hostname** no Cloudflare for SaaS
* Gerar o certificado SSL automaticamente

#### Passo 3 — Configurar no painel

1. Acesse **Configurações da Empresa** > **Branding**
2. No campo **Domínio customizado**, insira: `rastreio.suaempresa.com.br`
3. Salve

### Validação

Após configurar, acesse:

```
https://rastreio.suaempresa.com.br/tracking/CODE
```

A página deve carregar com:

* SSL válido (cadeado verde no navegador)
* Logo e cores da sua empresa
* Sem nenhuma referência ao BulkRoute visível ao cliente final

## Página de busca (sem código)

Se o cliente acessar a URL sem o código de tracking:

```
https://rastreio.suaempresa.com.br/tracking
```

Ele vê uma tela de busca onde pode digitar o código e consultar. Essa tela também exibe o branding da sua empresa.

## CSS customizado

Para personalizações avançadas, você pode injetar CSS na página de tracking:

```css theme={null}
/* Exemplo: mudar a fonte */
body {
  font-family: 'Inter', sans-serif;
}

/* Exemplo: esconder o rodapé */
.footer {
  display: none;
}

/* Exemplo: adicionar banner promocional */
.header::after {
  content: 'Frete grátis acima de R$ 299!';
  display: block;
  color: #2563eb;
  font-weight: 600;
  padding: 8px;
}
```

<Warning>
  O CSS é injetado dentro de um `<style>` na página. Evite seletores muito genéricos (`body`, `*`) que podem quebrar o layout. Use os seletores específicos da página de tracking.
</Warning>