IntegrationsReference

Classificação de Resíduos

Sistema de classificação de resíduos — hierarquia de Categoria, Tipo e Subtipo usada nos payloads de documentos.

Last updated on

Todo documento enviado à Carrot API é classificado usando uma hierarquia de três níveis: Categoria, Tipo e Subtipo. Os dois primeiros níveis são obrigatórios; o terceiro é opcional na API, embora uma metodologia possa exigi-lo. Essa estrutura organiza os documentos para agrupamento, rastreabilidade e validação de metodologia.

Hierarquia de classificação

Um subtipo sempre pertence a um tipo, e um tipo sempre pertence a uma categoria. Isso garante que cada documento esteja posicionado corretamente dentro do contexto de classificação da plataforma.

Categoria

O nível mais amplo de classificação. Indica o contexto geral do documento. Para integrações de cadeia de suprimentos, a categoria é tipicamente MassID, que se refere a documentos que rastreiam o histórico de uma massa de resíduos.

Outras categorias (como Methodology) existem para fluxos internos da plataforma e não são usadas em integrações padrão.

Tipo

O tipo identifica a classe primária de material ou processo dentro de uma categoria. Sob a categoria MassID, o tipo é um entre:

  • Glass
  • Metal
  • Organic
  • Paper
  • Plastic

Esse é o vocabulário que a plataforma reconhece adiante — a emissão de certificados e a API pública de MassID analisam type contra exatamente esses cinco valores e descartam registros fora deles. O POST /documents em si aceita type como string livre, então um valor fora dessa lista é aceito no envio e descartado depois.

Subtipo

O subtipo fornece a classificação mais específica, refinando o tipo com informações detalhadas sobre o material. Por exemplo:

  • Para o tipo Plastic: PET — o único subtipo de plástico aceito
  • Para o tipo Organic: Domestic Sludge, EFB similar to Garden, Yard and Park Waste, Food, Food Waste and Beverages, Garden, Yard and Park Waste, Industrial Sludge, Others (if organic), Tobacco, Wood and Wood Products

Os subtipos devem ser enviados em inglês. Os subtipos aceitos dependem da metodologia sob a qual a massa será auditada — consulte o guia de integração específico da metodologia para a lista completa.

Subtipos específicos por metodologia

Cada metodologia define os subtipos aceitos para validação. Uma massa submetida a uma metodologia deve usar um de seus subtipos aceitos para passar nas regras de validação.

Expectativas de validação

  • category e type são obrigatórios em todo documento. subtype é opcional na API, mas uma metodologia pode exigi-lo — um MassID sem subtipo não passa na verificação de uma metodologia que define subtipos aceitos, então nenhum certificado é emitido a partir dele.
  • As combinações de categoria/tipo devem seguir a taxonomia de negócio aprovada.
  • Mantenha os mapeamentos determinísticos entre ambientes (teste e produção).
  • Valide combinações não suportadas antes do envio à API para evitar rejeição.

Sistemas de códigos externos

Algumas metodologias exigem códigos externos de classificação de resíduos junto ao subtipo Carrot. Esses códigos conectam a classificação Carrot a padrões nacionais ou internacionais.

Códigos Ibama (Brasil)

O Ibama (Instituto Brasileiro do Meio Ambiente e dos Recursos Naturais Renováveis) publica a Lista Brasileira de Resíduos Sólidos (conforme IN nº 13/2012). Cada material de resíduo recebe um código de 6 dígitos (por exemplo, 02 01 01). Inclua o código e a descrição do Ibama nos atributos de metadados Local Waste Classification ID e Local Waste Classification Description.

Categorias de resíduos CDM

O CDM (Clean Development Mechanism) Tool 04 v08.1 define categorias de resíduos usadas para atribuição de fatores de emissão. Cada código Ibama mapeia para uma categoria CDM (por exemplo, 8.3 para resíduos alimentares). A metodologia usa esse mapeamento para selecionar os fatores de emissão corretos.

Listas de códigos específicas por metodologia

O BOLD Carbon exige tanto códigos Ibama quanto CDM, validados pela regra regional-waste-classification. Consulte os Códigos de resíduos aceitos — BOLD Carbon Framework para a lista completa de códigos Ibama aceitos e seus mapeamentos CDM.

Referências relacionadas:

On this page