Звірка рахунків

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

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

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

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

Призначення API

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

Створення звіту про оптові рахунки

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

Читати / Написати

Отримайте звіт про оптові рахунки

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

Читати

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

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

Читати

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

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

Читати / Написати

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

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

Для отримання детальнішої інформації про те, як Webex виставляє рахунки партнерам, див. Виставлення рахунків постачальникам послуг.

Створення звіту про оптові рахунки

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

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

2

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

3

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

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

Натисніть Виконати, щоб створити звіт.

5

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

Що далі

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

Отримайте звіт про оптові рахунки

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

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

2

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

3

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

4

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

5

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

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

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

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

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

2

У розділі Параметри запитувведіть будь-які параметри пошуку, які ви хочете використовувати (наприклад, початковаДата, кінцеваДата, Тип, сортування за). Щоб отримати додаткові відомості про ці параметри, див. довідку для розробників з API.

3

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

API виводить список звітів разом з унікальним ідентифікатором звіту та статусом (ЗАВЕРШЕНО, В ПРОЦЕСІ_).

Що далі

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

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

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

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

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

1

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

2

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

3

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

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

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

Поле

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

З'являється у звітах типу

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

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

ПАРТНЕР, КЛІЄНТ, КОРИСТУВАЧ

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

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

ПАРТНЕР, КЛІЄНТ, КОРИСТУВАЧ

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

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

ПАРТНЕР, КЛІЄНТ, КОРИСТУВАЧ

НАЗВА ПОСЛУГИ_

Назва послуги

(наприклад, ЗАГАЛЬНА_ЗОНА_ДЗВІНОК, WEBEX_ДЗВІНОК, WEBEX_ЛЮКС, WEBEX_ЗУСТРІЧІ)

ПАРТНЕР, КЛІЄНТ, КОРИСТУВАЧ

SKU

SKU для послуги

ПАРТНЕР, КЛІЄНТ, КОРИСТУВАЧ

ОПИС

Опис послуги

ПАРТНЕР, КЛІЄНТ, КОРИСТУВАЧ

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

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

ПАРТНЕР, КЛІЄНТ, КОРИСТУВАЧ

СПОЖИВАННЯ_КІНЕЦЬ_ДАТА

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

ПАРТНЕР, КЛІЄНТ, КОРИСТУВАЧ

КІЛЬКІСТЬ

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

Розрахунок:

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

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

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

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

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

ПАРТНЕР, КЛІЄНТ, КОРИСТУВАЧ

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

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

КЛІЄНТ, КОРИСТУВАЧ

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

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

КЛІЄНТ, КОРИСТУВАЧ

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

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

КОРИСТУВАЧ

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

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

КОРИСТУВАЧ

ІДЕНТИФІКАТОР РОБОЧОГО ПРОСТОРУ_

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

КОРИСТУВАЧ

Ідентифікатор місцезнаходження_

Унікальний ідентифікатор місцезнаходження

КЛІЄНТ, КОРИСТУВАЧ

ЛІЦЕНЗІЯ_ІДЕНТИФІКАТОР

Ідентифікатор ліцензії

Це поле видиме лише для оптових упаковок. Поле License_ID залишається порожнім для ліцензій, призначених до появи цього поля.

Звіт про виставлення рахунків може відображати кілька рядків для одного й того ж оптового пакету, причому кожен рядок представляє унікальний package/license Комбінація ідентифікаторів.

Якщо поле LICENSE_ID присутнє, кожен рядок представляє унікальний package/location/license Комбінація ідентифікаторів.

КЛІЄНТ, КОРИСТУВАЧ

Надання пакета користувачеві запускає оптове виставлення рахунків Webex, а видалення призначення пакета зупиняє його.