Описание XML-формата файла рублевого платежного документа

Таблица 8.43. Поля рублевого платежного документа

Тег Атрибут Тип данных Обязат. Комментарий

Поле CORPORATE

SBNS_RPAYORDER

paymentDocument - - +

Корневой тег документа.

Содержит теги: systemID, payer, clientDeviceInfo, payment, additional

-
systemID - Xs: string (100) - Идентификатор внешней системы, из которой пришел платеж Значение настройки конфигурации «Идентификатор внешней системы»
payer action - +

Содержит структуру с данными по плательщику.

Содержит атрибуты: action. Содержит вложенные теги: type, name, taxCode, payerId, oldSystemID, oldPayerId , addInfo1, addInfo2, addInfo3, account. Атрибут action задает порядок обновления справочника плательщиков. Возможные значения: INSERT – плательщик будет добавлен в случае отсутствия в справочнике плательщиков, но не будет обновлен при его наличии; UPDATE – плательщик будет добавляться при отсутствии и обновляться при наличии; DELETE – плательщик будет удален.

Фиксированное значение атрибута «UPDATE»
type - - +

Тип плательщика.

Возможные значения: PHYSICAL – физическое лицо, JURIDICAL – юридическое лицо.

JURIDICAL, если Плательщик – Организация
name - Xs: string (255) + Наименование плательщика SBNS_ORG.NAME по SBNS_RPAYORDER.ORGID
taxCode - Xs: string (100) - Идентификационный номер налогоплательщика (ИНН) SBNS_ORG.INN
payerId - Xs: string (300) +

Идентификационный номер плательщика во внешней системе.

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

SBNS_ORG.ID
oldSystemID - Xs: string (300) -

Идентификатор системы, с которой происходит миграция клиента. Должен быть уникальным для

каждой из систем, используемых

при миграции.

Обязательно для заполнения, если необходимо сохранить историю по плательщику при переходе Банка с одной системы ДБО на другую.

Заполняется если указано значение в настройке Конфигурация FRAUD-анализа

Идентификатор предыдущей системы для формирования истории выгрузки во FRAUD

Если значение в настройке не указано, то поле не заполняется.

oldPayerId - Xs: string (300) -

Идентификатор плательщика в системе, с которой осуществляется миграция. Должен быть уникальным для каждого плательщика в пределах внешней системы.

Обязательно для заполнения, если необходимо сохранить историю по плательщику при переходе Банка с одной системы ДБО на другую.

Заполняется значением из поля указанного в настройке Конфигурация FRAUD-анализа. Предыдущий идентификатор клиента для формирования истории выгрузки во FRAUD м
addInfo1 - Xs:string (300) - Дополнительные данные по плательщику 1 -
addInfo2 - Xs: string (300) - Дополнительные данные по плательщику 2 -
addInfo3 - Xs: string (300) - Дополнительные данные по плательщику 3 -
account - - +

Данные о счетах плательщика.

Может быть в нескольких экземплярах. Содержит теги: number, bankCode

-
number - Xs: string (255) + Номер счета SBNS_ACCOUNT.ACCOUNT
bankCode - Xs: string (100) + Код банка (БИК) SBNS_ACCOUNT.BANKBIC
directorName - Xs: string (1000) - ФИО генерального директора SBNS_ORG.MANAGERNAME
directorPhone - Xs: string (1000) - Телефоны генерального директора SBNS_ORG.MANAGERPHONES
accountantName - Xs: string (1000) - ФИО главного бухгалтера SBNS_ORG.ACCOUNTANTNAME
accountantPhone - Xs: string (1000) - Телефоны главного бухгалтера SBNS_ORG.ACCOUNTANTPHONES
fax - Xs: string (1000) - Факс SBNS_ORG.FAX
email - Xs: string (1000) - Адрес электронной почты SBNS_ORG.EMAIL
additionalContacts   Xs: string (1000) - Дополнительная контактная информация SBNS_ORG.NOTES
clientDeviceInfo - - +

