Zosúladenie fakturácie

Správcovia partnerov môžu použiť rozhrania API pre veľkoobchodnú fakturáciu na generovanie vlastných fakturačných zostáv, ktoré zobrazujú spotrebu na úrovni partnera, zákazníka alebo používateľa. Partneri môžu tieto informácie použiť na zosúladenie svojej mesačnej faktúry, aby mohli fakturovať svojim zákazníkom a používateľom podľa ich spotreby.

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.

Čítať / Napíšte

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.

Čítať / Napíšte

Zdroj údajov

Údaje pre fakturačné správy sa získavajú z údajov o spotrebe, ktoré Webex sleduje pre každého partnera. Webex každý deň sleduje spotrebu za predchádzajúci deň pre všetkých partnerov, zákazníkov a používateľov a agreguje údaje, aby sa dali použiť na vygenerovanie mesačnej faktúry partnera. Fakturačné rozhrania API využívajú tieto údaje a umožňujú správcom partnerov generovať vlastné prehľady, aby partner mohol zosúladiť spotrebu z 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 veľkoobchodnej fakturácii

Tento postup použite na vygenerovanie vlastnej fakturačnej správy, ktorú môžete použiť na vyrovnanie fakturácie.
1

Prejdite na rozhranie API na vytvorenie prehľadu veľkoobchodnej fakturácie.

2

Zadajte fakturačné obdobie zadaním hodnôt pre 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ň.

3

Zadajte Typ hlásenia:

  • PARTNER (toto je predvolené nastavenie) – zobrazuje spotrebu na úrovni partnera.
  • ZÁKAZNÍK – Zobrazuje celkovú spotrebu rozdelenú podľa úrovne organizácií zákazníkov v rámci partnera.
  • POUŽÍVATEĽ – Zobrazuje celkovú spotrebu rozdelenú na úroveň organizácií zákazníkov a predplatiteľov v rámci partnera.
4

Kliknite na Spustiť pre generovanie správy.

5

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 na Získať správu o fakturácii za veľkoobchod a stiahnite si kópiu správy.

Získajte správu o veľkoobchodnej fakturácii

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

Prejdite na rozhranie API na získanie prehľadu o veľkoobchodnej fakturácii.

2

V riadku GET kliknite na tlačidlo id a zadajte jedinečnú hodnotu identifikátora prehľadu.

3

Kliknite na Spustiť.

4

Výstupy API hlásia stav. Výstup obsahuje parameter tempDownloadURL, ktorý poskytuje URL adresu, z ktorej si môžete stiahnuť zostavu.

5

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 – zostavy, ktoré spadajú do daného obdobia, ale presne nezodpovedajú dátumom, sa nevrátia.
1

Prejsť na zoznam API pre správu o veľkoobchodnej fakturácii

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). Ďalšie podrobnosti o týchto parametroch nájdete v Pomocníkovi pre vývojárov k rozhraniu API.

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ť. Ak si chcete stiahnuť správu, prejdite na Získať správu o fakturácii za veľkoobchod.

Odstránenie prehľadu o veľkoobchodnej fakturácii

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úci prehľad fakturácie, musíte ho najprv odstrániť. Po odstránení existujúcej správy môžete pre dané obdobie vytvoriť novú správu. Upozorňujeme, že požiadavka na odstránenie neexistuje, ak sa správa nepodarí spracovať alebo sa práve spracováva.

  • Ak sa vygeneruje prehľad a odošlete URL adresu nesprávnej osobe, môžete prehľad odstrániť a táto osoba k nemu nebude mať prístup.

1

Prejdite do rozhrania API na odstránenie prehľadu veľkoobchodnej fakturácie.

2

Zadajte ID prehľadu .

3

Kliknite na Spustiť.

Polia prehľadu fakturácie

Fakturačné prehľady obsahujú nasledujúce polia:

Pole

Doplňujúce informácie

Zobrazuje sa v správach typu

MENO PARTNERA_

Meno partnera

PARTNER, ZÁKAZNÍK, POUŽÍVATEĽ

ID PARTNERA_ORGANIZÁCIE_

Jedinečný identifikátor partnera

PARTNER, ZÁKAZNÍK, POUŽÍVATEĽ

ID PREDPLATNÉHO_

Jedinečný identifikátor predplatného

PARTNER, ZÁKAZNÍK, POUŽÍVATEĽ

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Ľ

SKU

SKU pre službu

PARTNER, ZÁKAZNÍK, POUŽÍVATEĽ

POPIS

Popis služby

PARTNER, ZÁKAZNÍK, POUŽÍVATEĽ

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Ľ

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Ľ

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:

Denné množstvo pre každého používateľa vypočítavajú pomerne k danému dňu.

Používanie počas celého dňa = 1

Používanie na pol dňa = 0,5

Sčítajú denné súčty za všetky dni v rámci fakturačného obdobia, aby vypočítali 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.

PARTNER, ZÁKAZNÍK, POUŽÍVATEĽ

ID ZÁKAZNÍKA_ORG_

Jedinečný identifikátor interného zákazníka

ZÁKAZNÍK, POUŽÍVATEĽ

ZÁKAZNÍK_EXTERNÉ_ID

Jedinečný identifikátor zákazníka poskytnutý partnerom

ZÁKAZNÍK, POUŽÍVATEĽ

ID PREDPLATITEĽA_

Jedinečný identifikátor predplatiteľa

POUŽÍVATEĽ

ID POUŽÍVATEĽA_

ID používateľa Webexu predplatiteľa

POUŽÍVATEĽ

ID PRACOVNÉHO PRIESTORU_

Jedinečný identifikátor pracovného priestoru

POUŽÍVATEĽ

ID LOKALITY_

Jedinečný identifikátor polohy

ZÁKAZNÍK, POUŽÍVATEĽ

LICENCIA_ID

Identifikátor licencie

Toto pole je viditeľné iba pre veľkoobchodné balíky. Pole License_ID je prázdne pre licencie pridelené pred zavedením tohto poľa.

Fakturačná správa môže zobrazovať viacero riadkov pre ten istý veľkoobchodný balík, pričom každý riadok predstavuje jedinečný package/license Kombinácia ID.

Ak je prítomné pole ID LICENCE_, každý riadok predstavuje jedinečné package/location/license Kombinácia ID.

ZÁKAZNÍK, POUŽÍVATEĽ

Poskytnutie balíka používateľovi spustí fakturáciu Webex Wholesale, zatiaľ čo odstránenie priradenia balíka ju zastaví.