Faktureringsrapporter for engrosrute til marked

Faktureringsrapporter

Partnere kan bruke følgende API-er for engrosfakturering til å generere faktureringsrapporter som hjelper dem med å validere bruk og klargjøringsnøyaktighet. API-ene for engrosfakturering er tilgjengelige via developer.webex.com.

Avstemming — Viser forbruket per partner, per kunde eller per bruker. Partnere kan bruke denne egendefinerte fakturerings rapportinformasjonen til å avstemme den månedlige fakturaen slik at de kan fakturere sine kunder og brukere i henhold til bruksforbruket.
Point-In-Time — Viser gjeldende pakketildelinger på per kunde- eller brukernivå. Point-in-Time-rapporten gir en sanntidstelling av pakketildelinger. Partnere kan bruke denne informasjonen til å validere nøyaktigheten av klargjøring og sikre samsvar med kundeordrer.

Partnere kan også generere tilpassede faktureringsrapporter for underpartnere ved hjelp av parameteren SubpartnerOrgID.

Det er fire API-er som er tilgjengelige for partneradministratorer som oppfyller minimumskra vene til tilgang.

Fakturerings-API	Formålet med API	Krav til partneradministrasjonstilgang
Opprette en engrosfaktureringsrapport	Brukes til å generere en faktureringsrapport.	Lese/skrive
Få en engrosfaktureringsrapport	Brukes til å få en generert faktureringsrapport for nedlasting.	Lese
Liste over engrosfaktureringsrapporter	Brukes til å liste opp faktureringsrapportene som finnes for den partneren.	Lese
Slette en engrosfaktureringsrapport	Brukes til å slette en eksisterende faktureringsrapport.	Lese/skrive

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 forbruket 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 Tjenesteleverandørfakturering.

Opprette en engrosfaktureringsrapport

1	Gå til Opprett en API for engrosfaktureringsrapport fra developer.webex.com.
2	Velg en av følgende rapportkategorier: Avstemming (standard) Punkt i tid Hvis du vil generere en avstemningsrapport, er det ikke nødvendig å endre noe fordi Avstemming er valgt som standard, slik at du kan gå videre til neste trinn. Hvis du vil generere en Point-In-Time-rapport, endrer du valget til Point-i-Time.
3	Skriv inn BillingStartDate og BillingEndDate i formatet API-en spesifiserer. Du kan angi hvilken som helst dato fra de siste fem årene, men ikke gjeldende dag. For Point-In-Time-rapporten er feltene BillingStartDate og BillingEndDate ikke obligatoriske og ignoreres hvis de angis. Rapporten gjenspeiler alltid gjeldende pakketil delinger.
4	Skriv inn rapporttypen: PARTNER (standard) — Viser bruksforbruk eller pakketildelinger på partnernivå. Denne typen støttes ikke for Point-In-Time-rapporten. Kunde — viser forbruksforbruk eller pakkeallokeringer fordelt på nivået til kundeorganisasjoner under partneren. Bruker — viser bruksforbruk eller pakkeallokeringer fordelt på nivået til kundeorganisasjoner og abonnenter under partneren.
5	I Inklu der-feltet angir du tilleggskolonnene eller valgfrie kolonnene du vil se i rapportene. Hver rapporttype har et sett med obligatoriske attributter og et sett med valgfrie attributter. Du kan bestemme hvilke av de valgfrie attributtene som skal vises for hver rapport. Hvis du ikke inkluderer de valgfrie attributtene, viser rapporten bare de obligatoriske attributtene. Følgende kolonner er de valgfrie attributtene du kan be om å inkludere i Kunde- og brukerrapporten: CUSTOMER_GROUP_ID CUSTOMER_GROUP_NAME LOCATION_ID LICENSE_ID Du må inkludere CUSTOMER_GROUP_ID og CUSTOMER_GROUP_NAME sammen hvis du vil se disse attributtene i rapporten. Når du velger valgfrie kolonner, endres kolonnerekkefølgen i rapporter om kunde- og brukeravstemming. Partnere må oppdatere API-integrasjonen for å godta det nye csv-formatet. Kolonnerekkefølgen for Point-In-Time-rapporter forblir uendret. For øyeblikket har de eksisterende funksjonsinnstillingene forrang fremfor Include-parameteren når kolonnerekkefølgen bestemmes. Hvis for eksempel en bestemt funksjonsinnstilling er aktivert for en kunde, vises funksjonskolonnen i henhold til det gamle rapportformatet, selv om du legger dem til i Inkluder-parameteren. Vi fjerner disse innstillingene snart. Når de er fjernet, kan du bare be om de valgfrie kolonnene gjennom Inklude-parameteren.
6	Klikk Kjør for å generere rapporten.
7	Kopier rapport -ID fra API-utdataene. Du kan bruke denne verdien med Get API for å hente den genererte faktureringsrapporten.