Данные о рабочем месте отправителя. Может быть несколько.

Содержит теги: eventType, avpActive, ip, imei, imsi, mac, notRemoteAccess, osUpdatable, outerKeyStorage, deviceId, payerPhoneNumber

-
eventType - Xs: string +

Признак действия. Возможные значения:

• SAVE (сохранение)

• SIGN (подпись)

• SEND (отправка)

 
avpActive - Xs:boolean -

Флаг наличия антивируса на рабочем месте отправителя.

Возможные значения: true, false

AVPACTIVE

ip - Xs: string +

Внешний IP-адрес устройства (если удалось определить). Должен содержать корректный Ipv4 или Ipv6 адрес

Возможна передача нескольких значений

 
imei - Xs: string + IMEI - IMEI, только для устройств на Android (если удалось определить). Если не определен - null  
imsi - Xs: string + IMEI - IMEI, только для устройств на Android (если удалось определить). Если не определен - null  
mac - Xs:string -

MAC-адрес рабочего места отправителя.

Должен содержать корректный MAC-адрес (допустимы форматы с разделителем дефисом, разделителем двоеточием, без разделителя), если удалось определитьВозможна передача нескольких параметров

SBNS_USER_LOGIN_EVENT. MACADDRESS
notRemoteAccess - Xs:boolean -

Флаг отсутствия запущенной сессии удаленного доступа на рабочем месте отправителя.

Возможные значения: true, false

NOTREMOTEACCESS

osUpdatable - Xs:boolean -

Флаг активности системы обновления операционной системы на рабочем месте отправителя.

Возможные значения: true, false

SBNS_USER_WORKSPACE. OSUPDATABLE

osActualUpdate   Xs:boolean -

Флаг актуальности обновления операционной системы. Если не удалось получить – не передается

 
outerKeyStorage - Xs:boolean -

Флаг расположения ключей доступа отправителя на внешнем (съемном) носителе.[АПВ1] [ЛМС2]

Возможные значения: true, false

OUTERKEYSTORAGE

deviceId - xs:string  

Идентификатор мобильного ус-

тройства

SBNS_MOBILE_PUSH_DEVICE.DEVICEID
payerPhoneNumber - Xs: string + Номер телефона пользователя SBNS_PERSONCLIENT.PHONE
payment - - +

Основные данные платежа.

Содержит теги: dateTimeCreate, dateTimeReceive, payerName, payerTaxCode, payerAccount, payerBankCode, receiverName, receiverTaxCode, receiverAccount, receiverBankCode, documentNumber, documentDate, documentType, docRef, amount, currencyCode, ground

-
dateTimeCreate - Xs:dateTime +

Дата создания документа отправителем.

Дата и время в формате ГГГГ-ММ-ДДТчч:мм:сс.ССС [+чч:мм]

SYSCREATETIME
dateTimeReceive - Xs:dateTime +

Дата приема на обработку документа внешней системой (дата отправки платежа в Банк).

Дата и время в формате ГГГГ-ММ-ДДТчч:мм:сс.ССС [+чч:мм]

DELIVEREDTIME
payerName - Xs:string (255) + Имя отправителя платежа PAYERNAME
payerTaxCode - Xs:string (100) - Идентификационный номер налогоплательщика (ИНН) отправителя PAYERINN
payerAccount - Xs:string (255) + Счет, с которого производится отправка платежа. PAYERACCOUNT
payerBankCode - Xs:string (100) + Код банка (БИК) отправителя платежа PAYERBANKBIC
receiverName - Xs:string (255) + Наименование получателя платежа RECEIVERNAME
receiverTaxCode - Xs:string (100) - Идентификационный номер налогоплательщика (ИНН) получателя RECEIVERINN
receiverAccount - Xs:string (255) + Счет получателя платежа RECEIVERACCOUN
receiverBankCode - Xs:string (100) + Код банка (БИК) получателя платежа RECEIVERBANKBIC
documentNumber - Xs:string (50) + Номер платежного поручения DOCNUMBER
documentDate - Xs:dateTime +

