Описание
Категория или услуга в тарифе
Описание полей
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| 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 | Стоимость подключения услуги (в валюте тарифа) | |
| 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="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>