Poročila o obračunavanju na debelo od poti do trga

Poročila o obračunavanju

Partnerji lahko za ustvarjanje poročil o obračunavanju, ki jim pomagajo preveriti natančnost uporabe in zagotavljanja, uporabijo naslednje veleprodajne API-je za obračunavanje. API-ji za veleprodajno fakturiranje so dostopni prek spletnega mesta developer.webex.com.

Usklajevanje – prikazuje porabo na ravni partnerja, stranke ali uporabnika. Partnerji lahko uporabijo te podatke iz poročila o obračunavanju po meri za uskladitev svojih mesečnih računov, da lahko svojim strankam in uporabnikom zaračunajo glede na njihovo porabo.
Točka v času – prikazuje trenutne dodelitve paketov na stranko ali na uporabnika. Poročilo Point-In-Time (trenutno stanje) prikazuje število dodelitev paketov v realnem času. Partnerji lahko te podatke uporabijo za preverjanje točnosti rezervacij in zagotavljanje skladnosti z naročili strank.

Partnerji lahko ustvarijo tudi poročila o obračunavanju po meri za podpartnerje z uporabo parametra subPartnerOrgId.

Partnerskim skrbnikom, ki izpolnjujejo minimalne zahteve za dostop, so na voljo štirje API-ji.

API za obračunavanje	Namen API-ja	Zahteva za dostop skrbnika partnerja
Ustvari poročilo o veleprodajnem obračunavanju	Uporablja se za ustvarjanje poročila o obračunavanju.	Read/write
Pridobite poročilo o veleprodajnem obračunavanju	Uporablja se za prenos generiranega poročila o obračunavanju.	Preberi
Seznam poročil o veleprodajnem obračunavanju	Uporablja se za seznam poročil o obračunavanju, ki obstajajo za tega partnerja.	Preberi
Brisanje poročila o veleprodajnem obračunavanju	Uporablja se za brisanje obstoječega poročila o obračunavanju.	Read/write

Vir podatkov

Podatki za poročila o obračunavanju se pridobivajo iz dodelitev paketov in podatkov o uporabi, ki jih Webex spremlja za vsakega partnerja. Webex dnevno združuje podatke o strankah in uporabniških paketih, da ustvari mesečni račun partnerja. API-ji za obračunavanje uporabljajo te podatke, kar omogoča skrbnikom partnerjev ustvarjanje poročil po meri. Ta poročila pomagajo partnerjem uskladiti porabo iz mesečnega računa na ravni partnerja, stranke in uporabnika.

Za podrobnejše informacije o tem, kako Webex izstavlja račune partnerjem, glejte Obračunavanje ponudnikov storitev.

Ustvari poročilo o obračunavanju na debelo

