Ďakujeme za vašu spätnú väzbu.
Spätná väzba?Fakturačné prehľady
Partneri môžu použiť nasledujúce rozhrania API pre veľkoobchodnú fakturáciu na generovanie fakturačných zostáv, ktoré im pomáhajú overiť presnosť používania a poskytovania. Rozhrania API pre veľkoobchodnú fakturáciu sú dostupné prostredníctvom stránky developer.webex.com.
-
Zosúladenie – zobrazuje spotrebu na úrovni partnera, zákazníka alebo používateľa. Partneri môžu použiť tieto informácie z vlastnej fakturačnej správy na zosúladenie svojich mesačných faktúr, aby mohli fakturovať svojim zákazníkom a používateľom podľa ich spotreby.
-
Bod v čase – zobrazuje aktuálne pridelenie balíkov na úroveň zákazníka alebo používateľa. Správa Point-In-Time poskytuje počet alokácií balíkov v reálnom čase. Partneri môžu tieto informácie použiť na overenie presnosti poskytovania služieb a zabezpečenie súladu s objednávkami zákazníkov.
Partneri môžu tiež generovať vlastné fakturačné prehľady pre subpartnerov pomocou parametra subPartnerOrgId.
Pre partnerských administrátorov, ktorí spĺňajú minimálne požiadavky na prístup, sú k dispozícii štyri rozhrania API.
|
Fakturačné API |
Účel API |
Požiadavka na prístup správcu partnera |
|---|---|---|
|
Vytvorenie prehľadu o veľkoobchodnej fakturácii |
Používa sa na generovanie fakturačnej správy. |
Read/write |
|
Získajte správu o veľkoobchodnej fakturácii |
Používa sa na získanie vygenerovaného prehľadu fakturácie na stiahnutie. |
Prečítajte si |
|
Zoznam veľkoobchodných fakturačných prehľadov |
Používa sa na zobrazenie zoznamu fakturačných prehľadov, ktoré existujú pre daného partnera. |
Prečítajte si |
|
Odstránenie prehľadu o veľkoobchodnej fakturácii |
Používa sa na odstránenie existujúceho prehľadu fakturácie. |
Read/write |
Zdroj údajov
Údaje pre fakturačné správy sa získavajú z priradení balíkov a údajov o používaní, ktoré Webex sleduje pre každého partnera. Webex denne agreguje údaje o balíkoch zákazníkov a používateľov, aby vygeneroval mesačnú faktúru partnera. Fakturačné rozhrania API používajú tieto údaje, čo umožňuje správcom partnerov generovať vlastné prehľady. Tieto prehľady pomáhajú partnerom zosúladiť spotrebu z ich mesačnej faktúry na úrovni partnera, zákazníka a používateľa.
Podrobnejšie informácie o tom, ako Webex fakturuje partnerom, nájdete v časti Fakturácia poskytovateľa služieb.
Vytvorenie prehľadu o fakturácii za veľkoobchod
| 1 |
Z developer.webex.comprejdite na Vytvorenie rozhrania API pre veľkoobchodnú fakturačnú správu. |
| 2 |
Vyberte si jednu z nasledujúcich kategórií prehľadov:
Ak chcete vygenerovať zostavu o zosúladení, nie je potrebné nič meniť, pretože možnosť Zosúladenie je predvolene vybratá, takže môžete prejsť na ďalší krok. Ak chcete vygenerovať správu k určitému bodu v čase, zmeňte výber na možnosť K určitému bodu v čase. |
| 3 |
Zadajte billingStartDate a billingEndDate vo formáte, ktorý určuje rozhranie API. Môžete zadať ľubovoľný dátum z posledných piatich rokov, ale nie aktuálny deň. V prehľade k určitému bodu v čase nie sú polia billingStartDate a billingEndDate povinné a ak sú zadané, ignorujú sa. Správa vždy odráža aktuálne pridelenie balíkov. |
| 4 |
Zadajte typ hlásenia:
|
| 5 |
Do poľa Zahrnúť zadajte ďalšie alebo voliteľné stĺpce, ktoré chcete zobraziť v prehľadoch. Každý typ zostavy má sadu povinných atribútov a sadu voliteľných atribútov. Môžete sa rozhodnúť, ktoré z voliteľných atribútov sa majú zobraziť pre každú správu. Ak nezahrniete voliteľné atribúty, v zostave sa zobrazia iba povinné atribúty. Nasledujúce stĺpce predstavujú voliteľné atribúty, ktoré môžete na požiadanie zahrnúť do prehľadu Zákazník a Používateľ:
Ak chcete, aby sa tieto atribúty zobrazovali vo vašej správe, musíte spolu zahrnúť ID SKUPINY_ZÁKAZNÍKA_a NÁZOV SKUPINY ZÁKAZNÍKA__. Keď vyberiete voliteľné stĺpce, poradie stĺpcov v zostavách Odsúhlasenie zákazníkov a používateľov sa zmení. Partneri musia aktualizovať svoju integráciu API, aby akceptovali nový formát CSV. Poradie stĺpcov v prehľadoch k určitému bodu v čase zostáva nezmenené. V súčasnosti majú existujúce nastavenia funkcií pri určovaní poradia stĺpcov prednosť pred parametrom Zahrnúť. Napríklad, ak je pre zákazníka povolené konkrétne nastavenie funkcie, stĺpec tejto funkcie sa zobrazí v starom formáte prehľadu, aj keď ho pridáte do parametra Zahrnúť. Tieto nastavenia čoskoro odstránime. Po ich odstránení môžete voliteľné stĺpce vyžiadať iba prostredníctvom parametra Include. |
| 6 |
Kliknite na Spustiť pre generovanie správy. |
| 7 |
Skopírujte identifikátor správy z výstupu rozhrania API. Túto hodnotu môžete použiť s rozhraním Get API na získanie vygenerovaného prehľadu o fakturácii. |
Čo robiť ďalej
Prejdite do sekcie Získať správu o fakturácii za veľkoobchod a stiahnite si kópiu správy.
Získajte správu o fakturácii za veľkoobchod
Po vygenerovaní prehľadu o fakturácii použite toto rozhranie API na získanie konkrétneho prehľadu o fakturácii. Výstup správy sa odošle na URL adresu, kde je k dispozícii na stiahnutie 30 minút po dokončení požiadavky GET.
| 1 |
Z developer.webex.comprejdite na Získajte API pre veľkoobchodné fakturačné správy. |
| 2 |
Zadajte jedinečnú hodnotu id pre správu a kliknite na Spustiť. Výstupy API hlásia stav. Výstup obsahuje parameter tempDownloadURL, ktorý poskytuje URL adresu, z ktorej si môžete stiahnuť zostavu. |
| 3 |
Skopírujte tempDownloadURL do prehliadača, aby ste získali prístup k prehľadu a stiahli ho. |
Zoznam veľkoobchodných fakturačných prehľadov
Toto rozhranie API použite na získanie zoznamu vygenerovaných fakturačných prehľadov pre partnerskú organizáciu. Môžete zobraziť všetky existujúce prehľady alebo obmedziť zoznam na tie prehľady, ktoré spĺňajú zadané parametre, ako napríklad fakturačné obdobie a typ fakturácie (partner, zákazník, používateľ).
Ak zadáte voliteľné parametre, rozhranie API vráti iba tie prehľady, ktoré presne zodpovedajú zadaným parametrom. Napríklad, ak zadáte fakturačné obdobie, vrátia sa iba zostavy, ktoré používajú toto konkrétne fakturačné obdobie. Správy, ktoré spadajú do daného obdobia, ale nezodpovedajú presne dátumom, sa nevracajú.
| 1 |
Z developer.webex.comprejdite na List Wholesale Billing Report API. |
| 2 |
V časti Parametre dopytuzadajte ľubovoľné parametre vyhľadávania, ktoré chcete použiť (napríklad počiatočný dátum, koncový dátum, typ, zoradiť podľa). |
| 3 |
Kliknite na Spustiť. API vygeneruje zoznam reportov spolu s jedinečným ID reportu a stavom (DOKONČENÉ, V SPRACOVANÍ_).
|
Čo robiť ďalej
Zaznamenajte si id pre všetky prehľady, ktoré chcete stiahnuť. Pre stiahnutie správy prejdite na Získať správu o fakturácii za veľkoobchod.
Odstránenie prehľadu o fakturácii veľkoobchodu
Tento postup použite na odstránenie vygenerovaného prehľadu fakturácie na základe ID prehľadu. Niekoľko príkladov, kedy môžete chcieť odstrániť prehľad, zahŕňa:
-
Ak chcete znovu vytvoriť existujúcu zostavu fakturácie zosúladenia, musíte najprv existujúcu zostavu odstrániť. Po odstránení existujúcej správy môžete pre dané obdobie vytvoriť novú správu. Prehľad nie je možné odstrániť, ak jeho generovanie zlyhalo alebo stále prebieha.
V prípade prehľadu k určitému bodu v čase nie je potrebné odstrániť existujúci prehľad, pretože systém tieto prehľady negeneruje. Každá správa vždy zobrazuje údaje k aktuálnej časovej pečiatke.
-
Ak odošlete vygenerovanú URL adresu prehľadu nesprávnej osobe, môžete prehľad odstrániť, aby k nemu nemala prístup.
| 1 |
Z developer.webex.comprejdite na Odstrániť rozhranie API pre správu o veľkoobchodnej fakturácii. |
| 2 |
Zadajte ID prehľadu a kliknite na tlačidlo Spustiť. |
Polia prehľadu fakturácie
Fakturačné prehľady obsahujú nasledujúce polia:
|
Pole |
Opis |
Podporovaný typ prehľadu |
Podporovaná kategória prehľadov |
Povinný alebo voliteľný atribút |
|---|---|---|---|---|
|
MENO PARTNERA_ |
Meno partnera |
PARTNER, ZÁKAZNÍK, POUŽÍVATEĽ |
Zosúladenie, bod v čase |
Povinné |
|
ID PARTNERA_ORGANIZÁCIE_ |
Jedinečný identifikátor partnera |
PARTNER, ZÁKAZNÍK, POUŽÍVATEĽ |
Zosúladenie, bod v čase |
Povinné |
|
ID PREDPLATNÉHO_ |
Jedinečný identifikátor predplatného |
PARTNER, ZÁKAZNÍK, POUŽÍVATEĽ |
Zosúladenie, bod v čase |
Povinné |
|
ID SKUPINY ZÁKAZNÍKA__ | Jedinečný identifikátor skupiny, do ktorej zákazník patrí. Ak sa zákazník počas fakturačného obdobia presunie medzi skupinami, spotreba sa rozdelí na základe skupín, do ktorých zákazník počas daného obdobia patril. |
ZÁKAZNÍK, POUŽÍVATEĽ |
Zosúladenie, bod v čase |
Voliteľné |
|
NÁZOV SKUPINY ZÁKAZNÍKA__ | Zobrazovaný názov skupiny zákazníkov. Ak sa názov skupiny počas fakturačného obdobia zmenil, použije sa najnovší názov. |
ZÁKAZNÍK, POUŽÍVATEĽ |
Zosúladenie, bod v čase |
Voliteľné |
|
ID ZÁKAZNÍKA_ORG_ |
Interný jedinečný identifikátor zákazníka |
ZÁKAZNÍK, POUŽÍVATEĽ |
Zosúladenie, bod v čase |
Povinné |
|
ZÁKAZNÍK_EXTERNÉ_ID |
Jedinečný identifikátor zákazníka poskytnutý partnerom |
ZÁKAZNÍK, POUŽÍVATEĽ |
Zosúladenie, bod v čase |
Povinné |
|
TYP |
Typ používateľa alebo pracovného priestoru |
ZÁKAZNÍK, POUŽÍVATEĽ |
Bod v čase |
Povinné |
|
ID PREDPLATITEĽA_ |
Jedinečný identifikátor predplatiteľa |
POUŽÍVATEĽ |
Zosúladenie, bod v čase |
Povinné |
|
ID POUŽÍVATEĽA_ |
ID používateľa Webexu predplatiteľa |
POUŽÍVATEĽ |
Zosúladenie, bod v čase |
Povinné |
|
ID PRACOVNÉHO PRIESTORU_ |
Jedinečný identifikátor pracovného priestoru |
POUŽÍVATEĽ |
Zosúladenie, bod v čase |
Povinné |
|
NÁZOV SLUŽBY_ |
Názov služby (napr. SPOLOČNÁ_PRIESTOR_VOLANIE, WEBEX_VOLANIE, WEBEX_BALÍK, WEBEX_STRETNUTIA) |
PARTNER, ZÁKAZNÍK, POUŽÍVATEĽ |
Zosúladenie, bod v čase |
Povinné |
|
SKU |
SKU pre službu |
PARTNER, ZÁKAZNÍK, POUŽÍVATEĽ |
Zosúladenie, bod v čase |
Povinné |
|
POPIS |
Popis služby |
PARTNER, ZÁKAZNÍK, POUŽÍVATEĽ |
Zosúladenie, bod v čase |
Povinné |
|
SPOTREBA_ZAČIATOK_DÁTUM |
Začiatok spotreby služby. Spolu s nasledujúcim poľom táto hodnota definuje obdobie používania. |
PARTNER, ZÁKAZNÍK, POUŽÍVATEĽ |
Zmierenie |
Povinné |
|
SPOTREBA_KONIEC_DÁTUM |
Koniec spotreby služby. Spolu s predchádzajúcim poľom táto hodnota definuje obdobie spotreby. |
PARTNER, ZÁKAZNÍK, POUŽÍVATEĽ |
Zmierenie |
Povinné |
|
DÁTUM SPRÁVY_ |
Dátum a čas vygenerovania správy. |
ZÁKAZNÍK, POUŽÍVATEĽ |
Bod v čase |
Povinné |
|
MNOŽSTVO |
Predstavuje agregovanú spotrebu používateľov na partnera, na zákazníka alebo na používateľa (v závislosti od zostavy a úrovne, na ktorej si prezeráte údaje). Výpočet: Systém vypočíta denné množstvo pre každého používateľa pomerne k danému dňu. Používanie počas celého dňa = 1 Používanie na pol dňa = 0,5 Potom sčíta denné súčty za všetky dni v rámci fakturačného obdobia, aby vypočítal celkové množstvo pre daného používateľa v rámci daného fakturačného obdobia. V prípade prehľadov na úrovni zákazníkov a partnerov sa súčty pre všetkých používateľov agregujú, aby sa získal celkový objem pre daného zákazníka alebo partnera. Bod v čase: V správe o zákazníkovi sú uvedené pridelenia balíkov pre každého zákazníka. Každý riadok predstavuje celkové množstvo konkrétneho balíka priradeného používateľom alebo pracovným priestorom v rámci konkrétnej organizácie zákazníka. Ak nie sú pridelené žiadne balíky, v poli Množstvo sa zobrazuje hodnota „0“. V správe o používateľoch sú uvedené balíky priradené používateľom alebo pracovným priestorom. Každý riadok zobrazuje množstvo 1, ktoré predstavuje používateľa alebo pracovný priestor a jeho individuálny balík alebo doplnok. Ak je používateľovi alebo pracovnému priestoru pridelených viacero balíkov alebo doplnkov, v správe sa zobrazí viacero položiek, každá s množstvom 1. |
PARTNER, ZÁKAZNÍK, POUŽÍVATEĽ |
Zosúladenie, bod v čase |
Povinné |
|
ID LOKALITY_ |
Jedinečný identifikátor polohy |
ZÁKAZNÍK, POUŽÍVATEĽ |
Zosúladenie, bod v čase Správa o čase zákazníka neobsahuje ID lokality |
Voliteľné |
|
LICENCIA_ID |
Identifikátor licencie Toto pole je viditeľné iba pre veľkoobchodné balíky V prípade zostavy zosúladenia je pole License_ID prázdne pre licencie priradené pred zavedením tohto poľa. Fakturačná správa zobrazuje viacero riadkov pre ten istý veľkoobchodný balík, ak je priradený k rôznym kombináciám ID LOKÁCIE_a ID LICENCIE_. |
ZÁKAZNÍK, POUŽÍVATEĽ |
Zosúladenie, bod v čase |
Voliteľné |
Výberom voliteľných stĺpcov sa upraví poradie stĺpcov v prehľadoch Odsúhlasenie zákazníkov a používateľov. Nasledujúce poradie platí pre partnerov, ktorí majú v predplatnom iba veľkoobchodné skladové jednotky (SKU):
Správa na úrovni používateľa – NÁZOV PARTNERA_, ID PARTNERA_ORG_, ID PREDPLATNÉHO_, ID ZÁKAZNÍKA_SKUPINY_, NÁZOV SKUPINY__, ID ZÁKAZNÍKA_ORG_, ID ZÁKAZNÍKA_EXTERNÉ_ID, ID LOKALITY_, ID LICENCIE_, ID PREDPLATITEĽA_, ID POUŽÍVATEĽA_, ID PRACOVNÉHO PRIESTORU_, NÁZOV SLUŽBY_, SKU, POPIS, SPOTREBA_DÁTUM ZAČIATKU_, SPOTREBA_DÁTUM KONCA_, MNOŽSTVO
Správa na úrovni zákazníka – NÁZOV PARTNERA_, ID PARTNERA_ORG_, ID PREDPLATNÉHO_, ID SKUPINY ZÁKAZNÍKA__, ID SKUPINY ZÁKAZNÍKA_, NÁZOV SKUPINY_, ID ORG__, ID ZÁKAZNÍKA [_EXTERNÉ_ID, ID LOKALITY_, ID LICENCIE_, ID SLUŽBY_NÁZOV, SKU, POPIS, SPOTREBA_DÁTUM ZAČIATKU_, SPOTREBA_DÁTUM KONCA_, MNOŽSTVO
Poskytnutie balíka používateľovi spustí fakturáciu Webex Wholesale, zatiaľ čo odstránenie priradenia balíka ju zastaví.
Zákaznícka organizácia môže patriť v danom čase iba do jednej zákazníckej skupiny. Podpora pre viacero skupín zákazníkov na organizáciu momentálne nie je k dispozícii.
