Abgleich der Rechnungsstellung

Partner-Administratoren können die Wholesale-Rechnungs-APIs verwenden, um benutzerdefinierte Rechnungsberichte zu erstellen, in denen der Nutzungsverbrauch auf Partner-, Kunden- oder Benutzerebene angezeigt wird. Partner können diese Informationen verwenden, um ihre monatliche Rechnung abzugleichen, sodass sie ihren Kunden und Benutzern entsprechend ihrem Nutzungsverbrauch Rechnung stellen können.

Partner können mithilfe des subPartnerOrgId-Parameters auch benutzerdefinierte Abrechnungsberichte für Subpartner generieren.

Für Partner-Administratoren, die die Mindestanforderungen für den Zugriff erfüllen, stehen vier APIs zur Verfügung.

Rechnungs-API

Zweck der API

Partneradministrator-Zugriffsanforderung

Wholesale-Rechnungsbericht erstellen

Wird zum Generieren eines Rechnungsberichts verwendet.

Auslesen/Schreiben

Wholesale-Rechnungsbericht abrufen

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

Lesen

Wholesale-Rechnungsberichte auflisten

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

Lesen

Wholesale-Rechnungsbericht löschen

Wird zum Löschen eines vorhandenen Rechnungsberichts verwendet.

Auslesen/Schreiben

Datenquelle

Die Daten für die Rechnungsberichte werden aus den Nutzungsdaten abgerufen, die Webex für die einzelnen Partner nachverfolgt. Jeden Tag verfolgt Webex den Nutzungsverbrauch des Vortages für alle Partner, Kunden und Benutzer und aggregiert die Daten, sodass sie zur Erstellung der monatlichen Partnerrechnung verwendet werden können. Abrechnungs-APIs nutzen diese Daten und ermöglichen es Partner-Administratoren, benutzerdefinierte Berichte zu erstellen, sodass der Partner den Nutzungsverbrauch mit seiner monatlichen Rechnung auf Partner-, Kunden- und Benutzerebene abgleichen kann.

Detaillierte Informationen darüber, wie Webex Partner für die Rechnungsstellung stellt, finden Sie unter Rechnungsstellung für Dienstleister.

Wholesale-Rechnungsbericht erstellen

Mit diesem Verfahren können Sie einen benutzerdefinierten Rechnungsbericht erstellen, mit dem Sie Ihre Rechnungsstellung abgleichen können.
1

Rufen Sie die API zum Erstellen eines Wholesale-Rechnungsberichts auf.

2

Geben Sie den Abrechnungszeitraum ein, indem Sie die Werte für billingStartDate und billingEndDate in dem von der API angegebenen Format eingeben. Sie können ein beliebiges Datum aus den letzten fünf Jahren 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 gesamten Nutzungsverbrauch an, aufgeschlüsselt nach der Ebene der Kundenorganisationen unter dem Partner.
  • BENUTZER – Zeigt den gesamten Nutzungsverbrauch an, aufgeschlüsselt nach der Ebene der Kundenorganisationen und Subunternehmer unter dem Partner.
4

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

5

Kopieren Sie die Bericht-ID aus der API-Ausgabe. Sie können diesen Wert mit der Get API verwenden, um den generierten Rechnungsbericht zu erhalten.

Nächste Schritte

Gehen Sie zu Wholesale-Rechnungsbericht abrufen , um eine Kopie des Berichts herunterzuladen.

Wholesale-Rechnungsbericht abrufen

Nachdem ein Abrechnungsbericht generiert wurde, können Sie mit dieser API einen bestimmten Abrechnungsbericht abrufen. Der Bericht wird an eine URL ausgegeben, wo er nach Abschluss der GET-Anforderung 30 Minuten lang zum Download verfügbar ist.
1

Rufen Sie die Wholesale-Rechnungsbericht-API auf.

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.

Wholesale-Rechnungsberichte auflisten

Verwenden Sie diese API, um eine Liste der generierten Rechnungsberichte für die Partnerorganisation abzurufen. Sie können alle vorhandenen Berichte auflisten oder die Liste auf die Berichte beschränken, die die angegebenen Parameter erfüllen, z. B. Ihren Abrechnungszeitraum und Ihre Abrechnungsart (Partner, Kunde, Benutzer).

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

Gehen Sie zur Liste des Wholesale-Rechnungsberichts API

