Uzgadnianie rozliczeń

Administratorzy partnerów mogą używać interfejsów API rozliczeń hurtowych do generowania niestandardowych raportów rozliczeniowych, które wyświetlają zużycie zasobów na poziomie partnera, klienta lub użytkownika. Partnerzy mogą wykorzystać te informacje do uzgadniania swoich miesięcznych faktur, dzięki czemu mogą wystawiać rachunki swoim klientom i użytkownikom na podstawie ich zużycia.

Partnerzy mogą również generować niestandardowe raporty rozliczeniowe dla podpartnerów, korzystając z parametru subPartnerOrgId.

Administratorzy partnerscy, którzy spełniają minimalne wymagania dostępu, mają dostęp do czterech interfejsów API.

API rozliczeń

Cel API

Wymagania dotyczące dostępu administratora partnera

Utwórz raport rozliczeń hurtowych

Służy do generowania raportu rozliczeniowego.

Czytać / Pisać

Uzyskaj raport rozliczeń hurtowych

Służy do uzyskania wygenerowanego raportu rozliczeniowego do pobrania.

Czytaj

Wyświetl raporty rozliczeń hurtowych

Służy do wyświetlania listy raportów rozliczeniowych istniejących dla danego partnera.

Czytaj

Usuń raport rozliczeń hurtowych

Służy do usuwania istniejącego raportu rozliczeniowego.

Czytać / Pisać

Źródło danych

Dane do raportów rozliczeniowych pochodzą z danych o zużyciu, które Webex śledzi dla każdego partnera. Każdego dnia Webex śledzi zużycie energii przez wszystkich partnerów, klientów i użytkowników w ciągu poprzedniego dnia i agreguje dane, aby można je było wykorzystać do wygenerowania miesięcznej faktury dla partnera. Interfejsy API do rozliczeń wykorzystują te dane, umożliwiając administratorom partnerów generowanie niestandardowych raportów, dzięki którym partner może uzgadniać zużycie zasobów na podstawie miesięcznej faktury na poziomie partnera, klienta i użytkownika.

Aby uzyskać bardziej szczegółowe informacje na temat fakturowania partnerów przez firmę Webex, zapoznaj się z artykułem Rozliczenia dostawców usług.

Utwórz raport rozliczeń hurtowych

Użyj tej procedury, aby wygenerować niestandardowy raport rozliczeniowy, który możesz wykorzystać do uzgadniania rozliczeń.
1

Przejdź do interfejsu API tworzenia raportu rozliczeń hurtowych.

2

Wprowadź okres rozliczeniowy, wpisując wartości dla billingStartDate i billingEndDate w formacie określonym przez API. Można wpisać dowolną datę z ostatnich pięciu lat, ale nie dzień bieżący.

3

Wprowadź Typ raportu:

  • PARTNER (domyślne) — pokazuje zużycie na poziomie partnera.
  • KLIENT — przedstawia całkowite zużycie danych podzielone na poziom organizacji klienta podległego partnerowi.
  • UŻYTKOWNIK — przedstawia całkowite zużycie danych podzielone na poziom organizacji klientów i abonentów partnera.
4

Kliknij Uruchom, aby wygenerować raport.

5

Skopiuj raport id z wyjścia API. Możesz użyć tej wartości w interfejsie API Get w celu uzyskania wygenerowanego raportu rozliczeniowego.

Co zrobić dalej

Aby pobrać kopię raportu, przejdź do Pobierz raport rozliczeń hurtowych.

Uzyskaj raport rozliczeń hurtowych

Po wygenerowaniu raportu rozliczeniowego użyj tego interfejsu API, aby uzyskać konkretny raport rozliczeniowy. Raport jest przesyłany na adres URL, pod którym można go pobrać przez 30 minut od zakończenia żądania GET.
1

Przejdź do interfejsu API umożliwiającego uzyskanie raportu rozliczeń hurtowych.

2

W wierszu GET kliknij przycisk id i wprowadź unikalną wartość identyfikatora raportu.

3

Kliknij przycisk Uruchom.

4

Interfejs API generuje raport o stanie. Dane wyjściowe obejmują parametr tempDownloadURL, który zawiera adres URL, z którego można pobrać raport.

5

Skopiuj tempDownloadURL do przeglądarki, aby uzyskać dostęp do raportu i go pobrać.

Wyświetl raporty rozliczeń hurtowych

Użyj tego interfejsu API, aby uzyskać listę wygenerowanych raportów rozliczeniowych dla organizacji partnerskiej. Możesz wyświetlić listę wszystkich istniejących raportów lub ograniczyć ją do tych, które spełniają określone parametry, takie jak okres rozliczeniowy i typ rozliczenia (Partner, Klient, Użytkownik).

Jeśli wprowadzisz parametry opcjonalne, API zwróci tylko te raporty, które dokładnie odpowiadają wprowadzonym parametrom. Na przykład, jeśli wprowadzisz okres rozliczeniowy, zwrócone zostaną tylko raporty wykorzystujące ten konkretny okres rozliczeniowy — raporty, które mieszczą się w tym okresie, ale nie pokrywają się ściśle z datami, nie zostaną zwrócone.
1

Przejdź do interfejsu API raportu rozliczeń hurtowych listy

2

W obszarze Parametry zapytaniawprowadź dowolne parametry wyszukiwania, których chcesz użyć (na przykład datę rozpoczęcia, datę zakończenia, typ, sortowanie według). Więcej szczegółów na temat tych parametrów znajdziesz w pomocy dla programistów dotyczącej interfejsu API.

