Каталог услуг поставщика
В ИС УНП реализован функционал по импорту/экспорту Каталогов услуг Поставщиков посредством веб-сервиса, развёрнутого на стороне Системы.
Для каждого Поставщика услуг в ИС УНП посредством импорта данных из ИС ПУ может быть загружен Каталог услуг Поставщика. В последующих запросах на импорт Поставщик может загружать в ИС УНП измененённый Каталог услуг поставщика. Если для Поставщика ранее загружался в ИС УНП Каталог услуг, то в результате импорта нового Каталога услуг, все ранее загруженные услуги данного Поставщика становятся не активны в Системе. Вновь загруженные услуги (с учетом их статуса активности) являются актуальными и могут использоваться для осуществления по ним начислений и платежей.
Если Поставщик использует Каталог услуг при взаимодействии с УНП, его начисления и соответствующие платежи формируются с привязкой к услугам этого каталога - данные этих начислений и платежей сохраняемые в УНП в блоке AdditionalData должны содержать уникальный идентификатор услуги (наименование «SrvCode» и значение кода услуги).
В ГИС ГМП функционал по импорту/экспорту Каталогов услуг Поставщиков не используется, соответственно привязка к услуге («SrvCode») для начислений и платежей, передаваемых через УНП в ГИС ГМП не используется (в ГИС ГМП не обрабатывается).
Данные Каталога услуг Поставщика приведены в файле Catalog.xsd (глава 7. «XSD-схемы сущностей ИС УНП» настоящего документа). Состав полей Каталога услуг Поставщика приведен в таблице 10.
Таблица . «Атрибуты и элементы типа ServiceCatalog_Type»
Наименование
|
Кол-во тегов, обязательность тега или атрибута
|
Тип данных
|
Комментарий
|
Id (атрибут)
|
0..1, необязательно
|
ID
|
Необходим для наложения ЭП в формате XadES. Должен иметь структуру <буква [A-Z]>_<GUID>.
|
name (атрибут)
|
1, обязательно
|
xs:string
Строка произвольной длины
|
Наименование Каталога.
|
revisionDate (атрибут)
|
1, обязательно
|
xs:date
|
Дата последнего изменения Каталога (текущая дата).
|
version (атрибут)
|
0..1, необязательно
|
xs:token
|
Версия (версия форматов).
Для текущей версии форматов может содержать значение «1.16.2».
|
Service
|
1..n, обязательно
|
Service_Type
|
Данные Каталога услуг Поставщика
|
Signature
|
0..1, необязательно
|
ds:SignatureType
|
ЭП xml-документа. В теге содержатся реквизиты ЭП, соответствующие стандарту XML Advanced Electronic Signatures with Time-Stamp (описание стандарта находится в сети Интернет по адресу http://www.w3.org/TR/XAdES/).
|
Тип Service_Type
Таблица . «Атрибуты и элементы типа Service_Type»
Наименование
|
Кол-во тегов, обязательность тега или атрибута
|
Тип данных, с указанием ограничений ввода
|
Комментарий
|
name
(атрибут)
|
1, обязательно
|
String
Строка произвольной длины (минимальная длина = 1)
|
Наименование услуги.
|
code
(атрибут)
|
1, обязательно
|
String
Строка, максимальная длина = 36 символов.
|
Идентификатор услуги Поставщика.
|
desc
(атрибут)
|
0..1, необязательно
|
String
Строка произвольной длины
|
Описание услуги.
|
expires
(атрибут)
|
0..1, необязательно
|
date
|
Дата, до которой предоставляется услуга, если отсутствует, то услуга действует постоянно.
(Не используется)
|
isActive
(атрибут)
|
1, обязательно
|
boolean
|
Показывает доступность услуги:
true - доступна
false - не доступна.
|
revisionDate
(атрибут)
|
0..1, необязательно
|
date
|
Дата внесения изменений.
|
ServiceCategory
|
1, обязательно
|
ServiceCategoryType
|
Категория услуги. Заполняется в соответствии с перечнем, наименований и кодов категорий представленном в разделе 2 документа «Методические рекомендации (Каталог и начисление)».
|
code
(атрибут)
|
1, обязательно
|
String
Строка (длина: 1-20 символов)
|
Код категории.
|
name
(атрибут)
|
1, обязательно
|
String. Строка, максимальная длина = 128 символов.
|
Наименование категории.
|
PaymentParameters
|
0..1, необязательно
|
Контейнер
|
Список параметров платежа, необходимых для осуществления платежа по услуге. Список параметров состоит из произвольного числа параметров 2-х типов:
DescriptionSimpleParameter
DescriptionComplexParameter
Для услуги в составе этих параметров обязательно должны быть описаны:
Идентификатор плательщика;
Код бюджетной классификации (КБК) (при отсутствиии заполняется значением ноль);
Полное наименование Получателя, для указания в поле «16» платежа;
Для авансовой услуги дополнительно должны указываться:
Параметры для заполнения налоговых реквизитов;
Шаблон и параметры для формирования назначения платежа.
Информация по заполнению параметров платежа представлена в документе «Методические рекомендации (Каталог и начисление)»
|
DescriptionSimpleParameter
|
1..n, обязательно
|
DescriptionParameter_Type
|
Описание параметров услуги, подлежащих заполнению плательщиком при её оплате (см. п. 2.5.7.1). Используется для определения реквизитов, используемых в запросе неоплаченных начислений в ИС УНП, при составлении платежного поручения и обработки платежа, а также для того, чтобы Плательщик при совершении платежа мог указать необходимую информацию.
Рекомендации по заполнению параметров платежа приведены в документе «Методические рекомендации (Каталог и начисление)»
|
DescriptionComplexParameter
|
1..n, обязательно
|
DescriptionParameter_Type
|
Комплексное описание параметров услуги (см. п. 2.5.7.2).
Используется для определения реквизитов, описываемых группой параметров указываемых в запросе начислений в ИС УНП, при составлении платежного поручения и обработки платежа, а также для того, чтобы Плательщик при совершении платежа мог указать необходимую информацию.
Рекомендации по заполнению параметров платежа приведены в документе «Методические рекомендации (Каталог и начисление)»
|
CurrenciesServices
|
0..1, необязательно
|
Контейнер
|
Коды валют, в которых возможна оплата услуги.
|
CurrencyCode
|
1..n, обязательно
|
CurrencyCodeType
3-буквенный код валюты.
|
Код валюты ISO 4217
Всегда указывать наименование для рублей « RUR»
|
Payee
|
1, обязательно
|
PayeeType /
OrganizationCatalogType
|
Поставщик услуги и получатель платежа (если это одно и то же лицо. В противном случае, в данном поле указываются данные только поставщика услуги).
Данный тег содержит данные организации (тип. OrganizationCatalogType) –должны быть ВСЕГДА заполнены.
Если для данной услуги предполагается авансовая оплата (признак PaymentKind =1,2) или помимо данных поставщика услуги нужно указать полное наименование получателя платежа, то в блоке «DescriptionSimpleParameter» указывается простой параметр с наименованием @name = Recipient. Пример заполнения параметра приведен в разделе 2.1 документа «Методические рекомендации (Каталог и начисление)».
Требования к формату заполнения поля «Получатель» представлены в Положении ЦБР и Минфина РФ от 13 декабря 2006 г. № 298-П.
|
name
(атрибут)
|
1, обязательно
|
String
Строка: (1 – 2000) символов
|
Наименование организации
|
INN
(атрибут)
|
1, обязательно
|
INNType (см. описание в п. 2.5.7.2)
|
ИНН получателя
|
KPP
(атрибут)
|
1, обязательно
|
KPPType (см. описание в п. 2.5.7.3)
|
KPP получателя
|
OKTMO
(атрибут)
|
1, обязательно
|
OKTMOType
(см. описание в п. 2.5.7.4)
|
Код ОКТМО
|
OGRN
(атрибут)
|
0..1, необязательно
|
OGRNType (см. описани е в п. 2.5.7.6)
|
ОГРН
|
Accounts
|
1, обязательно
|
AccountsType
|
Счета организации
|
Account
|
1..n, обязательно
|
AccountCatalogType
|
Счет организации
|
kind
(атрибут)
|
0..1, необязательно
|
positiveInteger
|
Тип счета, принимает значения:
1 – расчетный;
2 – текущий;
3 - корреспондентский.
(по умолчанию – «расчетный»)
|
Account
|
1, обязательно
|
AccountNumType
(20 цифр)
|
Номер счета.
|
Bank
|
1, обязательно
|
BankType
|
Данные Банка, в котором открыт счет.
|
Name
|
0..1, необязательно
|
String
Строка, длина: (1-160) символов
|
Наименование Банка, в котором открыт счет
|
BIK
|
1, обязательно
|
BIKType
|
БИК Банка, в котором открыт счет. Наличие этого тега исключает тег SWIFT.
|
SWIFT
|
1, обязательно
|
SWIFTType
|
SWIFT – код Банка, в котором открыт счет. Наличие этого тега исключает тег BIK.
(Не используется).
|
CorrespondentBankAccount
|
0..1, необязательно
|
AccountNumType
(20 цифр)
|
Корреспондентский счет Банка в ЦБ РФ
|
Address
|
0..1, необязательно
|
AddressesType: Строковое представление адреса (1-255) символов;
Комментарий (1-2000) символов;
Поля адреса (1-2000) символов;
|
Адреса организации (рекомендуется для заполнения)
|
Contacts
|
0..1, необязательно
|
ContactsType:
Виды контакта (1-100) смволов;
Значение контакта – (1-100) символов;
Комментарий (1-2000) символов.
|
Контакты организации (рекомендуется для заполнения)
|
PaymentKind
|
1, обязательно
|
Integer
(значения: 1, 2, 3)
|
Вид оплаты. Возможные значения:
1 – авансовый платеж;
2 – услуга может иметь одновременно два типа оплаты (авансовый платеж и оплата выставленного поставщиком услуг счета);
3 – оплата выставленного поставщиком услуг счета.
|
MinAmount
|
0..1, необязательно
|
Money:
Long. Целое число от
(-9 223 372 036 854 775 808 +9 223 372 036 854 775 807).
|
Минимальная сумма платежа по услуге
|
currency
(атрибут)
|
0..1, необязательно
|
CurrencyCodeType:
3х - буквенный код валюты.
|
Код валюты в соответствии с ISO4217
|
exponent
(атрибут)
|
0..1, необязательно
|
Integer:
одна цифра (0-9), по умолчанию =2
|
Количество дробных знаков (используется значение =2) - передается целое значение в копейках
|
MaxAmount
|
0..1, необязательно
|
Money:
Long. Целое число от
(-9 223 372 036 854 775 808 +9 223 372 036 854 775 807).
|
Максимальная сумма платежа по услуге
|
currency
(атрибут)
|
0..1, необязательно
|
CurrencyCodeType:
3х - буквенный код валюты.
|
Код валюты в соответствии с ISO4217
|
exponent
(атрибут)
|
0..1, необязательно
|
Integer:
одна цифра (0-9), по умолчанию =2
|
Количество дробных знаков (используется значение =2) - передается целое значение в копейках
|
Commissions
|
0..1, необязательно
|
Commission_Type
|
Комиссии по услуге – Используется в случае установленных вида и значений комиссии.
|
Commission
|
1..n, обязательно
|
Commission_Type
|
Комиссии по услуге
Используется в случае установленных вида и значений комиссии.
|
Kind
|
1, обязательно
|
String:
Принимает значения: 1, 2, 3, 4, 5
|
Вид комиссии
1 – комиссия за операцию, с плательщика в пользу поставщика (зарезервировано)
2 - комиссия за операцию, с агента в пользу поставщика (зарезервировано)
3 - вознаграждение агенту за период взаиморасчётов агента и поставщика (зарезервировано).
|
Percent
|
0..1, необязательно
|
Decimal
Принимает значения (0 - 100).
По умолдчанию = 0.
|
Процент для расчета величины комиссии относительно фактической суммы платежа (т.е. платежа без комиссии).
|
MinValue
|
0..1, необязательно
|
Money:
Long. Целое число от
(-9 223 372 036 854 775 808 +9 223 372 036 854 775 807).
|
Минимальная сумма платежа, при которой применяется процент - тег «Percent»
|
currency
(атрибут)
|
0..1, необязательно
|
CurrencyCodeType:
3х - буквенный код валюты.
|
Код валюты в соответствии с ISO4217
|
exponent
(атрибут)
|
0..1, необязательно
|
Integer:
одна цифра (0-9),
по умолчанию =2
|
Количество дробных знаков. Используется значение = 2 - передается целое значение суммы в копейках.
|
MaxValue
|
0..1, необязательно
|
Money:
Long. Целое число от
(-9 223 372 036 854 775 808 +9 223 372 036 854 775 807).
|
Максимальная сумма платежа, при которой применяется процент – тег «Percent».
|
currency
(атрибут)
|
0..1, необязательно
|
CurrencyCodeType:
3х - буквенный код валюты.
|
Код валюты в соответствии с ISO4217
|
exponent
(атрибут)
|
0..1, необязательно
|
Integer:
одна цифра (0-9),
по умолчанию =2
|
Количество дробных знаков. Используется значение = 2 - передается целое значение суммы в копейках.
|
Regions
|
0..1, необязательно
|
Контейнер
|
Регионы, в которых предоставляется данная услуга.
(Не используется)
|
Region
|
1..n, обязательно
|
Region_Type
|
Регион
|
id
(атрибут)
|
0..1, необязательно
|
String:
3- цифры
|
Идентификатор региона
|
name
(атрибут)
|
0..1, необязательно
|
String:
Строка произвольной длины
|
Наименование региона
|
Subservices
|
0..1, необязательно
|
Контейнер
|
Подуслуги.
Для услуг, состоящих из нескольких составляющих, по которым осуществляется отдельная оплата. Деление услуг на подуслуги – на усмотрение Поставщика. (не используется)
|
Service
|
1..n, обязательно
|
Service_Type
|
Описание подуслуги. (не используется)
|
AdditionalData
|
0..1, необязательно
|
AdditionalData_Type
|
Дополнительные данные
|
Name
|
1, обязательно
|
String
Строка, длина: (1-100) символов
|
Наименование атрибута
|
Value
|
1, обязательно
|
String
Строка, длина: (1-255) символов
|
Значение атрибута
|
Элемент DescriptionSimpleParameter
В таблице 12 представлено описание и состав элемента DescriptionSimpleParameter.
Таблица . «Элемент DescriptionSimpleParameter»
Наименование
|
Кол-во тегов, обязательность
|
Тип данных
|
Комментарий
|
name
(атрибут)
|
1, обязательно
|
xs:string
|
Наименование простого параметра услуги.
Если параметр участвует в запросе экспорта данных его наименование должно совпадать с советующим атрибутом - наименованием, указанном в блоке AdditionalData экспортируемых данных.
Если параметр является признаком отправки данных начисления в ГИС ГМП его значение name = «duplication»
|
label
(атрибут)
|
1, обязательно
|
xs:string
|
Наименование параметра для отображения в интерфейсе.
|
required
(атрибут)
|
0..1, необязательно
|
xs:boolean
|
Указывает, является данный параметр обязательным для заполнения или нет.
|
readonly
(атрибут)
|
0..1, необязательно
|
xs:boolean
|
Указывает, что данный параметр не может быть изменен пользователем
|
supplierSrvCode
(атрибут)
|
0..1, необязательно
|
xs:string
|
Код услуги в каталоге поставщика
(Не используется).
|
supplierID
(атрибут)
|
0..1, необязательно
|
com:UUID
|
Id поставщика из каталога которого взята услуга
(Не используется).
|
isId
(атрибут)
|
0..1, необязательно
|
xs:integer
|
Указывает, является ли данный параметр идентификатором плательщика:
1 - параметр является уникальным идентификатором плательщика.
Если присутствует несколько параметров isID=1, то для идентификации плательщика может использоваться любой параметр с isID=1.
Если @isId не равен 1 или отсутствует, это означает, что параметр не является идентификатором плательщика.
Параметры не являющиеся идентификатором плательщика могут используются совместно параметрами с isID=1 и служить в запросе экспорта для ограничения области поиска. В этом случае, эти параметры должны быть определены как параметры для поиска, т.е. иметь атрибут forSearch= «true».
|
visible
(атрибут)
|
0..1, необязательно
|
xs:boolean
|
Отображать параметр в интерфейсе пользователя или нет.
|
forSearch
(атрибут)
|
0..1, необязательно
|
xs:boolean
|
Параметр используется в запросе экспорта для поиска данных.
|
forPayment
(атрибут)
|
0..1, необязательно
|
xs:boolean
|
Параметр используется при формировании данных платежа - его значение должно быть включено в блок дополнительных параметров платежа.
|
Regexp
|
0..1, необязательно
|
xs:string
|
Маска для проверки значения параметра, в случае отсутствия проверка не производится. Регулярные выражения, используемые в JAVA. Правила задания маски устанавливает Поставщик, если в его информационной системе осуществляется какой-либо контроль – длина, количество и порядок символов).
|
DefaultValue
|
0..1, необязательно
|
xs:string
|
Значение параметра по умолчанию
Если параметр является признаком отправки данных в ГИС ГМП (name = «duplication») при отсутствии значения в поле «data» это значение определяет отправку данных начисления по этой услуге в ГИС ГМП: «on» - отправлять; «off» - не отправлять.
|
AllowedValues
|
0..1, необязательно
|
AllowedValues
|
Возможные значения для параметра (аналог перечисления)
|
Value
|
1..n, обязательно
|
com:ParamValue_Type
|
Значение параметра
|
label
(атрибут)
|
0..1, необязательно
|
xsd:string
|
Наименование значения для отображения в интерфейсе
|
isSelected
(атрибут)
|
0..1, необязательно
|
xsd:boolean
|
Указывает, что данное значение выбрано в качестве текущего значения параметра в случае если присутствует список значений
|
data
(атрибут)
|
1, обязательно
|
xsd:string
|
Значение параметра.
В запросе на экспорт значение параметра должно совпадать с советующим значением, указанным в блоке AdditionalData экспортируемых данных.
Если параметр является признаком отправки данных начисления по этой услуге в ГИС ГМП (name = «duplication») значение «on» - определяет отправку данных в ГИС ГМП; значение «off» - запрет отправки.
|
Элемент DescriptionComplexParameter
В таблице 13 представлено описание и состав элемента DescriptionComplexParameter.
Таблица . «Элемент DescriptionComplexParameter»
Наименование
|
Кол-во тегов, обязательность
|
Тип данных
|
Комментарий
|
name
(атрибут)
|
1, обязательно
|
xs:string
|
Наименование сложного параметра.
Если параметр участвует в запросе экспорта данных его наименование должно входить в состав советующего атрибута - наименования, указанного в блоке AdditionalData экспортируемых данных.
|
label
(атрибут)
|
1, обязательно
|
xs:string
|
Наименование параметра для отображения в интерфейсе
|
required
(атрибут)
|
0..1, необязательно
|
xs:boolean
|
Указывает, является данный параметр обязательным для заполнения или нет
|
readonly
(атрибут)
|
0..1, необязательно
|
xs:boolean
|
Указывает, что данный параметр не может быть изменен пользователем
|
supplierSrvCode
(атрибут)
|
0..1, необязательно
|
xs:string
|
Код услуги в каталоге поставщика.
(Не используется).
|
supplierID
(атрибут)
|
0..1, необязательно
|
com:UUID
|
Id поставщика из каталога которого взята услуга.
(Не используется).
|
isId
(атрибут)
|
0..1, необязательно
|
xs:integer
|
Указывает, является ли данный параметр идентификатором плательщика.
1 - параметр является уникальным идентификатором плательщика. Если присутствует несколько параметров с таким значением isID, то для идентификации может использоваться любой параметр.
Если @isId не равен 1 или отсутствует, это означает, что параметр не является идентификатором плательщика.
Параметры не являющиеся идентификатором плательщика могут используются совместно параметрами с isID=1 и служить в запросе экспорта для ограничения области поиска. В этом случае, эти параметры должны быть определены как параметры для поиска, т.е. иметь атрибут forSearch= «true».
|
visible
(атрибут)
|
0..1, необязательно
|
xs:boolean
|
Отображать параметр в интерфейсе пользователя или нет
|
forSearch
(атрибут)
|
0..1, необязательно
|
xs:boolean
|
Параметр используется в запросе экспорта для поиска данных.
|
forPayment
(атрибут)
|
0..1, необязательно
|
xs:boolean
|
Параметр используется при формировании данных платежа - его значение должно быть включено в блок дополнительных параметров платежа.
|
Наименование
|
Кол-во тегов
|
Тип данных
|
Комментарий
|
Field
|
1..n, обязательно
|
DescriptionField_Type
|
|
name
(атрибут)
|
1, обязательно
|
xs:string
|
Наименование поля параметра
Если поле сложного параметра участвует в запросе экспорта данных, его наименование должно входить в состав советующего атрибута - наименования, указанного в блоке AdditionalData экспортируемых данных.
|
label
(атрибут)
|
1, обязательно
|
xs:string
|
Наименование поля параметра для отображения в интерфейсе
|
required
(атрибут)
|
0..1, необязательно
|
xs:boolean
|
Указывает, является данное поле параметра обязательным для заполнения или нет
|
readonly
(атрибут)
|
0..1, необязательно
|
xs:boolean
|
Указывает, что данное поле параметра не может быть изменено пользователем
|
visible
(атрибут)
|
0..1, необязательно
|
xs:boolean
|
Отображать поле в интерфейсе или нет
|
Regexp
|
0..1, необязательно
|
xs:string
|
Маска для проверки значения поля параметра, в случае отсутствия проверка не производится.
Формат JAVA. Правила задания маски устанавливает Поставщик, если в его информационной системе осуществляется какой-либо контроль значения – длина, количество и порядок символов).
|
DefaultValue
|
0..1, необязательно
|
xs:string
|
Значение поля параметра по умолчанию
|
AllowedValues
|
0..1, необязательно
|
AllowedValues
|
Возможные значения для поля сложного параметра (аналог перечисления)
|
Value
|
1..n, обязательно
|
com:ParamValue_Type
|
Значение поля сложного параметра
|
label
(атрибут)
|
0..1, необязательно
|
xsd:string
|
Наименование значения
|
isSelected
(атрибут)
|
0..1, необязательно
|
xsd:boolean
|
Указывает, что данное значение выбрано в качестве текущего значения поля сложного параметра в случае если присутствует список значений для этого поля
|
data
(атрибут)
|
1, обязательно
|
xsd:string
|
Значение параметра
В запросе на экспорт значения полей сложного параметра должны совпадать с советующими значениями, указанными для этого параметра в блоке AdditionalData экспортируемых данных.
|
|
