Odsouhlasení fakturace

Správci partnerů mohou používat rozhraní API velkoobchodní fakturace k vygenerování vlastních fakturačních zpráv, které zobrazují spotřebu využití na úrovni partnera, zákazníka nebo uživatele. 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 v závislosti na jejich spotřebě využití.

Partneři mohou také generovat vlastní zprávy o fakturaci pro dílčí partnery pomocí parametru subPartnerOrgId.

Existují čtyři rozhraní API, která jsou k dispozici správcům partnerů, kteří splňují minimální požadavky na přístup.

Rozhraní API fakturace

Účel rozhraní API

Požadavek na přístup pro správce partnera

Vytvoření přehledu velkoobchodní fakturace

Slouží k vygenerování sestavy fakturace.

Čtení/zápis

Získání přehledu velkoobchodní fakturace

Slouží ke stažení vygenerované zprávy o fakturaci.

Číst

Výpis sestav velkoobchodní fakturace

Používá se k zobrazení seznamu sestav fakturace, které pro daného partnera existují.

Číst

Odstranění přehledu velkoobchodní fakturace

Slouží k odstranění existující sestavy fakturace.

Čtení/zápis

Zdroje dat

Data pro sestavy fakturace jsou čerpána z dat o spotřebě využití, která Webex sleduje pro každého partnera. Služba Webex každý den sleduje spotřebu využití za předchozí den pro všechny partnery, zákazníky a uživatele a agreguje data, aby je bylo možné použít k vygenerování měsíční faktury partnera. Rozhraní API fakturace využívají tato data a umožňují správcům partnerů vytvářet vlastní zprávy, aby partner mohl sladit spotřebu využití ze své měsíční faktury na úrovni partnera, zákazníka a uživatele.

Podrobnější informace o tom, jak partneři fakturují faktury Webex, najdete v tématu Fakturace poskytovateli služeb.

Vytvoření přehledu velkoobchodní fakturace

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

Přejděte do rozhraní API vytvořit velkoobchodní fakturační sestavu.

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 jakékoli datum za posledních pět let, ale ne aktuální den.

3

Zadejte typ sestavy:

  • PARTNER (výchozí) – Zobrazuje spotřebu využití na úrovni partnera.
  • ZÁKAZNÍK – Zobrazuje celkovou spotřebu využití rozdělenou na úroveň zákaznických organizací pod partnerem.
  • UŽIVATEL – Zobrazuje celkovou spotřebu využití rozdělenou na úroveň zákaznických organizací a podřízených pod partnerem.
4

Kliknutím na tlačítko Spustit vygenerujte zprávu.

5

Zkopírujte ID sestavy z výstupu rozhraní API. Tuto hodnotu můžete použít s rozhraním Get API, abyste získali vygenerovanou fakturační sestavu.

Co dělat dál

Chcete-li si stáhnout kopii sestavy, přejděte do části Získání přehledu velkoobchodní fakturace .

Získání přehledu velkoobchodní fakturace

Po vygenerování fakturační sestavy použijte toto rozhraní API k získání konkrétní fakturační sestavy. Zpráva získá výstup na adresu URL, kde je dostupná ke stažení po dobu 30 minut od dokončení požadavku GET.
1

Přejděte do rozhraní API velkoobchodní fakturace.

2

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

3

Klikněte na Spustit.

4

Rozhraní API vypíše stav sestavy. Výstup obsahuje parametr tempDownloadURL , který poskytuje adresu URL, ze které lze sestavu stáhnout.

5

Chcete-li získat přístup ke zprávě a stáhnout ji, zkopírujte adresu tempDownloadURL do prohlížeče.

Výpis sestav velkoobchodní fakturace

Pomocí tohoto rozhraní API získáte seznam vygenerovaných sestav fakturace pro organizaci partnera. Můžete zobrazit seznam všech existujících sestav nebo seznam omezit na sestavy, které splňují zadané parametry, jako je například vaše fakturační období a typ fakturace (partner, zákazník, uživatel).

