Руководство пользователя электронного сервиса СМЭВ (стр. 6 )

Описание общих структур данных

ipsh:Suppliers (Поставщики услуг)

№	Код параметра	Описание параметра	Обязательность	Способ заполнения/Тип	Комментарий
1	supplier	Данные по отдельному поставщику услуг.	+	ipsh:Supplier	Количество элементов 1..N

ipsh:Supplier (Поставщик услуг)

№	Код параметра	Описание параметра	Обязательность	Способ заполнения/Тип	Комментарий
1	supplierName	Наименование Поставщика	+	xsd:string	Количество элементов 1..1
2	supplierINN	ИНН Поставщика услуги	+	xsd:string	Количество элементов 1..1
3	action	Тип действия с записью справочника «Тип операции с поставщиком услуги»	+	xsd:string	Количество элементов 1..1
4	serviceTypes	Информация о видах услуг, которые предоставляет данный Поставщик услуг.	+	ipsh:ServiceTypes	Количество элементов 1..1

ipsh:ServiceTypes (Типы услуг)

№	Код параметра	Описание параметра	Обязательность	Способ заполнения/Тип	Комментарий
1	serviceType	Информация об одном из видов услуг, которые предоставляет данный Поставщик услуг.	+	ipsh:ServiceType	Количество элементов 1..N

ipsh:ServiceType (Тип услуги)

№	Код параметра	Описание параметра	Обязательность	Способ заполнения/Тип	Комментарий
1	serviceTypeCode	Код вида услуги	+	xsd:string (20)	Количество элементов 1..1
2	serviceName	Наименование услуги	+	xsd:string	Количество элементов 1..1
3	regionCode	2-значный код региона по ОКАТО	+	xsd:string	Количество элементов 1..1

Сведения об ошибке (cn: Error)

№	Код параметра	Описание параметра	Обязательность	Способ заполнения/Тип	Комментарий
1	errorCode	Код ошибки	+	xsd:integer	Количество элементов 1..1
2	errorMessage	Описание ошибки		xsd:string(1000)	Количество элементов 0..1

Описания справочников

Возможные типы дополнительных атрибутов. Данная таблица является пополняемой. При необходимости передачи атрибутов начислений, отсутствующих в данной таблице, новые атрибуты будут добавлены по согласованию с Поставщиком начислений.

Возможные типы дополнительных атрибутов:

Тип атрибута	Тип значения	Описание	Текст на ПГУ
Month	Текст	Период оплаты (месяц) в формате ММ-ГГГГ	период
DocNo	Текст	Номер начисления в месяце	№ док.
TaxPeriod	Текст	Налоговый период	период
TaxDocNumber	Текст	Показатель номера документа	№ док.
TaxDocDate	Текст	Показатель даты документа	дата док.

Возможные коды ошибок:

Код ошибки	Описание	Фатальная
0	Запрос обработан успешно
1	Пользователь не найден в базе данных Поставщика начислений	+
2	Начисление не найдено в базе данных Поставщика начислений	+
3	Некритичная ошибка
4	Фатальная ошибка	+
5	Сервер занят
6	Ошибка авторизации	+
7	Платёж не найден	+
8	Платёж уже существует	+
9	Сумма ниже минимального порога	+
10	Сумма выше максимального порога	+
11	Невозможно отменить платёж	+
12	Ошибка во входных параметрах	+
13	Не найден лицевой счет	+
14	Не найден поставщик услуг	+

Справочник кодов видов услуг сформирован на основе Общероссийского классификатора услуг населению (ОКУН).

Код ОКУН/ИПШ	Наименование	Примечание
030000	Услуги связи	Данный код используется в том случае, если начисление сформировано Поставщиком услуги, по лицевым счетам которого оказывается одновременно много услуг связи (интернет, телефон и пр.). В остальных случаях используется классификатор более низкого уровня
032000	Услуги телефонной связи
034100	Услуги Интернет
035100	Услуги кабельного телевидения
042000	Жилищно-коммунальные услуги	Данный код используется в том случае, если начисление сформировано как Единый платёжный документ. В остальных случаях используется классификатор более низкого уровня
041100	Жилищные услуги
042100	Услуги электроснабжения
042200	Услуги водоснабжения
042300	Услуги газоснабжения
042400	Услуги теплоснабжения

Возможные значения для типа «Тип операции с поставщиком услуги»

Код	Название
1	добавление записи
2	изменение записи
3	удаление записи

Возможные значения для типа «Статус распоряжения на оплату в расчетном банке»

Код	Название
NEW	Распоряжение передано в банк, но не выполнено
CREATE_ERROR	При создании распоряжения возникла ошибка из-за валидации переданных параметров
CANCELED	Распоряжение отменено, согласно запросу на отмены платежа
PROCESSING_ERROR	При выполнении распоряжения возникла ошибка из-за параметров распоряжения
DONE	Распоряжение выполнено
MONEY_BACK	По выполненному распоряжению были возвращены деньги

Возможные значения для типа «Роль агента»

Код	Название
PAY_GATE	Шлюз поставщиков платежных сервисов (ШППС)
PAY_SYSTEM	Поставщик платежного сервиса
PAY_BANK	Расчетный банк
SERVICE_PROVIDER	Поставщик начислений
SERVICE_SUPPLIER	Поставщик услуги

Возможные значения для типа «Тип операции по согласованию статусов платежей по результатам отчета о выполненных операциях»

Код	Название
PAYMENT_CANCEL	полная отмена платежа
BILL_SOURCE_PUSH	Допроведение платежа со стороны ИПШ путем уведомления ПН о платеже
PAY_BANK_PUSH	Допроведение платежа со стороны ИПШ путем передачи в РБ повторного распоряжения на перечисление средств
PAYMENT_STATUS_CHANGE	изменение статуса платежа (приведение статуса платежа к статусу платежа в расчётном банке)
PAYMENT_STATUS_SAVE	игнорирование статуса платежа (статус платежа не изменяется)
PAYMENT_IGNORE	игнорирование платежа (поскольку платёж не найден в базе данных платежа, то он не обрабатывается)

Возможные значения для типа «Код причины отмены платежа»

Код	Название
USER_CANCEL	Отмена платежа на основании заявления пользователя
SUPPLIER_ERROR	Ошибка при приеме платежа поставщиком услуги
BANK_PAY_REQUEST_ERROR	Ошибка при передаче банку указания на перечисление денежных средств
BANK_PAY_ERROR	Ошибка при переводе банком денежных средств
BANK_MONEY_BACK	Возврат платежа банком получателя из-за неверных платёжных реквизитов
SUPPLIER_MONEY_BACK _ERROR	Ошибка из-за возврата платежа поставщиком услуги
IPSH_ERROR	Ошибка при обработке платежа в ИПШ
OVER_ERROR	Прочие ошибки