Съгласуване на фактурирането

Администраторите на партньори могат да използват 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 Wholesale, докато премахването на присвояването на пакета го спира.