Faktureringsrapporter for engrosrute til markedet
Faktureringsrapporter
Partnere kan bruke følgende API-er for engrosfakturering til å generere faktureringsrapporter som hjelper dem med å validere nøyaktigheten av bruk og klargjøring. API-ene for engrosfakturering er tilgjengelige via developer.webex.com.
-
Avstemming – viser bruksforbruk per partner, per kunde eller per bruker. Partnere kan bruke denne tilpassede faktureringsrapportinformasjonen til å avstemme den månedlige fakturaen sin, slik at de kan fakturere kundene og brukerne sine i henhold til forbruket.
-
Tidspunkt – Viser gjeldende pakketildelinger per kunde eller per bruker. Tidspunktsrapporten gir en sanntidstelling av pakketildelinger. Partnere kan bruke denne informasjonen til å validere nøyaktigheten av klargjøringen og sikre samsvar med kundeordrer.
Partnere kan også generere tilpassede faktureringsrapporter for underpartnere ved hjelp av subPartnerOrgId-parameteren.
Det finnes fire API-er som er tilgjengelige for partneradministratorer som oppfyller minimumskravene til tilgang.
|
Fakturerings-API |
Formålet med API-et |
Krav til tilgang for partneradministratorer |
|---|---|---|
|
Opprett en faktureringsrapport for engros |
Brukes til å generere en faktureringsrapport. |
Read/write |
|
Få en faktureringsrapport for engros |
Brukes til å hente en generert faktureringsrapport for nedlasting. |
Lese |
|
Liste over faktureringsrapporter for engros |
Brukes til å liste opp faktureringsrapportene som finnes for den partneren. |
Lese |
|
Slett en faktureringsrapport for engros |
Brukes til å slette en eksisterende faktureringsrapport. |
Read/write |
Datakilde
Data for faktureringsrapportene hentes fra pakketildelinger og bruksdata som Webex sporer for hver partner. Webex samler kunde- og brukerpakkedataene daglig for å generere partnerens månedlige faktura. Fakturerings-API-er bruker disse dataene, slik at partneradministratorer kan generere tilpassede rapporter. Disse rapportene hjelper partnere med å avstemme bruksforbruk fra den månedlige fakturaen på partner-, kunde- og brukernivå.
Hvis du vil ha mer detaljert informasjon om hvordan Webex fakturerer partnere, kan du se Fakturering av tjenesteleverandører.
Opprett en rapport om engrosfakturering
| 1 |
Fra developer.webex.comgår du til Opprett et API for engrosfaktureringsrapport. |
| 2 |
Velg en av følgende rapportkategorier:
Hvis du vil generere en avstemmingsrapport, trenger du ikke å endre noe fordi Avstemming er valgt som standard, så du kan gå videre til neste trinn. Hvis du vil generere en tidsrapport, endrer du valget til tidspunkt. |
| 3 |
Skriv inn billingStartDate og billingEndDate i formatet som API-et angir. Du kan angi hvilken som helst dato fra de siste fem årene, men ikke dagens dato. For rapporten om tidspunkt er ikke feltene billingStartDate og billingEndDate obligatoriske, og de ignoreres hvis de angis. Rapporten gjenspeiler alltid gjeldende pakketildelinger. |
| 4 |
Skriv inn rapporttypen :
|
| 5 |
Klikk på Kjør for å generere rapporten. |
| 6 |
Kopier rapport-ID-en fra API-utdataene. Du kan bruke denne verdien med Get API-et for å hente den genererte faktureringsrapporten. |
Hva du skal gjøre nå
Gå til delen Hent en faktureringsrapport for engros for å laste ned en kopi av rapporten.
Få en faktureringsrapport for engros
Når en faktureringsrapport er generert, kan du bruke dette API-et til å hente en spesifikk faktureringsrapport. Rapporten sendes til en URL der den er tilgjengelig for nedlasting i 30 minutter etter at GET-forespørselen er fullført.
| 1 |
Fra developer.webex.comgår du til Skaff deg en API for engrosfaktureringsrapport. |
| 2 |
Skriv inn den unike id -verdien for rapporten og klikk på Kjør. API-utgangene rapporterer status. Utdataene inkluderer parameteren tempDownloadURL, som gir en URL du kan laste ned rapporten fra. |
| 3 |
Kopier tempDownloadURL til en nettleser for å få tilgang til og laste ned rapporten. |
Liste over faktureringsrapporter for engros
Bruk dette API-et til å hente en liste over genererte faktureringsrapporter for partnerorganisasjonen. Du kan liste opp alle eksisterende rapporter, eller begrense listen til de rapportene som oppfyller de angitte parameterne, for eksempel faktureringsperiode og faktureringstype (partner, kunde, bruker).
Hvis du angir valgfrie parametere, returnerer API-et bare de rapportene som samsvarer nøyaktig med parameterne du angir. Hvis du for eksempel angir en faktureringsperiode, returneres bare rapporter som bruker den spesifikke faktureringsperioden. Rapporter som faller innenfor perioden, men som ikke samsvarer nøyaktig med datoene, returneres ikke.
| 1 |
Fra developer.webex.com, gå til List Wholesale Billing Report API. |
| 2 |
Under Søkeparametereskriver du inn eventuelle søkeparametere du vil bruke (for eksempel startdato, sluttdato, type, sorter etter). |
| 3 |
Klikk på Kjør. API-et viser en liste over rapporter sammen med den unike rapport-ID-en og statusen (FULLFØRT, PÅGÅR_).
|
Hva du skal gjøre nå
Ta en oversikt over -ID-en for alle rapporter du vil laste ned. Gå til Få en engrosfaktureringsrapport for å laste ned rapporten.
Slett en engrosfaktureringsrapport
Bruk denne prosedyren for å slette en generert faktureringsrapport basert på rapport-ID. Noen eksempler på hvor du kanskje vil slette en rapport inkluderer:
-
Hvis du vil generere en eksisterende avstemmingsfaktureringsrapport på nytt, må du først slette den eksisterende rapporten. Etter at du har slettet den eksisterende rapporten, kan du opprette en ny rapport for den perioden. Du kan ikke slette en rapport hvis genereringen har mislyktes eller fortsatt pågår.
For en tidsrapport trenger du ikke å slette en eksisterende rapport, siden systemet ikke genererer disse rapportene på nytt. Hver rapport gjenspeiler alltid data per gjeldende tidsstempel.
-
Hvis du sender en generert rapport-URL til feil person, kan du slette rapporten slik at de ikke får tilgang til den.
| 1 |
Fra developer.webex.com, gå til Slett API for engrosfaktureringsrapport. |
| 2 |
Skriv inn rapport - ID-en og klikk på Kjør. |
Faktureringsrapportfelt
Faktureringsrapporter inneholder følgende felt:
|
Felt |
Beskrivelse |
Støttet rapporttype |
Støttet rapportkategori |
|---|---|---|---|
|
PARTNER_NAVN |
Partnerens navn |
PARTNER, KUNDE, BRUKER |
Avstemming, tidspunkt |
|
PARTNER_ORG_ID |
Unik partneridentifikator |
PARTNER, KUNDE, BRUKER |
Avstemming, tidspunkt |
|
ABONNEMENT_ID |
Unik abonnementsidentifikator |
PARTNER, KUNDE, BRUKER |
Avstemming, tidspunkt |
|
TJENESTE_NAVN |
Navn på tjeneste (f.eks. SAMTALER I FELLES_OMRÅDE_, WEBEX_SAMTALER, WEBEX_SUITE, WEBEX_MØTER) |
PARTNER, KUNDE, BRUKER |
Avstemming, tidspunkt |
|
SKU |
Sku for tjenesten |
PARTNER, KUNDE, BRUKER |
Avstemming, tidspunkt |
|
BESKRIVELSE |
Beskrivelse av tjenesten |
PARTNER, KUNDE, BRUKER |
Avstemming, tidspunkt |
|
FORBRUK_STARTDATO_ |
Start av tjenesteforbruket. Sammen med følgende felt definerer denne verdien bruksperioden. |
PARTNER, KUNDE, BRUKER |
Forsoning |
|
FORBRUK_SLUTT_DATO |
Slutt på tjenesteforbruket. Sammen med det foregående feltet definerer denne verdien bruksforbruksperioden. |
PARTNER, KUNDE, BRUKER |
Forsoning |
|
MENGDE |
Representerer det aggregerte brukerforbruket per partner, per kunde eller per bruker (avhengig av rapporten og nivået du viser dataene på). Beregning: Systemet beregner det daglige antallet for hver bruker på en proporsjonal basis for den dagen. Bruk for en hel dag = 1 Bruk i en halv dag = 0,5 Deretter summerer den totalen per dag for alle dager innenfor faktureringsperioden for å beregne det totale antallet for den brukeren innenfor den faktureringsperioden. For rapporter på kunde- og partnernivå aggregeres totalene for alle brukere for å gi et totalbeløp for den kunden eller partneren. Tidspunkt: Kunderapporten viser pakketildelinger per kunde. Hver rad representerer den totale mengden av en bestemt pakke som er tilordnet brukere eller arbeidsområder innenfor en bestemt kundeorganisasjon. Antall viser «0» hvis det ikke er tildelt noen pakker. Brukerrapporten viser pakkene som er tilordnet brukere eller arbeidsområder. Hver rad viser et tall på 1, som representerer en bruker eller et arbeidsområde og deres individuelle pakke eller tillegg. Hvis flere pakker eller tillegg er tildelt en bruker eller et arbeidsområde, viser rapporten flere oppføringer, hver med et antall 1. |
PARTNER, KUNDE, BRUKER |
Avstemming, tidspunkt |
|
KUNDE_ORG_ID |
Intern unik kundeidentifikator |
KUNDE, BRUKER |
Avstemming, tidspunkt |
|
KUNDE_EKSTERN_ID |
Kundens unike identifikator som oppgitt av en partner |
KUNDE, BRUKER |
Avstemming, tidspunkt |
|
ABONNENT_ID |
Unik identifikator for abonnenten |
BRUKER |
Avstemming, tidspunkt |
|
BRUKER_ID |
Abonnentens Webex-bruker-ID |
BRUKER |
Avstemming, tidspunkt |
|
ARBEIDSOMRÅDE_ID |
Unik arbeidsområdeidentifikator |
BRUKER |
Avstemming, tidspunkt |
|
STEDS-ID_ |
Unik lokasjonsidentifikator |
KUNDE, BRUKER |
Avstemming, tidspunkt |
|
LISENS_ID |
Lisensidentifikator Dette feltet er bare synlig for engrospakker For avstemmingsrapporten er License_ID tom for lisenser som ble tildelt før dette feltet ble introdusert. Faktureringsrapporten viser flere rader for den samme engrospakken hvis den er knyttet til forskjellige kombinasjoner av LOCATION_ID og LICENSE_ID. |
KUNDE, BRUKER |
Avstemming, tidspunkt |
|
RAPPORT_DATO |
Datoen og klokkeslettet da rapporten genereres. |
KUNDE, BRUKER |
Tidspunkt |
Klargjøring av en pakke til en bruker utløser Webex Wholesale-fakturering, mens fjerning av pakketildelingen stopper den.