Благодарим за обратната връзка.
Отчети за фактуриране на едро от маршрута до пазара
Обратна връзка?Отчети за фактуриране
Партньорите могат да използват следните API за фактуриране на едро, за да генерират отчети за фактуриране, които им помагат да валидират точността на използването и осигуряването. API-тата за фактуриране на едро са достъпни чрез developer.webex.com.
-
Съгласуване – Показва потреблението на енергия на ниво партньор, клиент или потребител. Партньорите могат да използват тази информация за персонализиран отчет за фактуриране, за да съгласуват месечните си фактури, така че да могат да фактурират своите клиенти и потребители според потреблението им.
-
Точка във времето – Показва текущите разпределения на пакети на ниво клиент или потребител. Отчетът „Point-In-Time“ предоставя информация за броя на разпределенията на пакети в реално време. Партньорите могат да използват тази информация, за да проверят точността на осигуряването и да осигурят съответствие с поръчките на клиентите.
Партньорите могат също да генерират персонализирани отчети за фактуриране за подпартньори, използвайки параметъра 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. Можете да използвате тази стойност с Get API, за да получите генерирания отчет за фактуриране. |
Какво да направите след това
Отидете в раздела „Получаване на отчет за фактуриране на едро “ , за да изтеглите копие от отчета.
Получете отчет за фактуриране на едро
След като бъде генериран отчет за фактуриране, използвайте този API, за да получите конкретен отчет за фактуриране. Отчетът се изпраща към URL адрес, откъдето е достъпен за изтегляне в продължение на 30 минути след завършване на GET заявката.
| 1 |
От developer.webex.comотидете на Получаване на API за отчет за фактуриране на едро. |
| 2 |
Въведете уникалната стойност id за отчета и щракнете върху Run. API изходите отчитат състоянието. Изходът включва параметъра tempDownloadURL, който предоставя URL адрес, от който можете да изтеглите отчета. |
| 3 |
Копирайте tempDownloadURL в браузър, за да получите достъп до отчета и да го изтеглите. |
Списък на отчетите за фактуриране на едро
Използвайте този API, за да получите списък с генерирани отчети за фактуриране за партньорската организация. Можете да изброите всички съществуващи отчети или да ограничите списъка до онези отчети, които отговарят на зададените параметри, като например вашия период на фактуриране и тип фактуриране (партньор, клиент, потребител).
Ако въведете незадължителни параметри, API връща само онези отчети, които съответстват точно на зададените от вас параметри. Например, ако посочите период на фактуриране, ще бъдат върнати само отчети, които използват този конкретен период на фактуриране. Доклади, които попадат в периода, но не съвпадат точно с датите, не се връщат.
| 1 |
От developer.webex.comотидете на List Wholesale Billing Report API. |
| 2 |
Под Параметри на заявкатавъведете всички параметри за търсене, които искате да използвате (например началнаДата, крайнаДата, Тип, сортиране по). |
| 3 |
Кликнете върху Изпълнение. API извежда списъка с отчети заедно с уникалния идентификатор на отчета и състоянието му (ЗАВЪРШЕН, В ИЗПЪЛНЕНИЕ_).
|
Какво да направите след това
Запишете идентификатора за всички отчети, които искате да изтеглите. Отидете на Получаване на отчет за фактуриране на едро, за да го изтеглите.
Изтриване на отчет за фактуриране на едро
Използвайте тази процедура, за да изтриете генериран отчет за фактуриране въз основа на идентификатора на отчета. Няколко примера, в които може да искате да изтриете отчет, включват:
-
Ако искате да генерирате отново съществуващ отчет за съгласуване на фактурирането, първо трябва да изтриете съществуващия отчет. След като изтриете съществуващия отчет, можете да създадете нов отчет за този период. Не можете да изтриете отчет, ако генерирането му е неуспешно или все още е в процес на обработка.
За отчет към определен момент не е необходимо да изтривате съществуващ отчет, тъй като системата не генерира отново тези отчети. Всеки отчет винаги отразява данните към текущия момент на валидност.
-
Ако изпратите генериран URL адрес на отчет на грешен човек, можете да го изтриете, за да не може той да има достъп до него.
| 1 |
От developer.webex.comотидете на Изтриване на API за отчет за фактуриране на едро. |
| 2 |
Въведете идентификатора на отчета и щракнете върху] „ Изпълни“. |
Полета за отчет за фактуриране
Отчетите за фактуриране съдържат следните полета:
|
Поле |
Описание |
Поддържан тип отчет |
Поддържана категория отчети |
|---|---|---|---|
|
ИМЕ НА ПАРТНЬОР_ |
Име на партньора |
ПАРТНЬОР, КЛИЕНТ, ПОТРЕБИТЕЛ |
Съгласуване, момент във времето |
|
ИДЕНТИФИКАЦИОНЕН ИД НА ПАРТНЬОР_ОРГАНИЗАЦИЯ_ |
Уникален идентификатор на партньор |
ПАРТНЬОР, КЛИЕНТ, ПОТРЕБИТЕЛ |
Съгласуване, момент във времето |
|
АБОНАМЕНТ_ИД |
Уникален идентификатор на абонамента |
ПАРТНЬОР, КЛИЕНТ, ПОТРЕБИТЕЛ |
Съгласуване, момент във времето |
|
УСЛУГА_ИМЕ |
Име на услугата (напр. ОБЩА_ЗОНА_ПОЗВАНИЯ, WEBEX_ПОЗВАНИЯ, WEBEX_ПАКЕТ, WEBEX_СРЕЩИ) |
ПАРТНЬОР, КЛИЕНТ, ПОТРЕБИТЕЛ |
Съгласуване, момент във времето |
|
SKU |
SKU за услугата |
ПАРТНЬОР, КЛИЕНТ, ПОТРЕБИТЕЛ |
Съгласуване, момент във времето |
|
ОПИСАНИЕ |
Описание на услугата |
ПАРТНЬОР, КЛИЕНТ, ПОТРЕБИТЕЛ |
Съгласуване, момент във времето |
|
КОНСУМАЦИЯ_НАЧАЛНА ДАТА_ |
Начало на потреблението на услугата. Заедно със следното поле, тази стойност определя периода на използване. |
ПАРТНЬОР, КЛИЕНТ, ПОТРЕБИТЕЛ |
Съгласуване |
|
КОНСУМАЦИЯ_КРАЙ_ДАТА |
Край на потреблението на услугата. Заедно с предходното поле, тази стойност определя периода на потребление. |
ПАРТНЬОР, КЛИЕНТ, ПОТРЕБИТЕЛ |
Съгласуване |
|
КОЛИЧЕСТВО |
Представлява обобщената консумация на потребители на партньор, на клиент или на потребител (в зависимост от отчета и нивото, на което преглеждате данните). Изчисление: Системата изчислява дневното количество за всеки потребител пропорционално за този ден. Употреба за цял ден = 1 Употреба за половин ден = 0,5 След това сумира дневните суми за всички дни в рамките на периода на фактуриране, за да изчисли общото количество за този потребител в рамките на този период на фактуриране. За отчети на ниво клиент и партньор, общите суми за всички потребители се агрегират, за да се получи общо количество за този клиент или партньор. Момент във времето: Отчетът за клиента изброява разпределенията на пакетите за всеки клиент. Всеки ред представлява общото количество на конкретен пакет, присвоен на потребители или работни пространства в рамките на определена организация на клиента. Количеството показва „0“, ако няма разпределени пакети. Потребителският отчет изброява пакетите, присвоени на потребители или работни пространства. Всеки ред показва количество от 1, представляващо потребител или работно пространство и неговия индивидуален пакет или добавка. Ако на потребител или работно пространство са разпределени множество пакети или добавки, отчетът показва множество записи, всеки с определено количество 1. |
ПАРТНЬОР, КЛИЕНТ, ПОТРЕБИТЕЛ |
Съгласуване, момент във времето |
|
ИД НА КЛИЕНТ_ОРГАНИЗАЦИЯ_ |
Вътрешен уникален идентификатор на клиента |
КЛИЕНТ, ПОТРЕБИТЕЛ |
Съгласуване, момент във времето |
|
ВЪНШЕН ИДЕНТИФИКАЦИОНЕН ИД НА КЛИЕНТ__ |
Уникален идентификатор на клиента, предоставен от партньор |
КЛИЕНТ, ПОТРЕБИТЕЛ |
Съгласуване, момент във времето |
|
ИД НА АБОНАТ_ |
Уникален идентификатор за абоната |
ПОТРЕБИТЕЛ |
Съгласуване, момент във времето |
|
Карта сайта_ |
Потребителският идентификатор на Webex на абоната |
ПОТРЕБИТЕЛ |
Съгласуване, момент във времето |
|
ИД на РАБОТНО ПРОСТРАНСТВО_ |
Уникален идентификатор на работното пространство |
ПОТРЕБИТЕЛ |
Съгласуване, момент във времето |
|
МЕСТОПОЛОЖЕНИЕ_ИД |
Уникален идентификатор на местоположението |
КЛИЕНТ, ПОТРЕБИТЕЛ |
Съгласуване, момент във времето |
|
ИДЕНТИФИКАЦИОНЕН НОМЕР НА ЛИЦЕНЗ_ |
Идентификатор на лиценз Това поле е видимо само за пакети на едро За отчета за съгласуване, License_ID е празен за лицензи, присвоени преди въвеждането на това поле. Отчетът за фактуриране показва няколко реда за един и същ пакет на едро, ако е свързан с различни комбинации от ИД на МЕСТОПОЛОЖЕНИЕ_и ИД на ЛИЦЕНЗ_. |
КЛИЕНТ, ПОТРЕБИТЕЛ |
Съгласуване, момент във времето |
|
ДАТА НА ДОКЛАД_ |
Датата и часът, на които е генериран отчетът. |
КЛИЕНТ, ПОТРЕБИТЕЛ |
Точка във времето |
Предоставянето на пакет на потребител задейства фактурирането на Webex Wholesale, докато премахването на присвояването на пакета го спира.