2

Geben Sie unter Abfrageparameter alle Suchparameter ein, die Sie verwenden möchten (z. B. startDate, endDate, Type, sortBy on). Weitere Informationen zu diesen Parametern finden Sie in der Entwickler-Hilfe auf der API.

3

Auf Ausführen.

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

Nächste Schritte

Notieren Sie die ID für alle Berichte, die Sie herunterladen möchten. Gehen Sie zu Wholesale-Rechnungsbericht abrufen , um den Bericht herunterzuladen.

Wholesale-Rechnungsbericht löschen

Mit diesem Verfahren können Sie einen generierten Rechnungsbericht basierend auf der Berichts-ID löschen. Hier einige Beispiele, in denen Sie einen Bericht löschen möchten:

  • Wenn Sie einen vorhandenen Rechnungsbericht erneut generieren möchten, müssen Sie den vorhandenen Bericht zuerst löschen. Nachdem Sie den vorhandenen Bericht gelöscht haben, können Sie einen neuen Bericht für diesen Zeitraum erstellen. Beachten Sie, dass die Löschanforderung nicht existiert, wenn der Bericht fehlgeschlagen ist oder gerade ausgeführt wird.

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

1

Rufen Sie die API zum Löschen des Wholesale-Rechnungsberichts auf.

2

Geben Sie die Bericht-ID ein.

3

Auf Ausführen.

Felder für Rechnungsbericht

Abrechnungsberichte enthalten die folgenden Felder:

Feld

Zusätzliche Informationen

Erscheint in Berichten dieses Typs

PARTNERNAME_

Name des Partners

Partner, Kunde, Benutzer

PARTNER_ORG_ID

Eindeutige Partnerkennung

Partner, Kunde, Benutzer

ABONNEMENT_ID

Eindeutige Abonnement-ID

Partner, Kunde, Benutzer

DIENSTNAME_

Name des Dienstes

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

Partner, Kunde, Benutzer

SKU

SKU für den Service

Partner, Kunde, Benutzer

Beschreibung

Beschreibung des Dienstes

Partner, Kunde, Benutzer

_STARTDATUM_DES VERBRAUCHS

Beginn des Dienstverbrauchs. Zusammen mit dem unten stehenden Feld definiert dieser Wert den Nutzungszeitraum.

Partner, Kunde, Benutzer

_ENDDATUM_DES VERBRAUCHS

Ende des Dienstverbrauchs. Zusammen mit dem obigen Feld definiert dieser Wert den Nutzungszeitraum.

Partner, Kunde, Benutzer

Menge

Gibt den aggregierten Verbrauch der Benutzernutzung pro Partner, pro Kunde oder pro Benutzer (abhängig vom Bericht und der Ebene, auf der Sie die Daten anzeigen) an.

Berechnung:

Für jeden Benutzer wird die Tagesmenge anteilig für diesen Tag berechnet. Beispiel:

Nutzung für einen ganzen Tag = 1

Nutzung für einen halben Tag = 0,5

Die Gesamtwerte pro Tag für alle Tage innerhalb des Abrechnungszeitraums werden summiert, um eine Gesamtmenge für diesen Benutzer innerhalb des Abrechnungszeitraums bereitzustellen.

Für Berichte auf Kunden- und Partnerebene werden die Summen für alle Benutzer aggregiert, um eine Gesamtmenge für diesen Kunden oder Partner bereitzustellen.

Partner, Kunde, Benutzer

ORGANISATIONS-_ID_ DES KUNDEN

Interner eindeutiger Kundenbezeichner

Kunde, Benutzer

_EXTERNE_ID DES KUNDEN

Eindeutige Kennung des Kunden, wie von einem Partner bereitgestellt

Kunde, Benutzer

ABONNENT_ID

Eindeutige Kennung für den Abonnenten

USER (BENUTZER)

Nutzer-ID_

Die Webex-Benutzer-ID des Abonnenten

USER (BENUTZER)

ARBEITSBEREICHS-_ID

Eindeutige Arbeitsbereichsidentifizierung

USER (BENUTZER)

STANDORT-_ID

Eindeutiger Standortbezeichner

Kunde, Benutzer

Die Webex Wholesale-Abrechnung wird durch die Bereitstellung eines Pakets für einen Benutzer ausgelöst oder durch Entfernen der Paketzuweisung gestoppt.