Agir en tant qu’omnibus dans le service de crédit en faveur de l’environnement (version préliminaire)
Une organisation peut agir au nom de, ou représenter, une autre organisation en tant qu’omnibus dans le service de crédit en faveur de l’environnement (version préliminaire). Actuellement, cette fonctionnalité est activée pour les places de marché qui agissent au nom de leurs acheteurs en tant qu’acheteurs dans le service de crédit en faveur de l’environnement (version préliminaire). Les marchés doublent en tant qu’acheteurs dans ce scénario.
Les marchés qui ont un rôle de marché acheteur peuvent effectuer des opérations telles que le règlement après achat, le retrait et le partage des crédits au nom de leurs acheteurs finaux. Ils peuvent mettre à jour les détails de l’acheteur final pour le crédit sur le service de crédit en faveur de l’environnement (version préliminaire), qui assure la traçabilité des acheteurs finaux dans la lignée de crédit.
Ces capacités ne sont actuellement disponibles que via des API.
Activer les capacités omnibus pour une organisation
Si vous souhaitez activer les fonctionnalités omnibus, informez-en l’équipe du service de crédit en faveur de l’environnement pendant que vous partagez vos informations d’intégration. Pour plus d’informations sur l’intégration, accédez à Intégration.
En tant qu’organisation de marché dotée de capacités omnibus, vous aurez à la fois les rôles de marché et de marché acheteur. Vous utiliserez le rôle de marché acheteur pour effectuer des fonctionnalités omnibus au nom d’une organisation acheteuse.
Pour plus d’informations sur les rôles de marché pris en charge, accédez à Rôles de marché dans le service de crédit en faveur de l’environnement (version préliminaire).
Les fonctionnalités omnibus de l’instance d’évaluation du service de crédit en faveur de l’environnement (version préliminaire) peuvent être activées par une organisation ayant un rôle d’acheteur seul et à l’aide de l’API suivante :
PATCH/organizations/{organizationId}
Définissez l’indicateur isOmnibusOrganization sur vrai dans la requête d’API.
Remarque
L’indicateur isOmnibusOrganization ne peut être activé que par un utilisateur disposant d’autorisations d’administration au niveau de l’organisation et d’un rôle sur le marché des acheteurs.
Opérations disponibles pour les organisations omnibus
Règlement après achat
Les organisations omnibus peuvent effectuer des règlements après achat ou des transferts de propriété. Une fois qu’un acheteur a acheté un crédit sur un marché qui agit au nom de l’acheteur, le marché peut se transférer la propriété du crédit, car il joue également le rôle d’acheteur sur le service de crédit en faveur de l’environnement (version préliminaire). Le marché transfère la propriété en utilisant le rôle de marché acheteur avec l’API suivante :
POST tokens/{{token_id}}/transfer
Le marché, en utilisant le rôle de marché acheteur, peut mettre à jour les détails de l’acheteur réel qui a acheté le crédit sur le marché avec l’API suivante :
POST tokens/{{token_id}}/endusebuyertransfer
Vous pouvez spécifier les détails facultatifs suivants pour l’acheteur final :
- Id : Spécifiez l’ID de l’acheteur final sur votre plateforme.
- Détails : Spécifiez d’autres détails, tels que le nom ou la description de l’acheteur final.
Fractionner un crédit au nom d’un acheteur utilisateur final
Une place de marché agissant au nom de ses acheteurs finaux en tant qu’acheteur dans le service de crédit en faveur de l’environnement (version préliminaire) peut fractionner le crédit au nom de l’acheteur et peut également spécifier les détails de l’utilisateur final lors du fractionnement du crédit.
Le marché, en utilisant le rôle de marché acheteur, peut fractionner le crédit avec l’API suivante. Pour plus d’informations sur le fractionnement des crédits, accédez à Fractionner un crédit.
POST /tokens/{{token_id}}/split
Dans la même API de fractionnement, vous pouvez également spécifier l’utilisation des détails de l’acheteur pour un crédit lors du fractionnement.
Remarque
Les crédits enfants créés dans cette transaction hériteront automatiquement des détails de l’acheteur final du crédit parent.
En plus de la quantité pour chaque crédit enfant, vous pouvez spécifier les informations facultatives suivantes sur l’acheteur final pour le crédit qui est fractionné :
- Id : Spécifiez l’ID de l’acheteur final sur votre plateforme.
- Détails : Spécifiez d’autres détails, tels que le nom ou la description de l’acheteur final.
Retirer un crédit au nom d’un acheteur utilisateur final
Un marché agissant au nom de ses acheteurs finaux à l’aide d’un rôle d’acheteur peut retirer un crédit au nom de l’acheteur final et peut également spécifier les détails de l’utilisateur final dans la demande de retrait. Dans ce cas, le marché soumettrait une proposition de CreditRetire. Le marché peut spécifier les détails de l’acheteur final d’un crédit en soumettant une proposition de retrait.
Remarque
Les détails de l’acheteur final ne seront mis à jour que si la proposition de retrait est approuvée par le registre.
POST /proposals
Vous pouvez indiquer les détails facultatifs suivants lors de l’envoi de la proposition CreditRetire dans la section endUseBuyer de l’API :
- Détails : Fournissez d’autres détails, tels que le nom ou la description de l’acheteur final.
- ExternalId : spécifiez l’identité de l’acheteur final sur l’organisation de l’acheteur.
Une fois que les détails de l’acheteur final ont été mis à jour pour un crédit, un utilisateur d’une organisation disposant d’un accès en lecture sur le crédit peut afficher les détails de l’acheteur final dans le cadre des détails du crédit et dans le cadre de la lignée de crédit. Pour plus d’informations sur la lignée de crédit, accédez à Afficher la lignée de crédit.
Informations associées
Présentation du service de crédit environnemental (version préliminaire)
Présentation de la référence API du service de crédit environnemental (version préliminaire)
Glossaire du service de crédit environnemental (version préliminaire)
