Odsouhlasení fakturace

Správci partnerů mohou pomocí rozhraní API pro velkoobchodní fakturaci generovat vlastní fakturační sestavy, které zobrazují spotřebu na úrovni jednotlivých partnerů, zákazníků nebo uživatelů. Partneři mohou tyto informace 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.

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 partnera pro administrátory

Vytvořte si velkoobchodní fakturační sestavu

Používá se k vygenerování fakturačního reportu.

Číst / Napsat

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 výkazu.

Číst / Napsat

Zdroje dat

Data pro fakturační sestavy se získávají z dat o spotřebě, která Webex sleduje pro každého partnera. Webex každý den sleduje spotřebu všech partnerů, zákazníků a uživatelů za předchozí den a agreguje data, aby je bylo možné použít k vygenerování měsíční faktury partnera. Fakturační API využívají tato data a umožňují správcům partnerů generovat vlastní sestavy, aby partner mohl odsouhlasit spotřebu z 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

Tento postup použijte k vygenerování vlastní fakturační sestavy, kterou můžete použít k odsouhlasení fakturace.
1

Přejděte do rozhraní API pro vytvoření velkoobchodní fakturační sestavy.

2

Zadejte fakturační období zadáním hodnot pro billingStartDate a billingEndDate ve formátu určeném rozhraním API. Můžete zadat libovolné datum z posledních pěti let, ale ne aktuální den.

3

Zadejte Typ hlášení:

  • PARTNER (toto je výchozí nastavení) – Zobrazuje spotřebu na úrovni partnera.
  • ZÁKAZNÍK – Zobrazuje celkovou spotřebu rozdělenou podle úrovně zákaznických organizací v rámci partnera.
  • UŽIVATEL – Zobrazuje celkovou spotřebu rozdělenou na úroveň zákaznických organizací a předplatitelů v rámci partnera.
4

Klikněte na Spustit pro generování zprávy.

5

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

Chcete-li si stáhnout kopii zprávy, přejděte na Získat velkoobchodní fakturační zprávu.

Získejte zprávu o velkoobchodní fakturaci

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

Přejděte do rozhraní API pro získání velkoobchodní fakturační zprávy.

2

V řádku GET klikněte na tlačítko id a zadejte jedinečnou hodnotu ID pro sestavu.

3

Klikněte na Spustit.

4

Výstupy API hlásí stav. Výstup obsahuje parametr tempDownloadURL, který poskytuje URL adresu, ze které si můžete stáhnout sestavu.

5

Zkopírujte tempDownloadURL do prohlížeče, abyste si mohli stáhnout zprávu.

Seznam fakturačních sestav pro velkoobchod

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í – sestavy, které spadají do daného období, ale přesně neodpovídají datem, se nevrací.
1

Přejít na seznam API pro velkoobchodní fakturaci

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). Další podrobnosti o těchto parametrech naleznete v nápovědě pro vývojáře k rozhraní API.

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 zprávu o velkoobchodní fakturaci.

Smazání velkoobchodní fakturační zprávy

Tento postup použijte k odstranění vygenerované fakturační sestavy na základě ID sestavy. Mezi příklady, kdy můžete chtít smazat přehled, patří:

  • Pokud chcete znovu vytvořit existující fakturační sestavu, musíte ji nejprve smazat. Po odstranění existující sestavy můžete pro dané období vytvořit novou sestavu. Upozorňujeme, že požadavek na odstranění neexistuje, pokud se sestava nezdařila nebo se právě zpracovává.

  • Pokud se vygeneruje zpráva a odešlete URL nesprávné osobě, můžete zprávu smazat a tato osoba k ní nebude mít přístup.

1

Přejděte do rozhraní API pro odstranění velkoobchodní fakturační zprávy.

2

Zadejte ID sestavy .

3

Klikněte na Spustit.

Pole fakturačního reportu

Fakturační sestavy obsahují následující pole:

Pole

Další informace

Objevuje se v sestavách typu

JMÉNO PARTNERA_

Jméno partnera

PARTNER, ZÁKAZNÍK, UŽIVATEL

ID PARTNERA_ORGANIZACE_

Jedinečný identifikátor partnera

PARTNER, ZÁKAZNÍK, UŽIVATEL

ID PŘEDPLATNÉHO_

Jedinečný identifikátor předplatného

PARTNER, ZÁKAZNÍK, UŽIVATEL

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

SKU

SKU pro službu

PARTNER, ZÁKAZNÍK, UŽIVATEL

POPIS

Popis služby

PARTNER, ZÁKAZNÍK, UŽIVATEL

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

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

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:

Pro každého uživatele vypočítají denní množství poměrně pro daný den.

Použití po celý den = 1

Použití na půl dne = 0,5

Sečtou denní součty za všechny dny v rámci fakturačního období, aby vypočítali 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.

PARTNER, ZÁKAZNÍK, UŽIVATEL

ID ZÁKAZNÍKA_ORG_

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

ZÁKAZNÍK, UŽIVATEL

ZÁKAZNÍK_EXTERNÍ_ID

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

ZÁKAZNÍK, UŽIVATEL

ID ODBĚRATELE_

Jedinečný identifikátor pro předplatitele

UŽIVATEL

ID UŽIVATELE_

ID uživatele Webexu předplatitele

UŽIVATEL

PRACOVNÍ PROSTOR_ID

Jedinečný identifikátor pracovního prostoru

UŽIVATEL

ID LOKALITY_

Jedinečný identifikátor polohy

ZÁKAZNÍK, UŽIVATEL

LICENCE_ID

Identifikátor licence

Toto pole je viditelné pouze pro velkoobchodní balíčky. Pole License_ID je prázdné pro licence přiřazené před zavedením tohoto pole.

Fakturační sestava může zobrazovat více řádků pro stejný velkoobchodní balíček, přičemž každý řádek představuje jedinečný package/license Kombinace ID.

Pokud je přítomno pole LICENCE_ID, každý řádek představuje jedinečné package/location/license Kombinace ID.

ZÁKAZNÍK, UŽIVATEL

Zřízení balíčku uživateli spouští fakturaci Webex Wholesale, zatímco odebrání přiřazení balíčku ji zastaví.