Сверка счетов

Администраторы партнеров могут использовать API оптового выставления счетов для создания индивидуальных отчетов по счетам, которые отображают потребление ресурсов на уровне каждого партнера, каждого клиента или каждого пользователя. Партнеры могут использовать эту информацию для сверки своих ежемесячных счетов, чтобы выставлять счета своим клиентам и пользователям в соответствии с их потреблением.

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

Администраторам-партнерам, отвечающим минимальным требованиям доступа, доступны четыре API.

API биллинга

Назначение API

Требование к доступу администратора партнера

Создайте отчет по оптовым счетам

Используется для формирования отчета по выставлению счетов.

Читать / Писать

Получить отчет по оптовым счетам

Используется для получения сформированного отчета по выставлению счетов для загрузки.

Прочитать

Список отчетов по оптовым счетам

Используется для составления списка отчетов по выставлению счетов, которые существуют для данного партнера.

Прочитать

Удалить отчет по оптовым счетам

Используется для удаления существующего отчета по выставлению счетов.

Читать / Писать

Источник данных

Данные для отчетов по выставлению счетов извлекаются из данных об использовании ресурсов, которые Webex отслеживает для каждого партнера. Каждый день Webex отслеживает потребление ресурсов за предыдущий день для всех партнеров, клиентов и пользователей и объединяет данные, чтобы их можно было использовать для формирования ежемесячного счета партнера. API-интерфейсы выставления счетов используют эти данные, позволяя администраторам партнеров создавать индивидуальные отчеты, чтобы партнеры могли сверять данные об использовании ресурсов со своими ежемесячными счетами на уровне партнера, клиента и пользователя.

Более подробную информацию о том, как Webex выставляет счета партнерам, см. в разделе Выставление счетов поставщикам услуг.

Создайте отчет по оптовым счетам

Используйте эту процедуру для создания индивидуального отчета по выставлению счетов, который можно использовать для сверки счетов.
1

Перейдите на страницу API создания отчета по оптовым счетам.

2

Введите расчетный период, введя значения для billingStartDate и billingEndDate в формате, указанном API. Вы можете ввести любую дату за последние пять лет, но не текущий день.

3

Введите Тип отчета:

  • ПАРТНЕР (по умолчанию) — показывает потребление на уровне партнера.
  • КЛИЕНТ — показывает общее потребление ресурсов с разбивкой по уровню организаций-клиентов партнера.
  • USER — показывает общее потребление с разбивкой по уровню организаций-клиентов и подписчиков партнера.
4

Нажмите Выполнить, чтобы создать отчет.

5

Скопируйте идентификатор отчета из вывода API. Вы можете использовать это значение с API Get, чтобы получить сгенерированный отчет по выставлению счетов.

Дальнейшие действия

Перейдите по ссылке Получить отчет по оптовым счетам, чтобы загрузить копию отчета.

Получить отчет по оптовым счетам

После создания отчета по выставлению счетов используйте этот 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 выводит список отчетов вместе с уникальным идентификатором отчета и статусом (ЗАВЕРШЕН, В_ХОДЕ).

Дальнейшие действия

Запишите идентификатор для всех отчетов, которые вы хотите загрузить. Перейдите по ссылке Получить отчет по оптовым счетам, чтобы загрузить отчет.

Удалить отчет по оптовым счетам

Используйте эту процедуру для удаления отчета по выставлению счетов, созданного на основе идентификатора отчета. Вот несколько примеров, когда вам может потребоваться удалить отчет:

  • Если вы хотите повторно создать существующий отчет по выставлению счетов, вам необходимо сначала удалить существующий отчет. После удаления существующего отчета вы можете создать новый отчет за этот период. Обратите внимание, что требование об удалении не действует, если отчет не был обработан или находится в процессе выполнения.

  • Если отчет создан и вы отправили URL-адрес не тому человеку, вы можете удалить отчет, и он не сможет получить к нему доступ.

1

Перейдите к API удаления отчета по оптовым счетам.

2

Введите идентификатор отчета .

3

Нажмите кнопку Запуск.

Поля отчета по выставлению счетов

Отчеты о выставлении счетов содержат следующие поля:

Поле

Дополнительная информация

Появляется в отчетах типа

ИМЯ ПАРТНЕРА_

Имя партнера

ПАРТНЕР, КЛИЕНТ, ПОЛЬЗОВАТЕЛЬ

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

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

ПАРТНЕР, КЛИЕНТ, ПОЛЬЗОВАТЕЛЬ

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

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

ПАРТНЕР, КЛИЕНТ, ПОЛЬЗОВАТЕЛЬ

ИМЯ УСЛУГИ_

Название услуги

(например, ОБЩАЯ_ЗОНА_ВЫЗОВЫ, WEBEX_ВЫЗОВЫ, WEBEX_КОМНАТА, WEBEX_ВСТРЕЧИ)

ПАРТНЕР, КЛИЕНТ, ПОЛЬЗОВАТЕЛЬ

SKU

Артикул для услуги

ПАРТНЕР, КЛИЕНТ, ПОЛЬЗОВАТЕЛЬ

ОПИСАНИЕ

Описание услуги

ПАРТНЕР, КЛИЕНТ, ПОЛЬЗОВАТЕЛЬ

ПОТРЕБЛЕНИЕ_НАЧАЛО_ДАТА

Начало потребления услуги. Вместе со следующим полем это значение определяет период использования.

ПАРТНЕР, КЛИЕНТ, ПОЛЬЗОВАТЕЛЬ

ПОТРЕБЛЕНИЕ_КОНЕЦ_ДАТА

Окончание использования услуги. Вместе с предыдущим полем это значение определяет период потребления использования.

ПАРТНЕР, КЛИЕНТ, ПОЛЬЗОВАТЕЛЬ

КОЛИЧЕСТВО

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

Расчет:

Они рассчитывают дневное количество для каждого пользователя пропорционально этому дню.

Использование в течение всего дня = 1

Использование в течение половины дня = 0,5

Они суммируют итоговые значения за все дни расчетного периода, чтобы рассчитать общее количество для данного пользователя за этот расчетный период.

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

ПАРТНЕР, КЛИЕНТ, ПОЛЬЗОВАТЕЛЬ

КЛИЕНТ_ОРГ_ИДЕНТИФИКАТОР

Внутренний уникальный идентификатор клиента

КЛИЕНТ, ПОЛЬЗОВАТЕЛЬ

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

Уникальный идентификатор клиента, предоставленный партнером

КЛИЕНТ, ПОЛЬЗОВАТЕЛЬ

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

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

USER

USER_ID

Идентификатор пользователя Webex подписчика

USER

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

Уникальный идентификатор рабочего пространства

USER

МЕСТОПОЛОЖЕНИЕ_ИДЕНТИФИКАТОР

Уникальный идентификатор местоположения

КЛИЕНТ, ПОЛЬЗОВАТЕЛЬ

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

Идентификатор лицензии

Это поле видно только для оптовых пакетов. Идентификатор License_пуст для лицензий, назначенных до введения этого поля.

В отчете по выставлению счетов может отображаться несколько строк для одного и того же оптового пакета, при этом каждая строка представляет собой уникальный package/license Комбинация идентификаторов.

Если присутствует поле идентификатора LICENSE_, каждая строка представляет собой уникальный package/location/license Комбинация идентификаторов.

КЛИЕНТ, ПОЛЬЗОВАТЕЛЬ

Предоставление пакета пользователю запускает выставление счетов Webex Wholesale, а удаление назначения пакета останавливает его.