Factureringsafstemming

Partnerbeheerders kunnen de API's voor groothandelsfacturering gebruiken om aangepaste factureringsrapporten te genereren die het verbruik weergeven op het niveau per partner, per klant of per gebruikersniveau. Partners kunnen deze informatie gebruiken om hun maandelijkse factuur af te stemmen zodat ze hun klanten en gebruikers kunnen factureren aan de hand van hun verbruik.

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

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

Factureren-API

Doel van API

Toegangsvereiste partnerbeheerder

Een groothandelsrapport voor facturering maken

Wordt gebruikt om een factureringsrapport te genereren.

Lezen/schrijven

Een factuurrapport voor groothandels ophalen

Wordt gebruikt om een gegenereerd factureringsrapport op te halen om te downloaden.

Lezen

Groothandelsfactureringsrapporten weergeven

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

Lezen

Een wholesale-factureringsrapport verwijderen

Wordt gebruikt om een bestaand factureringsrapport te verwijderen.

Lezen/schrijven

Gegevensbron

Gegevens voor de factureringsrapporten worden opgehaald uit de gebruiksverbruiksgegevens die Webex voor elke partner bijhoudt. Elke dag houdt Webex het verbruik van de vorige dag voor alle partners, klanten en gebruikers bij en verzamelt het de gegevens zodat deze kunnen worden gebruikt om de maandelijkse factuur van de partner te genereren. API's voor facturering gebruiken deze gegevens, zodat partnerbeheerders aangepaste rapporten kunnen genereren zodat de partner het verbruik kan afstemmen op de maandelijkse factuur op het niveau van de partner, de klant en de gebruiker.

Zie Serviceprovider factureren voor meer informatie over hoe Webex partners factureert.

Een groothandelsrapport voor facturering maken

Gebruik deze procedure om een aangepast factureringsrapport te genereren dat u kunt gebruiken om uw facturering af te stemmen.
1

Ga naar de API voor het groothandelsfacturatierapport maken.

2

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

3

Voer het Type rapport in:

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

Klik op Uitvoeren om het rapport te genereren.

5

Kopieer de 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 Een factuurrapport voor groothandels ophalen om een kopie van het rapport te downloaden.

Een factuurrapport voor groothandels ophalen

Nadat een factureringsrapport is gegenereerd, gebruikt u deze API om een specifiek factureringsrapport te verkrijgen. Het rapport wordt uitgevoerd naar een URL waar het 30 minuten na voltooiing van het GET-verzoek kan worden gedownload.
1

Ga naar de API voor het groothandelsfactureringsrapport ophalen.

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 voert de rapportstatus uit. De uitvoer bevat de parameter tempDownloadURL , die een URL biedt van waaruit u het rapport kunt downloaden.

5

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

Groothandelsfactureringsrapporten weergeven

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

Als u optionele parameters invoert, retourneert de API alleen rapporten die exact overeenkomen met de opgegeven parameters. Als u bijvoorbeeld een factureringsperiode invoert, worden alleen rapporten die gebruikmaken van die specifieke factureringsperiode, geretourneerd. Rapporten die binnen de periode vallen, maar niet exact overeenkomen met de datums, worden niet geretourneerd.
1

Ga naar de API voor het factuurrapport voor groothandels

2

Voer onder Queryparameters de zoekparameters in die u wilt gebruiken (bijvoorbeeld de startDate, endDate, Type, sorteren op). Zie de Help van de ontwikkelaar voor de API voor meer informatie over deze parameters.

3

Klik op Uitvoeren.

De API voert de lijst met rapporten uit samen met de unieke rapport-id en status (VOLTOOID, IN_VOORTGANG).

De volgende stappen

Neem een opname van de id voor alle rapporten die u wilt downloaden. Ga naar Een factuurrapport voor groothandels ophalen om het rapport te downloaden.

Een wholesale-factureringsrapport verwijderen

Gebruik deze procedure om een gegenereerd factureringsrapport te verwijderen op basis van het rapport-id. Enkele voorbeelden waarbij u mogelijk een rapport wilt verwijderen, zijn:

  • Als u een bestaand factureringsrapport opnieuw wilt genereren, moet u eerst het bestaande rapport verwijderen. Nadat u het bestaande rapport hebt verwijderd, kunt u een nieuw rapport voor die periode maken. Houd er rekening mee dat de verwijderingsvereiste niet bestaat als het rapport is mislukt of bezig is.

  • Als er een rapport wordt gegenereerd en u verzendt de URL naar de verkeerde persoon, kunt u het rapport verwijderen en heeft deze persoon geen toegang meer tot het rapport.

1

Ga naar de API voor het groothandelsfactureringsrapport verwijderen.

2

Voer de id van het rapport in.

3

Klik op Uitvoeren.

Velden van factuurrapport

Factureringsrapporten bevatten de volgende velden:

Veld

Aanvullende informatie

Wordt weergegeven in Rapporten van dit type

PARTNER_NAAM

Naam partner

partner, klant, gebruiker

PARTNER_ORGANISATIE_-ID

Unieke partner-id

partner, klant, gebruiker

ABONNEMENT-ID_

Unieke abonnements-id

partner, klant, gebruiker

SERVICE_NAAM

Naam van de service

(bijvoorbeeld COMMON_AREA_CALLING, WEBEX_CALLING, WEBEX_SUITE, WEBEX_MEETINGS)

partner, klant, gebruiker

SKU

Sku voor de service

partner, klant, gebruiker

beschrijving

Beschrijving van de service

partner, klant, gebruiker

CONSUMPTIE_BEGIN_DATUM

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

partner, klant, gebruiker

CONSUMPTIE_EINDDATUM_

Einde van het serviceverbruik. Samen met het bovenstaande veld definieert deze waarde de periode van het gebruiksverbruik.

partner, klant, gebruiker

hoeveelheid

Staat voor het geaggregeerde gebruikersverbruik per partner, per klant of per gebruiker (afhankelijk van het rapport en het niveau waarop u de gegevens weergeeft).

Berekening:

Voor elke gebruiker wordt voor die dag de hoeveelheid per dag berekend op pro rata basis. Bijvoorbeeld:

Gebruik voor een volledige dag = 1

Gebruik voor een halve dag = 0,5

De totalen per dag voor alle dagen binnen de factureringsperiode worden samengeteld om een totale hoeveelheid voor die gebruiker binnen die factureringsperiode weer te geven.

Voor rapporten op klanten- en partnerniveau worden de totalen voor alle gebruikers samengevoegd om een totale hoeveelheid te geven voor die klant of partner.

partner, klant, gebruiker

KLANT_ORGANISATIE_-ID

Unieke id van interne klant

klant, gebruiker

_EXTERNE_ID VAN KLANT

Unieke id van de klant zoals verstrekt door een partner

klant, gebruiker

ABONNEE_ID

Unieke id voor de abonnee

GEBRUIKER

GEBRUIKERS-ID_

De Webex-gebruikers-id van de abonnee

GEBRUIKER

WERKPLEK_ID

Unieke identificatie van werkplek

GEBRUIKER

LOCATIE_ID

Unieke locatie-id

klant, gebruiker

Webex Wholesale-facturering wordt geactiveerd door het inrichten van een pakket aan een gebruiker of wordt gestopt door de pakkettoewijzing te verwijderen.