1	Na spletni strani developer.webex.compojdite na Ustvarjanje API-ja za poročila o veleprodajnem obračunavanju.
2	Izberite eno od naslednjih kategorij poročil: Usklajevanje (privzeto) Časovna točka Če želite ustvariti poročilo o usklajevanju, vam ni treba ničesar spreminjati, ker je Usklajevanje privzeto izbrano, zato lahko nadaljujete z naslednjim korakom. Če želite ustvariti poročilo do določenega trenutka, spremenite izbiro na Do določenega trenutka.
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« polji billingStartDate in billingEndDate nista obvezni in se prezreta, če ju vnesete. Poročilo vedno odraža trenutne dodelitve paketov.
4	Vnesite vrsto poročila: PARTNER (privzeto) – prikazuje porabo ali dodelitve paketov na ravni partnerja. Ta vrsta ni podprta za poročilo od točke do točke. STRANKA – Prikazuje porabo ali dodelitve paketov, razčlenjene na raven organizacij strank pod partnerjem. UPORABNIK – Prikazuje porabo ali dodelitve paketov, razčlenjene na raven organizacij strank in naročnikov v okviru partnerja.
5	V polje Vključi vnesite dodatne ali izbirne stolpce, ki jih želite videti v poročilih. Vsaka vrsta poročila ima nabor obveznih atributov in nabor izbirnih atributov. Za vsako poročilo se lahko odločite, katere od neobveznih atributov želite prikazati. Če ne vključite neobveznih atributov, poročilo prikaže samo obvezne atribute. Naslednji stolpci so izbirni atributi, ki jih lahko zahtevate za vključitev v poročilo o strankah in uporabnikih: ID SKUPINE STRANKE__ IME STRANKE_SKUPINA_ ID LOKACIJE_ LICENCA_ID Če želite, da se ti atributi prikažejo v poročilu, morate skupaj vključiti ID_SKUPINE STRANKE_in IME SKUPINE STRANKE__. Ko izberete izbirne stolpce, se vrstni red stolpcev v poročilih Uskladitev strank in uporabnikov spremeni. Partnerji morajo posodobiti svojo integracijo API-ja, da bodo lahko sprejeli novo obliko zapisa csv. Vrstni red stolpcev v poročilih do določene točke v času ostane nespremenjen. Trenutno imajo obstoječe nastavitve funkcij prednost pred parametrom Vključi pri določanju vrstnega reda stolpcev. Če je na primer za stranko omogočena določena nastavitev funkcije, se ta stolpec funkcij prikaže v stari obliki poročila, tudi če jih dodate v parameter Vključi. Te nastavitve bomo kmalu odstranili. Ko so odstranjeni, lahko izbirne stolpce zahtevate le s parametrom Vključi.
6	Kliknite Zaženi, da ustvarite poročilo.
7	Kopirajte poročilo id iz izhoda API-ja. To vrednost lahko uporabite z API-jem Get, da dobite ustvarjeno poročilo o obračunavanju.

Kaj storiti naprej

Za prenos kopije poročila pojdite v razdelek Pridobi poročilo o veleprodajnem obračunavanju.

Pridobite poročilo o obračunavanju na debelo

Ko je poročilo o obračunavanju ustvarjeno, uporabite ta API za pridobitev določenega poročila o obračunavanju. Poročilo se pošlje na URL, kjer je na voljo za prenos 30 minut po zaključku zahteve GET.

1	Na spletni strani developer.webex.compojdite na Pridobi API za poročila o veleprodajnem obračunavanju.
2	Vnesite edinstveno vrednost id za poročilo in kliknite Zaženi. Izhodi API-ja poročajo o stanju. Izhod vključuje parameter tempDownloadURL, ki zagotavlja URL, s katerega lahko prenesete poročilo.
3	Za dostop do poročila in prenos ga kopirajte tempDownloadURL v brskalnik.

Seznam poročil o veleprodajnem obračunavanju

S tem API-jem pridobite seznam ustvarjenih poročil o obračunavanju za partnersko organizacijo. Navedete lahko vsa obstoječa poročila ali pa seznam omejite na tista poročila, ki ustrezajo določenim parametrom, kot sta obračunsko obdobje in vrsta obračunavanja (partner, stranka, uporabnik).

Če vnesete neobvezne parametre, API vrne le tista poročila, ki se natančno ujemajo z določenimi parametri. Č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	Iz developer.webex.compojdite na Seznam API-ja za poročila o veleprodajnem obračunavanju.
2	V razdelku Parametri poizvedbevnesite poljubne parametre iskanja, ki jih želite uporabiti (na primer začetniDatum, končniDatum, Vrsta, sortBy na).
3	Kliknite Zaženi. API izpiše seznam poročil skupaj z edinstvenim ID-jem poročila in stanjem (ZAKLJUČENO, V_TEKU).

Kaj storiti naprej

Za vsa poročila, ki jih želite prenesti, si zabeležite id. Za prenos poročila pojdite na Pridobi poročilo o veleprodajnem obračunavanju.

Brisanje poročila o obračunavanju na debelo