Hva du skal gjøre videre

Gå til Få en engrosfaktureringsrapport for å laste ned en kopi av rapporten.

Få en engrosfaktureringsrapport

Når en faktureringsrapport er generert, bruk denne API-en for å få en bestemt faktureringsrapport. Rapporten sendes ut til en URL der den er tilgjengelig for nedlasting i 30 minutter etter at GET-forespørselen er fullført.

1	Gå til Få en engrosfaktureringsrapport API fra developer.webex.com.
2	Skriv inn den unike id- verdien for rapporten, og klikk Kj ør. API-utdataene rapporterer status. Utdataene inkluderer parameteren tempDownloadURL, som gir en URL som du kan laste ned rapporten fra.
3	Kopier T empDownloadURL til en nettleser for å få tilgang til og laste ned rapporten.

Liste over engrosfaktureringsrapporter

Bruk denne API-en til å få en liste over genererte faktureringsrapporter for partnerorganisasjonen. Du kan liste opp alle eksisterende rapporter, eller begrense listen til de rapportene som oppfyller de angitte parametrene, for eksempel faktureringsperioden og faktureringstypen (partner, kunde, bruker).

Hvis du angir valgfrie parametere, returnerer API bare de rapportene som samsvarer nøyaktig med parametrene du angir. Hvis du for eksempel angir en fakturerings periode, returneres bare rapporter som bruker den bestemte faktureringsperioden. Rapporter som faller innenfor perioden, men som ikke akkurat samsvarer med datoene, returneres ikke.

1	Gå til List Wholesale Billing Report API fra developer.webex.com.
2	Under Spørringsparametere angir du eventuelle søkeparametere du vil bruke (for eksempel Startdato, Sluttdato, Type, SortBy på).
3	Klikk Kjør. API-en sender ut listen over rapporter sammen med den unike rapport- ID og status (FULLFØRT,IN_PROGRESS).

Hva du skal gjøre videre

Ta en oversikt over ID- en for eventuelle rapporter du vil laste ned. Gå til Få en engrosfaktureringsrapport for å laste ned rapporten.

Slette en engrosfaktureringsrapport

Bruk denne fremgangsmåten til å slette en generert faktureringsrapport basert på rapport-ID. Noen eksempler der du kanskje vil slette en rapport er:

Hvis du vil gjenopprette en eksisterende faktureringsrapport for avstemming, må du først slette den eksisterende rapporten. Når 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 Point-In-Time-rapport trenger du ikke å slette en eksisterende rapport, siden systemet ikke regenererer disse rapportene. Hver rapport gjenspeiler alltid data fra gjeldende tidsstempel.
Hvis du sender en generert rapportadresse til feil person, kan du slette rapporten slik at vedkommende ikke får tilgang til den.

1	Fra developer.webex.com går du til Slett API for engrosfaktureringsrapport.
2	Skriv inn rapport- I den og klikk Kjør.

Faktureringsrapportfelt

Faktureringsrapporter inneholder følgende felt:

