Abrechnungsberichte für den Großhandelsvertrieb
Abrechnungsberichte
Partner können die folgenden Wholesale Billing APIs verwenden, um die Abrechnungsberichte zu generieren, die ihnen helfen, die Genauigkeit der Nutzung und Bereitstellung zu überprüfen. Die Wholesale Billing APIs sind über developer.webex.com zugänglich.
-
Abgleich – Zeigt den Verbrauch pro Partner, pro Kunde oder pro Benutzer an. Partner können die Informationen aus diesem benutzerdefinierten Abrechnungsbericht nutzen, um ihre monatliche Rechnung abzugleichen und ihren Kunden und Nutzern entsprechend ihrem Verbrauch die Kosten in Rechnung zu stellen.
-
Zeitpunktbezogene Anzeige – Zeigt die aktuellen Paketzuweisungen pro Kunde oder pro Benutzer an. Der Point-In-Time-Bericht liefert eine Echtzeit-Zählung der Paketzuweisungen. Partner können diese Informationen nutzen, um die Genauigkeit der Bereitstellung zu überprüfen und die Übereinstimmung mit den Kundenbestellungen sicherzustellen.
Partner können außerdem mithilfe des Parameters subPartnerOrgId benutzerdefinierte Abrechnungsberichte für Unterpartner erstellen.
Es gibt vier APIs, die Partneradministratoren zur Verfügung stehen, sofern sie die Mindestzugriffsvoraussetzungen erfüllen.
|
Abrechnungs-API |
Zweck der API |
Partner-Administratorzugriffsanforderungen |
|---|---|---|
|
Erstellen Sie einen Großhandelsabrechnungsbericht |
Wird zur Erstellung eines Abrechnungsberichts verwendet. |
Read/write |
|
Fordern Sie einen Großhandelsabrechnungsbericht an |
Dient dazu, einen generierten Abrechnungsbericht zum Download zu erhalten. |
Gelesen |
|
Liste der Großhandelsabrechnungsberichte |
Dient zur Auflistung der für diesen Partner vorhandenen Abrechnungsberichte. |
Gelesen |
|
Großhandelsabrechnungsbericht löschen |
Dient zum Löschen eines bestehenden Abrechnungsberichts. |
Read/write |
Datenquelle
Die Daten für die Abrechnungsberichte werden aus den Paketzuordnungen und Nutzungsdaten entnommen, die Webex für jeden Partner erfasst. Webex aggregiert täglich die Kunden- und Benutzerpaketdaten, um die monatliche Rechnung des Partners zu erstellen. Diese Daten werden über Billing-APIs genutzt, sodass Partneradministratoren benutzerdefinierte Berichte erstellen können. Diese Berichte helfen Partnern, den tatsächlichen Verbrauch anhand ihrer monatlichen Rechnung auf Partner-, Kunden- und Benutzerebene abzugleichen.
Weitere Informationen zur Rechnungsstellung von Webex an Partner finden Sie unter Abrechnung von Dienstanbietern.
Erstellen Sie einen Großhandelsabrechnungsbericht
| 1 |
Von developer.webex.com, gehen Sie zu Erstellen einer Wholesale Billing Report API. |
| 2 |
Wählen Sie eine der folgenden Berichtskategorien aus:
Wenn Sie einen Abstimmungsbericht erstellen möchten, müssen Sie nichts ändern, da die Abstimmung standardmäßig ausgewählt ist. Sie können also mit dem nächsten Schritt fortfahren. Wenn Sie einen Point-In-Time-Bericht erstellen möchten, ändern Sie die Auswahl auf Point-In-Time. |
| 3 |
Geben Sie billingStartDate und billingEndDate im von der API vorgegebenen Format ein. Sie können ein beliebiges Datum der letzten fünf Jahre eingeben, jedoch nicht den heutigen Tag. Für den Point-In-Time-Bericht sind die Felder billingStartDate und billingEndDate nicht erforderlich und werden ignoriert, falls sie ausgefüllt werden. Der Bericht spiegelt stets die aktuelle Paketzuteilung wider. |
| 4 |
Geben Sie den Berichtstyp ein:
|
| 5 |
Klicken Sie auf Ausführen, um den Bericht zu generieren. |
| 6 |
Kopieren Sie die Berichts - ID aus der API-Ausgabe. Sie können diesen Wert mit der Get-API verwenden, um den generierten Abrechnungsbericht zu erhalten. |
Nächste Schritte
Gehen Sie zum Abschnitt Großhandelsabrechnungsbericht anfordern, um eine Kopie des Berichts herunterzuladen.
Fordern Sie einen Großhandelsabrechnungsbericht an.
Sobald ein Abrechnungsbericht generiert wurde, können Sie über diese API einen spezifischen Abrechnungsbericht abrufen. Der Bericht wird unter einer URL ausgegeben, unter der er nach Abschluss der GET-Anfrage 30 Minuten lang zum Download bereitsteht.
| 1 |
Von developer.webex.com, gehen Sie zu Get a Wholesale Billing Report API. |
| 2 |
Geben Sie den eindeutigen Wert für die Berichts- ID ein und klicken Sie aufAusführen . Die API gibt einen Berichtsstatus aus. Die Ausgabe enthält den Parameter tempDownloadURL, der eine URL angibt, von der aus Sie den Bericht herunterladen können. |
| 3 |
Kopieren Sie die tempDownloadURL in einen Browser, um auf den Bericht zuzugreifen und ihn herunterzuladen. |
Großhandelsabrechnungsberichte auflisten
Verwenden Sie diese API, um eine Liste der generierten Abrechnungsberichte für die Partnerorganisation zu erhalten. Sie können alle vorhandenen Berichte auflisten oder die Liste auf diejenigen Berichte beschränken, die die angegebenen Parameter wie Abrechnungszeitraum und Abrechnungstyp (Partner, Kunde, Benutzer) erfüllen.
Wenn Sie optionale Parameter eingeben, gibt die API nur die Berichte zurück, die genau den von Ihnen angegebenen Parametern entsprechen. Wenn Sie beispielsweise einen Abrechnungszeitraum angeben, werden nur Berichte zurückgegeben, die diesen spezifischen Abrechnungszeitraum verwenden. Berichte, die zwar in den Zeitraum fallen, aber nicht exakt mit den Datumsangaben übereinstimmen, werden nicht zurückgegeben.
| 1 |
Von developer.webex.com, gehen Sie zu List Wholesale Billing Report API. |
| 2 |
Unter Abfrageparameterkönnen Sie beliebige Suchparameter eingeben, die Sie verwenden möchten (z. B. startDate, endDate, Type, sortBy on). |
| 3 |
Auf Ausführen. Die API gibt die Liste der Berichte zusammen mit der eindeutigen Berichts - ID und dem Status (ABGESCHLOSSEN, IN_BEARBEITUNG ) aus.
|
Nächste Schritte
Notieren Sie sich die id für alle Berichte, die Sie herunterladen möchten. Gehen Sie zu Großhandelsabrechnungsbericht abrufen, um den Bericht herunterzuladen.
Großhandelsabrechnungsbericht löschen
Mit diesem Verfahren können Sie einen generierten Abrechnungsbericht anhand der Berichts-ID löschen. Einige Beispiele, bei denen Sie einen Bericht möglicherweise löschen möchten:
-
Wenn Sie einen bestehenden Abrechnungsabstimmungsbericht neu generieren möchten, müssen Sie den bestehenden Bericht zuerst löschen. Nachdem Sie den bestehenden Bericht gelöscht haben, können Sie einen neuen Bericht für diesen Zeitraum erstellen. Ein Bericht kann nicht gelöscht werden, wenn seine Erstellung fehlgeschlagen ist oder noch läuft.
Für einen Stichtagsbericht ist es nicht nötig, einen bestehenden Bericht zu löschen, da das System diese Berichte nicht neu generiert. Jeder Bericht spiegelt stets die Daten zum aktuellen Zeitpunkt wider.
-
Falls Sie die URL eines generierten Berichts an die falsche Person gesendet haben, können Sie den Bericht löschen, sodass diese Person nicht mehr darauf zugreifen kann.
| 1 |
Von developer.webex.com, gehen Sie zu Delete Wholesale Billing Report API. |
| 2 |
Geben Sie die Berichts - ID ein und klicken Sie auf Ausführen. |
Felder im Abrechnungsbericht
Abrechnungsberichte enthalten die folgenden Felder:
|
Feld |
Beschreibung |
Unterstützter Berichtstyp |
Unterstützte Berichtskategorie |
|---|---|---|---|
|
PARTNER_NAME |
Name des Partners |
PARTNER, KUNDE, NUTZER |
Versöhnung, Stichtagsbetrachtung |
|
PARTNER_ORG_ID |
Eindeutige Partnerkennung |
PARTNER, KUNDE, NUTZER |
Versöhnung, Stichtagsbetrachtung |
|
ABONNEMENT-ID_ |
Eindeutige Abonnement-Kennung |
PARTNER, KUNDE, NUTZER |
Versöhnung, Stichtagsbetrachtung |
|
DIENSTNAME_ |
Name der Dienstleistung (z. B. COMMON_AREA_CALLING, WEBEX_CALLING, WEBEX_SUITE, WEBEX_MEETINGS) |
PARTNER, KUNDE, NUTZER |
Versöhnung, Stichtagsbetrachtung |
|
SKU |
Artikelnummer für den Service |
PARTNER, KUNDE, NUTZER |
Versöhnung, Stichtagsbetrachtung |
|
BESCHREIBUNG |
Beschreibung der Dienstleistung |
PARTNER, KUNDE, NUTZER |
Versöhnung, Stichtagsbetrachtung |
|
VERBRAUCH_START_DATUM |
Beginn der Dienstleistungsnutzung. Zusammen mit dem folgenden Feld definiert dieser Wert den Nutzungszeitraum. |
PARTNER, KUNDE, NUTZER |
Abgleich |
|
VERBRAUCH_ENDE_DATUM |
Ende der Inanspruchnahme der Dienstleistung. Zusammen mit dem vorhergehenden Feld definiert dieser Wert den Nutzungszeitraum. |
PARTNER, KUNDE, NUTZER |
Abgleich |
|
MENGE |
Stellt den aggregierten Nutzerverbrauch pro Partner, pro Kunde oder pro Nutzer dar (abhängig vom Bericht und der Ebene, auf der Sie die Daten betrachten). Berechnung: Das System berechnet die pro Tag benötigte Menge für jeden Benutzer anteilig für diesen Tag. Nutzung für einen ganzen Tag = 1 Nutzung für einen halben Tag = 0,5 Anschließend werden die Tageswerte für alle Tage innerhalb des Abrechnungszeitraums addiert, um die Gesamtmenge für diesen Benutzer innerhalb dieses Abrechnungszeitraums zu berechnen. Für Berichte auf Kunden- und Partnerebene werden die Summen aller Benutzer aggregiert, um eine Gesamtmenge für den jeweiligen Kunden oder Partner zu erhalten. Zeitpunkt: Der Kundenbericht listet die Paketzuteilungen pro Kunde auf. Jede Zeile stellt die Gesamtmenge eines bestimmten Pakets dar, das Benutzern oder Arbeitsbereichen innerhalb einer bestimmten Kundenorganisation zugewiesen ist. Die Menge wird mit „0“ angezeigt, wenn keine Pakete zugeteilt sind. Der Benutzerbericht listet die den Benutzern oder Arbeitsbereichen zugewiesenen Pakete auf. In jeder Zeile wird die Anzahl 1 angezeigt, die einen Benutzer oder Arbeitsbereich und dessen jeweiliges Paket oder Add-on repräsentiert. Wenn einem Benutzer oder Arbeitsbereich mehrere Pakete oder Add-ons zugewiesen sind, zeigt der Bericht mehrere Einträge an, jeweils mit der entsprechenden Menge. 1. |
PARTNER, KUNDE, NUTZER |
Versöhnung, Stichtagsbetrachtung |
|
KUNDE_ORGANISATION_ID |
Interne eindeutige Kundenkennung |
KUNDE, BENUTZER |
Versöhnung, Stichtagsbetrachtung |
|
KUNDEN_EXTERN_ID |
Eindeutige Kundenkennung, bereitgestellt von einem Partner |
KUNDE, BENUTZER |
Versöhnung, Stichtagsbetrachtung |
|
ABONNENTEN-ID_ |
Eindeutige Kennung für den Abonnenten |
USER (BENUTZER) |
Versöhnung, Stichtagsbetrachtung |
|
Nutzer-ID_ |
Die Webex-Benutzer-ID des Abonnenten |
USER (BENUTZER) |
Versöhnung, Stichtagsbetrachtung |
|
ARBEITSBEREICH_ID |
Eindeutige Arbeitsbereichskennung |
USER (BENUTZER) |
Versöhnung, Stichtagsbetrachtung |
|
STANDORT_ID |
Eindeutige Standortkennung |
KUNDE, BENUTZER |
Versöhnung, Stichtagsbetrachtung |
|
LIZENZ_ID |
Lizenzkennung Dieses Feld ist nur für Großhandelspakete sichtbar. Im Abgleichsbericht ist das Feld License_ID für Lizenzen, die vor der Einführung dieses Feldes vergeben wurden, leer. Der Abrechnungsbericht zeigt mehrere Zeilen für dasselbe Wholesale-Paket an, wenn es mit verschiedenen Kombinationen von LOCATION_ID und LICENSE_ID verknüpft ist. |
KUNDE, BENUTZER |
Versöhnung, Stichtagsbetrachtung |
|
BERICHT_DATUM |
Datum und Uhrzeit der Berichtserstellung. |
KUNDE, BENUTZER |
Zeitpunkt |
Die Bereitstellung eines Pakets für einen Benutzer löst die Abrechnung von Webex Wholesale aus, während die Entfernung der Paketzuweisung diese stoppt.