Hvala za povratne informacije.
Povratne informacije?Poročila o obračunu
Partnerji lahko uporabijo naslednje API-je za obračunavanje na debelo za ustvarjanje poročil o obračun avanju, ki jim pomagajo preveriti točnost uporabe in zagotavljanja storitev. API-ji za veleprodajno obračunavanje so dostopni prek developer.webex.com.
-
Usklajevanje — prikazuje porabo uporabe na partnerja, na stranko ali na uporabnika. Partnerji lahko uporabijo te podatke o poročilu o obračunu po meri za uskladitev mesečnega računa, tako da lahko svojim strankam in uporabnikom zaračunajo glede na njihovo porabo.
-
Točka v času — prikazuje trenutne dodelitve paketov na posamezno stranko ali na uporabnika. Poročilo o točkah v času zagotavlja število dodelitev paketov v realnem času. Partnerji lahko s temi informacijami potrdijo točnost zagotavljanja storitev in zagotovijo usklajenost z naročili strank.
Partnerji lahko ustvarjajo tudi poročila o obračunavanju po meri za podpartnerje s parametrom SubPartnerOrgID.
Obstajajo štirje API-ji, ki so na voljo partnerskim skrbnikom, ki izpolnjujejo minimalne zahteve glede dostopa.
|
API za obračunavanje |
Namen API-ja |
Zahteva za dostop skrbnika partnerja |
|---|---|---|
|
Ustvarjanje poročila o obračunavanju na debelo |
Uporablja se za ustvarjanje poročila o obračunu. |
Branje in pisanje |
|
Pridobite poročilo o obračunavanju na debelo |
Uporablja se za prenos ustvarjenega poročila o obračunu. |
Preberi |
|
Seznam poročila o obračunavanju na debelo |
Uporablja se za seznam poročil o obračunu, ki obstajajo za tega partnerja. |
Preberi |
|
Brisanje poročila o obračunavanju na debelo |
Uporablja se za brisanje obstoječega poročila o obračunu. |
Branje in pisanje |
Vir podatkov
Podatki za poročila o obračunavanju so izvlečeni iz dodelitev paketov in podatkov o uporabi, ki jih Webex sledi za vsakega partnerja. Webex dnevno združuje podatke o kupcu in uporabniškem paketu, da ustvari mesečni račun partnerja. API-ji za obračunavanje uporabljajo te podatke in partner skim skrbnikom omogočajo ustvarjanje poročil po meri. Ta poročila partnerjem pomag ajo uskladiti porabo uporabe iz mesečnega računa na ravni partnerja, kupca in uporabnika.
Za podrobnejše informacije o tem, kako Webex izračuna partnerja, glejte Obračunavanje ponudnika storitev.
Ustvarjanje poročila o obračunavanju na debelo
| 1 |
Na spletnem mestu developer.webex.com pojdite na Ustvari API za poročilo o veleprodajnem obračunu. |
| 2 |
Izberite katero koli od naslednjih kategorij poročil:
Če želite ustvariti poročilo o usklajevanju, ni treba ničesar spreminjati, ker je privzeto izbrana usklajevanje, zato lahko nadalju jete z naslednjim korakom. Če želite ustvariti poročilo o točki v času, spremenite izbiro na Točka v času. |
| 3 |
Vnesite billingStartDate in BillingEndDate v obliki, ki jo določa API. Vnesete lahko kateri koli datum iz zadnjih petih let, ne pa trenutnega dne. Za poročilo Point-In-Time polja BillingStartDate in Bill ingEndDate nista obvezna in se pri vno su prezrta. Poročilo vedno odraža trenutne dodelitve svež njev. |
| 4 |
Vnesite vrsto poročila:
|
| 5 |
V polje V klju či vnesite dodatne ali neobvezne stolpce, ki jih želite videti v poročilih. Vsaka vrsta poročila ima nabor obveznih atributov in niz neobveznih atributov. Odločite se lahko, kateri od neobveznih atributov bo prikazan za vsako poročilo. Če izbirnih atributov ne vključite, se v poročilu prikažejo samo obvezni atributi. Naslednji stolpci so neobvezni atributi, ki jih lahko zahtevate vključitev v poročilo o stranki in uporabniku:
Če želite, da CUSTOMER_GROUP_ID so ti atributi prikazani v poročilu, morate vključiti in CUSTOMER_GROUP_NAME skupaj. Ko izberete neobvezne stolpce, se vrstni red stolpcev v poročilih o usklajevanju strank in uporabnikov spremeni. Partnerji morajo posodobiti svojo integracijo API-ja, da sprejmejo novo obliko csv. Vrstni red stolpcev točkovnih poročil ostaja nespremenjen. Trenutno imajo obstoječe nastavitve funkcij pri določanju vrstnega reda stolpcev prednost pred parametrom Vključi. Če je na primer določena nastavitev funkcije omogočena za stranko, se ta stolpec funkcije prikaže v skladu s staro obliko poročila, tudi če jih dodate v parameter Vključi. Te nastavitve bomo kmalu odstranili. Ko so odstranjeni, lahko izbirne stolpce zahtevate samo s parametrom Vključi. |
| 6 |
Kliknite Z až eni, da ustvarite poročilo. |
| 7 |
Kopirajte id poročila iz izhoda API-ja. To vrednost lahko uporabite z API-jem Get, da dobite ustvarjeno poročilo o obračunu. |
Kaj storiti naprej
Če želite prene sti kopijo poročila, pojdite na razdelek Pridobite poročilo o obračunavanju na debelo.
Pridobite poročilo o veleprodajnem obračunu
Ko ustvarite poročilo o obračunu, uporabite ta API za pridobitev določenega poročila o obračunavanju. Poročilo prejme na URL, kjer je na voljo za prenos 30 minut po izpolnitvi zahteve GET.
| 1 |
Na spletnem mestu developer.webex.com pojdite na Pridobite API poročila o veleprodajnem obračunu. |
| 2 |
Vnesite edinst veno vrednost id za poročilo in kliknite Z aženi. API izdaja stanje poročila. Izhod vključuje parameter tempDownloadURL, ki zagotavlja URL, s katerega lahko prenesete poročilo. |
| 3 |
Kopirajte T empDownloadURL v brskalnik, da dostopate in prenesete poročilo. |
Seznam poročila o obračunavanju na debelo
Uporabite ta API za pridobitev seznama ustvarjenih poročil o obračunavanju za partnersko organizacijo. Navedete lahko vsa obstoječa poročila ali omejite seznam na tista poročila, ki ustrezajo določenim parametrom, kot sta obračunsko obdobje in vrsta obračuna (partner, stranka, uporabnik).
Če vnesete neobvezne parametre, API vrne samo tista poročila, ki se natančno ujemajo s parametri, ki ste jih določili. Če na primer določite obračunsko obdobje, se vrnejo samo poročila, ki uporabljajo to določeno obračunsko obdobje. Poroč ila, ki spadajo v obdobje, vendar se ne ujemajo natančno z datumi, se ne vrnejo.
| 1 |
Na spletnem mestu developer.webex.com pojdite na L ist Whol esale Bearing Report API. |
| 2 |
V razdel ku Parametri poizved be vnesite vse parametre iskanja, ki jih želite uporabiti (na primer začetni datum, končni datum, tip, razvrščanje vklopljeno). |
| 3 |
Kliknite Z aženi. API izvede seznam poročil skupaj z edinstvenim ID-jem poročila in statusom (DOKONČANO,IN_PROGRESS).
|
Kaj storiti naprej
Zapišite ID za vsa poročila, ki jih želite prenesti. Če želite prene sti poročilo, pojdite na Pridobite poročilo o obračun avanju na debelo.
Brisanje poročila o obračunavanju na debelo
S tem postopkom izbrišete ustvarjeno poročilo o obračunu na podlagi ID-ja poročila. Nekaj primerov, kjer boste morda želeli izbrisati poročilo, vključuje:
-
Če želite obnoviti obstoječe poročilo o obračunavanju usklajevanja, morate naj prej izbrisati obstoječe poročilo. Ko izbrišete obstoječe poročilo, lahko ustvarite novo poročilo za to obdobje. Poročila ne morete izbrisati, če njegovo ustvar janje ni uspelo ali je še v teku.
Za poročilo o točki v času vam ni treba izbrisati obstoječega poročila, saj sistem teh poročil ne obnavlja. Vsako poročilo vedno odraža podatke trenutnega časovnega žiga.
-
Če pošljete ustvarjeni URL poročila napačni osebi, lahko poročilo izbrišete, tako da ne more dostopati do njega.
| 1 |
Na spletnem mestu developer.webex.com pojdite na Izbri ši API poročila o veleprodajnem obračunu. |
| 2 |
Vnesite ID poročila in kliknite Z aženi. |
Polja poročila o obračunu
Poročila o obračunu vsebujejo naslednja polja:
|
Polje |
Opis |
Podprta vrsta poročila |
Podprta kategorija poročil |
Obvezni ali neobvezni atribut |
|---|---|---|---|---|
|
PARTNER_NAME |
Ime partnerja |
PARTNER, CUSTOMER, USER |
Usklajevanje, točkovno |
Obvezno |
|
PARTNER_ORG_ID |
Edinstven identifikator partnerja |
PARTNER, CUSTOMER, USER |
Usklajevanje, točkovno |
Obvezno |
|
SUBSCRIPTION_ID |
Edinstven identifikator naročnine |
PARTNER, CUSTOMER, USER |
Usklajevanje, točkovno |
Obvezno |
|
CUSTOMER_GROUP_ID | Edinstven identifikator skupine, ki ji pripada stranka. Če se stranka med obračunskim obdobjem premika med skupinami, se uporaba razdeli glede na skupine, v katere je stranka pripadala v tem obdobju. |
CUSTOMER, USER |
Usklajevanje, točkovno |
Neobvezno |
|
CUSTOMER_GROUP_NAME | Prikazano ime skupine strank. Če se je ime skupine spremenilo med obračunskim obdobjem, se uporabi zadnje ime. |
CUSTOMER, USER |
Usklajevanje, točkovno |
Neobvezno |
|
CUSTOMER_ORG_ID |
Notranji edinstveni identifikator stranke |
CUSTOMER, USER |
Usklajevanje, točkovno |
Obvezno |
|
CUSTOMER_EXTERNAL_ID |
Edinstven identifikator stranke, ki ga je zagotovil partner |
CUSTOMER, USER |
Usklajevanje, točkovno |
Obvezno |
|
TYPE |
Vrsta uporabnika ali delovnega prostora |
CUSTOMER, USER |
Točkovno |
Obvezno |
|
SUBSCRIBER_ID |
Edinstven identifikator za naročnika |
USER |
Usklajevanje, točkovno |
Obvezno |
|
USER_ID |
Uporabniški ID naročnika Webex |
USER |
Usklajevanje, točkovno |
Obvezno |
|
WORKSPACE_ID |
Edinstven identifikator delovnega prostora |
USER |
Usklajevanje, točkovno |
Obvezno |
|
SERVICE_NAME |
Ime storitve (npr.COMMON_AREA_CALLING,WEBEX_CALLING,WEBEX_SUITE,WEBEX_MEETINGS) |
PARTNER, CUSTOMER, USER |
Usklajevanje, točkovno |
Obvezno |
|
SKU |
SKU za storitev |
PARTNER, CUSTOMER, USER |
Usklajevanje, točkovno |
Obvezno |
|
DESCRIPTION |
Opis storitve |
PARTNER, CUSTOMER, USER |
Usklajevanje, točkovno |
Obvezno |
|
CONSUMPTION_START_DATE |
Začetek porabe storitve. Skupaj z naslednjim poljem ta vrednost določa obdobje uporabe. |
PARTNER, CUSTOMER, USER |
sprava |
Obvezno |
|
CONSUMPTION_END_DATE |
Konec porabe storitve. Skupaj s prejšnjim poljem ta vrednost določa obdobje porabe uporabe. |
PARTNER, CUSTOMER, USER |
sprava |
Obvezno |
|
REPORT_DATE |
Datum in čas, ko je poročilo ustvarjeno. |
CUSTOMER, USER |
Točkovno |
Obvezno |
|
QUANTITY |
Predstavlja skupno porabo uporabnikov na partnerja, na stranko ali na uporabnika (odvisno od poročila in ravni, na kateri si ogledujete podatke). Izračun: Sistem izračuna količino na dan za vsakega uporabnika sorazmerno za ta dan. Uporaba za cel dan = 1 Uporaba za pol dneva = 0,5 Nato sešteje dnevne vsote za vse dni v obračunskem obdobju, da izračuna skupno količino za tega uporabnika v tem obračunskem obdobju. Za poročila na ravni strank in partnerjev se skupni zneski za vse uporabnike združujejo, da se zagotovi skupna količina za to stranko ali partnerja. Point-In-Time: Poročilo stranke navaja dodelitve paketov na stranko. Vsaka vrstica predstavlja skupno količino določenega paketa, dodeljenega uporabnikom ali delovnim prostorom znotraj določene organizacije strank. Količina prikazuje« 0 », če ni dodeljenih paketov. Uporabniško poročilo navaja pakete, dodeljene uporabnikom ali delovnim prostorom. Vsaka vrstica prikazuje količino 1, ki predstavlja uporabnika ali delovni prostor ter njihov posamezen paket ali dodatek. Če je uporabniku ali delovnemu prostoru dodeljenih več paketov ali dodatkov, poročilo prikazuje več vnosov, vsak s količino 1. |
PARTNER, CUSTOMER, USER |
Usklajevanje, točkovno |
Obvezno |
|
LOCATION_ID |
Edinstven identifikator lokacije |
CUSTOMER, USER |
Usklajevanje, točkovno Poročilo stranke o točki v času ne vključuje identifikatorja lokacije |
Neobvezno |
|
LICENSE_ID |
Identifikator licence To polje je vidno samo za veleprodajne pakete Za poročilo o usklaj License_ID evanju je prazno za licence, dodeljene pred uvedbo tega polja. Poročilo o obračunu prikazuje več vrstic za isti veleprodajni paket, če je povezan z različnimi kombinaci LOCATION_ID jami inLICENSE_ID. |
CUSTOMER, USER |
Usklajevanje, točkovno |
Neobvezno |
Z izbiro neobveznih stolpcev se spremeni vrstni red stolpcev poročil o usklajevanju strank in uporabnikov. Naslednji vrstni red velja za partnerje, ki imajo v naročnini samo veleprodajne SKU:
Poročilo o ravni uporabnika— PARTNER_NAME PARTNER_ORG_ID SUBSCRIPTION_IDCUSTOMER_GROUP_ID,CUSTOMER_GROUP_NAME,CUSTOMER_ORG_ID,CUSTOMER_EXTERNAL_ID,LOCATION_ID,LICENSE_ID,SUBSCRIBER_ID,USER_ID,WORKSPACE_ID,SERVICE_NAME,, SKU, OPIS, CONSUMPTION_START_DATECONSUMPTION_END_DATE, KOLIČINA
Poročilo o ravni PARTNER_NAME stranke— PARTNER_ORG_IDSUBSCRIPTION_ID,CUSTOMER_GROUP_ID,CUSTOMER_GROUP_NAME,CUSTOMER_ORG_ID,CUSTOMER_EXTERNAL_ID,LOCATION_ID,LICENSE_ID,SERVICE_NAME,, SKU, OPIS, CONSUMPTION_START_DATECONSUMPTION_END_DATE, KOLIČINA
Zagotavljanje paketa uporabniku sproži obračunavanje na debelo Webex, odstranitev dodelitve paketa pa ga ustavi.
Organizacija strank lahko kadar koli pripada samo eni skupini strank. Podpora za več skupin strank na organizacijo trenutno ni na voljo.