Felt	Beskrivelse	Støttet rapporttype	Støttet rapportkategori	Obligatorisk eller Valgfri attributt
PARTNER_NAME	Navn på partner	PARTNER, CUSTOMER, USER	Avstemming, tidspunkt-i-tid	Obligatorisk
PARTNER_ORG_ID	Unik partneridentifikator	PARTNER, CUSTOMER, USER	Avstemming, tidspunkt-i-tid	Obligatorisk
SUBSCRIPTION_ID	Unik abonnementsidentifikator	PARTNER, CUSTOMER, USER	Avstemming, tidspunkt-i-tid	Obligatorisk
CUSTOMER_GROUP_ID	Den unike identifikatoren for gruppen kunden tilhører. Hvis kunden flyttes mellom grupper i løpet av faktureringsperioden, deles bruken basert på gruppene kunden tilhørte i den perioden.	CUSTOMER, USER	Avstemming, tidspunkt-i-tid	Valgfritt
CUSTOMER_GROUP_NAME	Visningsnavn på kundegruppen. Hvis gruppenavnet endres i løpet av faktureringsperioden, brukes det siste navnet.	CUSTOMER, USER	Avstemming, tidspunkt-i-tid	Valgfritt
CUSTOMER_ORG_ID	Intern kundeunik identifikator	CUSTOMER, USER	Avstemming, tidspunkt-i-tid	Obligatorisk
CUSTOMER_EXTERNAL_ID	Kundens unike identifikator som oppgitt av en partner	CUSTOMER, USER	Avstemming, tidspunkt-i-tid	Obligatorisk
TYPE	Bruker- eller arbeidsområdetype	CUSTOMER, USER	Punkt i tid	Obligatorisk
SUBSCRIBER_ID	Unik identifikator for abonnenten	USER	Avstemming, tidspunkt-i-tid	Obligatorisk
USER_ID	Abonnentens Webex-bruker-ID	USER	Avstemming, tidspunkt-i-tid	Obligatorisk
WORKSPACE_ID	Unik arbeidsområde-identifikator	USER	Avstemming, tidspunkt-i-tid	Obligatorisk
SERVICE_NAME	Navn på tjeneste (f.eks,COMMON_AREA_CALLING,WEBEX_CALLING,WEBEX_SUITE,WEBEX_MEETINGS)	PARTNER, CUSTOMER, USER	Avstemming, tidspunkt-i-tid	Obligatorisk
SKU	Sku for tjenesten	PARTNER, CUSTOMER, USER	Avstemming, tidspunkt-i-tid	Obligatorisk
DESCRIPTION	Beskrivelse av tjenesten	PARTNER, CUSTOMER, USER	Avstemming, tidspunkt-i-tid	Obligatorisk
CONSUMPTION_START_DATE	Start av tjenesteforbruket. Sammen med følgende felt definerer denne verdien bruksperioden.	PARTNER, CUSTOMER, USER	Forsoning	Obligatorisk
CONSUMPTION_END_DATE	Slutt på tjenesteforbruket. Sammen med det foregående feltet definerer denne verdien bruksforbruksperioden.	PARTNER, CUSTOMER, USER	Forsoning	Obligatorisk
REPORT_DATE	Dato og klokkeslett da rapporten genereres.	CUSTOMER, USER	Punkt i tid	Obligatorisk
QUANTITY	Representerer det aggregerte brukerforbruket per partner, per kunde eller per bruker (avhengig av rapporten og nivået du viser dataene på). Beregning: Systemet beregner mengden per dag for hver bruker på en forholdsmessig basis for den dagen. Bruk for en hel dag = 1 Bruk i en halv dag = 0,5 Deretter summerer den totalsummen per dag for alle dager i faktureringsperioden for å beregne det totale antallet for brukeren i den faktureringsperioden. For rapporter på kunde- og partnernivå aggregeres totalsummene for alle brukere for å gi et totalt antall for den kunden eller partneren. Point-In-Time: Kunderapporten viser pakketildelinger per kunde. Hver rad representerer den totale mengden av en bestemt pakke som er tilordnet brukere eller arbeidsområder i 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 antall 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 på 1.	PARTNER, CUSTOMER, USER	Avstemming, tidspunkt-i-tid	Obligatorisk
LOCATION_ID	Unik stedsidentifikator	CUSTOMER, USER	Avstemming, tidspunkt-i-tid Kundepunkt-i-tid-rapporten inkluderer ikke posisjons-ID	Valgfritt
LICENSE_ID	Lisensidentifikator Dette feltet er bare synlig for engrospakker For Avstemningsrapport License_ID er det tomt for lisenser som er tildelt før innføringen av dette feltet. Faktureringsrapporten viser flere rader for samme engrospakke hvis den er knyttet til forskjellige kombinasjoner av LOCATION_ID ogLICENSE_ID.	CUSTOMER, USER	Avstemming, tidspunkt-i-tid	Valgfritt

Hvis du velger valgfrie kolonner, endres kolonnerekkefølgen for rapporter om kunde- og brukeravstemming. Følgende rekkefølge gjelder for partnere med bare engros-SKU-er i abonnementet:

Brukernivårapport—PARTNER_NAME,PARTNER_ORG_ID,SUBSCRIPTION_ID,CUSTOMER_GROUP_ID,CUSTOMER_GROUP_NAME,CUSTOMER_ORG_ID,CUSTOMER_EXTERNAL_ID,LOCATION_ID,LICENSE_ID,SUBSCRIBER_ID,USER_ID,WORKSPACE_ID, SKUSERVICE_NAME, BESKRIVELSE,, CONSUMPTION_START_DATECONSUMPTION_END_DATE, MENGDE

Kundenivårapport— PARTNER_NAMEPARTNER_ORG_ID,SUBSCRIPTION_ID,CUSTOMER_GROUP_ID,,CUSTOMER_GROUP_NAME,CUSTOMER_ORG_ID,CUSTOMER_EXTERNAL_ID,LOCATION_ID,LICENSE_ID, SKUSERVICE_NAME, BESKRIVELSE,, CONSUMPTION_START_DATECONSUMPTION_END_DATE, KVANTITET

Å klargjøre en pakke til en bruker utløser Webex Wholesale fakturering, mens fjerning av pakketildelingen stopper den.

En kundeorganisasjon kan tilhøre bare én kundegruppe til enhver tid. Støtte for flere kundegrupper per organisasjon er for øyeblikket ikke tilgjengelig.

Cisco AI Assistant

Takk for tilbakemeldingen.