Описание
Категория или услуга в тарифе
Описание полей
| Параметр | Тип | Обязательный | Описание | Доступно с версии |
|---|---|---|---|---|
| notusbox | long | Тип услуги:
|
||
| tarid | long | Идентификатор тарифа, которому принадлежит категория | ||
| catid | long | Идентификатор каталога | ||
| servcarid | long | Идентификатор дополнительной услуги из каталога | ||
| catidx | long | Идентификатор категории тарифа (уникален в рамках тарифа).
В БД поля tarid и catidx являются составным первичным ключом для идентификации категории тарифа. Если в операции insupdTarCategory параметр равен -1, соответствующая категория будет добавлена к тарифному плану. |
||
| catidxmaster | long | Идентификатор мастер-категории | ||
| includes | long | Величина услуги, включённой в абонентскую плату (Мб или Мин) | ||
| common | long | Флаг двойного назначения Если категория является составной частью тарифа обслуживающего телефонию или интернет, то это поле описывает признак категории по умолчанию. В этом случае поле может принимать значения 0/1. Если категория является составной частью тарифа описывающего услугу, то поле содержит флаги описывающие тип услуги:
|
||
| disprior | long | Приоритет применения скидок:
|
||
| archive | long | Флаг «Категория удалена» | ||
| operid | long | Идентификатор оператора | ||
| freeseconds | long | Порог нетарифицируемого звонка — количество секунд от начала разговора, в течении которого не начисляется оплата | ||
| minchargedur | long | Минимальная длительность звонка после округления (сек) Рассмотрим пример с параметрами:
Тарификация различается в зависимости от длительности звонка:
|
||
| roundseconds | long | Величина округления времени звонка (сек) | ||
| enabled | long | Состояние категории (активна/неактивна) | ||
| available | long | Возможность активировать и деактивировать категорию из личного кабинета | ||
| availableformanager | long | Возможность назначать категорию из административного интерфейса:
|
||
| usrcansetmul | long | Не используется с релиза 2.0.42. Флаг возможности подключения более одного экземпляра услуги из личного кабинета | ||
| usrmaxmul | long | Не используется с релиза 2.0.42. Максимальное количество экземпляров услуги, которое можно подключить из личного кабинета | ||
| saledictionaryid | long | Идентификатор справочника с кодами GAAP, ОКЕИ и пр. Используется для связи с бухгалтерией | ||
| codeokei | long | Единица измерения услуги из ОКЕИ | ||
| keepturnedon | long | Флаг отключения пакета ЦТВ:
|
||
| autoassign | long | Флаг автоматического назначения услуги при смене тарифа (только при условии авто-назначения всех категорий с тарифа):
|
||
| servfuncid | long | Идентификатор сервисной функции, управляющей услугой | ||
| dtvtype | long | Тип услуги ЦТВ:
|
||
| usboxcount | long | Не используется | ||
| servicetype | long | Признак услуги:
|
||
| defaultsubscriptionfee | short | Флаг «Абонентская плата по умолчанию» | ||
| checkactivehours | long | Учитывать 12-часовой порог при тарификации услуги:
|
||
| isunique | long | Флаг «Уникальная услуга» | ||
| admblockabove | double | Стоимость услуги (в валюте тарифа) при административной блокировке | ||
| usrblockabove | double | Стоимость услуги(в валюте тарифа) при пользовательской блокировке | ||
| permabove | double | Цена за факт звонка. Для USBox — цена услуги для учётной записи в заблокированном состоянии | ||
| above | double | Стоимость услуги (в валюте тарифа) | ||
| includeabove | double | Стоимость подключения услуги (в валюте тарифа) | ||
| markingabove | double | Стоимость маркировки телефонного звонка | 2.0.54 | |
| descr | string | Описание категории | ||
| uuid | string | Код для связи с внешней системой. Сторонние биллинги могут возвращать значение по умолчанию | ||
| script | string | Скрипт, выполняемый при назначении услуги. На вход скрипта подается serv_id (идентификатор услуги USBox). Поддерживается два варианта скриптов:
|
||
| descrfull | string | Подробное описание услуги | ||
| link | string | Ссылка на внешний ресурс (URL) с подробным описанием услуги | ||
| scriptoff | string | Скрипт, выполняемый при отключении услуги. На вход скрипта подается serv_id (идентификатор услуги USBox). Поддерживается два варианта скриптов:
|
||
| directionforce | long | Маршрут телефонного направления:
|
||
| externalcharge | long | Флаг «Внешнее списание» | ||
| publicoffer | string | Ссылка на публичную оферту | ||
| paymentobject | long | Предмет расчёта (для фискализации) | ||
| allowblockcalls | long | Флаг «Разрешить вызовы при блокировке» (для VoIP) | ||
| gaap | long | Код GAAP (код вида услуги) | ||
| promoperiod | long | Пробный период | ||
| zones | soapTarZones | Список направлений |
Определение типа
<complexType name="soapTarCategory">
<sequence>
<element name="notusbox" type="xsd:long" minOccurs="0" maxOccurs="1" default="0"/>
<element name="tarid" type="xsd:long" minOccurs="1" maxOccurs="1"/>
<element name="catid" type="xsd:long" minOccurs="0" maxOccurs="1" default="0"/>
<element name="servcatid" type="xsd:long" minOccurs="0" maxOccurs="1" default="0"/>
<element name="catidx" type="xsd:long" minOccurs="1" maxOccurs="1"/>
<element name="catidxmaster" type="xsd:long" minOccurs="0" maxOccurs="1" default="0"/>
<element name="includes" type="xsd:long" minOccurs="1" maxOccurs="1"/>
<element name="common" type="xsd:long" minOccurs="1" maxOccurs="1"/>
<element name="disprior" type="xsd:long" minOccurs="1" maxOccurs="1"/>
<element name="archive" type="xsd:long" minOccurs="0" maxOccurs="1" default="0"/>
<element name="operid" type="xsd:long" minOccurs="1" maxOccurs="1"/>
<element name="freeseconds" type="xsd:long" minOccurs="0" maxOccurs="1" default="0"/>
<element name="minchargedur" type="xsd:long" minOccurs="0" maxOccurs="1" default="0"/>
<element name="roundseconds" type="xsd:long" minOccurs="0" maxOccurs="1" default="0"/>
<element name="enabled" type="xsd:long" minOccurs="0" maxOccurs="1" default="1"/>
<element name="available" type="xsd:long" minOccurs="0" maxOccurs="1" default="0"/>
<element name="availableformanager" type="xsd:long" minOccurs="0" maxOccurs="1" default="1"/>
<element name="usrcansetmul" type="xsd:long" minOccurs="0" maxOccurs="1" default="0"/>
<element name="usrmaxmul" type="xsd:long" minOccurs="0" maxOccurs="1" default="1"/>
<element name="saledictionaryid" type="xsd:long" minOccurs="0" maxOccurs="1" default="0"/>
<element name="codeokei" type="xsd:long" minOccurs="0" maxOccurs="1" default="0"/>
<element name="keepturnedon" type="xsd:long" minOccurs="0" maxOccurs="1" default="0"/>
<element name="autoassign" type="xsd:long" minOccurs="0" maxOccurs="1" default="0"/>
<element name="servfuncid" type="xsd:long" minOccurs="0" maxOccurs="1" default="0"/>
<element name="dtvtype" type="xsd:long" minOccurs="0" maxOccurs="1" default="0"/>
<element name="usboxcount" type="xsd:long" minOccurs="0" maxOccurs="1" default="0"/>
<element name="servicetype" type="xsd:long" minOccurs="0" maxOccurs="1" default="0"/>
<element name="defaultsubscriptionfee" type="xsd:short" minOccurs="0" maxOccurs="1" default="0"/>
<element name="checkactivehours" type="xsd:long" minOccurs="0" maxOccurs="1" default="-1"/>
<element name="isunique" type="xsd:long" minOccurs="0" maxOccurs="1" default="0"/>
<element name="admblockabove" type="xsd:double" minOccurs="0" maxOccurs="1" default="0"/>
<element name="usrblockabove" type="xsd:double" minOccurs="0" maxOccurs="1" default="0"/>
<element name="permabove" type="xsd:double" minOccurs="0" maxOccurs="1" default="0"/>
<element name="above" type="xsd:double" minOccurs="1" maxOccurs="1"/>
<element name="includeabove" type="xsd:double" minOccurs="0" maxOccurs="1" default="0"/>
<element name="markingabove" type="xsd:double" minOccurs="0" maxOccurs="1" default="0"/>
<element name="descr" type="xsd:string" minOccurs="0" maxOccurs="1" default=""/>
<element name="uuid" type="xsd:string" minOccurs="0" maxOccurs="1" default=""/>
<element name="script" type="xsd:string" minOccurs="0" maxOccurs="1" default=""/>
<element name="descrfull" type="xsd:string" minOccurs="0" maxOccurs="1" default=""/>
<element name="link" type="xsd:string" minOccurs="0" maxOccurs="1" default=""/>
<element name="scriptoff" type="xsd:string" minOccurs="0" maxOccurs="1" default=""/>
<element name="directionforce" type="xsd:long" minOccurs="0" maxOccurs="1" default="0"/>
<element name="externalcharge" type="xsd:long" minOccurs="0" maxOccurs="1" default="0"/>
<element name="publicoffer" type="xsd:string" minOccurs="0" maxOccurs="1" default=""/>
<element name="paymentobject" type="xsd:long" minOccurs="0" maxOccurs="1" default="-1"/>
<element name="allowblockcalls" type="xsd:long" minOccurs="0" maxOccurs="1" default="-1"/>
<element name="gaap" type="xsd:long" minOccurs="0" maxOccurs="1" default="0"/>
<element name="promoperiod" type="xsd:long" minOccurs="0" maxOccurs="1" default="0"/>
<element name="zones" type="lbapi:soapTarZones" minOccurs="0" maxOccurs="unbounded"/>
</sequence>
</complexType>