Facturatieverzoening

Partnerbeheerders kunnen de Wholesale Billing API's gebruiken om aangepaste factureringsrapporten te genereren waarin het verbruik per partner, per klant of per gebruiker wordt weergegeven. Partners kunnen deze informatie gebruiken om hun maandelijkse factuur af te stemmen, zodat ze hun klanten en gebruikers kunnen factureren op basis van hun verbruik.

Partners kunnen ook aangepaste factureringsrapporten voor subpartners genereren met behulp van de parameter subPartnerOrgId.

Er zijn vier API's beschikbaar voor partnerbeheerders die voldoen aan de minimale toegangsvereisten.

Facturering API

Doel van API

Vereisten voor partnerbeheerderstoegang

Maak een groothandelsfactuurrapport

Wordt gebruikt om een factureringsrapport te genereren.

Lezen / Schrijven

Ontvang een groothandelsfactuurrapport

Wordt gebruikt om een gegenereerd factureringsrapport te downloaden.

Lezen

Groothandelsfactureringsrapporten weergeven

Wordt gebruikt om de factureringsrapporten weer te geven die voor die partner bestaan.

Lezen

Een groothandelsfactureringsrapport verwijderen

Wordt gebruikt om een bestaand factureringsrapport te verwijderen.

Lezen / Schrijven

Gegevensbron

Gegevens voor de factureringsrapporten worden opgehaald uit de verbruiksgegevens die Webex voor elke partner bijhoudt. Webex houdt elke dag het verbruik van de vorige dag bij voor alle partners, klanten en gebruikers en voegt de gegevens samen, zodat deze kunnen worden gebruikt om de maandelijkse factuur van de partner te genereren. Facturerings-API's maken gebruik van deze gegevens en stellen partnerbeheerders in staat aangepaste rapporten te genereren. Zo kunnen partners het verbruik afstemmen op basis van hun maandelijkse factuur op partner-, klant- en gebruikersniveau.

Voor meer gedetailleerde informatie over hoe Webex partners factureert, zie Service Provider Billing.

Maak een groothandelsfactuurrapport

Gebruik deze procedure om een aangepast factureringsrapport te genereren waarmee u uw facturering kunt afstemmen.
1

Ga naar de API 'Groothandelsfactureringsrapport maken'.

2

Voer de factureringsperiode in door waarden voor billingStartDate en billingEndDate in te voeren in de indeling die de API specificeert. U kunt elke datum uit de laatste vijf jaar invoeren, maar niet de huidige dag.

3

Voer het Type van het rapport in:

  • PARTNER (dit is de standaardinstelling): toont het verbruik op partnerniveau.
  • KLANT: toont het totale verbruik, uitgesplitst naar het niveau van klantorganisaties onder de partner.
  • GEBRUIKER: Geeft het totale verbruik weer, uitgesplitst op het niveau van klantorganisaties en abonnees onder de partner.
4

Klik op Uitvoeren om het rapport te genereren.

5

Kopieer het rapport id uit de API-uitvoer. U kunt deze waarde gebruiken met de Get API om het gegenereerde factureringsrapport op te halen.

De volgende stappen

Ga naar Groothandelsfactureringsrapport ophalen om een kopie van het rapport te downloaden.

Ontvang een groothandelsfactuurrapport

Zodra een factureringsrapport is gegenereerd, kunt u deze API gebruiken om een specifiek factureringsrapport te verkrijgen. Het rapport wordt naar een URL gestuurd, waar het 30 minuten lang kan worden gedownload nadat de GET-aanvraag is voltooid.
1

Ga naar de API voor het verkrijgen van een Wholesale Billing Report.

2

Klik in de regel GET op de knop id en voer de unieke id-waarde voor het rapport in.

3

Klik op Uitvoeren.

4

De API geeft een rapportstatus weer. De uitvoer bevat de parameter tempDownloadURL, die een URL biedt waarvandaan u het rapport kunt downloaden.

5

Kopieer de tempDownloadURL naar een browser om het rapport te openen en te downloaden.

Groothandelsfactureringsrapporten weergeven

Gebruik deze API om een lijst te verkrijgen met gegenereerde factureringsrapporten voor de partnerorganisatie. U kunt alle bestaande rapporten weergeven, of de lijst beperken tot de rapporten die voldoen aan de opgegeven parameters, zoals uw factureringsperiode en factureringstype (Partner, klant, gebruiker).

Als u optionele parameters invoert, retourneert de API alleen de rapporten die exact overeenkomen met de parameters die u invoert. Als u bijvoorbeeld een factureringsperiode invoert, worden alleen rapporten geretourneerd die specifiek voor die factureringsperiode gelden. Rapporten die binnen die periode vallen, maar waarvan de datums niet exact overeenkomen, worden niet geretourneerd.
1

Ga naar de API voor het factureringsrapport van de lijst met groothandels

2

