Узгодження рахунків

Адміністратори партнерів можуть використовувати API для виставлення рахунків Wholesale для створення користувацьких звітів про виставлення рахунків, які відображають споживання на рівні партнера, клієнта або користувача. Партнери можуть використовувати цю інформацію для узгодження своїх щомісячних рахунків-фактур, щоб вони могли виставляти рахунки своїм клієнтам і користувачам відповідно до їхнього використання.

Партнери також можуть створювати користувацькі звіти про виставлення рахунків для субпартнерів за допомогою параметра subPartnerOrgId.

Є чотири API, доступні адміністраторам партнерів, які відповідають мінімальним вимогам до доступу.

API виставлення рахунків

Мета API

Вимога до доступу адміністратора партнера

Створити звіт про виставлення рахунків оптового продажу

Використовується для формування розрахункового звіту.

Читання/запис

Отримати звіт про виставлення рахунків оптового продажу

Використовується для отримання створеного звіту про виставлення рахунків для завантаження.

Прочитано

Список звітів про виставлення рахунків оптового продажу

Використовується для перелічення звітів про виставлення рахунків, які існують для цього партнера.

Прочитано

Видалити звіт про виставлення рахунків оптового продажу

Використовується для видалення наявного звіту про оплату.

Читання/запис

Джерело даних

Дані для звітів про виставлення рахунків отримують з даних про споживання використання, які відстежує Webex для кожного партнера. Щодня Webex відстежує використання за попередній день для всіх партнерів, клієнтів і користувачів і агрегує дані, щоб їх можна було використовувати для створення щомісячного рахунка партнера. API для виставлення рахунків використовують ці дані, дозволяючи адміністраторам партнерів створювати користувацькі звіти, щоб партнер міг узгоджувати споживання використання зі своїм щомісячним рахунком на рівні партнера, клієнта й користувача.

Докладну інформацію про способи виставлення рахунків Webex партнерів див. в розділі Виставлення рахунків постачальником послуг.

Створити звіт про виставлення рахунків оптового продажу

Використовуйте цю процедуру, щоб створити користувацький звіт про виставлення рахунків, який можна використовувати для узгодження виставлення рахунків.
1

Перейдіть до API звіту про виставлення рахунків оптового продажу.

2

Введіть платіжний період, ввівши значення для billingStartDate і billingEndDate у форматі, який визначено API. Можна ввести будь-яку дату останніх п’яти років, але не поточну.

3

Введіть Тип звіту:

  • ПАРТНЕР (це за замовчуванням) — показує споживання використання на рівні партнера.
  • КЛІЄНТ — показує загальне споживання використання з розбиттям до рівня організацій клієнтів у партнері.
  • КОРИСТУВАЧ — Показує загальне споживання використання з розбиттям до рівня клієнтських організацій і субпідрядників під партнером.
4

Клацніть Запустити , щоб створити звіт.

5

Скопіюйте ідентифікатор звіту з виводу API. Це значення можна використовувати з API Get, щоб отримати згенерований звіт про виставлення рахунків.

Що далі

Щоб завантажити копію звіту, перейдіть до розділу Отримати звіт про виставлення рахунків Wholesale .

Отримати звіт про виставлення рахунків оптового продажу

Після створення звіту про виставлення рахунків використовуйте цей API, щоб отримати конкретний звіт про виставлення рахунків. Звіт буде виведено за URL-адресою, де він буде доступний для завантаження впродовж 30 хвилин після завершення запиту GET.
1

Перейдіть до API звіту про виставлення рахунків оптового продажу.

2

У рядку GET клацніть кнопку id і введіть унікальне значення ідентифікатора для звіту.

3

Натисніть кнопку Виконати.

4

Звітувати про стан виходів API. Вивід включає параметр tempDownloadURL , який надає URL-адресу, з якої можна завантажити звіт.

5

Скопіюйте tempDownloadURL у браузер, щоб отримати доступ до звіту й завантажити його.

Список звітів про виставлення рахунків оптового продажу

Використовуйте цей API, щоб отримати список згенерованих звітів про виставлення рахунків для партнерської організації. Можна створити список усіх наявних звітів або обмежити список тими звітами, які відповідають зазначеним параметрам, як-от період виставлення рахунків і тип виставлення рахунків (партнер, клієнт, користувач).

Якщо ви вводите необов’язкові параметри, API повертає лише ті звіти, які точно відповідають введеному вами параметрам. Наприклад, якщо ви введете платіжний період, повертаються лише звіти, які використовують цей конкретний платіжний період — звіти, які припадають на цей період, але які не відповідають датам, не повертаються.
1

Перейти до API звіту про виставлення рахунків оптового продажу

