環境クレジットサービス (プレビュー) でオムニバスとして行動する

[アーティクル]
11/12/2024

環境クレジットサービス (プレビュー) でオムニバスとして他の組織に代わり、または代表して行動することができます。現在この機能は、環境クレジットサービス (プレビュー) のバイヤーとしてバイヤーに代わり行動するマーケットプレイスで有効になっています。このシナリオでは、マーケットプレイスがバイヤーの役割も果たします。

バイヤーのマーケットロールを持つマーケットプレイスは、最終購入者に代わり、購入後の決済、廃止、クレジット分割などの操作を実行することができます。また、環境クレジットサービス (プレビュー) でクレジットの最終使用購入者の詳細を更新することができます。これにより、クレジット系列の最終購入者は追跡調査できるようになります。

これらの機能は現在、API 経由でのみ利用できます。

組織のオムニバス機能を有効にする

オムニバス機能を有効にする場合は、オンボーディングの詳細を共有する際に環境クレジットサービスチームに知らせてください。オンボードの詳細については、オンボードに移動してください。

オムニバス機能を備えたマーケットプレイス組織として、マーケットプレイスとバイヤーの両方のマーケットロールを持つことになります。バイヤーマーケットロールを使用して、バイヤー組織に代わりオムニバス機能を実行します。

マーケットロールの詳細については、環境クレジットサービス (プレビュー) のマーケットロールを参照してください。

環境クレジットサービス (プレビュー) の試用版インスタンスのオムニバス機能は、独自にバイヤーロールを持つ組織が、次の API を使用して有効にすることができます:

PATCH/organizations/{organizationId}

API 要求で isOmnibusOrganization フラグを true に設定します。

注意

isOmnibusOrganization フラグは、組織レベルの管理者権限とバイヤーマーケットロールを持つユーザーのみが有効にできます。

オムニバス組織で利用可能な操作

購入後の決済

オムニバス組織は、購入後の決済または所有権の譲渡を行うことができます。バイヤーが、バイヤーに代わり行動しているマーケットプレースでクレジットを購入した後、マーケットプレースは環境クレジットサービス (プレビュー) のバイヤーの役割も果たしているため、クレジットの所有権を自分自身に譲渡できます。マーケットプレイスは、次の API でバイヤーマーケットロールを使用して所有権を譲渡します。

POST tokens/{{token_id}}/transfer

マーケットプレイスは、バイヤーマーケットロールを使用して、次の API を使用し、マーケットプレイスでクレジットを購入した実際のバイヤーの詳細を更新できます:

POST tokens/{{token_id}}/endusebuyertransfer

最終使用購入者について、次のオプションの詳細を指定できます:

Id: プラットフォーム上の最終購入者のIDを指定します。
詳細: 最終使用購入者の名前や説明など、その他の詳細を指定します。

最終使用購入者に代わりクレジットを分割する

環境クレジットサービス (プレビュー) のバイヤーとして最終購入者に代わり行動するマーケットプレイスは、バイヤーに代わってクレジットを分割でき、クレジットを分割する際に最終使用購入者の詳細を指定することもできます。

マーケットプレイスは、次の API でバイヤーマーケットロールを使用してクレジットを分割できます。クレジット分割の詳細については、クレジットの分割をご覧ください。

POST /tokens/{{token_id}}/split

同じ分割 API で、分割中にクレジットの使用購入者の詳細を指定することもできます。

注意

このトランザクションで作成された子クレジットは、親クレジットの最終使用購入者の詳細を自動的に継承します。

各子クレジットの数量とともに、分割されるクレジットについて次のオプションの最終使用購入者の詳細を指定することができます。

Id: プラットフォーム上の最終購入者のIDを指定します。
詳細: 最終使用購入者の名前や説明など、その他の詳細を指定します。

最終使用購入者に代わりクレジットを廃止する

バイヤーロールを使用して最終購入者に代わり行動するマーケットプレイスは、最終使用購入者に代わってクレジットを廃止でき、廃止リクエストで最終使用購入者の詳細を指定することもできます。この場合、マーケットプレースは CreditRetire 提案を送信します。マーケットプレイスは、クレジットの最終使用購入者の詳細を指定して、廃止プロポーザルを送信できます。

注意

最終用途購入者の詳細は、退職提案がレジストリによって承認された場合にのみ更新されます。