S tem postopkom izbrišete ustvarjeno poročilo o obračunavanju na podlagi ID-ja poročila. Nekaj primerov, ko boste morda želeli izbrisati poročilo, vključuje:

Če želite ponovno ustvariti obstoječe poročilo o usklajevanju obračunavanja, morate najprej izbrisati obstoječe poročilo. Ko izbrišete obstoječe poročilo, lahko za to obdobje ustvarite novo poročilo. Poročila ne morete izbrisati, če njegovo ustvarjanje ni uspelo ali je še v teku.

Za poročilo do določene točke v času vam ni treba izbrisati obstoječega poročila, saj sistem teh poročil ne ustvari ponovno. Vsako poročilo vedno odraža podatke od trenutnega časovnega žiga.
Če pošljete URL generiranega poročila napačni osebi, ga lahko izbrišete, da do njega ne bo mogla dostopati.

1	Na spletni strani developer.webex.compojdite na Brisanje API-ja za poročila o veleprodajnem obračunavanju.
2	Vnesite poročilo ID in kliknite Zaženi.

Polja poročila o obračunavanju

Poročila o obračunavanju vsebujejo naslednja polja:

Polje	Opis	Podprta vrsta poročila	Podprta kategorija poročil	Obvezni ali neobvezni atribut
IME PARTNERJA_	Ime partnerja	PARTNER, STRANKA, UPORABNIK	Usklajevanje, trenutek v času	Obvezno
ID PARTNERJA_ORG._	Enolični identifikator partnerja	PARTNER, STRANKA, UPORABNIK	Usklajevanje, trenutek v času	Obvezno
NAROČNINA_ID	Enolični identifikator naročnine	PARTNER, STRANKA, UPORABNIK	Usklajevanje, trenutek v času	Obvezno
ID SKUPINE STRANKE__	Enolični identifikator skupine, ki ji stranka pripada. Če se stranka med obračunskim obdobjem premakne med skupinami, se poraba razdeli glede na skupine, katerim je stranka pripadala v tem obdobju.	STRANKA, UPORABNIK	Usklajevanje, trenutek v času	Izbirno
IME STRANKE_SKUPINA_	Prikazno ime skupine strank. Če se je ime skupine med obračunskim obdobjem spremenilo, se uporabi najnovejše ime.	STRANKA, UPORABNIK	Usklajevanje, trenutek v času	Izbirno
ID STRANKE_ORG_	Notranji enolični identifikator stranke	STRANKA, UPORABNIK	Usklajevanje, trenutek v času	Obvezno
STRANKA_ZUNANJI_ID	Enolični identifikator stranke, ki ga zagotovi partner	STRANKA, UPORABNIK	Usklajevanje, trenutek v času	Obvezno
VRSTA	Vrsta uporabnika ali delovnega prostora	STRANKA, UPORABNIK	Časovna točka	Obvezno
ID NAROČNIKA_	Enolični identifikator za naročnika	UPORABNIK	Usklajevanje, trenutek v času	Obvezno
UPORABNIK_ID	Uporabniško ime naročnika za Webex	UPORABNIK	Usklajevanje, trenutek v času	Obvezno
ID DELOVNEGA PROSTORA_	Enolični identifikator delovnega prostora	UPORABNIK	Usklajevanje, trenutek v času	Obvezno
IME STORITVE_	Ime storitve (npr. SKUPNI_OBMOČJE_KLIC, WEBEX_KLIC, WEBEX_SUITE, WEBEX_SESTANKI)	PARTNER, STRANKA, UPORABNIK	Usklajevanje, trenutek v času	Obvezno
SKU	SKU za storitev	PARTNER, STRANKA, UPORABNIK	Usklajevanje, trenutek v času	Obvezno
OPIS	Opis storitve	PARTNER, STRANKA, UPORABNIK	Usklajevanje, trenutek v času	Obvezno
PORABA_ZAČETEK_DATUM	Začetek porabe storitve. Skupaj z naslednjim poljem ta vrednost določa obdobje uporabe.	PARTNER, STRANKA, UPORABNIK	Uskladitev	Obvezno
PORABA_KONEC_DATUM	Konec porabe storitve. Skupaj s prejšnjim poljem ta vrednost določa obdobje porabe.	PARTNER, STRANKA, UPORABNIK	Uskladitev	Obvezno
POROČILO_DATUM	Datum in ura, ko je bilo poročilo ustvarjeno.	STRANKA, UPORABNIK	Časovna točka	Obvezno
KOLIČINA	Predstavlja združeno 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 dnevno količino 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žijo, da se dobi skupna količina za to stranko ali partnerja. Časovna točka: Poročilo o strankah navaja dodelitve paketov na stranko. Vsaka vrstica predstavlja skupno količino določenega paketa, dodeljenega uporabnikom ali delovnim prostorom znotraj določene organizacije stranke. Količina prikazuje »0«, če ni dodeljenih paketov. V uporabniškem poročilu so navedeni paketi, dodeljeni uporabnikom ali delovnim prostorom. Vsaka vrstica prikazuje količino 1, ki predstavlja uporabnika ali delovni prostor in njegov posamezni paket ali dodatek. Če je uporabniku ali delovnemu prostoru dodeljenih več paketov ali dodatkov, poročilo prikaže več vnosov, vsak s količino 1.	PARTNER, STRANKA, UPORABNIK	Usklajevanje, trenutek v času	Obvezno
ID LOKACIJE_	Enolični identifikator lokacije	STRANKA, UPORABNIK	Usklajevanje, trenutek v času Poročilo o strankinih točkah v času ne vključuje ID-ja lokacije	Izbirno
LICENCA_ID	Identifikator licence To polje je vidno samo za veleprodajne pakete Za poročilo o usklajevanju je polje License_ID prazno za licence, dodeljene pred uvedbo tega polja. Poročilo o obračunavanju prikazuje več vrstic za isti veleprodajni paket, če je povezan z različnimi kombinacijami ID-ja LOKACIJE_in ID-ja LICENCE_.	STRANKA, UPORABNIK	Usklajevanje, trenutek v času	Izbirno