Pokud zadáte volitelné parametry, rozhraní API vrátí pouze sestavy, které přesně odpovídají zadaným parametrům. Pokud například zadáte fakturační období, budou vráceny pouze sestavy, které používají dané fakturační období – sestavy, které spadají do daného období, ale neodpovídají přesně daným datům, nebudou vráceny.
1

Přejít do seznamu API přehledu velkoobchodní fakturace

2

V části Parametry dotazu zadejte všechny parametry hledání, které chcete použít (například startDate, endDate, Type, sortBy on). Další podrobnosti o těchto parametrech naleznete v nápovědě pro vývojáře v rozhraní API.

3

Klikněte na Spustit.

Rozhraní API zobrazí seznam sestav spolu s jedinečným ID sestavy a stavem (DOKONČENO, PROBÍHÁ_PROBÍHÁ).

Co dělat dál

Poznamenejte si ID pro všechny zprávy, které chcete stáhnout. Chcete-li sestavu stáhnout, přejděte do části Získání přehledu velkoobchodní fakturace .

Odstranění přehledu velkoobchodní fakturace

Tento postup slouží k odstranění vygenerované fakturační sestavy založené na ID sestavy. Několik příkladů, kdy můžete chtít sestavu odstranit:

  • Pokud chcete znovu vygenerovat existující sestavu fakturace, musíte ji nejprve odstranit. Po odstranění stávající sestavy můžete pro toto období vytvořit novou sestavu. Upozorňujeme, že požadavek na odstranění neexistuje, pokud hlášení selhalo nebo probíhá.

  • Pokud vygenerujete sestavu a odešlete adresu URL nesprávné osobě, můžete sestavu odstranit a ona k ní nebude mít přístup.

1

Přejděte do rozhraní API Odstranit velkoobchodní fakturační zprávu.

2

Zadejte ID sestavy.

3

Klikněte na Spustit.

Pole ve zprávě fakturace

Sestavy fakturace obsahují následující pole:

Pole

Další informace

Zobrazuje se v sestavách tohoto typu

JMÉNO_PARTNERA

Jméno partnera

partner, zákazník, uživatel

ID_ORGANIZACE_PARTNERA

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ř. ČASTÉ_Oblast_volání, webex_volání, webex_apartmá, 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

DATUM_ZAČÁTKU_SPOTŘEBY

Začátek spotřeby služby. Tato hodnota společně s níže uvedeným polem definuje období používání.

partner, zákazník, uživatel

DATUM_UKONČENÍ_SPOTŘEBY

Konec spotřeby služby. Společně s výše uvedeným polem tato hodnota definuje období spotřeby využití.

partner, zákazník, uživatel

množství

Představuje agregovanou spotřebu využití uživatelů na partnera, zákazníka nebo uživatele (v závislosti na sestavě a na úrovni, na které si data prohlížíte).

Výpočet:

Pro každého uživatele se množství za den vypočítá v poměrném poměru pro daný den. Příklad:

Využití za celý den = 1

Využití po dobu půl dne = 0,5

Celkové částky za den za všechny dny v rámci fakturačního období se sečtou tak, aby poskytovaly celkové množství pro daného uživatele v rámci tohoto fakturačního období.

V případě sestav na úrovni zákazníka a partnera jsou celkové hodnoty pro všechny uživatele agregovány tak, aby poskytovaly celkové množství pro daného zákazníka nebo partnera.

partner, zákazník, uživatel

ID_ORGANIZACE_ZÁKAZNÍKA

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

zákazník, uživatel

ID_EXTERNÍHO_ZÁKAZNÍKA

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 služby Webex předplatitele

UŽIVATEL

ID PRACOVNÍHO_PROSTORU

Jedinečný identifikátor pracovního prostoru

UŽIVATEL

ID_POBOČKY

Jedinečný identifikátor pobočky

zákazník, uživatel

Velkoobchodní fakturace Webex se aktivuje po zřízení balíčku uživateli nebo se zastaví odebráním přiřazení balíčku.