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

# Pegada de Carbono & Certificado ESG

> Meça as emissões de CO₂ das suas entregas, compare transportadoras e baixe um certificado de sustentabilidade em PDF.

O módulo de Pegada de Carbono do BulkRoute calcula automaticamente as emissões de CO₂ de todos os seus envios, permitindo reportar ESG, comparar transportadoras e gerar um certificado em PDF.

<Note>
  Acesso: **Campo** > **Pegada de Carbono** (`/admin/carbon`). Requer perfil Manager.
</Note>

## Como o BulkRoute calcula

Cada shipment tem origem, destino, peso e carrier. O sistema calcula a distância roteada e multiplica pelo **fator de emissão** do modo de transporte:

| Modo        | Fator (gCO₂/ton-km) |
| :---------- | :------------------ |
| Rodoviário  | padrão              |
| Aéreo       | maior               |
| Ferroviário | menor               |

## Filtro de período

Selecione o período no topo da página:

| Período  | Descrição        |
| :------- | :--------------- |
| **30d**  | Últimos 30 dias  |
| **90d**  | Últimos 90 dias  |
| **365d** | Últimos 365 dias |

Todos os dados e KPIs são recalculados conforme o período selecionado.

## KPIs no topo

| KPI                    | O que significa                                |
| :--------------------- | :--------------------------------------------- |
| **Emissão Total**      | kgCO₂ emitido por todas as entregas no período |
| **Emissão Média**      | kgCO₂ por shipment — eficiência operacional    |
| **Carrier Mais Limpo** | Transportadora com menor emissão no período    |
| **Total Compensado**   | kgCO₂ compensado via `offsetEmission`          |

## Abas do dashboard

### Resumo

Visão geral com KPIs detalhados (emissões líquidas, compensado, total de shipments) e tabela dos últimos shipments com emissão individual.

### Por Carrier

Tabela de emissão por transportadora, destacando a "mais limpa" do período. Use para decidir quais carriers priorizar em rotas onde a sustentabilidade importa.

### Tendência

Emissões mensais com contagem de shipments — identifique se sua operação está ficando mais ou menos eficiente ao longo do tempo.

### Comparativo

Carriers vs. média do tenant, com variação percentual e status (Abaixo / Na / Acima da média). Identifique outliers rapidamente.

### Certificado

Resumo visual do período com 6 cards (Emissão Total, Compensado, Líquida, Shipments, Média, Carrier Mais Limpo) e botão **Baixar Certificado PDF**.

## Baixar o certificado em PDF

1. Selecione o período desejado
2. Vá na aba **Certificado**
3. Clique em **Baixar Certificado PDF**
4. O PDF é gerado em tempo real com:
   * Header BulkRoute
   * Nome da sua empresa
   * Período do relatório
   * Grid de KPIs
   * Data de geração

<Tip>
  O certificado pode ser anexado em relatórios anuais, propostas comerciais ou auditorias ESG (ISO 14001, SBTi).
</Tip>

## Compensação voluntária de emissões

Para registrar a compensação de CO₂ de um shipment específico:

```bash theme={null}
curl -X POST "https://api.bulkroute.com.br/api/carbon/emissions/shipment/{shipmentId}/offset" \
  -H "X-API-Key: bk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "offsetAmount": 12.5 }'
```

O valor compensado aparece no KPI "Total Compensado" e reduz as "Emissões Líquidas".