2

У розділі Параметри запиту введіть будь-які параметри пошуку, які потрібно використовувати (наприклад, startDate, endDate, type, sortBy on). Додаткові відомості про ці параметри див. у довідці для розробників щодо API.

3

Натисніть кнопку Виконати.

API виводить список звітів разом із унікальним ідентифікатором звіту й станом (ЗАВЕРШЕНО, ТРИВАЄ_ВИКОНАННЯ).

Що далі

Візьміть запис ідентифікатора для всіх звітів, які потрібно завантажити. Щоб завантажити звіт, перейдіть до розділу Отримати звіт про виставлення рахунків Wholesale .

Видалити звіт про виставлення рахунків оптового продажу

Використовуйте цю процедуру, щоб видалити створений звіт про виставлення рахунків на основі ідентифікатора звіту. Кілька прикладів, де ви можете видалити звіт, включають:

  • Щоб повторно створити наявний звіт про виставлення рахунків, спочатку необхідно видалити наявний звіт. Після видалення наявного звіту можна створити новий звіт за цей період. Зверніть увагу, що вимога щодо видалення не існує, якщо звіт не виконано або він триває.

  • Якщо звіт створено й ви надішлете URL-адресу не тій особі, ви можете видалити звіт, і вони не матимуть до нього доступу.

1

Перейдіть до API звіту про виставлення рахунків оптового продажу.

2

Введіть ідентифікатор звіту.

3

Натисніть кнопку Виконати.

Поля звіту про виставлення рахунків

Звіти про виставлення рахунків містять такі поля:

Поле

Додаткова інформація

Відображається в звітах цього типу

_ІМ’Я ПАРТНЕРА

Ім’я партнера

партнер, клієнт, користувач

ІДЕНТИФІКАТОР_ОРГАНІЗАЦІЇ_ ПАРТНЕРА

Унікальний ідентифікатор партнера

партнер, клієнт, користувач

ІДЕНТИФІКАТОР_ПІДПИСКИ

Унікальний ідентифікатор підписки

партнер, клієнт, користувач

ІМ’Я_СЛУЖБИ

Ім’я служби

(наприклад, ЗАГАЛЬНІ_ВИКЛИКИ_ОБЛАСТІ, WEBEX_CALLING, WEBEX_SUITE, WEBEX_MEETINGS)

партнер, клієнт, користувач

SKU

Sku для служби

партнер, клієнт, користувач

опис

Опис служби

партнер, клієнт, користувач

ДАТА ПОЧАТКУ__СПОЖИВАННЯ

Початок споживання послуг. Разом із полем нижче це значення визначає період використання.

партнер, клієнт, користувач

ДАТА ЗАВЕРШЕННЯ__СПОЖИВАННЯ

Кінець споживання послуг. Разом із вищезгаданим полем це значення визначає період споживання.

партнер, клієнт, користувач

кількість

Відображає сукупне споживання користувачами в розрахунку на партнера, клієнта або користувача (залежно від звіту та рівня, на якому ви переглядаєте дані).

Розрахунок:

Для кожного користувача кількість на день розраховується на пропорційній основі на цей день. Наприклад:

Використання протягом повного дня = 1

Використання протягом півдня = 0,5

Денні підсумки за всі дні в межах платіжного періоду підсумовуються, щоб надати загальну кількість для цього користувача в межах цього платіжного періоду.

Для звітів на рівні клієнта та партнера підсумки для всіх користувачів агрегуються, щоб забезпечити загальну кількість для цього клієнта чи партнера.

партнер, клієнт, користувач

ІДЕНТИФІКАТОР_ОРГАНІЗАЦІЇ_ КЛІЄНТА

Унікальний ідентифікатор внутрішнього клієнта

клієнт, користувач

_ЗОВНІШНІЙ_ІДЕНТИФІКАТОР КЛІЄНТА

Унікальний ідентифікатор клієнта, наданий партнером

клієнт, користувач

ІДЕНТИФІКАТОР_АБОНЕНТА

Унікальний ідентифікатор абонента

КОРИСТУВАЧ

ІДЕНТИФІКАТОР КОРИСТУВАЧА_

Ідентифікатор користувача Webex абонента

КОРИСТУВАЧ

ІДЕНТИФІКАТОР_РОБОЧОЇ ОБЛАСТІ

Унікальний ідентифікатор робочої області

КОРИСТУВАЧ

ІДЕНТИФІКАТОР_РОЗТАШУВАННЯ

Унікальний ідентифікатор розташування

клієнт, користувач

Виставлення рахунків Webex Wholesale запускається шляхом надання пакета користувачу або зупиняється шляхом видалення призначення пакета.