Z izbiro izbirnih stolpcev se spremeni vrstni red stolpcev v poročilih o usklajevanju strank in uporabnikov. Naslednji vrstni red velja za partnerje, ki imajo v naročnini samo veleprodajne artikle:

Poročilo na ravni uporabnika – IME PARTNERJA_, ID ORGANIZACIJE__, ID NAROČNINE_, ID STRANKE__, ID SKUPINE_, IME STRANKE_], ID ORGANIZACIJE__, ID STRANKE_, ZUNANJI ID [_, ID LOKACIJE_, ID LICENCE [_, ID NAROČNIKA_, ID UPORABNIKA__, ID DELOVNEGA PROSTORA_, IME STORITVE [], SKU, OPIS, DATUM ZAČETKA__, DATUM KONCA__, KOLIČINA

Poročilo na ravni stranke – IME PARTNERJA_, ID ORGANIZACIJE__, ID NAROČNINE_, ID SKUPINE STRANKE [__, ID SKUPINE STRANKE_, IME SKUPINE STRANKE__, ID ORGANIZACIJE__, ID STRANKE__] ZUNANJI [] ID, ID LOKACIJE , ID LICENCE_, ID STORITVE_IME, SKU, OPIS, PORABA_ZAČETNI DATUM_, DATUM PORABE_KONEC_, KOLIČINA

Dodelitev paketa uporabniku sproži obračunavanje Webex Wholesale, odstranitev dodelitve paketa pa ga ustavi.

Organizacija strank lahko v danem trenutku pripada samo eni skupini strank. Podpora za več skupin strank na organizacijo trenutno ni na voljo.

Cisco AI Assistant

Hvala za povratne informacije.