Guia de Integração BOLD Carbon (CH₄)
Guia de integração para a Aplicação BOLD Carbon (CH₄) v1.0.0 — eventos esperados, campos obrigatórios e requisitos de validação.
Este guia explica como enviar documentos MassID que satisfazem as regras do BOLD Carbon (CH₄). O BOLD Carbon compartilha a maioria das regras com o BOLD Recycling e adiciona uma regra exclusiva do Carbon para cálculo de emissões. A validação de limite geográfico é tratada no nível do framework.
Para o fluxo base da API, veja Enviando um MassID. Para o catálogo completo de regras, veja Regras do BOLD Carbon (CH₄).
Pré-requisitos
- Ter completado o fluxo de Quick Start.
- Familiaridade com os Conceitos Básicos (modelo de documento, ordenação de eventos, idempotência).
- Todos os participantes (Gerador de Resíduos, Transportador, Processador, Reciclador) possuem documentos de homologação válidos.
- A homologação do Reciclador inclui o coeficiente de emissão excedente necessário para o cálculo de emissões.
Regras compartilhadas com o BOLD Recycling
As regras 1–19 do BOLD Carbon são idênticas às do BOLD Recycling. A criação de documentos, sequência de eventos e requisitos de campos para essas regras são os mesmos. Veja o Guia de Integração do BOLD Recycling para o detalhamento completo evento a evento cobrindo:
- Criação de documento (categoria, tipo, subtipo, unidade de medida)
- Eventos ACTOR para todos os participantes (com homologação)
- Eventos Pick-up, Transport Manifest, Weighing, Drop-off, Sorting, Recycled e Recycling Manifest
- Validações de geolocalização, unicidade, período de tratamento biológico e códigos Ibama (veja Códigos de resíduos suportados para valores aceitos)
Tudo naquele guia se aplica aqui. Esta página cobre apenas a adição exclusiva do Carbon.
Mapeamento de eventos e regras
CUSTOM event names
| Event Name | Purpose | Validated by |
|---|---|---|
| PICK_UP | Waste collection from generator site | — |
| TRANSPORT_MANIFEST | Transport documentation attachment | — |
| WEIGHING | Weight capture at a calibrated scale | — |
| DROP_OFF | Delivery to the recycling/processing facility | — |
| SORTING | Waste sorting with contamination deduction | — |
| RECYCLED | Confirms composting or recycling completion | — |
| RECYCLING_MANIFEST | Final recycling documentation attachment | — |
ACTOR label vocabulary
| Label | Description | Validated by |
|---|---|---|
| WASTE_GENERATOR | Source of the waste material | — |
| HAULER | Transports waste from origin to facility | — |
| RECYCLER | Operates the recycling or composting facility | — |
| PROCESSOR | Processes sorted material | — |
Regras exclusivas do Carbon
Regra 20 — Emissões Evitadas
Calcula as emissões evitadas de CO₂ equivalente com base na metodologia UNFCCC AMS-III.F. O cálculo utiliza:
| Entrada | Fonte |
|---|---|
| Coeficiente de emissão excedente | Documento de homologação do Reciclador. |
| Baselines por subtipo de resíduo | Documento de homologação do Reciclador. |
| Tipo de Gás de Efeito Estufa (GHG) | Atributo de metadado do MassID. |
| Subtipo de resíduo | Campo subtype do documento MassID. |
| Valor do MassID | Campo value do documento MassID (peso em kg). |
O que sua integração deve garantir:
- O documento de homologação do reciclador inclui um coeficiente de emissão excedente válido e baselines para cada subtipo de resíduo.
- O subtipo e o valor do documento MassID estão corretamente definidos.
- O atributo de metadado GHG está presente e válido.
A regra retorna as emissões evitadas calculadas em CO₂e.
Limite geográfico
A regra methodology-distance-limit no nível do framework valida a distância entre os locais de
Pick-up e Drop-off. Distâncias superiores a 200 km são sinalizadas para revisão. Esta é uma
verificação do framework, não uma regra da aplicação — não afeta a contagem de regras.
Pós-validação
Quando todas as 20 regras passam:
- Emite um certificado GasID vinculado ao MassID (em vez de um RecycledID).
- Executa as regras de GasID (distribuição de recompensas para participantes da cadeia de suprimentos).
- Gera tokens de crédito C-CARB.CH4 (Tokenized Carbon Credits (TCC)) após a liquidação da ordem de crédito.
Diferenças em relação ao BOLD Recycling
| Aspecto | BOLD Recycling | BOLD Carbon (CH₄) |
|---|---|---|
| Quantidade de regras | 19 regras de MassID | 20 regras de MassID (19 compartilhadas + 1 exclusiva) |
| Tipo de certificado | RecycledID | GasID |
| Token de crédito | C-BIOW (TRC) | C-CARB.CH4 (TCC) |
| Cálculo de emissões | Não aplicável | CO₂e evitado via UNFCCC AMS-III.F (regra 20) |
| Limite geográfico | Distância Pick-up → Drop-off sinalizada no nível do framework | Mesma verificação no nível do framework (limite de 200 km) |
| Dados de homologação | Campos padrão de homologação | Deve incluir coeficiente de emissão excedente para reciclador |
Problemas comuns
Todos os problemas comuns do BOLD Recycling se aplicam, além de:
- Coeficiente de emissão ausente — A homologação do reciclador deve incluir o coeficiente de emissão excedente. Sem ele, a regra 20 não consegue calcular as emissões evitadas.
- Sinalização de distância — Os endereços de Pick-up e Drop-off devem ser geograficamente razoáveis. Distâncias superiores a 200 km são sinalizadas para revisão. Garanta que as coordenadas GPS estejam precisas em ambos os eventos.
- Baselines ausentes — A homologação do reciclador deve incluir baselines para cada subtipo de resíduo utilizado no cálculo de emissões.
Ver catálogo de regras · Ver referência da aplicação · Guia de integração do BOLD Recycling