Als Omnibus im Umwelt-Kreditservice handeln (Vorschauversion)

Eine Organisation kann bei Umwelt-Kreditservice (Vorschauversion) im Namen einer anderen Organisation handeln oder diese vertreten. Derzeit ist diese Funktionalität für Marktplätze aktiviert, die im Namen ihrer Kaufenden als Kaufender im Umwelt-Kreditservice (Vorschauversion) auftreten. Marketplaces fungieren in diesem Szenario als Käufer.

Marketplaces, die über eine Käufermarktrolle verfügen, können im Namen ihrer Endkäufer*innen Vorgänge wie Abrechnung nach dem Kauf, Ausbuchung und Aufteilung von Gutschriften durchführen. Sie können die Details der Endabnehmenden für die Gutschrift im Umwelt-Kreditservice (Vorschauversion) aktualisieren, der die Rückverfolgbarkeit für die Abnehmenden in der Kreditlinie gewährleistet.

Diese Funktionalitäten sind derzeit nur über APIs verfügbar.

Omnibus Funktionalitäten für eine Organisation aktivieren

Wenn Sie Funktionalitäten für den Omnibus aktivieren möchten, teilen Sie dies dem Team von Umwelt-Kreditservice mit, während Sie Ihre Onboarding-Details mit ihm teilen. Weitere Informationen zum Onboarding finden Sie unter Onboarding.

Als Marketplace Organisation mit Omnibus Funktionalitäten haben Sie sowohl die Marktplatz- als auch die Käufermarkt-Rolle. Sie verwenden die Rolle Käufermarkt für die Durchführung von Omnibus Funktionalitäten im Namen einer Käuferorganisation.

Weitere Informationen über Marktrollen finden Sie unter Marktrollen in Umwelt-Kreditservice (Vorschauversion).

Die Funktionalitäten in der Test-Instanz von Umwelt-Kreditservice (Vorschauversion) können von einer Organisation mit einer Kaufendenrolle selbständig und unter Verwendung der folgenden API aktiviert werden:

PATCH/organizations/{organizationId}

Legen Sie das Flag istOmnibusOrganisation in der API-Anfrage auf wahr fest.

Notiz

Das Flag istOmnibusOrganisation kann nur von einem Benutzer aktiviert werden, der über die Berechtigung auf Organisationsebene und die Rolle eines Käufermarktes verfügt.

Für Omnibus-Organisationen verfügbare Vorgänge

Abrechnung nach dem Kauf

Omnibus-Organisationen können Abrechnungen nach dem Kauf oder Eigentumsübertragungen durchführen. Nachdem ein Kaufender eine Gutschrift auf einem Marketplace gekauft hat, der im Namen des Kaufenden handelt, kann der Marketplace das Eigentum an der Gutschrift auf sich selbst übertragen, da er sich als Kaufender auf Umwelt-Kreditservice (Vorschauversion) verdoppelt. Der Marketplace überträgt das Eigentum unter Verwendung der Marktrolle Käufer*in mit der folgenden API:

POST tokens/{{token_id}}/transfer

Der Marketplace, der die Rolle des Käufermarktes verwendet, kann die Daten des tatsächlichen Käufers, der die Gutschrift auf dem Marketplace gekauft hat, mit der folgenden API aktualisieren:

POST tokens/{{token_id}}/endusebuyertransfer

Sie können die folgenden optionalen Details für den Endabnehmer angeben:

• Id: Geben Sie die ID des Endkäufers auf Ihrer Plattform an.
• Details: Geben Sie weitere Details an, wie z.B. den Namen oder die Beschreibung des Endverbrauchers.

Teilen Sie eine Gutschrift im Namen eines Endabnehmers auf

Ein Marketplace, der im Namen seiner Endverbrauchenden als Kaufender im Umwelt-Kreditservice (Vorschauversion) handelt, kann die Gutschrift im Namen des Kaufenden aufteilen und bei der Aufteilung der Gutschrift auch die Angaben zum Endverbrauchenden angeben.

Der Marketplace kann unter Verwendung der Käufermarktrolle die Gutschrift mit der folgenden API aufteilen. Weitere Informationen zum Splitten von Gutschriften finden Sie unter Gutschrift splitten.

POST /tokens/{{token_id}}/split

In der gleichen Split-API können Sie auch die Details des Käufers für eine Gutschrift beim Splitten angeben.

Notiz

Die in dieser Transaktion erstellten untergeordneten Gutschriften erben automatisch die Details des Endverbrauchers der übergeordneten Gutschrift.

Zusammen mit der Anzahl der untergeordneten Gutschriften können Sie die folgenden optionalen Angaben zum Endverbraucher für die zu teilende Gutschrift machen:

• Id: Geben Sie die ID des Endkäufers auf Ihrer Plattform an.
• Details: Geben Sie weitere Details an, wie z.B. den Namen oder die Beschreibung des Endverbrauchers.

Eine Gutschrift ausbuchen im Namen eines Endverbrauchers

Ein Marketplace, der im Namen von Endkäufern handelt und eine Käuferrolle verwendet, kann eine Gutschrift im Namen des Endkäufers zurücknehmen und kann auch die Details des Endkäufers im Rücknahmeantrag angeben. In diesem Fall würde der Marketplace ein CreditRetire Angebot senden. Der Marketplace kann die Details des Endverbrauchers für eine Gutschrift angeben, indem er ein Angebot ausbuchen sendet.

Notiz

Die Angaben zum Endverbraucher werden nur aktualisiert, wenn das Angebot auszubuchen von der Registrierungsstelle genehmigt wird.

POST /proposals

Sie können die folgenden optionalen Details angeben, während Sie den CreditRetire Vorschlag im Abschnitt endUseBuyer der API einreichen:

• Details: Geben Sie weitere Details an, z. B. den Namen oder die Beschreibung des Endkäufers.
• ExternalId: Geben Sie die Identität des Endverbraucherkäufers in der Käuferorganisation an.

Nachdem die Details des Endabnehmers für einen Kredit aktualisiert wurden, kann ein Benutzer einer Organisation mit Lesezugriff auf den Kredit die Details des Endabnehmers als Teil der Kreditdetails und als Teil des Kreditverlaufs einsehen. Weitere Informationen über Gutschriften finden Sie unter Gutschriften anzeigen.

Siehe auch

Umwelt-Kreditservice (Vorschauversion) – Überblick
Umwelt-Kreditservice (Vorschauversion) API-Referenzüberblick
Umwelt-Kreditservice (Vorschauversion) – Glossar