3

Kliknij przycisk Uruchom.

Interfejs API generuje listę raportów wraz z unikalnym identyfikatorem raportu i statusem (ZAKOŃCZONO, W TOKU_).

Co zrobić dalej

Zapisz identyfikator dla wszystkich raportów, które chcesz pobrać. Aby pobrać raport, przejdź do Pobierz raport rozliczeń hurtowych.

Usuń raport rozliczeń hurtowych

Użyj tej procedury, aby usunąć wygenerowany raport rozliczeniowy na podstawie identyfikatora raportu. Oto kilka przykładów sytuacji, w których możesz chcieć usunąć raport:

  • Jeśli chcesz wygenerować ponownie istniejący raport rozliczeniowy, musisz najpierw usunąć istniejący raport. Po usunięciu istniejącego raportu możesz utworzyć nowy raport za ten okres. Należy pamiętać, że wymóg usunięcia nie obowiązuje, jeśli raport zakończył się niepowodzeniem lub jest w trakcie tworzenia.

  • Jeśli raport zostanie wygenerowany i wyślesz adres URL do niewłaściwej osoby, możesz usunąć raport i ta osoba nie będzie miała do niego dostępu.

1

Przejdź do interfejsu API usuwania raportu rozliczeń hurtowych.

2

Wprowadź raport Identyfikator.

3

Kliknij przycisk Uruchom.

Pola raportu rozliczeniowego

Raporty rozliczeniowe zawierają następujące pola:

Pole

Dodatkowe informacje

Pojawia się w raportach tego typu

PARTNER_NAZWA

Nazwa partnera

PARTNER, KLIENT, UŻYTKOWNIK

PARTNER_ORG_ID

Unikalny identyfikator partnera

PARTNER, KLIENT, UŻYTKOWNIK

SUBSKRYPCJA_ID

Unikalny identyfikator subskrypcji

PARTNER, KLIENT, UŻYTKOWNIK

USŁUGA_NAZWA

Nazwa usługi

(np. WSPÓLNE_OBSZAR_POŁĄCZENIA, WEBEX_POŁĄCZENIA, WEBEX_SUITE, WEBEX_SPOTKANIA)

PARTNER, KLIENT, UŻYTKOWNIK

JM

SKU dla usługi

PARTNER, KLIENT, UŻYTKOWNIK

OPIS

Opis usługi

PARTNER, KLIENT, UŻYTKOWNIK

ZUŻYCIE_DATA ROZPOCZĘCIA_

Rozpoczęcie korzystania z usługi. Ta wartość wraz z poniższym polem definiuje okres użytkowania.

PARTNER, KLIENT, UŻYTKOWNIK

KONSUMPCJA_KOŃCOWA_DATA

Zakończenie użytkowania usługi. Wartość ta wraz z poprzednim polem definiuje okres zużycia użytkowania.

PARTNER, KLIENT, UŻYTKOWNIK

ILOŚĆ

Reprezentuje zagregowane zużycie użytkowników na partnera, klienta lub użytkownika (w zależności od raportu i poziomu, na którym przeglądasz dane).

Obliczenie:

Obliczają dzienną ilość dla każdego użytkownika proporcjonalnie do danego dnia.

Stosowanie przez cały dzień = 1

Stosowanie przez pół dnia = 0,5

Sumują całkowite ilości danych za wszystkie dni okresu rozliczeniowego, aby obliczyć całkowitą ilość danych dla danego użytkownika w danym okresie rozliczeniowym.

W raportach na poziomie klienta i partnera sumy dla wszystkich użytkowników są agregowane w celu uzyskania łącznej ilości dla danego klienta lub partnera.

PARTNER, KLIENT, UŻYTKOWNIK

KLIENT_ORGANIZACJA_ID

Wewnętrzny unikalny identyfikator klienta

KLIENT, UŻYTKOWNIK

KLIENT_ZEWNĘTRZNY_ID

Unikalny identyfikator klienta podany przez partnera

KLIENT, UŻYTKOWNIK

ID SUBSKRYBENTA_

Unikalny identyfikator subskrybenta

UŻYTKOWNIK

IDENTYFIKATOR UŻYTKOWNIKA_

Identyfikator użytkownika Webex subskrybenta

UŻYTKOWNIK

PRZESTRZEŃ ROBOCZA_ID

Unikalny identyfikator obszaru roboczego

UŻYTKOWNIK

LOKALIZACJA_ID

Unikalny identyfikator lokalizacji

KLIENT, UŻYTKOWNIK

LICENCJA_ID

Identyfikator licencji

To pole widoczne jest tylko dla pakietów hurtowych. Pole License_jest puste w przypadku licencji przypisanych przed wprowadzeniem tego pola.

Raport rozliczeniowy może zawierać wiele wierszy dla tego samego pakietu hurtowego, przy czym każdy wiersz reprezentuje unikalny pakiet. package/license Kombinacja identyfikatorów.

Jeżeli pole LICENSE_ID jest obecne, każdy wiersz reprezentuje unikalny package/location/license Kombinacja identyfikatorów.

KLIENT, UŻYTKOWNIK

Dostarczenie pakietu użytkownikowi powoduje uruchomienie rozliczeń w ramach usługi Webex Wholesale, natomiast usunięcie przypisania pakietu powoduje jego zatrzymanie.