Uzgadnianie rozliczeń

Administratorzy partnerów mogą korzystać z interfejsów API do rozliczania Wholesale do generowania niestandardowych raportów rozliczeniowych, które wyświetlają wykorzystanie na poziomie partnera, klienta lub użytkownika. Partnerzy mogą użyć tych informacji do uzgodnienia miesięcznych faktur, aby mogli wystawiać rachunki swoim klientom i użytkownikom zgodnie z ich zużyciem.

Partnerzy mogą również generować niestandardowe raporty rozliczeniowe dla podpartnerów przy użyciu parametru subPartnerOrgId.

Istnieją cztery interfejsy API, które są dostępne dla administratorów partnerskich, którzy spełniają minimalne wymagania dostępu.

Interfejs API rozliczeń

Cel interfejsu API

Wymaganie dostępu administratora partnera

Utwórz raport rozliczeniowy Wholesale

Służy do generowania raportu rozliczeniowego.

Odczyt / zapis

Uzyskiwanie raportu rozliczeniowego Wholesale

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

Czytaj

Wyświetl raporty rozliczeniowe Wholesale

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

Czytaj

Usuwanie raportu rozliczeniowego Wholesale

Służy do usunięcia istniejącego raportu rozliczeniowego.

Odczyt / zapis

Źródło danych

Dane na potrzeby raportów rozliczeniowych są pobierane z danych o wykorzystaniu, które usługa Webex śledzi dla każdego partnera. Każdego dnia usługa Webex śledzi zużycie w poprzednim dniu dla wszystkich partnerów, klientów i użytkowników oraz agreguje dane, dzięki czemu można je wykorzystać do wygenerowania miesięcznej faktury partnera. Interfejsy API rozliczeń wykorzystują te dane, umożliwiając administratorom partnerów generowanie niestandardowych raportów, aby partner mógł uzgodnić zużycie na podstawie miesięcznej faktury na poziomie partnera, klienta i użytkownika.

Aby uzyskać bardziej szczegółowe informacje na temat partnerów faktur Webex, zobacz Rozliczanie dostawcy usług.

Utwórz raport rozliczeniowy Wholesale

Ta procedura służy do wygenerowania niestandardowego raportu rozliczeniowego, którego można użyć do uzgadniania rozliczeń.
1

Przejdź do interfejsu API tworzenia raportu rozliczeniowego Wholesale.

2

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

3

Wprowadź Typ raportu:

  • PARTNER (jest to ustawienie domyślne) — pokazuje wykorzystanie na poziomie partnera.
  • KLIENT — pokazuje łączne użycie w podziale na poziom organizacji klientów w ramach partnera.
  • UŻYTKOWNIK — pokazuje łączne użycie w podziale na poziom organizacji klientów i poddostawców w ramach partnera.
4

Kliknij przycisk Uruchom , aby wygenerować raport.

5

Skopiuj identyfikator raportu z wyniku interfejsu API. W celu uzyskania wygenerowanego raportu rozliczeniowego można użyć tej wartości z interfejsem API Get.

Co zrobić dalej

Przejdź do sekcji Pobierz raport rozliczeniowy Wholesale , aby pobrać kopię raportu.

Uzyskiwanie raportu rozliczeniowego Wholesale

Po wygenerowaniu raportu rozliczeniowego użyj tego interfejsu API, aby uzyskać konkretny raport rozliczeniowy. Raport zostaje wygenerowany na adres URL, pod którym jest dostępny do pobrania przez 30 minut po zakończeniu żądania GET.
1

Przejdź do interfejsu API pobierania raportu rozliczeniowego Wholesale.

2

W wierszu GET kliknij przycisk identyfikator i wprowadź unikatową wartość identyfikatora dla raportu.

3

Kliknij przycisk Uruchom.

4

Interfejs API wyświetla stan raportu. Dane wyjściowe zawierają parametr tempDownloadURL , który zawiera adres URL, z którego można pobrać raport.

5

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

Wyświetl raporty rozliczeniowe Wholesale

Za pomocą tego interfejsu API można uzyskać listę wygenerowanych raportów rozliczeniowych dla organizacji partnerskiej. Można wyświetlić listę wszystkich istniejących raportów lub ograniczyć ją do raportów, które spełniają określone parametry, takie jak okres rozliczeniowy i typ rozliczeniowy (partner, klient, użytkownik).

Jeśli wprowadzisz opcjonalne parametry, API zwraca tylko te raporty, które odpowiadają dokładnie wprowadzonym parametrom. Na przykład w przypadku wprowadzenia okresu rozliczeniowego zwracane są tylko raporty używające tego konkretnego okresu rozliczeniowego — raporty mieszczące się w tym okresie, ale niedokładnie zgodne z datami, nie są zwracane.
1

