Благодарим вас за обратную связь.
Отчеты о выставлении счетов по оптовым каналам сбыта
Отправить обратную связь?Отчеты по выставлению счетов
Партнеры могут использовать следующие API для оптового выставления счетов, чтобы создавать отчеты о выставлении счетов, которые помогают им проверять точность использования и предоставления ресурсов. Доступ к API для оптовых платежей осуществляется через developer.webex.com.
-
Сверка — отображает данные об использовании на уровне партнера, клиента или пользователя. Партнеры могут использовать информацию из этого пользовательского отчета по выставлению счетов для сверки своих ежемесячных счетов, чтобы выставлять счета своим клиентам и пользователям в соответствии с их потреблением.
-
Отображает текущее распределение пакетов услуг на уровне клиента или пользователя. Отчет «На определенный момент времени» предоставляет данные о количестве выделенных пакетов в режиме реального времени. Партнеры могут использовать эту информацию для проверки точности предоставления услуг и обеспечения соответствия заказам клиентов.
Партнеры также могут создавать пользовательские отчеты по выставлению счетов для субпартнеров, используя параметр subPartnerOrgId.
Администраторам-партнерам, отвечающим минимальным требованиям к доступу, доступны четыре API.
|
API для выставления счетов |
Назначение API |
Требования к административным правам партнера |
|---|---|---|
|
Создать отчет по оптовым продажам |
Используется для формирования отчета по выставлению счетов. |
Read/write |
|
Получите отчет по оптовым продажам |
Используется для получения сгенерированного отчета о выставлении счетов для скачивания. |
Прочитать |
|
Отчеты по оптовым продажам |
Используется для отображения существующих отчетов по выставлению счетов для данного партнера. |
Прочитать |
|
Удаление отчета по оптовым продажам |
Используется для удаления существующего отчета по выставлению счетов. |
Read/write |
Источник данных
Данные для отчетов по выставлению счетов берутся из назначений пакетов и данных об использовании, которые Webex отслеживает для каждого партнера. Webex ежедневно собирает данные о пакетах услуг клиентов и пользователей для формирования ежемесячного счета-фактуры для партнера. API для выставления счетов используют эти данные, позволяя администраторам партнеров создавать пользовательские отчеты. Эти отчеты помогают партнерам сверять данные об использовании ресурсов, указанные в ежемесячном счете, на уровне партнеров, клиентов и пользователей.
Более подробную информацию о том, как Webex выставляет счета партнерам, см. в разделе Выставление счетов поставщику услуг.
Создать отчет по оптовым продажам
| 1 |
На сайте developer.webex.comперейдите в Создать API для оптовых счетов. |
| 2 |
Выберите одну из следующих категорий отчетов:
Если вы хотите создать отчет о сверке, ничего менять не нужно, поскольку сверка выбрана по умолчанию, поэтому вы можете перейти к следующему шагу. Если вы хотите создать отчет по отдельным моментам времени, измените параметр на «Отчет по отдельным моментам времени». |
| 3 |
Введите billingStartDate и billingEndDate в формате, указанном в API. Вы можете ввести любую дату за последние пять лет, но не текущий день. Для отчета «На определенный момент времени» поля billingStartDate и billingEndDate не являются обязательными и игнорируются, если в них введены данные. В отчете всегда отражается текущее распределение пакетов услуг. |
| 4 |
Введите тип отчета:
|
| 5 |
Нажмите Выполнить, чтобы сгенерировать отчет. |
| 6 |
Скопируйте идентификатор отчета из выходных данных API. Вы можете использовать это значение с API Get для получения сгенерированного отчета о выставлении счетов. |
Дальнейшие действия
Перейдите в раздел Получить отчет по оптовым продажам, чтобы загрузить копию отчета.
Получите отчет по оптовым продажам
После формирования отчета по выставлению счетов используйте этот API для получения конкретного отчета по выставлению счетов. Отчет выводится по URL-адресу, где он доступен для скачивания в течение 30 минут после завершения GET-запроса.
| 1 |
С сайта developer.webex.comперейдите по ссылке Получить API отчета по оптовым платежам. |
| 2 |
Введите уникальное id значение для отчета и нажмите Запустить. API выводит статус отчета. В выходные данные входит параметр tempDownloadURL, который предоставляет URL-адрес, с которого можно загрузить отчет. |
| 3 |
Скопируйте tempDownloadURL в браузер, чтобы получить доступ к отчету и загрузить его. |
Отчеты по оптовым продажам
Используйте этот API для получения списка сгенерированных отчетов по выставлению счетов для партнерской организации. Вы можете отобразить список всех существующих отчетов или ограничить список только теми отчетами, которые соответствуют указанным параметрам, таким как расчетный период и тип выставления счетов (Партнер, клиент, пользователь).
Если вы укажете необязательные параметры, API вернет только те отчеты, которые точно соответствуют указанным вами параметрам. Например, если вы укажете расчетный период, будут возвращены только отчеты, использующие этот конкретный расчетный период. Отчеты, поступившие в указанный период, но не точно совпадающие с датами, не возвращаются.
| 1 |
С сайта developer.webex.comперейдите к List Wholesale Billing Report API. |
| 2 |
В поле Параметры запросавведите любые параметры поиска, которые вы хотите использовать (например, startDate, endDate, Type, sortBy on). |
| 3 |
Нажмите кнопку Запуск. API выводит список отчетов вместе с уникальным идентификатором отчета ( id ) и статусом (COMPLETED, IN_( PROGRESS)).
|
Дальнейшие действия
Запишите идентификатор для всех отчетов, которые вы хотите загрузить. Перейдите по ссылке Получить отчет по оптовым продажам, чтобы загрузить отчет.
Удалить отчет по оптовым продажам
Используйте эту процедуру для удаления сгенерированного отчета по выставлению счетов на основе идентификатора отчета. Вот несколько примеров ситуаций, когда вам может потребоваться удалить отчет:
-
Чтобы восстановить существующий отчет по сверке счетов, необходимо сначала удалить этот отчет. После удаления существующего отчета вы можете создать новый отчет за этот период. Удалить отчет нельзя, если его создание не удалось или оно еще продолжается.
Для создания отчета на определенный момент времени нет необходимости удалять существующий отчет, поскольку система не генерирует их заново. В каждом отчете всегда отражены данные по состоянию на текущую дату.
-
Если вы отправите URL-адрес сгенерированного отчета не тому человеку, вы можете удалить отчет, и он не сможет получить к нему доступ.
| 1 |
С сайта developer.webex.comперейдите в Удалить API отчета по оптовым платежам. |
| 2 |
Введите идентификатор отчета и нажмите Запустить. |
Поля отчета о выставлении счетов
В отчетах по выставлению счетов содержатся следующие поля:
|
Поле |
Описание |
Поддерживаемые типы отчетов |
Поддерживаемая категория отчетов |
|---|---|---|---|
|
ПАРТНЕР_ИМЯ |
Имя партнера |
ПАРТНЕР, КЛИЕНТ, ПОЛЬЗОВАТЕЛЬ |
Примирение, на определенный момент времени |
|
ПАРТНЕР_ОРГ_ИДЕНТИФИКАТОР |
Уникальный идентификатор партнера |
ПАРТНЕР, КЛИЕНТ, ПОЛЬЗОВАТЕЛЬ |
Примирение, на определенный момент времени |
|
ПОДПИСКА_ID |
Уникальный идентификатор подписки |
ПАРТНЕР, КЛИЕНТ, ПОЛЬЗОВАТЕЛЬ |
Примирение, на определенный момент времени |
|
НАЗВАНИЕ СЛУЖБЫ_ |
Название услуги (например, ОБЩАЯ_ЗОНА_ЗВОНКИ, ЗВОНКИ WEBEX_ЗВОНКИ, WEBEX_ПАКЕТ, WEBEX_СОБРАНИЯ) |
ПАРТНЕР, КЛИЕНТ, ПОЛЬЗОВАТЕЛЬ |
Примирение, на определенный момент времени |
|
SKU |
Артикул услуги |
ПАРТНЕР, КЛИЕНТ, ПОЛЬЗОВАТЕЛЬ |
Примирение, на определенный момент времени |
|
ОПИСАНИЕ |
Описание услуги |
ПАРТНЕР, КЛИЕНТ, ПОЛЬЗОВАТЕЛЬ |
Примирение, на определенный момент времени |
|
РАСХОД_НАЧАЛО_ДАТА |
Начало использования услуги. Наряду с указанным ниже полем, это значение определяет период использования. |
ПАРТНЕР, КЛИЕНТ, ПОЛЬЗОВАТЕЛЬ |
Сверка |
|
ДАТА ПОТРЕБЛЕНИЯ_КОНЕЦ_ |
Окончание использования услуги. Наряду с предыдущим полем, это значение определяет период использования. |
ПАРТНЕР, КЛИЕНТ, ПОЛЬЗОВАТЕЛЬ |
Сверка |
|
КОЛИЧЕСТВО |
Отражает совокупное потребление ресурсов пользователями по каждому партнеру, клиенту или пользователю (в зависимости от отчета и уровня просмотра данных). Расчет: Система рассчитывает количество потребления за день для каждого пользователя пропорционально отработанному времени. Использовать в течение всего дня = 1 Использование в течение половины дня = 0,5 Затем программа суммирует ежедневные суммы за все дни расчетного периода, чтобы рассчитать общую сумму для данного пользователя за этот расчетный период. В отчетах на уровне клиентов и партнеров итоговые суммы по всем пользователям суммируются для получения общей суммы по данному клиенту или партнеру. Момент времени: В отчете для клиентов указаны выделенные пакеты услуг для каждого клиента. Каждая строка представляет собой общее количество конкретного пакета, выделенного пользователям или рабочим местам в рамках конкретной организации-заказчика. Если пакеты не выделены, в поле «Количество» отображается «0». В отчете для пользователей перечислены пакеты, назначенные пользователям или рабочим пространствам. В каждой строке указано значение 1, представляющее пользователя или рабочее пространство, а также их индивидуальный пакет или дополнение. Если пользователю или рабочей области назначено несколько пакетов или дополнений, то в отчете отображается несколько записей, каждая из которых содержит указание количества. 1. |
ПАРТНЕР, КЛИЕНТ, ПОЛЬЗОВАТЕЛЬ |
Примирение, на определенный момент времени |
|
ИДЕНТИФИКАТОР КЛИЕНТА_ОРГ_ |
Внутренний уникальный идентификатор клиента |
КЛИЕНТ, ПОЛЬЗОВАТЕЛЬ |
Примирение, на определенный момент времени |
|
КЛИЕНТ_ВНЕШНИЙ_ИДЕНТИФИКАТОР |
Уникальный идентификатор клиента, предоставленный партнером. |
КЛИЕНТ, ПОЛЬЗОВАТЕЛЬ |
Примирение, на определенный момент времени |
|
ИДЕНТИФИКАТОР ПОДПИСЧИКА_ |
Уникальный идентификатор абонента |
USER |
Примирение, на определенный момент времени |
|
USER_ID |
Идентификатор пользователя Webex подписчика |
USER |
Примирение, на определенный момент времени |
|
РАБОЧАЯ ПРОСТРАНСТВО_ID |
Уникальный идентификатор рабочего пространства |
USER |
Примирение, на определенный момент времени |
|
МЕСТОПОЛОЖЕНИЕ_ID |
Уникальный идентификатор местоположения |
КЛИЕНТ, ПОЛЬЗОВАТЕЛЬ |
Примирение, на определенный момент времени |
|
ЛИЦЕНЗИЯ_ИДЕНТИФИКАТОР |
Идентификатор лицензии Это поле отображается только для оптовых пакетов. В отчете о сверке поле License_ID остается пустым для лицензий, назначенных до введения этого поля. В отчете по выставлению счетов отображается несколько строк для одного и того же оптового пакета, если он связан с различными комбинациями идентификаторов LOCATION_ID и LICENSE_ID. |
КЛИЕНТ, ПОЛЬЗОВАТЕЛЬ |
Примирение, на определенный момент времени |
|
ОТЧЕТ_ДАТА |
Дата и время создания отчета. |
КЛИЕНТ, ПОЛЬЗОВАТЕЛЬ |
Момент времени |
Предоставление пользователю пакета услуг запускает выставление счетов Webex Wholesale, а удаление назначения пакета услуг останавливает этот процесс.
