Rechnungsabgleich

Partneradministratoren können die Wholesale Billing-APIs verwenden, um benutzerdefinierte Abrechnungsberichte zu erstellen, die den Verbrauch auf Partner-, Kunden- oder Benutzerebene anzeigen. Partner können diese Informationen zum Abgleich ihrer monatlichen Rechnung verwenden, sodass sie ihren Kunden und Benutzern die jeweilige Nutzungsintensität in Rechnung stellen können.

Partner können mithilfe des Parameters „subPartnerOrgId“ auch benutzerdefinierte Abrechnungsberichte für Unterpartner erstellen.

Partneradministratoren, die die Mindestzugriffsanforderungen erfüllen, stehen vier APIs zur Verfügung.

Abrechnungs-API

Zweck der API

Partner-Administratorzugriffsvoraussetzung

Erstellen Sie einen Großhandelsabrechnungsbericht

Wird zum Erstellen eines Abrechnungsberichts verwendet.

Lesen / Schreiben

Holen Sie sich einen Großhandelsabrechnungsbericht

Wird verwendet, um einen generierten Abrechnungsbericht zum Download zu erhalten.

Lesen

Großhandelsabrechnungsberichte auflisten

Wird verwendet, um die für diesen Partner vorhandenen Abrechnungsberichte aufzulisten.

Lesen

Löschen eines Großhandelsabrechnungsberichts

Wird verwendet, um einen vorhandenen Abrechnungsbericht zu löschen.

Lesen / Schreiben

Datenquelle

Die Daten für die Abrechnungsberichte werden aus den Nutzungsdaten abgerufen, die Webex für jeden Partner verfolgt. Webex verfolgt täglich den Nutzungsverbrauch des Vortages für alle Partner, Kunden und Benutzer und aggregiert die Daten, sodass sie zur Erstellung der monatlichen Rechnung des Partners verwendet werden können. Abrechnungs-APIs nutzen diese Daten und ermöglichen es Partneradministratoren, benutzerdefinierte Berichte zu erstellen, sodass der Partner den Nutzungsverbrauch anhand seiner monatlichen Rechnung auf Partner-, Kunden- und Benutzerebene abgleichen kann.

Ausführlichere Informationen zur Rechnungsstellung durch Webex an Partner finden Sie unter Abrechnung mit Dienstanbietern.

Erstellen Sie einen Großhandelsabrechnungsbericht

Verwenden Sie dieses Verfahren, um einen benutzerdefinierten Abrechnungsbericht zu erstellen, den Sie zum Abgleichen Ihrer Abrechnung verwenden können.
1

Gehen Sie zur API „Erstellen eines Großhandelsabrechnungsberichts“.

2

Geben Sie den Abrechnungszeitraum ein, indem Sie Werte für billingStartDate und billingEndDate in dem von der API angegebenen Format eingeben. Sie können jedes Datum der letzten fünf Jahre eingeben, jedoch nicht den aktuellen Tag.

3

Geben Sie den Typ des Berichts ein:

  • PARTNER (dies ist die Standardeinstellung) – Zeigt den Nutzungsverbrauch auf Partnerebene an.
  • KUNDE – Zeigt den Gesamtverbrauch aufgeschlüsselt nach der Ebene der Kundenorganisationen unter dem Partner an.
  • BENUTZER – Zeigt den gesamten Nutzungsverbrauch aufgeschlüsselt nach Kundenorganisationen und Abonnenten unter dem Partner an.
4

Klicken Sie auf Ausführen, um den Bericht zu erstellen.

5

Kopieren Sie die Berichts - ID aus der API-Ausgabe. Sie können diesen Wert mit der Get-API verwenden, um den generierten Abrechnungsbericht abzurufen.

Nächste Schritte

Gehen Sie zu Holen Sie sich einen Großhandelsabrechnungsbericht, um eine Kopie des Berichts herunterzuladen.

Holen Sie sich einen Großhandelsabrechnungsbericht

Sobald ein Abrechnungsbericht erstellt wurde, verwenden Sie diese API, um einen bestimmten Abrechnungsbericht zu erhalten. Der Bericht wird an eine URL ausgegeben, wo er nach Abschluss der GET-Anforderung 30 Minuten lang zum Download bereitsteht.
1

Gehen Sie zur API „Get a Wholesale Billing Report“.

2

Klicken Sie in der Zeile GET auf die Schaltfläche id und geben Sie den eindeutigen ID-Wert für den Bericht ein.

3

Auf Ausführen.

4

Die API gibt den Berichtsstatus aus. Die Ausgabe enthält den Parameter tempDownloadURL, der eine URL bereitstellt, von der Sie den Bericht herunterladen können.

5

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 den angegebenen Parametern wie Ihrem Abrechnungszeitraum und Abrechnungstyp (Partner, Kunde, Benutzer) entsprechen.

Wenn Sie optionale Parameter eingeben, gibt die API nur die Berichte zurück, die genau den von Ihnen eingegebenen Parametern entsprechen. Wenn Sie beispielsweise einen Abrechnungszeitraum eingeben, werden nur Berichte zurückgegeben, die diesen bestimmten Abrechnungszeitraum verwenden. Berichte, die in den Zeitraum fallen, aber nicht genau mit den Daten übereinstimmen, werden nicht zurückgegeben.
1

Gehen Sie zur API für den Listen-Großhandelsabrechnungsbericht

2