Дата платежного документа.

Дата в формате ГГГГ-ММ-ДД

DOCDATE
documentType - Xs:string (100) +

Тип платежного документа.

Для рублевого платежного документа в настоящее время определен тип – PDR

Фиксированное значение «PDR»
docRef - Xs:string (100) +

Референс платежного документа во внешней системе.

Должен быть уникальным для каждого платежного документа в пределах одной внешней системы и одного типа документа.

ID
amount - Xs:double + Сумма платежа в формате 0.00 (без разделителей разрядов, разделитель целой и дробной части – точка) DOCUMENTSUM
currencyCode - Xs:string (3) + Валюта платежа (цифровой код) Фиксированное значение «810»
ground - Xs:string (40000) - Основание платежа PAYMENTPURPOSE
additional - - -

Массив дополнительных полей платежного документа.

Весь этот массив хранится в БД одним полем в формате не ограничен, общий размер всех дополнительных полей не должен превышать 4Мб. Содержит теги: field

-
field - - -

Дополнительное поле платежного документа.

Содержит структуру. Может быть в нескольких экземплярах. Содержит теги: name, value.

-
name - Xs:string + Имя дополнительного поля -
value - Xs:string + Значение дополнительного поля -
В рамках доработок законодательства по 383-П в блоке additional будет передаваться в том числе и поле РПП Рез. поле (23)
RESERV23 - Xs:string - Резервное поле Резервное поле
value - Xs:string     Из поля РПП «RESERV23»
В рамках доработок законодательства "Указание 5286-У" в блоке additional должен передаваться атрибут Платежного поручения
incometypecode - Xs:string - Назначение платежа кодовое (для указания кода вида дохода) INCOMETYPECODE
value - Xs:string -    

[Примечание] Примечание

В теге account передается информация обо всех счетах плательщика для обновления информации о плательщике в системе FA. В теге payeraccount указывается тот счет, с которого осуществляется платеж.

Таблица 8.44. Описание массива дополнительных полей, которые необходимо передавать внутри тега additional для работы критериев системы

Значение поля field Описание
STMQUERYEXIST

Признак наличия документов Запрос выписки по счетам плательщика за контрольный период (Boolean).

Возможные значения: 0 (false), 1(true).

ACCOUNTREST Остаток на счете плательщика за вычетом суммы текущего платежа (double) в формате 0.00 (без разделителей разрядов, разделитель дробной и целой части – точка).
FAULTPASSATTEMTCOUNT Общее количество неудачных попыток ввода пароля при входе в систему (integer).
PASSCHANGED Признак смены пароля пользователем за контрольный период до создания платежного поручения. Контрольный период по умолчанию 24 часа (Boolean). Возможные значения: 0 (false), 1 (true).
REFUSEDDOCCOUNT Количество отказанных платежных поручений (integer).
SENDTYPE Описание способа отправки платежа (string). Возможные значения: электронно, почтой, телеграфом, срочно.
SENDTYPECODE

Код способа отправки платежа (string).

Возможные значения: «0» - пустое значение, «1» - электронно, «2» - почтой, «3» - телеграфом, «4» - срочно.

SAFETOUCHCONFIRM

Признак использования клиентом устройства safetouch при отправке платежа (Boolean).

Возможные значения: 0 (false), 1 (true).

PAYMENTSOURCE Источник платежа. Возможные значениия: "ИК", "БК" или "МК", где ИК – передается внешней системой, если клиент отправил платеж с интернет-клиента ДБО (тонкий клиент); БК – передается внешней системой, если клиент отправил платеж с банк-клиента ДБО (толстый клиент); МК – передается внешней системой, если клиент отправил платеж с мобильного клиента ДБО.