Atuar como um omnibus no Serviço de Crédito Ambiental (versão preliminar)
Uma organização pode atuar em nome de outra organização, ou representá-la, como um omnibus no Serviço de Crédito Ambiental (versão preliminar). No momento, esse recurso está habilitado para marketplaces que atuam em nome de seus compradores como compradores no Serviço de Crédito Ambiental (versão preliminar). Os marketplaces dobram como compradores neste cenário.
Marketplaces que têm um papel de mercado comprador podem realizar operações como liquidação pós-compra, aposentadoria e divisão de crédito em nome de seus compradores finais. Eles podem atualizar os detalhes do comprador de uso final para o crédito no Serviço de Crédito Ambiental (versão preliminar), que fornece rastreabilidade para os compradores finais na linhagem de crédito.
Atualmente, esses recursos estão disponíveis apenas por meio de APIs.
Habilitar recursos omnibus para uma organização
Se você deseja habilitar recursos omnibus, informe a equipe do Serviço de Crédito Ambiental enquanto compartilha seus detalhes de integração. Para obter mais informações sobre integração, acesse Integração.
Como uma organização de mercado com recursos omnibus, você terá as funções de mercado e mercado de compradores. Você usará a função de mercado comprador para executar recursos omnibus em nome de uma organização compradora.
Para obter mais informações sobre funções de mercado, acesse Funções de mercado no Serviço de Crédito Ambiental (versão preliminar).
Os recursos omnibus na instância de teste do Serviço de Crédito Ambiental (versão preliminar) podem ser habilitados por uma organização com uma função de comprador por conta própria e usando a seguinte API:
PATCH/organizations/{organizationId}
Defina o sinalizador isOmnibusOrganization como true na solicitação de API.
Nota
O sinalizador isOmnibusOrganization só pode ser ativado por um usuário que tenha permissões de administrador no nível da organização e uma função de mercado comprador.
Operações disponíveis para organizações omnibus
Liquidação pós-compra
As organizações omnibus podem realizar liquidações pós-compra ou transferências de propriedade. Depois que um comprador compra um crédito em um marketplace que está agindo em nome do comprador, o marketplace pode transferir a propriedade do crédito para si mesmo, porque eles estão dobrando como compradores no Serviço de Crédito Ambiental (versão preliminar). O marketplace transfere a propriedade usando a função de mercado do comprador com a seguinte API:
POST tokens/{{token_id}}/transfer
O mercado, usando a função de mercado comprador, pode atualizar os detalhes do comprador real que comprou o crédito no mercado com a seguinte API:
POST tokens/{{token_id}}/endusebuyertransfer
Você pode especificar os seguintes detalhes opcionais para o comprador final:
- Id: especifique o ID do comprador final na sua plataforma.
- Detalhes: Especifique outros detalhes, como o nome ou a descrição do comprador final.
Dividir um crédito em nome de um comprador de uso final
Um marketplace agindo em nome de seus compradores finais como um comprador no Serviço de Crédito Ambiental (versão preliminar) pode dividir o crédito em nome do comprador e também pode especificar os detalhes do comprador de uso final ao dividir o crédito.
O marketplace usando a função de mercado do comprador pode dividir o crédito com a seguinte API. Para obter informações sobre como dividir os créditos, acesse Dividir um crédito.
POST /tokens/{{token_id}}/split
Na mesma API de divisão, você também pode especificar o uso de detalhes do comprador para um crédito durante a divisão.
Nota
Os créditos filhos criados nesta transação herdarão automaticamente os detalhes do comprador de uso final do crédito pai.
Juntamente com a quantidade de cada crédito filho, você pode especificar os seguintes detalhes opcionais do comprador de uso final para o crédito que está sendo dividido:
- Id: especifique o ID do comprador final na sua plataforma.
- Detalhes: Especifique outros detalhes, como o nome ou a descrição do comprador final.
Desativar um crédito em nome de um comprador de uso final
Um mercado agindo em nome de seus compradores finais que usam uma função de comprador podem baixar um crédito em nome do comprador de uso final e também pode especificar os detalhes do comprador na solicitação de baixa. Nesse caso, o marketplace enviaria uma proposta de CreditRetire. O marketplace pode especificar os detalhes do comprador de uso final para um crédito que enviará uma proposta de aposentadoria.
Nota
Os detalhes do comprador de uso final só serão atualizados se a proposta de baixa for aprovada pelo registro.
POST /proposals
Você pode especificar os seguintes detalhes opcionais ao enviar a proposta CreditRetire na seção endUseBuyer da API:
- Detalhes: Forneça outros detalhes, como o nome ou a descrição do comprador final.
- ExternalId: especifique a identidade do comprador final na organização do comprador.
Depois que os detalhes do comprador de uso final foram atualizados para um crédito, um usuário de uma organização com acesso de leitura no crédito pode visualizar os detalhes do comprador de uso final como parte dos detalhes de crédito e como parte da linhagem de crédito. Para obter mais informações sobre linhagem de crédito, acesse Exibir linhagem de crédito.
Informações relacionadas
Visão geral do Environmental Credit Service (versão preliminar)
Visão geral da referência da API do Environmental Credit Service (versão preliminar)
Glossário do Environmental Credit Service (versão preliminar)