Geben Sie unter Abfrageparameteralle Suchparameter ein, die Sie verwenden möchten (z. B. Startdatum, Enddatum, Typ, Sortierung nach). Weitere Einzelheiten zu diesen Parametern finden Sie in der Entwicklerhilfe zur API.

3

Auf Ausführen.

Die API gibt die Liste der Berichte zusammen mit der eindeutigen Berichts- ID und dem Status (ABGESCHLOSSEN, IN_ARBEIT ) aus.

Nächste Schritte

Notieren Sie sich die -ID für alle Berichte, die Sie herunterladen möchten. Gehen Sie zu Holen Sie sich einen Großhandelsabrechnungsbericht, um den Bericht herunterzuladen.

Löschen eines Großhandelsabrechnungsberichts

Verwenden Sie dieses Verfahren, um einen generierten Abrechnungsbericht basierend auf der Berichts-ID zu löschen. Hier sind einige Beispiele, warum Sie einen Bericht möglicherweise löschen möchten:

  • Wenn Sie einen vorhandenen Abrechnungsbericht neu erstellen möchten, müssen Sie zunächst den vorhandenen Bericht löschen. Nachdem Sie den vorhandenen Bericht gelöscht haben, können Sie für diesen Zeitraum einen neuen Bericht erstellen. Beachten Sie, dass die Löschanforderung nicht besteht, wenn der Bericht fehlgeschlagen ist oder in Bearbeitung ist.

  • Wenn ein Bericht erstellt wird und Sie die URL an die falsche Person senden, können Sie den Bericht löschen und die Person kann nicht mehr darauf zugreifen.

1

Gehen Sie zur API „Großhandelsabrechnungsbericht löschen“.

2

Geben Sie die Berichts-ID ein.

3

Auf Ausführen.

Felder im Abrechnungsbericht

Abrechnungsberichte enthalten die folgenden Felder:

Feld

Zusätzliche Informationen

Erscheint in Berichten des Typs

PARTNER_NAME

Name des Partners

PARTNER, KUNDE, NUTZER

PARTNER_ORG_ID

Eindeutige Partnerkennung

PARTNER, KUNDE, NUTZER

Abonnement_ID

Eindeutige Abonnementkennung

PARTNER, KUNDE, NUTZER

DIENST_NAME

Name des Dienstes

(z. B. COMMON_AREA_CALLING, WEBEX_CALLING, WEBEX_SUITE, WEBEX_MEETINGS)

PARTNER, KUNDE, NUTZER

SKU

SKU für den Dienst

PARTNER, KUNDE, NUTZER

BESCHREIBUNG

Beschreibung des Dienstes

PARTNER, KUNDE, NUTZER

VERBRAUCH_START_DATUM

Beginn der Leistungsinanspruchnahme. Zusammen mit dem folgenden Feld definiert dieser Wert den Nutzungszeitraum.

PARTNER, KUNDE, NUTZER

VERBRAUCH_ENDE_DATUM

Ende der Leistungsinanspruchnahme. Zusammen mit dem vorhergehenden Feld definiert dieser Wert den Nutzungszeitraum.

PARTNER, KUNDE, NUTZER

MENGE

Stellt den aggregierten Benutzerverbrauch pro Partner, pro Kunde oder pro Benutzer dar (je nach Bericht und Ebene, auf der Sie die Daten anzeigen).

Berechnung:

Sie berechnen die Tagesmenge für jeden Benutzer anteilig für diesen Tag.

Nutzung für einen ganzen Tag = 1

Nutzung für einen halben Tag = 0,5

Sie addieren die Tagesgesamtbeträge für alle Tage innerhalb des Abrechnungszeitraums, um die Gesamtmenge für diesen Benutzer innerhalb dieses Abrechnungszeitraums zu berechnen.

Bei Berichten auf Kunden- und Partnerebene werden die Summen aller Benutzer aggregiert, um eine Gesamtmenge für diesen Kunden oder Partner bereitzustellen.

PARTNER, KUNDE, NUTZER

KUNDE_ORG_ID

Interne eindeutige Kundenkennung

KUNDE, BENUTZER

KUNDE_EXTERN_ID

Eindeutige Kundenkennung, wie von einem Partner bereitgestellt

KUNDE, BENUTZER

SUBSCRIBER_ID

Eindeutige Kennung für den Abonnenten

USER (BENUTZER)

Nutzer-ID_

Die Webex-Benutzer-ID des Abonnenten

USER (BENUTZER)

ARBEITSBEREICH_ID

Eindeutige Arbeitsbereichskennung

USER (BENUTZER)

STANDORT_ID

Eindeutige Standortkennung

KUNDE, BENUTZER

LIZENZ_ID

Lizenzkennung

Dieses Feld ist nur für Großhandelspakete sichtbar. Für Lizenzen, die vor der Einführung dieses Feldes vergeben wurden, ist die ID License_leer.

Ein Abrechnungsbericht kann mehrere Zeilen für dasselbe Großhandelspaket enthalten, wobei jede Zeile eine eindeutige package/license ID-Kombination.

Wenn das Feld LICENSE_ID vorhanden ist, stellt jede Zeile eine eindeutige package/location/license ID-Kombination.

KUNDE, BENUTZER

Durch die Bereitstellung eines Pakets für einen Benutzer wird die Webex-Großhandelsabrechnung ausgelöst, während sie durch das Entfernen der Paketzuweisung gestoppt wird.