Faktureringsrapporter for engroshandel via rute til markedet
Faktureringsrapporter
Partnere kan bruge følgende Wholesale billing API'er til at generere faktureringsrapporter, der hjælper dem med at validere brug og nøjagtighed af provisionering. Engrosfakturerings-API'erne er tilgængelige via developer.webex.com.
-
Afstemning – Viser forbrug pr. partner, pr. kunde eller pr. bruger. Partnere kan bruge disse brugerdefinerede faktureringsrapportoplysninger til at afstemme deres månedlige faktura, så de kan fakturere deres kunder og brugere i henhold til deres forbrug.
-
Tidspunkt – Viser aktuelle pakkeallokeringer pr. kunde eller pr. bruger. Rapporten "Point-In-Time" viser en realtidsoptælling af pakkeallokeringer. Partnere kan bruge disse oplysninger til at validere nøjagtigheden af klargøringen og sikre overensstemmelse med kundeordrer.
Partnere kan også generere brugerdefinerede faktureringsrapporter for underpartnere ved hjælp af subPartnerOrgId-parameteren.
Der er fire API'er, der er tilgængelige for partneradministratorer, der opfylder minimumskravene til adgang.
|
Fakturerings-API |
Formålet med API'en |
Krav til adgang for partneradministratorer |
|---|---|---|
|
Opret en rapport om engrosfakturering |
Bruges til at generere en faktureringsrapport. |
Read/write |
|
Få en rapport om engrosfakturering |
Bruges til at hente en genereret faktureringsrapport til download. |
Læs |
|
Liste over faktureringsrapporter for engros |
Bruges til at liste de faktureringsrapporter, der findes for den pågældende partner. |
Læs |
|
Slet en engrosfaktureringsrapport |
Bruges til at slette en eksisterende faktureringsrapport. |
Read/write |
Datakilde
Data til faktureringsrapporterne hentes fra pakketildelinger og brugsdata, som Webex sporer for hver partner. Webex aggregerer dagligt kunde- og brugerpakkedata for at generere partnerens månedlige faktura. Fakturerings-API'er bruger disse data, hvilket giver partneradministratorer mulighed for at generere brugerdefinerede rapporter. Disse rapporter hjælper partnere med at afstemme forbrug fra deres månedlige faktura på partner-, kunde- og brugerniveau.
For mere detaljerede oplysninger om, hvordan Webex fakturerer partnere, se Fakturering af tjenesteudbyder.
Opret en rapport om engrosfakturering
| 1 |
Fra developer.webex.comskal du gå til Opret en API for engrosfaktureringsrapport. |
| 2 |
Vælg en af følgende rapportkategorier:
Hvis du vil generere en afstemningsrapport, er der ingen grund til at ændre noget, da Afstemning er valgt som standard, så du kan fortsætte til næste trin. Hvis du vil generere en rapport på tidspunktet, skal du ændre valget til Tidspunkt. |
| 3 |
Indtast billingStartDate og billingEndDate i det format, som API'en angiver. Du kan indtaste en hvilken som helst dato fra de seneste fem år, men ikke den aktuelle dag. For rapporten Point-In-Time er felterne billingStartDate og billingEndDate ikke obligatoriske og ignoreres, hvis de indtastes. Rapporten afspejler altid de aktuelle pakkeallokeringer. |
| 4 |
Indtast rapporttypen :
|
| 5 |
Klik på Kør for at generere rapporten. |
| 6 |
Kopier rapport-id'et fra API-outputtet. Du kan bruge denne værdi med Get API'en til at hente den genererede faktureringsrapport. |
Næste trin
Gå til afsnittet Hent en engrosfaktureringsrapport for at downloade en kopi af rapporten.
Få en rapport om engrosfakturering
Når en faktureringsrapport er genereret, skal du bruge denne API til at indhente en specifik faktureringsrapport. Rapporten sendes til en URL, hvor den kan downloades i 30 minutter efter, at GET-anmodningen er fuldført.
| 1 |
Fra developer.webex.comskal du gå til Hent en API til engrosfaktureringsrapport. |
| 2 |
Indtast den unikke id værdi for rapporten, og klik på Kør. API-outputtet rapporterer status. Outputtet indeholder parameteren tempDownloadURL, som angiver en URL, hvorfra du kan downloade rapporten. |
| 3 |
Kopier tempDownloadURL til en browser for at få adgang til og downloade rapporten. |
Liste over faktureringsrapporter for engros
Brug denne API til at hente en liste over genererede faktureringsrapporter for partnerorganisationen. Du kan vise alle eksisterende rapporter eller begrænse listen til de rapporter, der opfylder de angivne parametre, såsom din faktureringsperiode og faktureringstype (partner, kunde, bruger).
Hvis du indtaster valgfrie parametre, returnerer API'en kun de rapporter, der matcher præcis de parametre, du angiver. Hvis du f.eks. angiver en faktureringsperiode, returneres kun rapporter, der bruger den specifikke faktureringsperiode. Rapporter, der falder inden for perioden, men som ikke præcist matcher datoerne, returneres ikke.
| 1 |
Fra developer.webex.comskal du gå til List Wholesale Billing Report API. |
| 2 |
Under Forespørgselsparametreskal du indtaste de søgeparametre, du vil bruge (f.eks. startdato, slutdato, type, sorter efter). |
| 3 |
Klik på Kør. API'en udskriver listen over rapporter sammen med det unikke rapport-id og status (AFSLUTET, I GANG_).
|
Næste trin
Registrer id'et for alle rapporter, du vil downloade. Gå til Hent en engrosfaktureringsrapport for at downloade rapporten.
Slet en rapport om engrosfakturering
Brug denne procedure til at slette en genereret faktureringsrapport baseret på rapport-id. Her er et par eksempler på, hvor du måske vil slette en rapport:
-
Hvis du vil generere en eksisterende afstemningsfaktureringsrapport, skal du først slette den eksisterende rapport. Når du har slettet den eksisterende rapport, kan du oprette en ny rapport for den pågældende periode. Du kan ikke slette en rapport, hvis genereringen er mislykket eller stadig er i gang.
For en Point-In-Time-rapport behøver du ikke at slette en eksisterende rapport, da systemet ikke genererer disse rapporter. Hver rapport afspejler altid data fra det aktuelle tidsstempel.
-
Hvis du sender en genereret rapport-URL til den forkerte person, kan du slette rapporten, så de ikke kan få adgang til den.
| 1 |
Fra developer.webex.comskal du gå til Slet API'en til engrosfaktureringsrapport. |
| 2 |
Indtast rapportens -id og klik på Kør. |
Faktureringsrapportfelter
Faktureringsrapporter indeholder følgende felter:
|
Felt |
Beskrivelse |
Understøttet rapporttype |
Understøttet rapportkategori |
|---|---|---|---|
|
PARTNER_NAVN |
Partnerens navn |
PARTNER, KUNDE, BRUGER |
Afstemning, tidspunkt |
|
PARTNER_ORG_ID |
Unik partneridentifikator |
PARTNER, KUNDE, BRUGER |
Afstemning, tidspunkt |
|
ABONNEMENT_ID |
Unikt abonnementsidentifikator |
PARTNER, KUNDE, BRUGER |
Afstemning, tidspunkt |
|
SERVICE_NAVN |
Tjenestens navn (f.eks. FÆLLESOMRÅDE_OPKALD, WEBEX__OPKALD , WEBEX_SUITE, WEBEX_MØDER) |
PARTNER, KUNDE, BRUGER |
Afstemning, tidspunkt |
|
SKU |
Sku for tjenesten |
PARTNER, KUNDE, BRUGER |
Afstemning, tidspunkt |
|
BESKRIVELSE |
Beskrivelse af tjenesten |
PARTNER, KUNDE, BRUGER |
Afstemning, tidspunkt |
|
FORBRUG_START_DATO |
Start af serviceforbruget. Sammen med det følgende felt definerer denne værdi brugsperioden. |
PARTNER, KUNDE, BRUGER |
Afstemning |
|
FORBRUG_SLUT_DATO |
Slut på serviceforbruget. Sammen med det foregående felt definerer denne værdi forbrugsperioden. |
PARTNER, KUNDE, BRUGER |
Afstemning |
|
MÆNGDE |
Repræsenterer det samlede brugerforbrug pr. partner, pr. kunde eller pr. bruger (afhængigt af rapporten og det niveau, hvor du ser dataene). Beregning: Systemet beregner den daglige mængde for hver bruger forholdsmæssigt for den pågældende dag. Brug for en hel dag = 1 Brug i en halv dag = 0,5 Derefter summerer den de daglige totaler for alle dage inden for faktureringsperioden for at beregne den samlede mængde for den pågældende bruger inden for den pågældende faktureringsperiode. For rapporter på kunde- og partnerniveau aggregeres totalerne for alle brugere for at give en samlet mængde for den pågældende kunde eller partner. Tidspunkt: Kunderapporten viser pakkeallokeringer pr. kunde. Hver række repræsenterer den samlede mængde af en specifik pakke, der er tildelt brugere eller arbejdsområder inden for en bestemt kundeorganisation. Mængden viser "0", hvis der ikke er allokeret pakker. Brugerrapporten viser de pakker, der er tildelt brugere eller arbejdsområder. Hver række viser antallet 1, der repræsenterer en bruger eller et arbejdsområde og deres individuelle pakke eller tilføjelsesprogram. Hvis flere pakker eller tilføjelser er tildelt en bruger eller et arbejdsområde, viser rapporten flere poster, hver med en mængde 1. |
PARTNER, KUNDE, BRUGER |
Afstemning, tidspunkt |
|
KUNDE_ORG_ID |
Intern kunde unik identifikator |
KUNDE, BRUGER |
Afstemning, tidspunkt |
|
KUNDE_EKSTERN_ID |
Kundens unikke identifikator som angivet af en partner |
KUNDE, BRUGER |
Afstemning, tidspunkt |
|
ABONNENT_ID |
Unik identifikator for abonnenten |
BRUGER |
Afstemning, tidspunkt |
|
BRUGER-ID_ |
Abonnentens Webex-bruger-ID |
BRUGER |
Afstemning, tidspunkt |
|
ARBEJDSOMRÅDE_ID |
Unikt arbejdsområde-id |
BRUGER |
Afstemning, tidspunkt |
|
LOKATION_ID |
Unik lokationsidentifikator |
KUNDE, BRUGER |
Afstemning, tidspunkt |
|
LICENS_ID |
Licensidentifikator Dette felt er kun synligt for engrospakker For afstemningsrapporten er License_ID tomt for licenser, der er tildelt før dette felt blev introduceret. Faktureringsrapporten viser flere rækker for den samme engrospakke, hvis den er knyttet til forskellige kombinationer af LOCATION_ID og LICENSE_ID. |
KUNDE, BRUGER |
Afstemning, tidspunkt |
|
RAPPORT_DATO |
Dato og klokkeslæt for genereringen af rapporten. |
KUNDE, BRUGER |
Tidspunkt |
Klargøring af en pakke til en bruger udløser Webex Wholesale-fakturering, mens fjernelse af pakketildelingen stopper den.