Voer onder Queryparameterseventuele zoekparameters in die u wilt gebruiken (bijvoorbeeld startdatum, einddatum, type, sortBy op). Raadpleeg de Help voor ontwikkelaars op de API voor meer informatie over deze parameters.

3

Klik op Uitvoeren.

De API geeft de lijst met rapporten weer, samen met de unieke rapport-ID en de status (VOLTOOID, IN_UITVOERING).

De volgende stappen

Noteer de id voor alle rapporten die u wilt downloaden. Ga naar Groothandelsfactureringsrapport ophalen om het rapport te downloaden.

Een groothandelsfactureringsrapport verwijderen

Gebruik deze procedure om een gegenereerd factureringsrapport te verwijderen op basis van de rapport-ID. Hier volgen enkele voorbeelden van situaties waarin u een rapport wilt verwijderen:

  • Als u een bestaand factureringsrapport opnieuw wilt genereren, moet u het bestaande rapport eerst verwijderen. Nadat u het bestaande rapport hebt verwijderd, kunt u een nieuw rapport voor die periode maken. Houd er rekening mee dat er geen sprake is van een verwijderingsvereiste als het rapport is mislukt of nog in uitvoering is.

  • Als er een rapport is gegenereerd en u de URL naar de verkeerde persoon stuurt, kunt u het rapport verwijderen. De verkeerde persoon kan het rapport dan niet meer openen.

1

Ga naar de API voor het verwijderen van Wholesale Billing Reports.

2

Voer het rapport Idin.

3

Klik op Uitvoeren.

Velden in het factureringsrapport

Factureringsrapporten bevatten de volgende velden:

Veld

Aanvullende informatie

Verschijnt in rapporten van het type

PARTNER_NAAM

Naam van de partner

PARTNER, KLANT, GEBRUIKER

PARTNER_ORG_ID

Unieke partner-ID

PARTNER, KLANT, GEBRUIKER

ABONNEMENT_ID

Unieke abonnements-ID

PARTNER, KLANT, GEBRUIKER

SERVICE_NAAM

Naam van de dienst

(bijv. COMMON_AREA_CALLING, WEBEX_CALLING, WEBEX_SUITE, WEBEX_MEETINGS)

PARTNER, KLANT, GEBRUIKER

SKU

SKU voor de service

PARTNER, KLANT, GEBRUIKER

BESCHRIJVING

Omschrijving van de dienst

PARTNER, KLANT, GEBRUIKER

CONSUMPTIE_START_DATUM

Begin van het serviceverbruik. Samen met het volgende veld definieert deze waarde de gebruiksperiode.

PARTNER, KLANT, GEBRUIKER

CONSUMPTIE_EIND_DATUM

Einde van het serviceverbruik. Samen met het voorgaande veld definieert deze waarde de verbruiksperiode.

PARTNER, KLANT, GEBRUIKER

HOEVEELHEID

Geeft het geaggregeerde gebruikersverbruik weer per partner, per klant of per gebruiker (afhankelijk van het rapport en het niveau waarop u de gegevens bekijkt).

Berekening:

Ze berekenen de dagelijkse hoeveelheid voor elke gebruiker op een evenredige basis voor die dag.

Gebruik voor een hele dag = 1

Gebruik voor een halve dag = 0,5

Ze tellen de totalen per dag voor alle dagen binnen de factureringsperiode bij elkaar op om de totale hoeveelheid voor die gebruiker binnen die factureringsperiode te berekenen.

Voor rapporten op klant- en partnerniveau worden de totalen voor alle gebruikers samengevoegd om een totaalbedrag voor die klant of partner te verkrijgen.

PARTNER, KLANT, GEBRUIKER

KLANT_ORG_ID

Interne klant unieke identificatie

KLANT, GEBRUIKER

KLANT_EXTERNE_ID

Unieke klantidentificatie zoals verstrekt door een partner

KLANT, GEBRUIKER

ABONNEE_ID

Unieke identificatie voor de abonnee

GEBRUIKER

GEBRUIKERS-ID_

De Webex-gebruikers-ID van de abonnee

GEBRUIKER

WERKRUIMTE_ID

Unieke werkruimte-ID

GEBRUIKER

LOCATIE_ID

Unieke locatie-identificatie

KLANT, GEBRUIKER

LICENTIE_ID

Licentie-ID

Dit veld is alleen zichtbaar voor Groothandel-pakketten. De License_ID is leeg voor licenties die zijn toegewezen vóór de introductie van dit veld.

Een factureringsrapport kan meerdere rijen voor hetzelfde Wholesale-pakket weergeven, waarbij elke rij een uniek nummer vertegenwoordigt. package/license ID-combinatie.

Als het veld LICENSE_ID aanwezig is, vertegenwoordigt elke rij een uniek package/location/license ID-combinatie.

KLANT, GEBRUIKER

Wanneer u een pakket aan een gebruiker toewijst, wordt de facturering van Webex Wholesale geactiveerd. Verwijdert u de pakkettoewijzing, dan wordt deze geactiveerd.