Faktureringsavstämning

Partneradministratörer kan använda Wholesale Billing API:er för att generera anpassade faktureringsrapporter som visar användningsförbrukning på nivåerna per partner, per kund eller per användare. Partners kan använda den här informationen för att stämma av sina månadsfakturor så att de kan fakturera sina kunder och användare enligt deras förbrukning.

Partners kan också generera anpassade faktureringsrapporter för underpartners med hjälp av parametern subPartnerOrgId.

Det finns fyra API:er som är tillgängliga för partneradministratörer som uppfyller minimikraven för åtkomst.

Fakturerings-API

Syfte med API

Krav på partneradministratörsåtkomst

Skapa en faktureringsrapport för grossistledet

Används för att generera en faktureringsrapport.

Läsa / Skriva

Få en faktureringsrapport för grossister

Används för att hämta en genererad faktureringsrapport för nedladdning.

Läs

Lista grossistfaktureringsrapporter

Används för att lista de faktureringsrapporter som finns för den partnern.

Läs

Ta bort en grossistfaktureringsrapport

Används för att ta bort en befintlig faktureringsrapport.

Läsa / Skriva

Datakälla

Data för faktureringsrapporterna hämtas från de användningsförbrukningsdata som Webex spårar för varje partner. Varje dag spårar Webex föregående dags användning för alla partners, kunder och användare och aggregerar informationen så att den kan användas för att generera partnerns månadsfaktura. Fakturerings-API:er utnyttjar dessa data och låter partneradministratörer generera anpassade rapporter så att partnern kan stämma av användningsförbrukningen från sin månadsfaktura på partner-, kund- och användarnivå.

För mer detaljerad information om hur Webex fakturerar partners, se Fakturering av tjänsteleverantör.

Skapa en faktureringsrapport för grossistledet

Använd den här proceduren för att generera en anpassad faktureringsrapport som du kan använda för att stämma av din fakturering.
1

Gå till API:et för att skapa en grossistfaktureringsrapport.

2

Ange faktureringsperioden genom att ange värden för billingStartDate och billingEndDate i det format som API:et anger. Du kan ange vilket datum som helst från de senaste fem åren, men inte aktuell dag.

3

Ange rapportens typ:

  • PARTNER (detta är standardinställningen) – Visar användningsförbrukning på partnernivå.
  • KUND – Visar total användning uppdelad på kundorganisationsnivå under partnern.
  • ANVÄNDARE – Visar total användning uppdelad på nivån för kundorganisationer och prenumeranter under partnern.
4

Klicka på Kör för att generera rapporten.

5

Kopiera rapport-id:t från API-utdata. Du kan använda det här värdet med Get API för att hämta den genererade faktureringsrapporten.

Nästa steg

Gå till Hämta en grossistfaktureringsrapport för att ladda ner en kopia av rapporten.

Få en faktureringsrapport för grossister

När en faktureringsrapport har genererats kan du använda detta API för att hämta en specifik faktureringsrapport. Rapporten skickas till en URL där den kan laddas ner i 30 minuter efter att GET-begäran har slutförts.
1

Gå till API:et för att hämta en grossistfaktureringsrapport.

2

På raden GET klickar du på knappen id och anger det unika id-värdet för rapporten.

3

Klicka på Kör.

4

API-utdata rapporterar status. Utdata innehåller parametern tempDownloadURL, som tillhandahåller en URL från vilken du kan ladda ner rapporten.

5

Kopiera tempDownloadURL till en webbläsare för att komma åt och ladda ner rapporten.

Lista grossistfaktureringsrapporter

Använd detta API för att hämta en lista över genererade faktureringsrapporter för partnerorganisationen. Du kan lista alla befintliga rapporter, eller begränsa listan till de rapporter som uppfyller de angivna parametrarna, till exempel din faktureringsperiod och faktureringstyp (partner, kund, användare).

Om du anger valfria parametrar returnerar API:et endast de rapporter som exakt matchar de parametrar du anger. Om du till exempel anger en faktureringsperiod returneras endast rapporter som använder den specifika faktureringsperioden – rapporter som faller inom perioden men som inte exakt matchar datumen returneras inte.
1

Gå till API:et för lista över grossistfaktureringsrapporter

2

Under Frågeparametraranger du de sökparametrar du vill använda (till exempel startdatum, slutdatum, typ, sortera efter). För mer information om dessa parametrar, se utvecklarhjälpen i API:et.