Przejdź do interfejsu API raportu rozliczeniowego Wholesale

2

W obszarze Parametry zapytania wprowadź wszystkie parametry wyszukiwania, których chcesz użyć (na przykład data startDate, endDate, Type, sortBy on). Dodatkowe informacje na temat tych parametrów można znaleźć w pomocy dla programistów w API.

3

Kliknij przycisk Uruchom.

API wyświetla listę raportów wraz z unikatowym identyfikatorem raportu i stanem (UKOŃCZONE, W_TOKU).

Co zrobić dalej

Zanotuj identyfikator wszystkich raportów, które chcesz pobrać. Aby pobrać raport, przejdź do sekcji Pobierz raport rozliczeniowy .

Usuwanie raportu rozliczeniowego Wholesale

Ta procedura służy do usunięcia wygenerowanego raportu rozliczeniowego na podstawie identyfikatora raportu. Kilka przykładów usunięcia raportu:

  • Jeśli chcesz ponownie wygenerować istniejący raport rozliczeniowy, najpierw należy usunąć istniejący raport. Po usunięciu istniejącego raportu można utworzyć nowy raport dla tego okresu. Należy pamiętać, że wymóg usuwania nie istnieje, jeśli raport nie powiódł się lub jest w toku.

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

1

Przejdź do interfejsu API usuwania raportu rozliczeniowego Wholesale.

2

Wprowadź identyfikator raportu.

3

Kliknij przycisk Uruchom.

Pola raportu rozliczeniowego

Raporty rozliczeniowe zawierają następujące pola:

Pole

Dodatkowe informacje

Pojawia się w raportach tego typu

NAZWA_PARTNERA

Nazwa partnera

partner, klient, użytkownik

IDENTYFIKATOR_ORGANIZACJI_PARTNERA

Unikatowy identyfikator partnera

partner, klient, użytkownik

IDENTYFIKATOR_SUBSKRYPCJI

Unikatowy identyfikator subskrypcji

partner, klient, użytkownik

NAZWA_USŁUGI

Nazwa usługi

(np. POŁĄCZENIA OBSZARU__WSPÓLNEGO, POŁĄCZENIA WEBEX_CALLING, WEBEX_SUITE, WEBEX_MEETINGS)

partner, klient, użytkownik

JM

JM dla usługi

partner, klient, użytkownik

opis

Opis usługi

partner, klient, użytkownik

DATA_ROZPOCZĘCIA_KONSUMPCJI

Początek zużycia usługi. Wraz z poniższym polem ta wartość określa okres użycia.

partner, klient, użytkownik

DATA_ZAKOŃCZENIA_KONSUMPCJI

Koniec zużycia usługi. Wraz z powyższym polem ta wartość określa okres użytkowania.

partner, klient, użytkownik

liczba

Reprezentuje zagregowane użycie użytkowników na partnera, na klienta lub na użytkownika (w zależności od raportu i poziomu wyświetlania danych).

Obliczanie:

Dla każdego użytkownika ilość dzienna jest obliczana w sposób proporcjonalny dla danego dnia. Na przykład:

Użycie przez cały dzień = 1

Użycie przez pół dnia = 0,5

Sumy dzienne dla wszystkich dni w okresie rozliczeniowym są sumowane, aby zapewnić łączną ilość dla tego użytkownika w tym okresie rozliczeniowym.

W przypadku raportów na poziomie klienta i partnera sumy dla wszystkich użytkowników są agregowane, aby zapewnić łączną ilość dla tego klienta lub partnera.

partner, klient, użytkownik

IDENTYFIKATOR_ORGANIZACJI_KLIENTA

Wewnętrzny unikatowy identyfikator klienta

klient, użytkownik

IDENTYFIKATOR_ZEWNĘTRZNY_KLIENTA

Unikatowy identyfikator klienta podany przez partnera

klient, użytkownik

IDENTYFIKATOR_SUBSKRYBENTA

Unikatowy identyfikator abonenta

UŻYTKOWNIK

IDENTYFIKATOR UŻYTKOWNIKA_

Identyfikator użytkownika Webex subskrybenta

UŻYTKOWNIK

IDENTYFIKATOR_OBSZARU ROBOCZEGO

Unikatowy identyfikator obszaru roboczego

UŻYTKOWNIK

IDENTYFIKATOR_LOKALIZACJI

Unikatowy identyfikator lokalizacji

klient, użytkownik

Rozliczenia Webex Wholesale są wyzwalane przez udostępnienie pakietu do użytkownika lub zatrzymywane przez usunięcie przypisania pakietu.