Каталог услуг поставщика
В ИС РНиП реализован функционал по импорту/экспорту Каталогов услуг поставщика посредством веб-сервиса, развёрнутого на стороне Системы.
Для каждого поставщика в ИС РНиП посредством импорта данных из ИС ПУ загружается Каталог услуг поставщика. В последующих запросах на импорт поставщик может загружать в ИС РНиП измененённый Каталог услуг поставщика (за период, начиная с указанной даты). Если для Поставщика ранее загружался в ИС РНиП Каталог услуг, то в результате импорта нового Каталога услуг, все ранее загруженные услуги для данного поставщика становятся не доступны в Системе. Вновь загруженные услуги доступны в Системе для экспорта, осуществления по ним начислений и платежей.
Данные Каталога услуг поставщика приведены в файле Catalog.xsd
(пункт 6. «XSD-схемы сущностей ИС РНиП» настоящего документа) и схематично представлены на рисунке 15, описание элементов приведено в таблице 17.
Рисунок . Каталог услуг поставщика
Таблица . Атрибуты и элементы типа ServiceCatalog_Type
Наименование
|
Кол-во тегов
|
Тип данных
|
Комментарий
|
@name
|
1
|
xs:string
|
Наименование Каталога.
|
@revisionDate
|
1
|
xs:date
|
Дата последнего изменения Каталога (текущая дата).
|
@version
|
0..1
|
xs:token
|
Версия (версия форматов).
Для текущей версии форматов принимает значение «1.15».
|
Service
|
1..n
|
Service_Type
|
Каталог услуг поставщика (см. п. 2.7.1)
|
Signature
|
0..1
|
ds:SignatureType
|
Цифровая подпись xml-документа. В теге содержатся реквизиты цифровой подписи, соответствующие стандарту XML-Signature (описание стандарта XML-Signature находится в сети Интернет по адресу http://www.w3.org/TR/xmldsig-core/).
Тег должен содержать определение префикса пространства имён «http://www.w3.org/2000/09/xmldsig#»
|
Тип Service_Type
Рисунок . Тип Service_Type
Таблица . Атрибуты и элементы типа Service_Type
Наименование
|
Кол-во тегов
|
Тип данных
|
Комментарий
|
@name
|
1
|
xs:string
|
Наименование услуги.
|
@code
|
1
|
xs:string
|
Идентификатор услуги Поставщика.
|
@desc
|
0..1
|
xs:string
|
Описание услуги.
|
@expires
|
0..1
|
xs:date
|
Дата, до которой предоставляется услуга, если отсутствует, то услуга действует постоянно.
(Не используется)
|
@isActive
|
1
|
xs:boolean
|
Показывает доступность услуги:
true - доступна
false - не доступна.
|
@revisionDate
|
0..1
|
xs:date
|
Дата внесения изменений.
|
ServiceCategory
|
1
|
Контейнер
|
Категория услуги. Заполняется в соответствии с перечнем, наименований и кодов категорий представленном в разделе 2 документа «Методические рекомендации (Каталог и начисление)». Актуальный перечень категорий, и ответы на вопросы по использованию/присвоению кодов категорий можно получить обратившись по электронному адресу help.rnip@mos.ru.
|
@code
|
1
|
xs:string
|
Код категории.
|
@name
|
1
|
xs:string
|
Наименование категории.
|
PaymentParameters
|
0..1
|
Контейнер
|
Список параметров платежа, необходимых для принятия платежа по услуге. Список параметров состоит из произвольного числа параметров 2-х типов:
DescriptionSimpleParameter
DescriptionComplexParameter
Для услуги обязательно должны быть описаны:
Идентификатор плательщика;
Код бюджетной классификации (КБК) (при отсутствиии заполняется 20 нулями);
Полное наименование получателя, для указания в поле 16 платежа;
Для авансовой услуги дополнительно должна указываться информация:
Описание параметров для заполнения налоговых реквизитов;
Шаблон и параметры для формирования назначения платежа.
Информация по заполнению параметров платежа представлена в документе «Методические рекомендации (Каталог и начисление)»
|
DescriptionSimpleParameter
|
1..n
|
Контейнер
|
Описание параметров услуги, подлежащих заполнению плательщиком при её оплате.
(см. п. 2.7.1.1). Используется для определения реквизитов, используемых при запросе неоплаченных начислений в ИС РНиП, при составлении платежного поручения и обработки платежа, а также для того, чтобы плательщик при совершении платежа мог указать необходимую информацию.
Информация по заполнению параметров платежа представлена в документе «Методические рекомендации (Каталог и начисление)»
|
DescriptionComplexParameter
|
1..n
|
Контейнер
|
Комплексное описание параметров услуги (см. п 2.7.1.2).
Используется для определения реквизитов, описанных группами параметров используемых при запросе начислений в ИС РНиП, при составлении платежного поручения и обработки платежа, а также для того, чтобы плательщик при совершении платежа мог указать необходимую информацию.
Информация по заполнению параметров платежа представлена в документе «Методические рекомендации (Каталог и начисление)»
|
CurrenciesServices
|
0..1
|
Контейнер
|
Коды валют, в которых возможна оплата услуги.
|
CurrencyCode
|
1..n
|
Com:CurrencyCodeType
|
Код валюты.
Всегда указывать наименование для рублей « RUR»
|
org:Payee
|
1
|
Контейнер
|
Поставщик услуги и получатель платежа (если это одно и то же лицо. В противном случае, в данном поле указываются данные только поставщика услуги).
Поле должно быть ВСЕГДА заполнено.
Если для данной услуги предполагается авансовая оплата (признак PaymentKind =1,2) или помимо данных поставщика услуги нужно указать полное наименование получателя платежа, то в блоке «DescriptionSimpleParameter» указывается простой параметр с наименованием @name = Recipient. Пример заполнения параметра приведен в разделе 2.1 документа «Методические рекомендации (Каталог и начисление)».
Требования к формату заполнения поля «Получатель» представлены в Положении ЦБР и Минфина РФ от 13 декабря 2006 г. N 298-П.
|
@name
|
1
|
xsd:string
|
Наименование организации
|
@INN
|
1
|
INN_Type
|
ИНН получателя.
|
@KPP
|
1
|
KPP_Type
|
KPP Получателя.
|
@OKATO
|
1
|
ОКАТО_Type
|
Код ОКАТО.
|
@OGRN
|
0..1
|
OGRN_Type
|
ОГРН.
|
Accounts
|
1
|
Контейнер
|
Счета организации
|
Account
|
1..n
|
AccountCatalogType
|
Счет организации
|
@kind
|
0..1
|
xsd:positiveInteger
|
Тип счета, принимает значения:
1 – расчетный;
2 – текущий;
3 - корреспондентский.
(по умолчанию – «расчетный»)
|
Account
|
1
|
AccountNumType
|
Номер счета.
|
Bank
|
1
|
Контейнер
|
Данные Банка, в котором открыт счет.
|
@name
|
0..1
|
xsd:string
|
Наименование Банка, в котором открыт счет
|
@BIK
|
1
|
xsd:string
|
БИК Банка, в котором открыт счет. Наличие этого тега исключает тег SWIFT.
|
@SWIFT
|
1
|
xsd:string
|
SWIFT – код Банка, в котором открыт счет. Наличие этого тега исключает тег BIK.
(Не используется).
|
CorrespondentBankAccount
|
0..1
|
AccountNumType
|
Корреспондентский счет Банка в ЦБ РФ
|
Address
|
0..1
|
Контейнер
|
Адрес организации
|
Contacts
|
0..n
|
Контейнер
|
Контактная информация
|
Addresses
|
0..1
|
Контейнер
|
Адреса организации (рекомендуется для заполнения)
|
Contacts
|
0..1
|
Контейнер
|
Контакты организации (рекомендуется для заполнения)
|
PaymentKind
|
0..1
|
xs:integer
|
Вид оплаты:
1 – авансовый платеж;
2 – услуга может иметь одновременно два типа оплаты (авансовый платеж и оплата выставленного поставщиком услуг счета);
3 – оплата выставленного поставщиком услуг счета.
Обязательно для заполнения.
|
MinAmount
|
0..1
|
Контейнер
|
Минимальная сумма платежа по услуге
|
@currency
|
0..1
|
com:CurrencyCodeType
|
Код валюты в соответствии с ISO4217
|
@exponent
|
0..1
|
xsd:integer
|
Количество дробных знаков
|
MaxAmount
|
0..1
|
Контейнер
|
Максимальная сумма платежа по услуге
|
@currency
|
0..1
|
com:CurrencyCodeType
|
Код валюты в соответствии с ISO4217
|
@exponent
|
0..1
|
xsd:integer
|
Количество дробных знаков используется значение =2 - передается целое значение в копейках
|
Commissions
|
0..1
|
com:Commission_Type
|
Комиссии / торговые уступки по услуге – заполняется согласно требованиям документа «Методические рекомендации (Каталог услуг и начисление)».
|
Commission
|
1..n
|
com:Commission_Type
|
Комиссии/ торговые уступки по услуге
Используется в случае установленных вида и значений комиссии/ уступки. Правила и примеры заполения приведены в документе «Методические рекомендации (Каталог и начисление)»
|
Kind
|
1
|
xsd:string
|
Вид комиссии/ уступки
1 – комиссия за операцию, с плательщика в пользу поставщика (зарезервировано)
2 - комиссия за операцию, с агента в пользу поставщика (зарезервировано)
3 - вознаграждение агенту за период взаиморасчётов агента и поставщика (зарезервировано)
4 – торговая уступка КО (платежному агенту) за операцию с Поставщика, в случае, если комиссия с Плательщика не берется.
5 – торговая уступка КО (платежному агенту) за операцию с Поставщика в случае если с Плательщика берется комиссия уменьшенная на величину этой уступки.
|
Percent
|
0..1
|
xsd:decimal
|
Процент для расчета величины торговой уступки относительно фактической суммы платежа (т.е. платежа без комиссии)/
Параметр ограничени значениями [0.0 – 100.0];
- Если данный тег определен и имеет не нулевое значение, то при условии попадания суммы платежа в границы диапазона заданного параметрами (MinValue - MaxValue)
- значение уступки расчитывается как процент суммы платежа;
- Если Percent = 0, то это означает, что уступка для данного диапазона суммы платежа отсутствует;
-Если параметр Persent не определен, то значения (MinValue - MaxValue) задают ограничения на величину уступки (рассчитанной на основе данных из другого блока).
|
MinValue
|
0..1
|
com:Money
|
Минимальная сумма платежа, при которой применяется процент - тег «Percent» для расчета величины торговой уступки.
При отсутствии тега сумма принимается равной 0.
При отсутствии тега «Percent» представляет минимальную величину торговой уступки.
Запись должна представлять значение сотых долей валюты, т.е. указывается количество копеек, (одна копейка записывается как «1», а один рубль, записывается как «100»).
|
@currency
|
0..1
|
com:CurrencyCodeType
|
Код валюты в соответствии с ISO4217
|
@exponent
|
0..1
|
xsd:integer
|
Количество дробных знаков. Используется значение = 2 - передается целое значение суммы в копейках.
|
MaxValue
|
0..1
|
com:Money
|
Максимальная сумма платежа, при которой применяется процент – тег «Percent» для расчета величины торговой уступки.
при отсутствии тега принимается неограниченной.
При отсутствии тега «Percent» представляет максимальную величину торговой уступки.
Запись должна представлять значение сотых долей валюты, т.е. указывается количество копеек, (одна копейка записывается как «1», а один рубль, записывается как «100»).
|
@currency
|
0..1
|
com:CurrencyCodeType
|
Код валюты в соответствии с ISO4217
|
@exponent
|
0..1
|
xsd:integer
|
Количество дробных знаков. Используется значение = 2 - передается целое значение суммы в копейках.
|
Regions
|
0..1
|
Контейнер
|
Регионы, в которых предоставляется данная услуга.
(Не используется)
|
Region
|
1..n
|
Region_Type
|
Регион
|
@id
|
0..1
|
|
Идентификатор региона
|
@name
|
0..1
|
|
Наименование региона
|
Subservices
|
0..1
|
Контейнер
|
Подуслуги.
Для услуг, состоящих из нескольких частей, по которым осуществляется отдельная оплата. Деление услуг на подуслуги – на усмотрение Поставщика.
|
Service
|
1..n
|
Service_Type
|
Описание (не используется)
|
com:AdditionalData
|
0..1
|
com:AdditionalData_Type
|
Дополнительные данные
|
TraitGroup
|
1..n
|
Контейнер
|
Группа атрибутов.
|
@name
|
0..1
|
xsd:string
|
Наименование группы атрибутов
|
Trait
|
1
|
com:Trait_Type
|
Атрибут
|
@required
|
0..1
|
xsd:boolean
|
Обязательный/не обязательный.
Пример: true
|
@label
|
0..1
|
xsd:string
|
Метка.
|
@valueFormat
|
0..1
|
xsd:string
|
Формат данных
|
Name
|
1
|
xsd:string
|
Наименование атрибута.
|
Value
|
1
|
xsd:string
|
Значение атрибута.
| Элемент DescriptionSimpleParameter
Рисунок . Элемент DescriptionSimpleParameter
Таблица . Элемент DescriptionSimpleParameter
Наименование
|
Кол-во тегов
|
Тип данных
|
Комментарий
|
@name
|
1
|
xs:string
|
Наименование простого параметра услуги.
Если параметр используется для поиска начислений или платежей в запросе экспорта данных, его наименование должно также присутствовать в блоке AdditionalData экспортируемых данных.
Наименования параметров, описывающих КБК, параметров для заполнения налоговых реквизитов и т.д. должны соответствовать значениям, указанным в п.2.1 документа «Методические рекомендации (Каталог и начисление)»
|
@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
|
Значение «true» указывает, что в интерфейсе плательщика должно быть отображено наименование текущего параметра и его значение (вслучае, если заполнен DefaultValue для данного параметра) и/или должно быть указано плательщиком (вслучае, если @required имеет значение «true» и/или @readonly имеет значение «false»)
|
@forSearch
|
0..1
|
xs:boolean
|
«true» - означает, что параметр может использоваться для поиска начислений или палтежей в запросе экспорта данных.
(если параметр используется в запросе экспорта данных, его наименование и значение должно присутствовать в блоке AdditionalData экспортируемых данных).
|
@forPayment
|
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 экспортируемых данных.
|
Элемент DescriptionComplexParameter
Рисунок . Элемент DescriptionComplexParameter
Таблица . Элемент DescriptionComplexParameter
Наименование
|
Кол-во тегов
|
Тип данных
|
Комментарий
|
@name
|
1
|
xs:string
|
Наименование сложного параметра ( См. п.2.1 документа «Методические рекомендации (Каталог и начисление)»).
Если параметр используется для поиска начислений или платежей в запросе экспорта данных, его наименование должно также входить в состав соответсвющего атрибута - наименования сложного параметра, указанного в блоке 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
|
«true» - означает, что параметр может использоваться для поиска начислений или палтежей в запросе экспорта данных.
(если параметр используется в запросе экспорта данных, его наименование и значение должно присутствовать в блоке AdditionalData экспортируемых данных).
|
@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
|
Отображать поле в интерфейсе или нет
|
|