3

Klicka på Kör.

API:et matar ut listan över rapporter tillsammans med det unika rapport-ID:t och statusen (SLUTFÖRD, PÅGÅR_).

Nästa steg

Anteckna -id:t för alla rapporter som du vill ladda ner. Gå till Hämta en grossistfaktureringsrapport för att ladda ner rapporten.

Ta bort en grossistfaktureringsrapport

Använd den här proceduren för att ta bort en genererad faktureringsrapport baserad på rapport-ID. Några exempel på var du kanske vill ta bort en rapport är:

  • Om du vill generera en befintlig faktureringsrapport på nytt måste du först ta bort den befintliga rapporten. När du har tagit bort den befintliga rapporten kan du skapa en ny rapport för den perioden. Observera att kravet på borttagning inte finns om rapporten misslyckas eller pågår.

  • Om en rapport genereras och du skickar URL:en till fel person kan du radera rapporten och personen kommer då inte att kunna komma åt den.

1

Gå till API:et för att ta bort rapporten om grossistfakturering.

2

Ange rapportens -ID.

3

Klicka på Kör.

Faktureringsrapportfält

Faktureringsrapporter innehåller följande fält:

Fält

Ytterligare information

Visas i rapporter av typen

PARTNERN_NAMN

Partnerns namn

PARTNER, KUND, ANVÄNDARE

PARTNER_ORG_ID

Unik partneridentifierare

PARTNER, KUND, ANVÄNDARE

PRENUMERATION_ID

Unik prenumerationsidentifierare

PARTNER, KUND, ANVÄNDARE

TJÄNST_NAMN

Tjänstens namn

(t.ex. GEMENSAMMA_OMRÅDES-SAMTAL_, WEBEX_-SAMTAL, WEBEX_SUITE, WEBEX_MÖTEN)

PARTNER, KUND, ANVÄNDARE

SKU

Sku för tjänsten

PARTNER, KUND, ANVÄNDARE

BESKRIVNING

Beskrivning av tjänsten

PARTNER, KUND, ANVÄNDARE

FÖRBRUKNING_START_DATUM

Början av tjänsteförbrukningen. Tillsammans med följande fält definierar detta värde användningsperioden.

PARTNER, KUND, ANVÄNDARE

FÖRBRUKNING_SLUTDATUM_

Slut på tjänsteförbrukningen. Tillsammans med föregående fält definierar detta värde användningsperioden.

PARTNER, KUND, ANVÄNDARE

KVANTITET

Representerar den aggregerade användarkonsumtionen per partner, per kund eller per användare (beroende på rapporten och nivån där du visar informationen).

Beräkning:

De beräknar den dagliga kvantiteten för varje användare proportionellt för den dagen.

Användning under en hel dag = 1

Användning i en halv dag = 0,5

De summerar totalsummorna per dag för alla dagar inom faktureringsperioden för att beräkna den totala kvantiteten för den användaren inom den faktureringsperioden.

För rapporter på kund- och partnernivå aggregeras totalerna för alla användare för att ge en total kvantitet för den kunden eller partnern.

PARTNER, KUND, ANVÄNDARE

KUND_ORG_ID

Intern kunds unika identifierare

KUND, ANVÄNDARE

KUND_EXTERN_ID

Kundens unika identifierare som tillhandahålls av en partner

KUND, ANVÄNDARE

PRENUMERANT_ID

Unik identifierare för prenumeranten

ANVÄNDARE

ANVÄNDAR-ID_

Prenumerantens Webex-användar-ID

ANVÄNDARE

ARBETSYTA_ID

Unik arbetsyteidentifierare

ANVÄNDARE

PLATS_ID

Unik platsidentifierare

KUND, ANVÄNDARE

LICENS_ID

Licensidentifierare

Det här fältet är endast synligt för grossistpaket. License_-ID:t är tomt för licenser som tilldelats innan detta fält introducerades.

En faktureringsrapport kan visa flera rader för samma grossistpaket, där varje rad representerar ett unikt package/license ID-kombination.

Om fältet LICENS-ID_finns representerar varje rad ett unikt package/location/license ID-kombination.

KUND, ANVÄNDARE

Att etablera ett paket till en användare utlöser Webex Wholesale-fakturering, medan borttagning av pakettilldelningen stoppar det.