Děkujeme za vaši zpětnou vazbu.
Zpětná vazba?Fakturační zprávy
Partneři mohou k vygenerování fakturačních sestav, které jim pomáhají ověřit přesnost využití a zřizování, použít následující rozhraní API pro velkoobchodní fakturaci. Rozhraní API pro velkoobchodní fakturaci jsou dostupná na webu developer.webex.com.
-
Odsouhlasení – Zobrazuje spotřebu na úrovni partnera, zákazníka nebo uživatele. Partneři mohou tyto informace z vlastní fakturační zprávy použít k odsouhlasení svých měsíčních faktur, aby mohli fakturovat svým zákazníkům a uživatelům podle jejich spotřeby.
-
Bod v čase – Zobrazuje aktuální alokace balíčků na úrovni zákazníka nebo uživatele. Zpráva Point-In-Time poskytuje počet alokací balíčků v reálném čase. Partneři mohou tyto informace využít k ověření přesnosti zřizování a zajištění souladu s objednávkami zákazníků.
Partneři mohou také generovat vlastní fakturační sestavy pro subpartnery pomocí parametru subPartnerOrgId.
Pro partnerské administrátory, kteří splňují minimální požadavky na přístup, jsou k dispozici čtyři rozhraní API.
|
Fakturační API |
Účel API |
Požadavek na přístup pro správce partnera |
|---|---|---|
|
Vytvořte si velkoobchodní fakturační sestavu |
Používá se k vygenerování fakturačního reportu. |
Read/write |
|
Získejte zprávu o velkoobchodní fakturaci |
Používá se k získání vygenerované fakturační sestavy ke stažení. |
Číst |
|
Seznam fakturačních sestav pro velkoobchod |
Používá se k zobrazení seznamu fakturačních sestav, které pro daného partnera existují. |
Číst |
|
Smazání velkoobchodní fakturační zprávy |
Používá se k odstranění existujícího fakturačního reportu. |
Read/write |
Zdroj dat
Data pro fakturační sestavy se získávají z přiřazení balíčků a dat o využití, které Webex sleduje pro každého partnera. Webex denně agreguje data o zákaznických a uživatelských balíčcích a generuje měsíční fakturu partnera. Fakturační API tato data využívají a umožňují správcům partnerů generovat vlastní přehledy. Tyto sestavy pomáhají partnerům odsouhlasit spotřebu z jejich měsíční faktury na úrovni partnera, zákazníka a uživatele.
Podrobnější informace o tom, jak Webex fakturuje partnerům, naleznete v části Fakturace poskytovatele služeb.
Vytvořte si velkoobchodní fakturační sestavu
| 1 |
Z webu developer.webex.compřejděte na Vytvoření API pro velkoobchodní fakturační sestavu. |
| 2 |
Vyberte si jednu z následujících kategorií přehledů:
Pokud chcete vygenerovat zprávu o odsouhlasení, není třeba nic měnit, protože možnost Odsouhlasení je ve výchozím nastavení vybrána, takže můžete pokračovat k dalšímu kroku. Pokud chcete vygenerovat sestavu k určitému bodu v čase, změňte výběr na možnost K určitému bodu v čase. |
| 3 |
Zadejte billingStartDate a billingEndDate ve formátu, který určuje API. Můžete zadat libovolné datum z posledních pěti let, ale ne aktuální den. Pro přehled k určitému bodu v čase nejsou pole billingStartDate a billingEndDate povinná a pokud jsou zadána, budou ignorována. Zpráva vždy odráží aktuální alokace balíčků. |
| 4 |
Zadejte typ hlášení:
|
| 5 |
Do pole Zahrnout zadejte další nebo volitelné sloupce, které chcete v přehledech vidět. Každý typ sestavy má sadu povinných atributů a sadu volitelných atributů. Můžete se rozhodnout, které z volitelných atributů se mají pro každou sestavu zobrazit. Pokud nezahrnete volitelné atributy, sestava zobrazí pouze povinné atributy. Následující sloupce představují volitelné atributy, které můžete požádat o zahrnutí do sestavy Zákazník a Uživatel:
Pokud chcete tyto atributy vidět ve svém přehledu, musíte uvést ID ZÁKAZNÍKA_SKUPINY_a NÁZEV ZÁKAZNÍKA_SKUPINY_společně. Když vyberete volitelné sloupce, pořadí sloupců v sestavách Odsouhlasení zákazníků a uživatelů se změní. Partneři musí aktualizovat svou integraci API, aby přijali nový formát CSV. Pořadí sloupců v reportech k určitému bodu v čase zůstává nezměněno. V současné době mají stávající nastavení funkcí při určování pořadí sloupců přednost před parametrem Include. Pokud je například pro zákazníka povoleno určité nastavení funkce, zobrazí se sloupec dané funkce ve starém formátu sestavy, i když jej přidáte do parametru Zahrnout. Tato nastavení brzy odstraníme. Jakmile jsou odebrány, můžete volitelné sloupce vyžádat pouze pomocí parametru Include. |
| 6 |
Klikněte na Spustit pro generování zprávy. |
| 7 |
Zkopírujte ID sestavy z výstupu API. Tuto hodnotu můžete použít s rozhraním Get API k získání vygenerované fakturační sestavy. |
Co dělat dál
Přejděte do sekce Získat velkoobchodní fakturační zprávu a stáhněte si kopii zprávy.
Získejte přehled o fakturaci za velkoobchodní prodej
Jakmile je vygenerována fakturační sestava, použijte toto API k získání konkrétní fakturační sestavy. Zpráva se odešle na URL adresu, kde je k dispozici ke stažení po dobu 30 minut po dokončení požadavku GET.
| 1 |
Z webu developer.webex.compřejděte na Získejte API pro velkoobchodní fakturační sestavy. |
| 2 |
Zadejte jedinečnou hodnotu id pro sestavu a klikněte na Spustit. Výstupy API hlásí stav. Výstup obsahuje parametr tempDownloadURL, který poskytuje URL adresu, ze které si můžete stáhnout sestavu. |
| 3 |
Zkopírujte tempDownloadURL do prohlížeče pro přístup k přehledu a jeho stažení. |
Seznam fakturačních sestav pro velkoobchodní prodej
Toto API použijte k získání seznamu vygenerovaných fakturačních sestav pro partnerskou organizaci. Můžete zobrazit seznam všech existujících reportů nebo seznam omezit na ty reporty, které splňují zadané parametry, jako je fakturační období a typ fakturace (partner, zákazník, uživatel).
Pokud zadáte volitelné parametry, API vrátí pouze ty sestavy, které přesně odpovídají zadaným parametrům. Pokud například zadáte fakturační období, vrátí se pouze sestavy, které používají toto konkrétní fakturační období. Zprávy, které spadají do daného období, ale které se přesně neshodují s daty, se nevrací.
| 1 |
Z webu developer.webex.compřejděte na List Wholesale Billing Report API. |
| 2 |
V části Parametry dotazuzadejte libovolné parametry vyhledávání, které chcete použít (například počátečníDatum, koncovéDatum, Typ, sortBy podle). |
| 3 |
Klikněte na Spustit. API vypíše seznam reportů spolu s jedinečným ID reportu a stavem (DOKONČENO, V PROGRESU_).
|
Co dělat dál
U všech reportů, které chcete stáhnout, si poznamenejte id. Chcete-li si stáhnout zprávu, přejděte na Získat velkoobchodní fakturační zprávu.
Smazání fakturačního reportu pro velkoobchod
Tento postup použijte k odstranění vygenerované fakturační sestavy na základě ID sestavy. Několik příkladů, kdy můžete chtít smazat přehled, zahrnuje:
-
Pokud chcete znovu vytvořit existující sestavu fakturace pro odsouhlasení, musíte nejprve existující sestavu smazat. Po odstranění existující sestavy můžete pro dané období vytvořit novou sestavu. Nelze smazat sestavu, pokud její generování selhalo nebo stále probíhá.
U sestavy k určitému bodu v čase není nutné existující sestavu mazat, protože systém tyto sestavy negeneruje znovu. Každá sestava vždy odráží data k aktuálnímu časovému razítku.
-
Pokud odešlete vygenerovanou URL adresu sestavy nesprávné osobě, můžete sestavu smazat, aby k ní neměla přístup.
| 1 |
Z webu developer.webex.compřejděte na Odstranění rozhraní API pro velkoobchodní fakturaci. |
| 2 |
Zadejte ID sestavy a klikněte na Spustit. |
Pole fakturačního reportu
Fakturační sestavy obsahují následující pole:
|
Pole |
Popis |
Podporovaný typ sestavy |
Podporovaná kategorie sestav |
Povinný nebo volitelný atribut |
|---|---|---|---|---|
|
JMÉNO PARTNERA_ |
Jméno partnera |
PARTNER, ZÁKAZNÍK, UŽIVATEL |
Odsouhlasení, bod v čase |
Povinné |
|
ID PARTNERA_ORGANIZACE_ |
Jedinečný identifikátor partnera |
PARTNER, ZÁKAZNÍK, UŽIVATEL |
Odsouhlasení, bod v čase |
Povinné |
|
ID PŘEDPLATNÉHO_ |
Jedinečný identifikátor předplatného |
PARTNER, ZÁKAZNÍK, UŽIVATEL |
Odsouhlasení, bod v čase |
Povinné |
|
ZÁKAZNÍK_SKUPINA_ID | Jedinečný identifikátor skupiny, do které zákazník patří. Pokud je zákazník během fakturačního období přesunut mezi skupinami, je využití rozděleno na základě skupin, do kterých zákazník v daném období patřil. |
ZÁKAZNÍK, UŽIVATEL |
Odsouhlasení, bod v čase |
Volitelné |
|
ZÁKAZNÍK_SKUPINA_NÁZEV | Zobrazovaný název skupiny zákazníků. Pokud se název skupiny během fakturačního období změnil, použije se nejnovější název. |
ZÁKAZNÍK, UŽIVATEL |
Odsouhlasení, bod v čase |
Volitelné |
|
ID ZÁKAZNÍKA_ORG_ |
Interní jedinečný identifikátor zákazníka |
ZÁKAZNÍK, UŽIVATEL |
Odsouhlasení, bod v čase |
Povinné |
|
ZÁKAZNÍK_EXTERNÍ_ID |
Jedinečný identifikátor zákazníka poskytnutý partnerem |
ZÁKAZNÍK, UŽIVATEL |
Odsouhlasení, bod v čase |
Povinné |
|
TYP |
Typ uživatele nebo pracovního prostoru |
ZÁKAZNÍK, UŽIVATEL |
Bod v čase |
Povinné |
|
ID ODBĚRATELE_ |
Jedinečný identifikátor pro předplatitele |
UŽIVATEL |
Odsouhlasení, bod v čase |
Povinné |
|
ID UŽIVATELE_ |
ID uživatele Webexu předplatitele |
UŽIVATEL |
Odsouhlasení, bod v čase |
Povinné |
|
PRACOVNÍ PROSTOR_ID |
Jedinečný identifikátor pracovního prostoru |
UŽIVATEL |
Odsouhlasení, bod v čase |
Povinné |
|
NÁZEV SLUŽBY_ |
Název služby (např. SPOLEČNÁ_PROSTOR_VOLÁNÍ, WEBEX_VOLÁNÍ, WEBEX_SADA, WEBEX_SCHŮZKY) |
PARTNER, ZÁKAZNÍK, UŽIVATEL |
Odsouhlasení, bod v čase |
Povinné |
|
SKU |
SKU pro službu |
PARTNER, ZÁKAZNÍK, UŽIVATEL |
Odsouhlasení, bod v čase |
Povinné |
|
POPIS |
Popis služby |
PARTNER, ZÁKAZNÍK, UŽIVATEL |
Odsouhlasení, bod v čase |
Povinné |
|
SPOTŘEBA_ZAČÁTEK_DATUM |
Začátek spotřeby služby. Spolu s následujícím polem tato hodnota definuje dobu používání. |
PARTNER, ZÁKAZNÍK, UŽIVATEL |
Odsouhlasení |
Povinné |
|
SPOTŘEBA_KONEC_DATUM |
Konec spotřeby služby. Spolu s předchozím polem tato hodnota definuje období spotřeby. |
PARTNER, ZÁKAZNÍK, UŽIVATEL |
Odsouhlasení |
Povinné |
|
DATUM ZPRÁVY_ |
Datum a čas, kdy je sestava vygenerována. |
ZÁKAZNÍK, UŽIVATEL |
Bod v čase |
Povinné |
|
MNOŽSTVÍ |
Představuje agregovanou spotřebu uživatelů na partnera, na zákazníka nebo na uživatele (v závislosti na sestavě a úrovni, na které data zobrazujete). Výpočet: Systém vypočítá denní množství pro každého uživatele poměrně pro daný den. Použití po celý den = 1 Použití na půl dne = 0,5 Poté sečte denní součty za všechny dny v rámci fakturačního období a vypočítá celkové množství pro daného uživatele v rámci daného fakturačního období. U sestav na úrovni zákazníků a partnerů se součty pro všechny uživatele agregují, čímž se získá celkové množství pro daného zákazníka nebo partnera. Bod v čase: V sestavě zákazníka je uveden seznam alokací balíčků pro každého zákazníka. Každý řádek představuje celkové množství konkrétního balíčku přiřazeného uživatelům nebo pracovním prostorům v rámci konkrétní zákaznické organizace. Pokud nejsou přiděleny žádné balíčky, v poli Množství se zobrazuje „0“. Uživatelská sestava obsahuje seznam balíčků přiřazených uživatelům nebo pracovním prostorům. Každý řádek zobrazuje množství 1, které představuje uživatele nebo pracovní prostor a jeho individuální balíček nebo doplněk. Pokud je uživateli nebo pracovnímu prostoru přiděleno více balíčků nebo doplňků, sestava zobrazí více položek, každá s počtem 1. |
PARTNER, ZÁKAZNÍK, UŽIVATEL |
Odsouhlasení, bod v čase |
Povinné |
|
ID LOKALITY_ |
Jedinečný identifikátor polohy |
ZÁKAZNÍK, UŽIVATEL |
Odsouhlasení, bod v čase Zpráva o zákazníkovi k určitému bodu v čase neobsahuje ID lokality. |
Volitelné |
|
LICENCE_ID |
Identifikátor licence Toto pole je viditelné pouze pro velkoobchodní balíčky Pro odsouhlasovací zprávu je pole License_ID prázdné pro licence přiřazené před zavedením tohoto pole. Fakturační sestava zobrazuje více řádků pro stejný velkoobchodní balíček, pokud je přidružen k různým kombinacím ID LOKACE_a ID LICENCE_. |
ZÁKAZNÍK, UŽIVATEL |
Odsouhlasení, bod v čase |
Volitelné |
Výběrem volitelných sloupců se upraví pořadí sloupců v sestavách odsouhlasení zákazníků a uživatelů. Následující pořadí platí pro partnery, kteří mají v předplatném pouze velkoobchodní SKU:
Zpráva na úrovni uživatele – NÁZEV PARTNERA_, ID PARTNERA_ORG_, ID PŘEDPLATNÉHO_, ID ZÁKAZNÍKA_SKUPINY_, NÁZEV SKUPINY__, ID ZÁKAZNÍKA_ORG_, ID ZÁKAZNÍKA [_EXTERNÍ [_ID, ID LOKALITY_, ID LICENCE_, ID PŘEDPLATITELE_, ID UŽIVATELE_, ID PRACOVNÍHO PROSTORU_, NÁZEV SLUŽBY_, SKU, POPIS, SPOTŘEBA_DATUM ZAČÁTKU_, SPOTŘEBA_KONEC_DATUM, MNOŽSTVÍ
Zpráva na úrovni zákazníka – NÁZEV PARTNERA_, ID PARTNERA_ORG_, ID PŘEDPLATNÉHO_, ID ZÁKAZNÍKA_SKUPINY_, ID ZÁKAZNÍKA_SKUPINY_, ID ZÁKAZNÍKA_ORG__, ID ZÁKAZNÍKA [_EXTERNÍ [] ID, ID LOKALITY_, ID LICENCE_, ID SLUŽBY_NÁZEV, SKU, POPIS, SPOTŘEBA_DATUM ZAČÁTKU_, SPOTŘEBA_KONEC_DATUM, MNOŽSTVÍ
Zřízení balíčku uživateli spouští fakturaci Webex Wholesale, zatímco odebrání přiřazení balíčku ji zastaví.
Zákaznická organizace může v daném okamžiku patřit pouze do jedné zákaznické skupiny. Podpora pro více skupin zákazníků na organizaci momentálně není k dispozici.
