Благодарим за обратната връзка.
Обратна връзка?Отчети за фактуриране
Партньорите могат да използват следните API за фактуриране на едро, за да генерират отчети за фактуриране , които им помагат да проверят точността на използването и предоставянето на услуги. API за фактуриране на едро са достъпни чрез developer.webex.com.
-
Съгласуване — показва потреблението на използване на всеки партньор, клиент или ниво на потребител. Партньорите могат да използват тази персонализирана информация за отчета за фактуриране, за да съгласуват месечната си фактура, така че да могат да фактурират своите клиенти и потребители според потреблението им.
-
Точка в времето — показва текущите разпределения на пакети на клиент или на ниво на потребител. Докладът за точково време предоставя броене на разпределенията на пакетите в реално време. Партньорите могат да използват тази информация, за да потвърдят точността на предоставянето и да осигурят съответствие с поръчките на клиентите.
Партньорите могат също да генерират персонализирани отчети за фактуриране за подпартньори, като използват параметъра SubPartnerOrgid.
Има четири API, които са достъпни за партньорски администратори, които отговарят на минималните изисквания за достъп.
|
API за фактуриране |
Цел на API |
Изискване за достъп до администратора |
|---|---|---|
|
Създайте отчет за фактуриране на едро |
Използва се за генериране на отчет за фактуриране. |
Четене/запис |
|
Вземете отчет за фактуриране на едро |
Използва се за получаване на генериран отчет за фактуриране за изтегляне. |
Прочети |
|
Списък на отчетите за фактуриране на |
Използва се за изброяване на отчетите за фактуриране, които съществуват за този партньор. |
Прочети |
|
Изтриване на доклад за фактуриране на едро |
Използва се за изтриване на съществуващ отчет за фактуриране. |
Четене/запис |
Източник на данни
Данните за отчетите за фактуриране се извличат от задачите на пакети и данните за използването, които Webex проследява за всеки партньор. Webex ежедневно обобщава данните за клиентските и потребителските пакети, за да генерира месечната фактура на партньора. API за фактуриране използват тези данни, което позволява на администраторите на партньори да генерират персонализирани отчети. Тези отчети помагат на партньорите да съчетават потреблението на използване от месечната си фактура на ниво партньор, кли ент и потребител.
За по-подробна информация относно начина, по който Webex фактурира партньорите, вижте Фактуриране на доставчика на услуги.
Създайте отчет за фактуриране на едро
| 1 |
От developer.webex.com отидете на Създаване на API за отчет за фактуриране на ед ро. |
| 2 |
Изберете някоя от следните категории отчети:
Ако искате да генерирате отчет за помирение, няма нужда да променяте нищо, тъй като Съгласуването е избрано по подразбиране, така че можете да преминете към следващата стъпка. Ако искате да генерирате отчет „Точка в време“, променете избора на Точка в време. |
| 3 |
Въведете billingStartDate и BillingEndDate във формата, който API посочва. Можете да въведете всяка дата от последните пет години, но не и текущия ден. За отчета „Точка в време“ полетата BillingStartDate и Bill ingEndDate не са задължителни и се игнорират, ако бъдат въведени. Докладът винаги отразява текущите разпределени пакети. |
| 4 |
Въведете типа на отчета:
|
| 5 |
В полето Включ ване въведете допълнителните или незадължителните колони, които искате да видите в отчетите. Всеки тип отчет има набор от задължителни атрибути и набор от незадължителни атрибути. Можете да решите кой от опционалните атрибути да се показва за всеки отчет. Ако не включите незадължителните атрибути, отчетът показва само задължителните атрибути. Следните колони са незадължителните атрибути, които можете да поискате да включите в отчета за клиента и потребителя:
Трябва да включите CUSTOMER_GROUP_ID и CUSTOMER_GROUP_NAME заедно, ако искате да видите тези атрибути във вашия отчет. Когато изберете незадължителни колони, редът на колоните в отчетите за съгласуване на клиенти и потребители се променя. Партньорите трябва да актуализират своята API интеграция, за да приемат новия csv формат. Редът на колоните на отчетите в точковия момент остава непроменен. Понастоящем съществуващите настройки на функциите имат предимство пред параметъра Включване при определяне на реда на колоните. Например, ако определена настройка на функцията е активирана за клиент, тогава тази колона с функции се показва съгласно стария формат на отчета, дори ако ги добавите в параметъра Включване. Скоро ще премахнем тези настройки. След като бъдат премахнати, можете да поискате опционалните колони само чрез параметъра Включване. |
| 6 |
Щракнете върху Из пълни, за да генерирате отчета. |
| 7 |
Копирайте идентификатора на отчета от изхода на API. Можете да използвате тази стойност с API за получаване, за да получите генерирания отчет за фактуриране. |
Какво да правя по-нататък
Отидете в раздела Получаване на отчет за фактуриране на едро, за да изтеглите копие от отчета.
Получете отчет за фактуриране на едро
След като се генерира отчет за фактуриране, използвайте този API, за да получите конкретен отчет за фактуриране. Отчетът се извежда на URL адрес, където е достъпен за изтегляне в продължение на 30 минути след завършване на заявката GET.
| 1 |
От developer.webex.com отидете на Получаване на API за отчет за фактуриране на ед ро. |
| 2 |
Въведете уникалната идентифика ционна стойност за отчета и щракнете върху Из пълни. API извежда състоянието на отчета. Изходът включва параметъра tempDownload Url, който предоставя URL адрес, от който можете да изтеглите отчета. |
| 3 |
Копирайте TempDownloadURL в браузър за достъп и изтегляне на отчета. |
Списък на отчетите за фактуриране на
Използвайте този API, за да получите списък с генерирани отчети за фактуриране за партньорската организация. Можете да изброите всички съществуващи отчети или да ограничите списъка до тези отчети, които отговарят на зададените параметри, като периода на фактуриране и типа на фактуриране (партньор, клиент, потребител).
Ако въведете незадължителни параметри, API връща само тези отчети, които съответстват точно на параметрите, които сте посочили. Например, ако зададете период на фактуриране, се връщат само отчетите, които използват този конкретен период на фактуриране. Док ладите, които попадат в рамките на периода, но които не съвпадат точно с датите, не се връщат.
| 1 |
От developer.webex.com отидете на Списък на отчета за фактуриране на едро API. |
| 2 |
Под Параметри на заяв ката въведете всички параметри за търсене, които искате да използвате (например StartDate, EndDate, Type, SortBy). |
| 3 |
Щракнете върху Изпъл ни. API извежда списъка с отчети заедно с уникалния идентификатор на от чета и състояние (ЗАВЪРШЕН,IN_PROGRESS).
|
Какво да правя по-нататък
Запишете идентификатора за всички отчети, които искате да изтеглите. Отидете на Получаване на отчет за фактуриране на едро, за да изтеглите отчета.
Изтриване на доклад за фактуриране на едро
Използвайте тази процедура, за да изтриете генериран отчет за фактуриране въз основа на идентификатора на отчета. Няколко примера, при които може да искате да изтриете отчет, включват:
-
Ако искате да регенерирате съществуващ отчет за фактуриране за съгласуване, първо трябва да изтриете съществуващия отчет. След като изтриете съществуващия отчет, можете да създадете нов отчет за този период. Не можете да изтриете отчет, ако генерирането му е неуспешно или все още е в ход.
За отчет в точката не е необходимо да изтривате съществуващ отчет, тъй като системата не регенерира тези отчети. Всеки отчет винаги отразява данни към текущата времева марка.
-
Ако изпратите URL адрес на генериран отч ет на грешен човек, можете да изтриете отчета, така че той да няма достъп до него.
| 1 |
От developer.webex.com отидете на Из три ване на API за отч ет за фактуриране на едро. |
| 2 |
Въведете идентификатора на отчета и щракнете върху Изпъл ни. |
Полета за отчета за фактуриране
Отчетите за фактуриране съдържат следните полета:
|
Поле |
Описание |
Поддържан тип отчет |
Поддържана категория отчети |
Задължителен или незадължителен атрибут |
|---|---|---|---|---|
|
PARTNER_NAME |
Име на партньора |
PARTNER, CUSTOMER, USER |
Помирение, точка в момент |
Задължително |
|
PARTNER_ORG_ID |
Уникален идентификатор на партньора |
PARTNER, CUSTOMER, USER |
Помирение, точка в момент |
Задължително |
|
SUBSCRIPTION_ID |
Уникален идентификатор на або |
PARTNER, CUSTOMER, USER |
Помирение, точка в момент |
Задължително |
|
CUSTOMER_GROUP_ID | Уникалният идентификатор на групата, към която клиентът принадлежи. Ако клиентът е преместен между групи по време на периода на фактуриране, използването се разделя въз основа на групите, към които клиентът е принадлежал през този период. |
CUSTOMER, USER |
Помирение, точка в момент |
Незадължително |
|
CUSTOMER_GROUP_NAME | Показване на името на групата клиенти. Ако името на групата се е променило по време на периода на фактуриране, се използва последното име. |
CUSTOMER, USER |
Помирение, точка в момент |
Незадължително |
|
CUSTOMER_ORG_ID |
Вътрешен уникален идентификатор на клиента |
CUSTOMER, USER |
Помирение, точка в момент |
Задължително |
|
CUSTOMER_EXTERNAL_ID |
Уникален идентификатор на клиента, предоставен от партньор |
CUSTOMER, USER |
Помирение, точка в момент |
Задължително |
|
TYPE |
Тип потребител или работно пространство |
CUSTOMER, USER |
Точка във времето |
Задължително |
|
SUBSCRIBER_ID |
Уникален идентификатор за абоната |
USER |
Помирение, точка в момент |
Задължително |
|
USER_ID |
Потребителският идентификационен номер на Webex на абоната |
USER |
Помирение, точка в момент |
Задължително |
|
WORKSPACE_ID |
Уникален идентификатор на работното пространство |
USER |
Помирение, точка в момент |
Задължително |
|
SERVICE_NAME |
Име на услугата (напр. COMMON_AREA_CALLINGWEBEX_CALLING,,WEBEX_SUITE,WEBEX_MEETINGS) |
PARTNER, CUSTOMER, USER |
Помирение, точка в момент |
Задължително |
|
SKU |
SKU за услугата |
PARTNER, CUSTOMER, USER |
Помирение, точка в момент |
Задължително |
|
DESCRIPTION |
Описание на услугата |
PARTNER, CUSTOMER, USER |
Помирение, точка в момент |
Задължително |
|
CONSUMPTION_START_DATE |
Начало на потреблението на услугата. Заедно със следното поле тази стойност определя периода на използване. |
PARTNER, CUSTOMER, USER |
Помирение |
Задължително |
|
CONSUMPTION_END_DATE |
Край на потреблението на услугата. Заедно с предходното поле тази стойност определя периода на потребление на използване. |
PARTNER, CUSTOMER, USER |
Помирение |
Задължително |
|
REPORT_DATE |
Датата и часът, на който се генерира отчетът. |
CUSTOMER, USER |
Точка във времето |
Задължително |
|
QUANTITY |
Представлява обобщеното потребление на потребителя за партньор, на клиент или на потребител (в зависимост от отчета и нивото, на което преглеждате данните). Изчисляване: Системата изчислява количеството на ден за всеки потребител на пропорционална основа за този ден. Употреба за цял ден = 1 Употреба за половин ден = 0.5 След това той сумира общите суми на ден за всички дни в рамките на периода на фактуриране, за да изчисли общото количество за този потребител в рамките на този период на фактуриране. За отчетите на ниво клиенти и партньори общите суми за всички потребители се обобщават, за да се предостави общо количество за този клиент или партньор. Точно във времето: Отчетът на клиента изброява разпределенията на пакети на клиент. Всеки ред представлява общото количество на конкретен пакет, присвоен на потребители или работни пространства в рамките на определена клиентска организация. Количеството показва „0“, ако няма разпределени пакети. Потребителският отчет изброява пакетите, присвоени на потребители или работни пространства. Всеки ред показва количество от 1, представляващо потребител или работно пространство и техния индивидуален пакет или добавка. Ако на потребител или работно пространство са разпределени множество пакети или добавки, отчетът показва множество записи, всеки с количество от 1. |
PARTNER, CUSTOMER, USER |
Помирение, точка в момент |
Задължително |
|
LOCATION_ID |
Уникален идентификатор за местоположение |
CUSTOMER, USER |
Помирение, точка в момент Отчетът за точката на клиента не включва идентификационен номер на местоположението |
Незадължително |
|
LICENSE_ID |
Лицензен идентификатор Това поле е видимо само за пакети на едро За доклада за съгласуване License_ID е празен за лицензи, предоставени преди въвеждането на това поле. Отчетът за фактуриране показва няколко реда за един и същ пакет на едро, ако е свързан с различни комбинации от LOCATION_ID иLICENSE_ID. |
CUSTOMER, USER |
Помирение, точка в момент |
Незадължително |
Избирането на незадължителни колони променя реда на колоните на отчетите за съгласуване на клиенти и потребители. Следната поръчка важи за партньори, които имат само SKU на едро в техния абонамент:
Доклад за ниво потребител— PARTNER_NAME PARTNER_ORG_IDSUBSCRIPTION_ID,CUSTOMER_GROUP_ID,CUSTOMER_GROUP_NAME,CUSTOMER_ORG_ID,,CUSTOMER_EXTERNAL_ID,LOCATION_ID,LICENSE_ID,,SUBSCRIBER_ID,USER_ID, SKU WORKSPACE_IDSERVICE_NAME, ОПИСАНИЕ,, CONSUMPTION_START_DATECONSUMPTION_END_DATE, КОЛИЧЕСТВО
Отчет за ниво кли PARTNER_NAME ент—PARTNER_ORG_ID,SUBSCRIPTION_ID,CUSTOMER_GROUP_ID,CUSTOMER_GROUP_NAME,,CUSTOMER_ORG_ID,CUSTOMER_EXTERNAL_ID,LOCATION_ID,LICENSE_ID, SKUSERVICE_NAME, ОПИСАНИЕ,, CONSUMPTION_START_DATECONSUMPTION_END_DATE, КОЛИЧЕСТВО
Предоставянето на пакет на потребител задейства фактурирането на Webex Wholesale, докато премахването на присвояването на пакет го спира.
Клиентската организация може да принадлежи само към една група клиенти по всяко време. Понастоящем не е налична поддръжка за множество групи клиенти на организация.
