Ďakujeme za vašu spätnú väzbu.
Spätná väzba?Fakturačné správy
Partneri môžu použiť nasledujúce rozhrania API veľkoobchodnej fakturácie na generovanie fakturačných zostáv , ktoré im pomôžu overiť presnosť používania a poskytovania. Rozhrania API veľkoobchodnej fakturácie sú prístupné prostredníctvom developer.webex.com.
-
Zosúladenie — zobrazuje spotrebu používania na jedného partnera, zákazníka alebo na úrovni používateľa. Partneri môžu použiť tieto informácie o vlastnej fakturačnej správe na zosúladenie svojej mesačnej faktúry tak, aby mohli účtovať svojim zákazníkom a používateľom podľa ich spotreby.
-
Point-in-Time — zobrazuje aktuálne prideľovanie balíkov na zákazníka alebo na úrovni 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 a zabezpečenie zosúladenia s objednávkami zákazníkov.
Partneri môžu tiež generovať vlastné fakturačné prehľady pre subpartnerov pomocou parametra SubPartnerOrgID.
Existujú štyri rozhrania API, ktoré sú k dispozícii partnerským správcom, ktorí spĺňajú minimálne požiadavky na prístup.
|
Fakturačné API |
Účel API |
Požiadavka na prístup správcu partnera |
|---|---|---|
|
Vytvorenie veľkoobchodnej fakturačnej správy |
Používa sa na generovanie fakturačnej správy. |
Čítanie/zápis |
|
Získajte správu o veľkoobchodnej fakturácii |
Používa sa na získanie vygenerovaného fakturačného prehľadu na stiahnutie. |
Prečítajte si |
|
Zoznam veľkoobchodných fakturačných správ |
Používa sa na zoznam fakturačných zostáv, ktoré existujú pre daného partnera. |
Prečítajte si |
|
Odstránenie veľkoobchodnej fakturačnej správy |
Používa sa na odstránenie existujúceho fakturačného prehľadu. |
Čítanie/zápis |
Zdroj údajov
Údaje pre fakturačné prehľady sú čerpané z priradení balíkov a údajov o používaní, ktoré Webex sleduje pre každého partnera. Webex denne agreguje údaje o zákazníkovi a používateľskom balíku a generuje mesačnú faktúru partnera. Fakturačné rozhrania API používajú tieto údaje, čo umožňuje partnerským správcom generovať vlastné zostavy. Tieto správy pomáhajú partnerom z osúladiť spotrebu používania z ich mesačnej faktúry na úrovni partnera, zákazníka a používateľa.
Podrobnejšie informácie o tom, ako spoločnosť Webex fakturuje partnerov, nájdete v téme Fakturácia poskytovateľom služieb.
Vytvorenie prehľadu veľkoobchodnej fakturácie
| 1 |
Na stránke developer.webex.com prejdite na položku Vytvorenie roz hrania API veľkoobchod nej fakturácie. |
| 2 |
Vyberte niektorú z nasledujúcich kategórií zostáv:
Ak chcete vygenerovať správu o zosúladení, nie je potrebné nič meniť, pretože v predvolenom nastavení je vybrané Zosúladenie, takže môžete prej sť ďalším krokom. Ak chcete vygenerovať prehľad o bode v čase, zmeňte výber na Point-In-Time. |
| 3 |
Zadajte billingStartDate a BillingEndDate vo formáte, ktorý určuje roz hranie API. Môžete zadať ľubovoľný dátum z posledných piatich rokov, ale nie aktuálny deň. V prehľade Point-In-Time polia BillingStartDate a BillingEndD ate nie sú povinné a pri zadaní sa ignorujú. Správa vždy odráža aktuálne pridelené balí ky. |
| 4 |
Zadajte typ pre hľadu:
|
| 5 |
Do poľa Zah rnúť zadajte ďalšie alebo voliteľné stĺpce, ktoré chcete zobraziť v zostavách. Každý typ zostavy má súbor povinných atribútov a sadu voliteľných atribútov. Môžete sa rozhodnúť, ktorý z voliteľných atribútov sa zobrazí pre každú zostavu. Ak nezahrnete voliteľné atribúty, zostava zobrazí iba povinné atribúty. Nasledujúce stĺpce sú voliteľné atribúty, ktoré môžete požiadať o zahrnutie do prehľadu zákazníka a používateľa:
Ak chcete tieto atribúty vidieť vo svojom prehľade, musíte ich zahrnúť CUSTOMER_GROUP_NAME spolu. CUSTOMER_GROUP_ID Keď vyberiete voliteľné stĺpce, poradie stĺpcov v prehľadoch Zosúladenie zákazníka a používateľa sa zmení. Partneri musia aktualizovať svoju integráciu API, aby akceptovali nový formát csv. Poradie stĺpcov správ Point-In-Time zostáva nezmenené. V súčasnosti majú existujúce nastavenia funkcií pri určovaní poradia stĺpcov prednosť pred parametrom Zahrnúť. Ak je napríklad povolené určité nastavenie funkcie pre zákazníka, stĺpec funkcie sa zobrazí podľa starého formátu zostavy, aj keď ich pridáte do parametra Zahrnúť. Tieto nastavenia čoskoro odstránime. Po ich odstránení môžete požadovať voliteľné stĺpce iba pomocou parametra Zahrnúť. |
| 6 |
Kliknite na tlači dlo Spustiť pre vygenerovanie zostavy. |
| 7 |
Skopírujte id zost avy z výstupu API. Túto hodnotu môžete použiť pomocou rozhrania Get API na získanie vygenerovaného fakturačného prehľadu. |
Čo robiť ďalej
Ak chcete sti ahnuť kópiu zostavy, prejdite do časti Získanie veľkoobchod nej fakturačnej správy.
Získajte správu o veľkoobchodnej fakturácii
Po vygenerovaní fakturačného prehľadu použite toto rozhranie API na získanie konkrétneho fakturačného prehľadu. Správa sa zobrazí na adresu URL, kde je k dispozícii na stiahnutie po dobu 30 minút po dokončení požiadavky GET.
| 1 |
Na stránke developer.webex.com prejdite na položku Získať rozhran ie API správy o veľkoobchodnej fakturácii. |
| 2 |
Zadajte jedinečnú hodno tu id pre zostavu a kliknite na tlačidlo S pustiť. Rozhranie API vystupuje stav správy. Výstup obsahuje parameter tempDownloadURL, ktorý poskytuje adresu URL, z ktorej si môžete prehľad stiahnuť. |
| 3 |
Skopírujte adresu tempDownloadURL do prehliadača a získajte prístup k zostave a stiah nite ho. |
Zoznam veľkoobchodných fakturačných správ
Pomocou tohto rozhrania API získate zoznam vygenerovaných fakturačných zostáv pre partnerskú organizáciu. Môžete uviesť všetky existujúce prehľady alebo obmedziť zoznam na tie zostavy, ktoré spĺňajú zadané parametre, ako je 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 zostavy, ktoré presne zodpovedajú parametrom, ktoré zadáte. Ak napríklad zadáte fakturačné obdobie, vrátia sa iba prehľady, ktoré používajú dané konkrétne fakturačné obdobie. Sprá vy, ktoré spadajú do daného obdobia, ale ktoré sa presne nezhodujú s dátumami, sa ne vrátia.
| 1 |
Na stránke developer.webex.com prejdite na položku List Whol esale Filling Report API. |
| 2 |
V časti Parametre dota zu zadajte všetky parametre vyhľadávania, ktoré chcete použiť (napríklad StartDate, EndDate, Type, SortBy). |
| 3 |
Kliknite na tlači dlo Spustiť. Rozhranie API vystupuje zoznam zostáv spolu s jedinečným ID zostavy a stavom (DOKONČENÉ,IN_PROGRESS).
|
Čo robiť ďalej
Zaznamenajte si ID všetkých zostáv, ktoré chcete sti ahnuť. Ak chcete prehľad prev ziať, prejdite na položku Získať veľkoobchod nú fakturačnú správu.
Odstránenie prehľadu veľkoobchodnej fakturácie
Tento postup použite na odstránenie vygenerovaného fakturačného prehľadu založeného na identifikácii zostavy. Niekoľko príkladov, kde možno budete chcieť vymazať zostavu, zahŕňajú:
-
Ak chcete obnoviť existujúci prehľad o fakturácii zosúladenia, musíte naj skôr odstrániť existujúci prehľad. Po odstránení existujúcej zostavy môžete vytvoriť novú zostavu pre dané obdobie. Nie je možné odstrániť zostavu, ak jej generovanie zlyhalo alebo stále prebieha.
V prípade prehľadu Point-In-Time nemusíte vymazať existujúci prehľad, pretože systém tieto zostavy neobnovuje. Každá správa vždy odráža údaje aktuálnej časovej pečiatky.
-
Ak odošlete vygenerovanú adresu URL správy nesprávnej osobe, môžete zostavu odstrániť, aby k nej nemala prístup.
| 1 |
Na stránke developer.webex.com prejdite na položku Odstrániť rozhranie API správy veľkoobchodnej faktur ácie. |
| 2 |
Zadajte ID zostavy a kliknite na tlačidlo S pustiť. |
Polia fakturačného prehľadu
Fakturačné prehľady obsahujú nasledujúce polia:
|
Pole |
Popis |
Podporovaný typ zostavy |
Podporovaná kategória prehľadu |
Povinný alebo voliteľný atribút |
|---|---|---|---|---|
|
PARTNER_NAME |
Názov partnera |
PARTNER, CUSTOMER, USER |
Zosúladenie, v čase |
Povinné |
|
PARTNER_ORG_ID |
Jedinečný identifikátor partnera |
PARTNER, CUSTOMER, USER |
Zosúladenie, v čase |
Povinné |
|
SUBSCRIPTION_ID |
Jedinečný identifikátor predplatného |
PARTNER, CUSTOMER, USER |
Zosúladenie, v čase |
Povinné |
|
CUSTOMER_GROUP_ID | Jedinečný identifikátor skupiny, do ktorej zákazník patrí. Ak je zákazník počas fakturačného obdobia presunutý medzi skupinami, používanie sa rozdelí na základe skupín, do ktorých zákazník patril počas daného obdobia. |
CUSTOMER, USER |
Zosúladenie, v čase |
Voliteľné |
|
CUSTOMER_GROUP_NAME | Zobrazený názov skupiny zákazníkov. Ak sa názov skupiny zmenil počas fakturačného obdobia, použije sa najnovší názov. |
CUSTOMER, USER |
Zosúladenie, v čase |
Voliteľné |
|
CUSTOMER_ORG_ID |
Interný jedinečný identifikátor zákazníka |
CUSTOMER, USER |
Zosúladenie, v čase |
Povinné |
|
CUSTOMER_EXTERNAL_ID |
Jedinečný identifikátor zákazníka poskytnutý partnerom |
CUSTOMER, USER |
Zosúladenie, v čase |
Povinné |
|
TYPE |
Typ používateľa alebo pracovného priestoru |
CUSTOMER, USER |
Bod v čase |
Povinné |
|
SUBSCRIBER_ID |
Jedinečný identifikátor pre predplatiteľa |
USER |
Zosúladenie, v čase |
Povinné |
|
USER_ID |
ID používateľa Webex predplatiteľa |
USER |
Zosúladenie, v čase |
Povinné |
|
WORKSPACE_ID |
Jedinečný identifikátor pracovného priestoru |
USER |
Zosúladenie, v čase |
Povinné |
|
SERVICE_NAME |
Názov služby (napr.COMMON_AREA_CALLING,WEBEX_CALLING,WEBEX_SUITE,WEBEX_MEETINGS) |
PARTNER, CUSTOMER, USER |
Zosúladenie, v čase |
Povinné |
|
SKU |
SKU pre službu |
PARTNER, CUSTOMER, USER |
Zosúladenie, v čase |
Povinné |
|
DESCRIPTION |
Popis služby |
PARTNER, CUSTOMER, USER |
Zosúladenie, v čase |
Povinné |
|
CONSUMPTION_START_DATE |
Začiatok spotreby služby. Spolu s nasledujúcim poľom táto hodnota definuje obdobie používania. |
PARTNER, CUSTOMER, USER |
Zmierenie |
Povinné |
|
CONSUMPTION_END_DATE |
Koniec spotreby služby. Spolu s predchádzajúcim poľom táto hodnota definuje obdobie spotreby používania. |
PARTNER, CUSTOMER, USER |
Zmierenie |
Povinné |
|
REPORT_DATE |
Dátum a čas vygenerovania správy. |
CUSTOMER, USER |
Bod v čase |
Povinné |
|
QUANTITY |
Predstavuje súhrnnú spotrebu používateľa na jedného partnera, na zákazníka alebo na jedného používateľa (v závislosti od zostavy a úrovne, na ktorej sa údaje zobrazujú). Výpočet: Systém vypočíta denné množstvo pre každého používateľa proporcionálne pre daný deň. Použitie na celý deň = 1 Použitie na pol dňa = 0,5 Potom sa sumarizujú denné súčty za všetky dni v rámci fakturačného obdobia, aby sa vypočítalo celkové množstvo pre daného používateľa v tomto fakturačnom období. V prípade správ na úrovni zákazníkov a partnerov sa súčty všetkých používateľov agregujú tak, aby poskytli celkové množstvo pre daného zákazníka alebo partnera. Point-in-Time: Zákaznícka správa uvádza prideľovanie balíkov na 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 zákazníckej organizácie. Množstvo zobrazuje „0“, ak nie sú pridelené žiadne balíčky. Správa používateľa obsahuje zoznam balíkov priradených používateľom alebo pracovným priestorom. Každý riadok zobrazuje množstvo 1, ktoré predstavuje používateľa alebo pracovný priestor a ich individuálny balík alebo doplnok. Ak je používateľovi alebo pracovnému priestoru pridelených viac balíkov alebo doplnkov, zostava zobrazí viacero položiek, z ktorých každá má množstvo 1. |
PARTNER, CUSTOMER, USER |
Zosúladenie, v čase |
Povinné |
|
LOCATION_ID |
Jedinečný identifikátor polohy |
CUSTOMER, USER |
Zosúladenie, v čase Zákaznícka správa Point-In-Time neobsahuje ID polohy |
Voliteľné |
|
LICENSE_ID |
Identifikátor licencie Toto pole je viditeľné len pre veľkoobchodné balíky V prípade správy o zosúlad License_ID ení je pre licencie pridelené pred zavedením tohto poľa prázdne. Fakturačná správa zobrazuje viacero riadkov pre ten istý veľkoobchodný balík, ak je spojený s rôznymi kombináciami LOCATION_ID aLICENSE_ID. |
CUSTOMER, USER |
Zosúladenie, v čase |
Voliteľné |
Výberom voliteľných stĺpcov sa upravuje poradie stĺpcov správ o zosúladení zákazníkov a používateľov Nasledujúca objednávka sa vzťahuje na partnerov, ktorí majú v predplatnom iba veľkoobchodné SKU:
Údaje o úrovni použív PARTNER_NAME ateľa— PARTNER_ORG_IDSUBSCRIPTION_ID,CUSTOMER_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, MNOŽSTVO
Správa na úrovni zákaz PARTNER_NAME níka—PARTNER_ORG_ID,SUBSCRIPTION_ID,CUSTOMER_GROUP_ID,CUSTOMER_GROUP_NAME,CUSTOMER_ORG_ID,,CUSTOMER_EXTERNAL_ID,LOCATION_ID,LICENSE_ID,SERVICE_NAME, SKU, POPIS,CONSUMPTION_START_DATE,CONSUMPTION_END_DATE, MNOŽSTVO
Poskytnutie balíka používateľovi spustí účtovanie Webex Wholesale, zatiaľ čo odstránenie priradenia balíkov ho zastaví.
Zákaznícka organizácia môže v danom čase patriť iba do jednej skupiny zákazníkov. Podpora viacerých skupín zákazníkov na organizáciu momentálne nie je k dispozícii.
