Спецификация форматов и порядок обмена данными в канале «Сбербанк Интеграция» (API). Версия 33.000

Содержание

Введение

1.1. Назначение документа

1.2. Термины и сокращения

1.3. Ссылки на документы

РКО по рублевым операциям

2.1. Платежное поручение

2.1.1.

Дайджест

2.1.2.

Формат взаимодействия

2.1.2.1.

Формат отправки документа в СББОЛ

2.1.2.2.

Особенности получения статусов об обработке из СББОЛ

2.2. Запрос выписки

2.2.1.

Клиентский запрос выписки

2.2.1.1.

Общие сведения

2.2.1.2.

Дайджест

2.2.1.3.

Формат взаимодействия

2.2.1.3.1.

Формат отправки документа в СББОЛ

2.2.1.4.

Особенности получения статусов об обработке из СББОЛ

2.2.2.

Запрос на получение ежедневной выписки и других документов, сформированных на

стороне СББОЛ

2.2.2.1.

Общие сведения

2.2.2.2.1. Дайджест запроса на получение выписки Request/Incoming

2.2.2.2.2. Дайджест запроса на получение выписки Request/AccountStatement

2.2.2.3.

Формат взаимодействия

2.2.2.3.1.

Формат отправки запроса на получение выписки Request/Incoming

2.2.2.3.2.

Формат отправки запроса на получение выписки Request/AccountStatement

2.2.2.4.

Особенности взаимодействия

2.3. Инкрементальное обновление выписки

Не поддерживается

2.4. Информация о движении денежных средств по рублевому/валютному счету

2.4.1.

Общие сведения

2.4.2.

Дайджест

2.4.3.

Формат взаимодействия

2.4.3.1.

Формат получения выписки из СББОЛ

2.5. Платежное требование (исходящее)

127

2.5.1.

Дайджест

127

2.5.2.

Формат взаимодействия

131

2.5.2.1.

Формат отправки документа в СББОЛ

131

2.5.3.

Особенности получения статусов об обработке из СББОЛ

140

2.6. Кредитные договоры

147

2.6.1.

Распоряжение о переводе кредитных средств

147

2.6.1.1.

Дайджест

147

2.6.1.2.

Формат взаимодействия

150

2.6.1.2.1.

Формат отправки документа в СББОЛ

151

2.6.1.3.

Особенности получения статусов об обработке из СББОЛ

155

Документы свободного формата

162

3.1. Письмо в банк (функционал отключен и более не поддерживается)

162

3.1.1.

Общие сведения

162

3.1.2.

Дайджест

162

3.1.3.

Формат взаимодействия

165

3.1.3.1.

Формат отправки документа в СББОЛ (функционал отключен и более не поддерживается)

165

3.1.4.

Особенности получения статусов об обработке из СББОЛ

175

3.2. Письмо из банка (функционал отключен и более не поддерживается)

182

3.2.1.

Общие сведения

182

3.2.2.

Дайджест

182

3.2.3.

Формат взаимодействия

185

3.2.3.1.

Формат получения документа (функционал отключен и более не поддерживается)

185

3.3. Письмо свободного формата в банк

192

3.3.1.

Общие сведения

192

3.3.2.

Дайджест

192

3.3.3.

Формат взаимодействия

193

3.3.3.1.

Формат отправки документа в СББОЛ

193

3.3.4.

Особенности получения статусов об обработке из СББОЛ

198

3.4. Письмо свободного формата из банка

200

3.4.1.

Общие сведения

200

3.4.2.

Дайджест

200

3.4.3.

Формат взаимодействия

201

3.4.3.1.

Формат получения документа

202

3.5. Обмен сообщениями с Банком

206

3.5.1.

Дайджест запроса чата с Банком

206

3.5.2.

Дайджест получения сообщения из Банка

207

3.5.3.

Дайджест запроса статусов обработки сообщения из СББОЛ

208

3.5.4.

Формат взаимодействия

209

3.5.4.1.

Формат отправки запроса чата с Банком

209

3.5.4.2.

Формат получения сообщения из Банка

210

3.5.4.3.

Формат отправки сообщения в Банк

212

3.5.4.4.

Формат запроса статусов обработки сообщения из СББОЛ

219

3.5.5.

Особенности получения статусов обработки сообщения из СББОЛ

220

3.6. Передача скан-копий иных документов в Банк

222

3.6.1.

Общие сведения

222

3.6.2.

Дайджест запроса на добавление «Иного документаª

224

3.6.3.

Формат взаимодействия

226

3.6.3.1.

Формат отправки «Иного документаª в СББОЛ

226

3.6.4.

Дайджест запроса на добавление контракта ГОЗ

230

3.6.5.

Формат взаимодействия

233

3.6.5.1.

Формат отправки запроса на добавление контракта ГОЗ в СББОЛ

233

3.6.6.

Дайджест запроса на добавление акта ГОЗ

238

3.6.7.

Формат взаимодействия

240

3.6.7.1.

Формат отправки запроса на добавление акта ГОЗ в СББОЛ

241

3.6.8.

Дайджест документа «Запрос ссылки на загрузку файлаª

245

3.6.9.

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

247

3.6.9.1.

Формат отправки документа «Запрос ссылки на загрузку файлаª в СББОЛ

247

3.6.9.2.

Формат получения ссылки из СББОЛ

250

3.6.10.

Дайджест документа «Запрос статуса загрузки файлаª

252

3.6.11.

Формат взаимодействия при запросе статуса загрузки файлов

254

3.6.11.1. Формат отправки документа «Запрос статуса загрузки файлаª в СББОЛ

254

3.6.11.2. Формат получения статуса загрузки файла из СББОЛ

255

3.6.12.

Особенности получения статусов загруженных файлов

257

3.7. Передача «Досылаемых документовª в Банк

260

3.7.1.

Дайджест «Досылаемых документовª

260

3.7.2.

Формат взаимодействия при отправке «Досылаемых документовª

262

3.7.2.1.

Формат отправки «Досылаемых документовª в СББОЛ

262

3.7.3.

Особенности получения статусов обработки «Досылаемых документовª из СББОЛ

265

3.8. Работа в Личном кабинете поставщика услуг

268

3.8.1.

Общие сведения

268

3.8.2.

Передача в банк Реестра задолженностей

270

3.8.2.1.

Дайджест запроса на получение ссылок на загрузку реестра задолженностей

270

3.8.2.2.

Формат запроса на получение ссылок на загрузку реестра задолженностей

272

3.8.2.3.

Дайджест ответа со ссылками на загрузку реестра задолженностей

274

3.8.2.4.

Формат ответа со ссылками на загрузку реестра задолженностей

276

3.8.2.5.

Дайджест запроса на загрузку реестра задолженностей

278

3.8.2.6.

Формат запроса на загрузку реестра задолженностей

280

3.8.2.7.

Особенности получения статусов загрузки реестра задолженностей

284

3.8.3.

Получение из Банка реестра платежей

287

3.8.3.1.

Общие сведения

287

3.8.3.2.

Дайджест запроса реестра платежей

287

3.8.3.3.

Формат запроса реестра платежей

288

3.8.3.4.

Дайджест ответа с реестром платежей

290

3.8.3.5.

Формат ответа с реестром платежей

291

3.8.3.6.

Дайджест запроса на скачивание из СББОЛ реестра платежей

296

3.8.3.7.

Формат запроса на скачивание из СББОЛ реестра платежей

297

3.8.3.8.

Дайджест ответа со ссылкой на скачивание реестра платежей

298

3.8.3.9.

Формат ответа со ссылкой на скачивание реестра платежей

299

1. Введение

Данная документация предназначена для описания форматов взаимодействия с СББОЛ, а

именно:

- РКО по рублевым операциям;

- Документы свободного формата.

1.1. Назначение документа

Настоящий документ содержит описание API взаимодействия внешней Учетной системой

клиента с каналом предоставления ДБО «Универсальный Платежный Шлюз» (УПШ).

Документ содержит описание особенностей интеграции учетной системы клиента и УПШ,

форматов передаваемых сообщений и особенностей работы.

1.2. Термины и сокращения

Таблица 1. Глоссарий

№

Термин/Сокращение

Определение

п/п

АБС

Автоматизированная банковская система

Банк

ОАО «Сбербанк России»

Перечень подписываемых полей сообщения и их

значения, передаваемого со стороны Банка в УС или

наоборот.

Дайджест

При отправке к сообщению предъявляются требования

- должен ли он быть подписан отправителем. В случае

необходимости подпсиания сообщения - должен быть

сформирован дайджест

Дистанционное банковское обслуживание (АРМ

ДБО

«Клиент» ЦАС «Клиент-Сбербанк» и АС «Сбербанк

Бизнес Онл@йн»)

Юридическое лицо/индивидуальный предприниматель,

являющиеся резидентами, имеющие в Банке

Клиент

банковский(-ие) счет (-а) в валюте Российской

Федерации и/или иностранных валютах и

заключившие с Банком Договор банковского счета

Система

Система «CORREQTS»

СББОЛ

АС Сбербанк Бизнес ОнЛ@йн

Канал предоставления услуг дистанционного

УПШ

банковского обслуживания «Универсальный

Платежный Шлюз».

Учетные системы клиентов Банка, доработанные для

УС

взаимодействия с каналом УПШ.

Устройство - шлюз, с которым через Интернет может

взаимодействовать ПО токенов для обеспечения

безопасного канала связи с серверами в защищенной

10.

ФПСУ

подсети. Устройсво используется совместно с

токенами и служит для работы с защищаемыми веб-

сервисами через шифрованное соединения

11.

ЭД

Электронный документ

Электронная подпись - информация в электронной

форме, которая присоединена к другой информации в

электронной форме (подписываемой информации) или

12.

ЭП

иным образом связана с такой информацией и которая

используется для определения лица, подписывающего

информацию (в ред. закона от 06.04.2011 № 63-ФЗ).

Язык описания веб-сервисов и доступа к ним,

13.

WSDL

основанный на языке XML

Secure Remote Password Protocol (SRPP) — протокол

парольной аутентификации, устойчивый к

14.

SRP

прослушиванию и MITM-атаке и не требующий

третьей доверенной стороны.

1.3. Ссылки на документы

Таблица 2. Документы

№

Наименование

Местонахождение

Назначение

п/п

документа

Описание интеграция УС с каналом

УПШ:

Документация по

 Особенности реализации

API УПШ 1

 Общая

характеристика

часть.docx

процессов взаимодействия

 Безопасность

Описание форматов

взаимодействия с СББОЛ:

 Первичная

инициализация

Клиента

Документация по

 Репликация справочников на

API УПШ 2

сторону Клиента

часть.docx

 Получение

извещения

результатах

обработки

клиентских документов

 Запрос на отзыв документов

Описание форматов

Документация по

взаимодействия с СББОЛ:

API УПШ 4

часть.docx

 Документы зарплатного проекта

Описание форматов

Документация по

взаимодействия с СББОЛ:

API УПШ 5

 РКО по валютным операциям

часть.docx

 Документы валютного контроля

2. РКО по рублевым операциям

2.1. Платежное поручение

2.1.1.Дайджест

Подпись документа на стороне УС:

 Единственная подпись или

 Первая и вторая подпись

Дайджест: формируется

Ключевой буфер (дайджест):

 Для формирования электронной подписи из документа формируется строковая

последовательность (ключевой буфер или дайджест), включающая все значимые данные

документа, поля, содержащие пустые значения, не включаются.

 Ключевой буфер (дайджест) для подписания ЭП образует строковый массив в кодировке

UTF-8, Отдельные записи массива разделены символом перевода строки. В качестве

символа перевода строки используется 0x0A.

 При наличии в мультистроковых данных последовательности из двух символов перевода

строки CR+LF (ASCII 0x0D 0x0A) необходимо удалять символ возврата каретки CR (ASCII

0x0D) и оставлять только символ подачи строки LF (ASCII 0x0A).

 В случае использования 2-х ЭП дайджест строится точно также как и при единственной ЭП.

Примечание. Для отделения некоторых видов данных друг от друга в дайджест включены

«заголовки», такие как ATTRIBUTES и FIELDS. Эти «заголовки» не несут информации

исходного документа, а служат для внутренней организации данных в дайджесте.

«Заголовки» указываются в отдельной строке, где кроме них ничего нет.

Формат дайджеста:

№п/

Наименование

Версионно

Описание

Пример значения

поля

сть

ATTRIBUTES

Актуально

<Наименование поля>=<Значение поля>, например

с версии 27

OrgId=963084ba-7079-4b9d-bbab-c4972dee82d9

Идентификатор организации в

OrgId

963084ba-7079-4b9d-

ДБО (может быть использован

Актуально

bbab-c4972dee82d9

сторонней системой для

с версии 27

дополнительной идентификации)

Отправитель, а также тип

Sender

Ромашка

использованного Клиентом

Актуально

программного обеспечения при

с версии 27

отправке документа

ExtId

3a6378ef-07ee-4535-

Уникальный* идентификатор

a10a-0c82817cae23

документа в учетной системе (УС)

Актуально

Клиента.

с версии 27

*Уникальность контролируется на

стороне банка

FIELDS

<Наименование поля>=<Значение поля>, например

Актуально

AccDoc.AccDocNo=444

с версии 27

После последней строки НЕ делать перевод строки

AccDoc.AccDocN

Номер расчетного документа

444

Актуально

с версии 27

Код вида валютной операции

AccDoc.CodeVO

12010

Актуально

с версии 27

Дата создания документа

AccDoc.DocDate

2012-02-01

Актуально

с версии 27

Сумма платежа в виде decimal

AccDoc.DocSum

1230.55

Актуально

с версии 27

10.

Вид платежа

AccDoc.PaytKind

Актуально

с версии 27

11.

Очерёдность платежа

AccDoc.Priority

Актуально

с версии 27

12.

AccDoc.PsNum

Номер паспорта сделки

12345678/1481/1948/6/0

Актуально

с версии 27

13.

AccDoc.Purpose

Назначение платежа

Оплата по договору. В

Актуально

том числе НДС 18 % -

с версии 27

15.25

14.

Вид операции

AccDoc.TransKin

01 Списано, зачислено по

платежному поручению, по

поручению банка

02 Оплачено, зачислено по

платежному требованию

03 Оплачен наличными денежный

чек, выдано по расходному

кассовому ордеру

04 Поступило наличными по

объявлению на взнос наличными,

приходному кассовому ордеру,

препроводительной ведомости к

сумке 0402300

06 Оплачено, зачислено по

инкассовому поручению

07 Оплачено, поступило по

Изменено в

расчетному чеку

версии 32

08 Открытие аккредитива,

зачисление сумм

неиспользованного,

аннулированного аккредитива

09 Списано, зачислено по

мемориальному ордеру, а также по

первичным учетным документам с

реквизитами счетов по дебету и

кредиту

12 Зачислено на основании авизо

16 Списано, зачислено по

платежному ордеру

17 Списано, зачислено по

банковскому ордеру

18 Списано, зачислено по ордеру

по передаче ценностей

15.

AccDoc.UIP

УИП

1234-55-67890

Актуально

с версии 27

16.

Дополнительная услуга СБРФ

AccDoc.UrgentSB

Актуально

с версии 27

17.

Код вида дохода

AccDoc.CodeOfR

Добавлено

evenueType

в версии 33

18.

Номер кредитного договора

Credit.CredConN

5000000

Актуально

с версии 27

19.

Признак «Целевое поручение»

Credit.FlagTarget

Актуально

Assignment

с версии 27

20.

Признак «Использовать

Credit.FlagUseO

Актуально

собственные средства»

wnMeans

с версии 27

21.

Код бюджетной классификации

DepartmentalInfo

12131415161718192012

Актуально

(104)

.CBC

с версии 27

22.

Дата налогового документа (109)

DepartmentalInfo

22.03.2012

DD.MM.YYYY.

.DocDate

00 - иные случаи при

Актуально

формировании РПП в пользу

с версии 33

таможенных органов.

23.

Номер налогового документа (108)

DepartmentalInfo

1122

Актуально

.DocNo

с версии 27

24.

DepartmentalInfo

Показатель статуса

Актуально

налогоплательщика (101)

.DrawerStatus

с версии 27

25.

DepartmentalInfo

Код ОКАТО (105)

66666666666

Актуально

.OKATO

с версии 27

26.

DepartmentalInfo

Показатель основания платежа

ВУ

Актуально

(106)

.PaytReason

с версии 27

27.

DepartmentalInfo

Тип налогового платежа (110)

Актуально

.TaxPaytKind

с версии 27

28.

Налоговый период (107)

DepartmentalInfo

01.02.2015

Поле дайджеста

.TaxPeriod

DepartmentalInfo.TaxPeriod

заполняется значением XML

параметра DepartmentalInfo-

>taxPeriod.

Над значением поля перед

добавлением в дайджест делаются

следующие преобразования:

Проверяем есть ли в значении

символы отличные от цифр,

символа решетки (#) и точки (.) ;

Изменено в

Если есть - то заменяем все

версии 32

символы «/» на «.»;

Если нет - то вычисляем

длину строки;

Если длина строки равна

восьми символам - строка

добавляется в дайджест как есть;

Если нет и значение строки не

равно «0», то в конец строки

добавляются две точки (..);

Если значение строки равно

«0», в дайджест добавляется «0».

29.

ПАО СБЕРБАНК

Изменено в

Наименование банка получателя

версии

Payee.Bank.Name

32.001

30.

Payee.Bank.Bank

Название населённого пункта

Москва

Изменено в

банка получателя

City

версии

32.001

31.

Тип населённого пункта банка

Payee.Bank.Settle

Изменено в

получателя

mentType

версии

32.001

32.

БИК банка получателя

Payee.Bank.Bic

044444444

Актуально

с версии 27

33.

Номер корр. счёта банка

Payee.Bank.Corre

01020304050607080910

Актуально

получателя

spAcc

с версии 27

34.

ИНН получателя (до 12)

Payee.INN

0000000000

Актуально

с версии 27

35.

КПП получателя (до 9)

Payee.KPP

770000000

Актуально

с версии 27

36.

Наименование получателя

Payee.Name

ООО "БЕС"

Актуально

с версии 27

37.

Payee.PersonalAc

Номер счёта получателя

77777777777777777777

Актуально

с версии 27

38.

ПАО СБЕРБАНК

Изменено в

Payer.Bank.Name

Наименование банка плательщика

версии

32.001

Название населённого пункта

Изменено в

39.

Payer.Bank.Bank

Москва

банка плательщика

версии

City

32.001

40.

Тип населённого пункта банка

Изменено в

Payer.Bank.Settle

плательщика

версии

mentType

32.001

41.

БИК плательщика

Payer.Bank.Bic

010203045

Актуально

с версии 27

42.

Номер корр. счёта банка

Payer.Bank.Corre

12345678901234567890

Актуально

плательщика

spAcc

с версии 27

43.

Payer.INN

ИНН плательщика (до 12)

7777777777

Актуально

с версии 27

44.

Payer.KPP

КПП плательщика (до 9)

001122334

Актуально

с версии 27

45.

Payer.Name

Наименование плательщика

ООО "БЕС"

Актуально

с версии 27

46.

Payer.PersonalAc

Номер счёта плательщика

11111111111111111111

Актуально

с версии 27

47.

Структура (поле РЦК)

BudgetCaption

Актуально

с версии 27

48.

Центр ответственности (поле

EstimateCaption

Актуально

РЦК)

с версии 27

49.

PRODUCT (поле РЦК). Если

Product

документ передается в рамках

Актуально

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

с версии 27

указывается значение

"DirectControl"

50.

TABLES

Актуально

с версии 27

51.

Многострочная аналитика

Table=RzkDocana

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

Актуально

lytics

соответствии со справочниками

с версии 27

РЦК (СБК)

52.

Сумма

Amount

Актуально

с версии 27

53.

Код сметы доходов и расходов ЦО

Class1Code

Актуально

с версии 27

54.

Наименование сметы доходов и

Class1Description

Актуально

расходов ЦО

с версии 27

55.

Название вида финансирования

FinanceTypeDesc

Актуально

ription

с версии 27

56.

Классификатор сметы

KesrCode

Актуально

с версии 27

57.

KesrDescription

Наименование сметы статей

Актуально

доходов и расходов

с версии 27

58.

OrgGroupCaptio

Наименование группы

Актуально

организаций

с версии 27

59.

PactDate

Дата договора

Актуально

с версии 27

60.

Номер договора

PactNum

Актуально

с версии 27

61.

Наименование договора

PactSubject

Актуально

с версии 27

62.

Код вида расчетов

PayCodeCode

Актуально

с версии 27

63.

Название вида расчёта

PayCodeDescripti

Актуально

с версии 27

64.

Идентификатор вида расчёта в

PayСodeId

Актуально

РЦК (СБК)

с версии 27

65.

Код проекта

ProjectStdCode

Актуально

с версии 27

66.

Наименование проекта

ProjectStdDescrip

Актуально

tion

с версии 27

67.

Дата документа основания

ReasonDate

Актуально

платежа

с версии 27

68.

ReasonNum

Номер документа основания

Актуально

платежа

с версии 27

69.

ReasonType

Вид документа основания платежа

Актуально

с версии 27

70.

Table=BigFileAttachments EssenceAttachment

Изменено в

версии

Таблица данных вложений. Сортировка - по возрастанию UploadJobId

32.001

71.

UploadJobId

Идентификатор задания на загрузку

7b8360e9-69ae-34d4-

Добавлено в

файла в БФ

b5e2-b7e60f2a3fdf

версии 30

72.

FileHash

Представление хэш файла по одному

5C00CCC2734CDD3332D

из алгоритмов: ГОСТ 34.11 94 или

3D4749576E3C1A7DBAF0

ГОСТ 34.11 2012 в зависимости от

E7EA74E9FA602413C90A

значения системного параметра

129FA

Изменено в

big_file_sms_digest_hash_algorithm

версии

(Справочник CommonSetting)

32.001

Параметр заполняется, если

BF_TOKEN_SIGN_ENABLED = true

(Справочник DocTypeParam)

Пример дайджеста

ATTRIBUTES

OrgId=fb8360e9-69ae-40d4-b5e2-b7e60f2a3fd7

Sender=Ромашка

ExtId=17ae67be-9ca1-1945-e054-00144ff81192

FIELDS

AccDoc.AccDocNo=444

AccDoc.CodeVO=12010

AccDoc.DocDate=2012-02-01

AccDoc.DocSum=1230.55

AccDoc.PaytKind=0

AccDoc.Priority=5

AccDoc.PsNum=12345678/1481/1948/6/0

AccDoc.Purpose=Оплата по договору. В том числе НДС 18 % - 15.25

AccDoc.TransKind=01

AccDoc.UIP=1234-55-67890

AccDoc.UrgentSBRF=0

Credit.CredConNum=5000000

Credit.FlagTargetAssignment=1

Credit.FlagUseOwnMeans=1

DepartmentalInfo.CBC=12131415161718192012

DepartmentalInfo.DocDate=22.03.2012

DepartmentalInfo.DocNo=1122

DepartmentalInfo.DrawerStatus=01

DepartmentalInfo.OKATO=66666666666

DepartmentalInfo.PaytReason=ВУ

DepartmentalInfo.TaxPaytKind=01

DepartmentalInfo.TaxPeriod=01.02.2015

Payee.Bank.Name=ОАО "СБЕРБАНК РОССИИ"

Payee.Bank.BankCity=МОСКВА

Payee.Bank.SettlementType=Г.

Payee.Bank.Bic=44444444

Payee.Bank.CorrespAcc=01020304050607080910Payee.INN=0000000000

Payee.KPP=770000000

Payee.Name=ООО "БЕС"

Payee.PersonalAcc=77777777777777777777

Payer.Bank.Name=ОАО БАНК СТС

Payer.Bank.BankCity=МОСКВА

Payer.Bank.SettlementType=Г.

Payer.Bank.Bic=10203045

Payer.Bank.CorrespAcc=12345678901234567890Payer.INN=7777777777

Payer.KPP=1122334

Payer.Name=ООО "БЕС"

Payer.PersonalAcc=11111111111111111111

Пример дайджеста с использованием сущностей ГОЗ

ATTRIBUTES

OrgId=5e218ae3-1969-4411-a9cf-b10c9f730e5c

Sender=Оператор услуг

ExtId=68945284-dffc-4165-bb02-25428d147d18

FIELDS

AccDoc.AccDocNo=6

AccDoc.DocDate=2017-05-15

AccDoc.DocSum=888.00

AccDoc.PaytKind=0

AccDoc.Priority=5

AccDoc.Purpose=НДС не облагается

AccDoc.TransKind=01

Credit.FlagTargetAssignment=0

Credit.FlagUseOwnMeans=0

Payee.Bank.Name=ПАО СБЕРБАНК

Payee.Bank.Bic=044525225

Payee.Bank.CorrespAcc=30101810400000000225

Payee.INN=7707698992

Payee.KPP=770901001

Payee.Name=ООО "Куул коннекшнс"

Payee.PersonalAcc=40706810438000017985

Payer.Bank.Name=ПАО СБЕРБАНК

Payer.Bank.BankCity=МОСКВА

Payer.Bank.SettlementType=Г

Payer.Bank.Bic=044525225

Payer.Bank.CorrespAcc=30101810400000000225

Payer.INN=232009849069

Payer.Name=Индивидуальный предприниматель Григорьева Ирина Васильевна

Payer.PersonalAcc=40825810738003000088

2.1.2.Формат взаимодействия

Взаимодействие: Документ передается из УС в СББОЛ

Инициатор получения справочника: УС

Формат передачи документа на сторону СББОЛ: Request/PayDocRu

Формат предоставления ответа (квитанции) об исполнении документа со стороны

СББОЛ: Response/Tickets

Особенности:

При передаче документа на сторону СББОЛ передается информация об ошибках

безопасности в случае недопустимости использования средств удаленного управления

компьютером при работе с ТК.

2.1.2.1. Формат отправки документа в СББОЛ

Request/PayDocRu

Версионно

Элемент

Описание элемента

Тип

Описание типа

Мн.

сть

Request

Запрос УС к СББОЛ

Request

Актуально

[1]

с версии

@requestId

Уникальный идентификатор запроса

UuidSeparat

UUID с

разделителями в

Актуально

виде дефисов.

[1]

с версии

Набор из 32

символов [0-9], [a-

f] и дефисов

@orgId

Идентификатор организации в ДБО (может быть использован

UuidSeparat

UUID с

сторонней системой для дополнительной идентификации)

разделителями в

Актуально

виде дефисов.

[1]

с версии

Набор из 32

символов [0-9], [a-

f] и дефисов

@version

Номер версии формата обмена

xs:string

Простой тип XML

Актуально

RegEx: "[0-

Schema

[1]

с версии

9\.]{1,20}"

@sender

Система-отправитель

xs:string

Простой тип XML

RegEx: «[-a-

Schema

Актуально

zA-Zа-яА-

[1]

с версии

Я0-9:

_]{1,20}»

@receiver

Система-получатель - Если система получатель СББОЛ, то

xs:string

Простой тип XML

SBBOL_DBO

RegEx: «[-a-

Schema

Актуально

[0..1

zA-Zа-яА-

с версии

]

Я0-9:

_]{1,20}»

@protocolVersion

Версия протокола

xs:string

Простой тип XML

[0..1

Актуально

Schema

]

с версии

PayDocRu

Платёжное поручение рублёвое

PayDocRu

Актуально

[1]

с версии

*.1

@docExtId

Уникальный* идентификатор документа в учетной системе

UuidSeparat

UUID с

(УС) Клиента.

разделителями в

Актуально

виде дефисов.

*Уникальность контролируется на стороне банка

[1]

с версии

Набор из 32

символов [0-9], [a-

f] и дефисов

0 - обычная передача на выполнение

*.2

@sentForSign

BoolType

Актуально

[0..1

1 - передано для подписания в ИК

с версии

]

*.3

@cancType

Тип списания.

xs:int

Простой тип XML

Актуально

Schema

[0..1

Заполняется значением UpgRplDictionary/DirTypeEntry/@code

с версии

]

Необходимо передавать для документов типа ГОЗ БФ

*.4

AccDoc

Реквизиты платёжного документа

AccDoc

Актуально

[1]

с версии

*.1

@uip

УИП

uipType

Уникальный

Идентификатор

1) Если счет плательщика ГОЗ, выполняется обычный платеж

xs:string

Платежа (УИП) (25

котрагенту - в поле указывается номер гоз контракта;

[max: 25]

символов)

2) Если счет плательщика ГОЗ, выполняется налоговый

платеж - в поле указывается УИП или 0;

3) Если счет плательщика не ГОЗ - в поле указывается УИП

или 0;

Актуально

[0..1

с версии

4) Если счет получателя соответствует маске 40822* - в поле

]

указывается УИП.

5) Если счет получателя соответствует маске "03212", "03222",

"03232", "03242", "03252", "03262" либо "03272", то в поле

указывается 4-хзначный код НПА или УИП. 4-хзначный код

НПА допускается только при оплате на счета "03212".

УИП: 15 [A-Z или А-Я или 0-9 или A-Z, А-Я, 0-9], 20 [A-Z, А-

Я, 0-9], 25 [0-9], 4 [0-9] или «0»

*.2

@accDocNo

Номер расчетного документа

xs:string

Простой тип XML

Актуально

[min: 1,

Schema

[1]

с версии

max: 8]

*.3

@docDate

Дата создания документа

xs:date

Простой тип XML

Актуально

Schema

[1]

с версии

*.4

@docSum

Сумма платежа

xs:decimal

Простой тип XML

Актуально

Schema

[1]

с версии

*.5

@transKind

Вид операции

xs:string [2]

Простой тип XML

Актуально

01 Списано, зачислено по платежному поручению, по

Schema

[1]

с версии

поручению банка

02 Оплачено, зачислено по платежному требованию

03 Оплачен наличными денежный чек, выдано по расходному

кассовому ордеру

04 Поступило наличными по объявлению на взнос наличными,

приходному кассовому ордеру, препроводительной ведомости

к сумке 0402300

06 Оплачено, зачислено по инкассовому поручению

07 Оплачено, поступило по расчетному чеку

08 Открытие аккредитива, зачисление сумм

неиспользованного, аннулированного аккредитива

09 Списано, зачислено по мемориальному ордеру, а также по

первичным учетным документам с реквизитами счетов по

дебету и кредиту

12 Зачислено на основании авизо

16 Списано, зачислено по платежному ордеру

17 Списано, зачислено по банковскому ордеру

18 Списано, зачислено по ордеру по передаче ценностей

*.6

@paytKind

Вид платежа Возможные значения: «почтой», «электронно»,

xs:string

Простой тип XML

«телеграфом», «срочно». Если не указано, заполняется: «0»

[min: 1,

Schema

Актуально

max: 15]

[1]

с версии

*.7

@priority

Очерёдность платежа: число от 1 до 5

xs:int

Простой тип XML

[min:1;

Schema

В соответствии с Положением банка России от 19.06.2012 №

max:5]

383-П

Актуально

1. Списание по исполнительным документам,

[1]

с версии

предусматривающим перечисление или выдачу денежных

средств со счета для удовлетворения требований о

возмещении вреда, причиненного жизни и здоровью, а также

требований о взыскании алиментов;

2. Списание по исполнительным документам,

предусматривающим перечисление или выдачу денежных

средств для расчетов по выплате выходных пособий и оплате

труда с лицами, работающими или работавшими по трудовому

договору (контракту), по выплате вознаграждений авторам

результатов интеллектуальной деятельности;

3. Списание по платежным документам, предусматривающим

перечисление или выдачу денежных средств для расчетов по

оплате труда с лицами, работающими по трудовому договору

(контракту), поручениям налоговых органов на списание и

перечисление задолженности по уплате налогов и сборов в

бюджеты бюджетной системы Российской Федерации, а также

поручениям органов контроля за уплатой страховых взносов

на списание и перечисление сумм страховых взносов в

бюджеты государственных внебюджетных фондов;

4. Списание по исполнительным документам,

предусматривающим удовлетворение других денежных

требований;

5. Списание по исполнительным документам,

предусматривающим удовлетворение других.

ю.денежныхю.требований

*.8

@codeVO

Код вида валютной операции

OperCodeTy

Код вида валютной

Актуально

[0..1

операции, 5 цифр

с версии

]

*.9

@psNum

Номер паспорта сделки

DealPassNu

Полный номер

Актуально

[0..1

mFullType

паспорта сделки

с версии

]

одной строкой

*.10

@urgentSBRF

Дополнительная услуга СБРФ. Срочность: 0 - срочный, 1 -

xs:string

Простой тип XML

срочный с УВ, 2 - неотложный

[min: 1,

Schema

Изменено

[0..1

max: 1]

в версии

Признак возможности неотложенного платежа возвращается в

]

RegEx:

Response/OrganizationsInfo/OrganizationInfo/OrgData/Accounts/

"[012]"

Account/OtherAccountData/IsNotDelay

*.11

@vat

Указывается способ расчета НДС согласно справочнику

xs:string

Простой тип XML

Актуально

расчета НДС в СББОЛ: 1 - расчет по % (1) 2 - расчет по % (2) 3

Schema

[0..1

с версии

- Расчет по % (+) 4 - НДС не облаг. 5 - Ввод НДС 6 - Ручной

]

ввод

*.12

@vatSum

Сумма НДС

xs:decimal

Простой тип XML

Актуально

[0..1

Schema

с версии

]

*.13

@vatRate

% НДС

xs:decimal

Простой тип XML

Актуально

[0..1

Schema

с версии

]

*.14

@initialCard

Идентификатор договора депозита

UuidSeparat

UUID с

разделителями в

Актуально

виде дефисов.

[0..1

с версии

Набор из 32

]

символов [0-9], [a-

f] и дефисов

*.15

@codeOfRevenueType

Код вида дохода

xs:string

Простой тип XML

Добавлен

[0..1

Schema

о в версии

]

*.16

purposePurpose

Назначение платежа

xs:string

Простой тип XML

[max: 210]

Schema

Допустимые

Изменено

символы на

[1]

в версии

момент написания

документации:

ABCDEFGHIJKL

MNOPQRSTUVW

XYZabcdefghijklmn

opqrstuvwxyz12345

67890

АБВГДЕЁЖЗИЙК

ЛМНОПРСТУФХ

ЦЧШЩЪЫЬЭЮЯ

абвгдеёжзийклмно

прстуфхцчшщъыьэ

юя!"№#$%&'()*+,-

./:;<=>?@[\]^_`{|}~

*.5

Payer

Реквизиты плательщика

Client

Актуально

[1]

с версии

*.1

@personalAcc

Номер счёта

AccNumTyp

Номер счёта или

Актуально

корр. счёта, 20

[1]

с версии

цифр

*.2

@inn

ИНН (от 5 до 12 или 0)

InnType

ИНН

юридического или

Актуально

[0..1

физического лица

с версии

]

РФ, от 5 до 12

цифр

*.3

@kpp

КПП (до 9)

KppType

КПП, 9 цифр

Актуально

Поле «КПП плательщика (102)» должно состоять из 9 цифр (0-

[0..1

с версии

9) или <0>, если поле «Счет плательщика» соответствует

]

маске = <40802***************> или поле «ИНН

плательщика» = <0>

*.4

Name

Наименование клиента

xs:string

Простой тип XML

Актуально

[max: 160]

Schema

[1]

с версии

*.5

Bank

Реквизиты банка клиента

Bank

Актуально

[1]

с версии

*.1

@bic

БИК из банковского справочника БИКов (dict= «BIC»)

BicType

БИК, 9 цифр

Актуально

[1]

с версии

*.2

@correspAcc

Номер корр. счёта банка из справочника БИК банка (dict=

AccNumTyp

Номер счёта или

Актуально

[0..1

«BIC»),

корр. счёта, 20

с версии

]

цифр

*.3

Name

Наименование банка из справочника БИК банка (dict= «BIC»),

xs:string

Простой тип XML

Изменено

соответственно указанному БИК

[min: 1,

Schema

[1]

в версии

max: 80160]

ЗАГЛАВНЫМИ БУКВАМИ

*.4

BankCity

Название населённого пункта банка из справочника БИК

xs:string

Простой тип XML

Изменено

[0..1

банка (dict= «BIC»), соответственно указанному БИК

[min: 1,

Schema

в версии

]

max: 30]

ЗАГЛАВНЫМИ БУКВАМИ

*.5

SettlementType

Тип населённого пункта банка из справочника БИК банка

xs:string

Простой тип XML

Изменено

[0..1

(dict= «BIC»), соответственно указанному БИК

[min: 1,

Schema

в версии

]

max: 20]

ЗАГЛАВНЫМИ БУКВАМИ

*.6

Filial

НЕ ИСПОЛЬЗУЕТСЯ

xs:string

Простой тип XML

Изменено

[0..1

[min: 1,

Schema

в версии

]

max: 15]

*.6

Payee

Реквизиты получателя

Contragent

Актуально

Если у организации установлен признак «Использовать

с версии

[1]

подтвержденный справочник контрагентов», то в качестве

получателя должен быть указан подтвержденный контрагент

из справочника контрагентов.

*.1

@personalAcc

Номер счёта

AccNumTyp

Простой тип XML

e [20]

Schema

Если счет получателя соответствует маске счетов:

4010[1]***************;

40302***************;

4050[1]********2****** («2» в 14-ом разряде счета);

Актуально

4060[1]********[1]****** («1» в 14-ом разряде счета);

[0..1

с версии

4060[1]********3****** («3» в 14-ом разряде счета);

]

4070[1]********[1]****** («1» в 14-ом разряде счета);

4070[1]********3****** («3» в 14-ом разряде счета);

40503********4****** («4» в 14-ом разряде счета);

40603********4****** («4» в 14-ом разряде счета);

40703********4****** («4» в 14-ом разряде счета),

то необходимо проверять, что поля 101-109 заполнены

*.2

@kpp

КПП (до 9)

KppType

КПП, 9 цифр

Актуально

[0..1

с версии

]

*.3

@inn

ИНН (до 12)

InnType

ИНН

Актуально

юридического или

[0..1

с версии

физического лица

]

РФ, до 12 цифр

*.4

Name

Наименование контрагента

xs:string

Простой тип XML

Актуально

[max: 160]

Schema

[1]

с версии

*.5

Bank

Реквизиты банка контрагента

Bank

Актуально

[1]

с версии

*.1

@bic

БИК из справочника БИК банка (dict= «BIC»),

BicType

БИК, 9 цифр

Актуально

[1]

с версии

*.2

@correspAcc

Номер корр. счёта банка из справочника БИК банка (dict=

AccNumTyp

Номер счёта или

Актуально

[0..1

«BIC»). При вводе БИК УФК заполнение параметра

корр. счёта, 20

с версии

]

обязательно

цифр

*.3

Name

Наименование банка из справочника БИК банка (dict= «BIC»),

xs:string

Простой тип XML

Изменено

соответственно указанному БИК

[min: 1,

Schema

[1]

в версии

max: 80160]

32.001

ЗАГЛАВНЫМИ БУКВАМИ

*.4

BankCity

Название населённого пункта банка из справочника БИК

xs:string

Простой тип XML

Изменено

[0..1

банка (dict= «BIC»), соответственно указанному БИК

[min: 1,

Schema

в версии

]

max: 30]

32.001

ЗАГЛАВНЫМИ БУКВАМИ

*.5

SettlementType

Тип населённого пункта банка из справочника БИК банка

xs:string

Простой тип XML

Изменено

[0..1

(dict= «BIC»), соответственно указанному БИК

[min: 1,

Schema

в версии

]

max: 20]

32.001

ЗАГЛАВНЫМИ БУКВАМИ

*.6

Filial

НЕ ИСПОЛЬЗУЕТСЯ

xs:string

Простой тип XML

Изменено

[0..1

[min: 1,

Schema

в версии

]

max: 15]

*.7

DepartmentalInfo

Налоговая информация: поля 101, 104 - 110 платёжного

Departmenta

[0..1

Актуально

поручения

lInfo

]

с версии

Актуально

*.1

@drawerStatus

Показатель статуса налогоплательщика (101)

xs:string

Простой тип XML

[0..1

с версии

[min: 1,

Schema

]

max: 2]

*.2

@okato

Код ОКАТО (105)

OkatoType

ОКАТО, от 1 до 11

Актуально

[0..1

цифр (иногда

с версии

Поле «ОКАТО (105)» должно содержать 8 или 11 цифр (0-9),

]

заполняется

если «Счет получателя платежа» соответствует маске =

нулём)

<40101***************>

*.3

@paytReason

Показатель основания платежа (106)

xs:string

Простой тип XML

Актуально

[0..1

[min: 1,

Schema

с версии

]

max: 2]

Налоговый период (107)

*.4

@taxPeriod

xs:string

Простой тип XML

В поле может быть ровно 8 символов: цифры и #

[min: 1,

Schema

max: 10]

ИЛИ

0|[0-

**/**/**** или **.**.****, где * обозначены символы, первые

9#]{8}|(МС|

2 символа, которые могут принимать значения "МС","КВ",

Изменено

[0..1

КВ|ПЛ|ГД|[

"ПЛ", "ГД" или цифры от 0 до 9, остальные символы - цифры

в версии

]

от 0 до 9

9]{2})(\.[0-

ИЛИ

9]{2}\.[0-

9]{4}|/[0-

Значение «0»

9]{2}/[0-

9]{4})

*.5

@docNo

Номер налогового документа (108)

xs:string

Простой тип XML

Изменено

[min: 1,

Schema

[0..1

Проверять, что поле содержит символы в формате

в версии

max: 15]

]

ЦЦ;СССССССССССС, где “ЦЦ” - число 01-26, 28-30 “;” -

32.001

разделительный символ точка с запятой "СССССССССССС" -

цифро-буквенный код [A-Z (за исключением символа “N”), А-

Я, 0-9]), если

поле показатель статуса @drawerStatus содержит значение

[03,19,20]

или

показатель статуса @drawerStatus содержит значение 24 и

основание платежа @paytReason не соответствует значению

из параметров:



7 цифр (Номер декларации): ДЕ,ДК,ПД



7 цифр (Номер ордера): ПО,ПК



7 цифр (Порядковый номер) : КТ,КК



7 цифр (Номер квитанции) : КВ



0:00

Поле содержит значение 0, если показатель статуса

@drawerStatus содержит значение [03, 16, 19, 20 ] и ИНН

плательщика состоит из 12 цифр и поле @uip содержит

значение 0.

Дата налогового документа (109) DD.MM.YYYY или 0.

*.6

@docDate

xs:string

Простой тип XML

Изменено

00 - иные случаи при формировании РПП в пользу

[0..1

[min: 1,

Schema

в версии

таможенных органов.

]

max: 10]

*.7

@taxPaytKind

Тип налогового платежа (110)

xs:string

Простой тип XML

Актуально

[0..1

[min: 1,

Schema

с версии

]

max: 2]

*.8

@cbc

Код бюджетной классификации (104)

CbcType

КБК, Код

бюджетной

Поле «КБК (104)» должно содержать 20 цифр (0-9), если

Актуально

классификации, 20

[0..1

«Счет получателя платежа» соответствует маске =

с версии

цифр

]

<40101***************>

Поле «КБК (104)» не равно полю «УИП», кроме случая, когда

КБК=0 и УИП=0 или оба пусты.

Если поле «Счет плательщика» соответствует маске =

<40116***************> или организация - УФК или «Счет

получателя» соответствует маске = <40105***************>,

то до 20 символов [A-Z, a-z, А-Я, а-я, 0-9]

*.8

Information

Информация получателю

xs:string

Простой тип XML

Актуально

[0..1

[min: 1,

Schema

с версии

]

max: 210]

*.9

Credit

Доп. реквизиты. Указываются для платёжных документов,

Credit

Актуально

[0..1

проводимых за счёт предоставляемого банком кредита

с версии

]

Актуально

*.1

@flagTargetAssignment

Признак «Целевое поручение»: 0 - не установлен, 1 -

BoolType

Двоичное

[1]

с версии

установлен

значение: 0 или 1

*.2

@flagUseOwnMeans

Признак «Использовать собственные средства»: 0 - не

BoolType

Двоичное

Актуально

установлен, 1 - установлен

значение: 0 или 1

[1]

с версии

*.3

CredConNum

Номер кредитного договора (в базе varchar(255), но ввод

xs:string

Простой тип XML

Актуально

[0..1

ограничили пока до 30)

[min: 1,

Schema

с версии

]

max: 255]

*.1

LinkedDocs

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

LinkedDocs

Связанные

Актуально

[0..1

карт, зарплатные ведомости и т.п.

документы

с версии

]

Актуально

*.1

LDoc

Документ, связанный с поручением

[0..n

с версии

]

*.1

@type

Тип связанного документа

xs:string

Простой тип XML

Актуально

[0..1

[min: 1,

Schema

с версии

Значение можно найти в Части 1, п. «Типы связанных

]

max: 50]

документов»

*.2

@docExtId

Уникальный* идентификатор документа в учетной системе

UuidSeparat

UUID с

(УС) Клиента.

разделителями в

Изменено

виде дефисов.

[0..1

*Уникальность контролируется на стороне банка

в версии

Набор из 32

]

ОБЯЗАТЕЛЕН ДЛЯ ЗАПОЛНЕНИЯ, ЕСЛИ НЕ ЗАПОЛНЕН

символов [0-9], [a-

@docId

f] и дефисов

*.3

@docId

Глобальный идентификатор документа

UuidSeparat

UUID с

разделителями в

ОБЯЗАТЕЛЕН ДЛЯ ЗАПОЛНЕНИЯ, ЕСЛИ НЕ ЗАПОЛНЕН

Изменено

виде дефисов.

[0..1

@docExtId

в версии

Набор из 32

]

символов [0-9], [a-

f] и дефисов

*.4

Params

Дополнительные параметры связанного с поручением

Params

Множество

Актуально

документа

параметров

[0..1

с версии

произвольного

]

вида

*.1

Param

Параметр

Отдельный

Актуально

параметр

[1..n

с версии

произвольного

]

вида

*.1

@name

Название параметра

Актуально

[1]

с версии

*.2

@value

Значение параметра

xs:string

Простой тип XML

[1]

Актуально

[min: 1,

Schema

с версии

max: 255]

*.1

Attachments

Приложенные к документу отсканированные образы-

Attachments

Актуально

[0..1

вложения

Type

с версии

]

Актуально

*.1

Attachment

Отдельное вложение

[1..n

с версии

]

*.1

Type

Тип файла вложения

xs:string

Простой тип XML

Актуально

[0..1

Schema

с версии

]

*.2

AttachmentName

Имя файла вложения

xs:string

Простой тип XML

[0..1

Изменено

[min: 1,

Schema

]

в версии

max: 255]

[1]

*.3

Description

Пользовательское описание файла вложения

xs:string

Простой тип XML

Актуально

[0..1

[min: 1,

Schema

с версии

]

max: 1024]

*.4

Date

Дата добавления вложения

xs:date

Простой тип XML

Актуально

[0..1

Schema

с версии

]

*.5

Size

Размер вложения

xs:int

Простой тип XML

Актуально

[0..1

Schema

с версии

]

*.6

Body

В бинарном представлении в сжатом и несжатом виде

xs:base64Bin

Простой тип XML

Актуально

ary

Schema

[1]

с версии

*.7

AttachmentSign

Подпись вложения

AttachmentS

Актуально

[0..1

ign

с версии

]

*.1

Sign

ЭП клиента

DigitalSign

Актуально

[1..n

с версии

]

*.1

Issuer

Идентификатор поставщика сертификата Например, "

xs:string

Простой тип XML

Актуально

issuer="E=IdleCA, C=RU, S=Idle CA, L=Idle CA, O=Idle CA,

[min: 1,

Schema

[1]

с версии

OU=Idle CA, CN=Idle CA" "

max: 1024]

*.2

Серийный номер сертификата

xs:string

Простой тип XML

Актуально

[min: 1,

Schema

[1]

с версии

max: 255]

*.3

Value

Значение ЭП

xs:base64Bin

Простой тип XML

Актуально

ary

Schema

[1]

с версии

*.4

DigestName

Имя схемы подписи

xs:string

Простой тип XML

Актуально

[0..1

Schema

с версии

]

*.5

DigestVersio

Версия схемы подписи

xs:string

Простой тип XML

Актуально

[0..1

Schema

с версии

]

Уникальные свойства компьютера, осуществляющего

*.6

PcPropHash

xs:string

Простой тип XML

установку сеанса связи, SHA 512 от значения PcProp.

Schema

Содержит следующие параметры:

Актуально

[0..1

с версии

]

∙ UUID

∙ Идентификатор процессора

∙ Серийный номер BIOS

∙ Серийный номер жесткого диска.

Передаваться должны в виде строки с разделителем «;».

Формат передачи: «UUID;Идентификатор

процессора;Серийный номер BIOS;Серийный номер жесткого

диска».

*.7

Fraud

Данные для fraud-мониторинга. Информация о подписи

Fraud

Простой тип XML

Актуально

[0..1

Schema

с версии

]

*.1

Логин

xs:string

Простой тип XML

Актуально

Schema

[1]*

с версии

Данные токена

*.2

TokenInfo

xs:string

Простой тип XML

Отображение в запросе (разделитель «;»):

Schema

BCRYPT;;;;;

Отображение в интерфейсе:

Тип токена: TOKEN

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

TOKEN - обычный токен,

TOKEN_BU - токен с кнопкой,

Актуально

TOKEN_SC - токен с экраном

[1]*

с версии

BCRYPT - ПАК ФПСУ-IP или токен ФПСУ-IP (в этом случае

остальную информацию о конфигурации не заполнять),

SMS — при подтверждении операций кодом СМС (в этом

случае остальную информацию о конфигурации не заполнять)

Информация о конфигурации токена:

IС1_A10D0010L_C1_VT01KA02

Дата конфигурации: 2012-04-13 09:44:59.003

Серийный номер токена: 00041485B

Номер сборки токена: 100

*.3

HttpAcce

Список поддерживаемых естественных языков Требуется

xs:string

Простой тип XML

ptLangua

указать локализацию ОС компьютера, на котором установлен

Schema

Актуально

БК,

Например, для английской локализации в

[1]*

с версии

качестве значения атрибута указывается - 'en-US', для русской

локализации указывается - 'ru-RU'.

*.4

IpMACA

IP и Mac адреса компьютера отправившего или подписавшего.

xs:string

Простой тип XML

Актуально

ddresses

Формат: «remoteIP;remoteMac;ip1;mac1;ip2;mac2»

Schema

[1]*

с версии

*.5

Geolocatio

Геопозиционирование компьютера отправившего или

xs:string

Простой тип XML

Актуально

nInfo

подписавшего. Формат:

Schema

[1]*

с версии

«Longitude;Latitude;HorizontalAccuracy;Timestamp;Status»

*.6

PcProp

Уникальные свойтсва компьютера отправившего или

xs:string

Простой тип XML

подписавшего. Формат: «UUID;Идентификатор

Schema

Актуально

процессора;Серийный номер BIOS;Серийный номер жесткого

[1]*

с версии

диска».

*.7

DevicePri

Правила формирования значения данного поля описаны в 1

Простой тип XML

Актуально

[0..1

части п. «Правила формирования значения параметра

Schema

с версии

]

DevicePrint»

*.8

Order

Очередность наложения подписи (какая подпись когда была

xs:int

Простой тип XML

Актуально

[0..1

наложена) в случае наложения подписи и удаления ее, порядок

Schema

с версии

]

должен сдвигаться соответственно влево

*.9

SignDate

Дата/Время подписи Пример: 2012-04-13 09:44:59.003

xs:dateTime

Простой тип XML

Актуально

[0..1

Schema

с версии

]

BigFileAttachments

Данные о больших файлах, связанных с сущностью

BigFileAttac

*.1

Добавлен

[0..1

hments

о в версии

]

BigFileAttachment

Данные о большом файле, связанном с сущностью

BigFileAttac

Файл в БФ

*.1

Добавлен

[1..n

hment

о в версии

]

UploadJobId

Идентификатор задания на загрузку файла в БФ

UuidSeparat

UUID с

разделителями в

виде дефисов.

Добавлен

Набор из 32

[1]

о в версии

символов [0-9], [a-

f] или [A-F] и

дефисов

Description

Пользовательское описание файла вложения

xs:string

Простой тип XML

Добавлен

[0..1

[min: 1,

Schema

о в версии

]

max: 1024]

*.1

Services

Продукты и услуги плательщика (доп. продукты РЦК,

Services

Актуально

[0..1

например, консолидация, финансирование и т.п.)

с версии

]

*.1

Params

Произвольные дополнительные параметры, описывающие

Params

Множество

Актуально

продукты и услуги

параметров

[1]

с версии

произвольного

вида

Param

Отдельный параметр произвольного вида

Param

Актуально

[1..n

с версии

]

@name

Название параметра

xs:string

Актуально

[1]

[min: 1,

с версии

max: 255]

@value

Значение параметра

xs:string

Простой тип XML

Актуально

[min: 1,

Schema

[1]

с версии

max: 255]

*.1

CurrDealCertificateInfo

Справка о валютных операциях

Изменено

[0..1

в версии

Сведения о валютной операции

]

*.1

@number

Номер документа (клиентский)

xs:string

Изменено

[max: 6]

[1]

в версии

xs:string

[max: 10]

*.2

@date

Дата документа

xs:date

Актуально

[1]

с версии

*.1

Rzk

Многострочная аналитика и параметры обработки платежного

Rzk

документа в РЦК (СБК)

В случае, если счет плательщика имеет признак «Счет

контроля и акцепта», то отправка данных по аналитике в

данном блоке полей обязательна

Актуально

[0..1

Если счет плательщика имеет признак «Счет контроля и

с версии

]

акцепта» и данные по аналитике не были отправлены, то

документ будет отклонен с ошибкой «Электронный

документ не прошел логические контроли Системы ДБО

при приеме на стороне Банка или Запрос на выписку

превышает 15 дней (Не заполнен Центр ответственности

Центр ответственности не найден в справочнике)»

*.1

RzkParams

Параметры обработки документа в РЦК (СБК)

RzkParams

Актуально

[0..1

с версии

]

*.1

BudgetId

Идентификатор структуры (поле РЦК)

xs:long

Актуально

[1]

с версии

*.2

BudgetСaption

Структура (поле РЦК)

xs:string

Актуально

[1]

с версии

*.3

EstimateId

Идентификатор Центра ответственности (поле РЦК)

xs:long

Актуально

[1]

с версии

*.4

EstimateCaption

Центр ответственности (поле РЦК)

xs:string

Актуально

[1]

с версии

*.5

Product

PRODUCT (поле РЦК). Если документ передается в рамках

xs:string

Актуально

[0..1

прямого управления счетом, то указывается значение

с версии

]

"DirectControl"

*.6

RzkStatus

Доп. статус СБК (поле РЦК)

xs:string

Актуально

[0..1

с версии

]

*.7

RzkAction

Последнее действие с документом в СБК (поле РЦК)

xs:string

Актуально

[0..1

с версии

]

*.8

DistributedSign

Признак «Документ по распределенной схеме»: 0 - не включен

BoolType

Актуально

[0..1

1 -включен. По умолчанию установлен признак 0 - не

с версии

]

включен.

*.2

RzkDocAnalytics

Многострочная аналитика платежного документа в

RzkDocAnal

Актуально

[0..1

соответствии со справочниками РЦК (СБК)

ytics

с версии

]

*.1

RzkDocAnalytic

RzkDocAnal

Актуально

[1..n

ytic

с версии

]

*.1

Amount

Сумма

xs:decimal

Актуально

[1]

с версии

*.2

BudgetId

Идентификатор структуры

xs:long

Актуально

[0..1

с версии

]

*.3

Classifier1Id

Идентификатор сметы доходов и расходов ЦО

xs:long

Актуально

[0..1

с версии

]

*.4

Class1Code

Код сметы доходов и расходов ЦО

xs:string

Актуально

[0..1

[min: 1,

с версии

]

max: 20]

*.5

Class1Descriptio

Наименование сметы доходов и расходов ЦО

xs:string

Актуально

[0..1

[min: 1,

с версии

]

max: 255]

*.6

FinanceTypeDesc

Название вида финансирования

xs:string

Актуально

[0..1

ription

[min: 1,

с версии

]

max: 255]

*.7

FinanceTypeId

Идентификатор вида финансирования в РЦК (СБК)

xs:long

Актуально

[0..1

с версии

]

*.8

KesrCode

Классификатор сметы

xs:long

Актуально

[0..1

с версии

]

*.9

KesrDescription

Наименование сметы статей доходов и расходов

xs:string

Актуально

[0..1

[min: 1,

с версии

]

max: 255]

*.1

OrgGroupCaptio

Наименование группы организаций

xs:string

Актуально

[0..1

[min: 1,

с версии

]

max: 100]

*.1

OrgGroupId

Идентификатор группы организаций

xs:long

Актуально

[0..1

с версии

]

*.1

PactDate

Дата договора

xs:date

Актуально

[0..1

с версии

]

*.1

PactId

Идентификатор договора в РЦК (СБК)

xs:long

Актуально

[0..1

с версии

]

*.1

PactNum

Номер договора

xs:string

Актуально

[0..1

[min: 1,

с версии

]

max: 60]

*.1

PactSubject

Наименование договора

xs:string

Актуально

[0..1

[min: 1,

с версии

]

max: 255]

*.1

PayCodeCode

Код вида расчетов

xs:string

Актуально

[0..1

[min: 1,

с версии

]

max: 2]

*.1

PayCodeDescript

Название вида расчёта

xs:string

Актуально

[0..1

ion

[min: 1,

с версии

]

max: 255]

*.1

PayCodeId

Идентификатор вида расчёта в РЦК (СБК)

xs:long

Актуально

[0..1

с версии

]

*.1

ProjectStdCode

Код проекта

xs:string

Актуально

[0..1

[min: 1,

с версии

]

max: 20]

*.2

ProjectStdDescri

Наименование проекта

xs:string

Актуально

[0..1

ption

[min: 1,

с версии

]

max: 255]

*.2

ProjectStdId

Идентификатор проекта в РЦК (СБК)

xs:long

Актуально

[0..1

с версии

]

*.2

ReasonDate

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

xs:date

Актуально

[0..1

с версии

]

*.2

ReasonNum

Номер документа основания платежа

xs:string

Актуально

[0..1

[min: 1,

с версии

]

max: 255]

*.2

ReasonType

Вид документа основания платежа

xs:string

Актуально

[0..1

[min: 1,

с версии

]

max: 255]

*.1

SuppDocs

Перечень сущностей ГОЗ

SuppDocs

Актуально

[0..1

с версии

]

*.1

SuppDoc

Актуально

[1..n

с версии

]

*.1

@essenceId

Внешний идентификатор сущности в УС

UuidSeparat

Внешний идентификатор сущности

Значение для поля приходит в ответе на запрос статуса

Актуально

отправки документа с типом «АКТ ГОЗ» ,«ИНОЙ» или

[1]

с версии

«Контракт ГОЗ». Тип зависит от значения

@essenceType

(поле docId)

*.2

@essenceType

Тип сущности: SUBST_DOC - Иной документ, ACT - акт,

BigFilesEsse

Актуально

CONTRACT - контракт

nceType

[1]

с версии

*Если нет технической возможности предоставить данные раздела фрод-мониторинга, то поле можно передавать cо значением «null»

Пример

<Request xmlns='http://bssys.com/upg/request' orgId='ea54da8f-8225-4f06-a53f-6f9a19531fe3'

requestId='992eef03-9e03-4393-97c0-840a8a72c855' version='01.007.00' sender='Ромашка'

receiver='SBBOL_DBO'>

<AccDoc accDocNo='11' docDate='2016-06-23' docSum='153' transKind='01'

paytKind='электронно' priority='5'>

</AccDoc>

<Name>Общество с ограниченной ответственностью "ЯМ Интернешнл

(СНГ)"</Name>

<Name>ПАО СБЕРБАНК</Name>

<BankCity>МОСКВА</BankCity>

</Bank>

</Payer>

<Name>тестовый получсатель</Name>

<Name>ПАО СБЕРБАНК</Name>

<BankCity>Г. МОСКВА</BankCity>

</Bank>

</Payee>

</PayDocRu>

<Sign>

<Issuer>CN=ЛавринСВ-Тестовая печать-УЦ-9</Issuer>

<Value>dnenujcvma20d0W4S98ucGOcXAmFUYeevq2SVUapKbY6JdjrsGE4gvN5u6myqSBiAXj

dSD3xK3ZDoF7ixWIRmg==</Value>

<PcPropHash>ECCB0C2EA8F72D3961A9BADFC5BF67A4C1E3154A59F2CC39A62F9EA6976

426481DE75A977F79BD00CDE82E059126EBAA2B496D2F5C4182EF91EB9798EF62B32E</PcPropH

ash>

<Fraud>

<Login>Тестовый Пользователь</Login>

<TokenInfo> BCRYPT;;;;;</TokenInfo>

<PcProp>8FBE0BC4-5F7C-11E1-AEBF-

DF3EA9FF2800;BFEBFBFF000206A7;PBAF441;

Z2AMA1FK</PcProp>

<DevicePrint>version%3D3.4.1.0_1%26pm_fpua%3DWin64%7C0%7Cx64%7Cru%7C01.005.00

%26pm_fpsc%3D32%7C1600%7C900%7C1600%26pm_fpsw%3Dabk%3D6%2C1%2C7601%2C17514

%7Cwnt%3D6%2C1%2C7601%2C18952%7Cdht%3D11%2C0%2C9600%2C18376%7Cie5%3D%7Cibe

%3D11%2C0%2C9600%2C18376%7Cieh%3D11%2C0%2C9600%2C18376%7Ciee%3D6%2C3%2C96

00%2C18376%7Cwmp%3D12%2C0%2C7601%2C19148%7Cobp%3D11%2C0%2C9600%2C18376%7

Coex%3D6%2C1%2C7601%2C17514%7Cvbs%3D5%2C6%2C0%2C8833%26pm_fptz%3D3%26pm_fpl

n%3Dlang%3Dru%7Csyslang%3Dru%7Cuserlang%3Dru%26pm_fpjv%3D0%26pm_fpco%3D0%26pm_f

pasw%3D%26pm_fpan%3DSBB%26pm_fpacn%3DSBB%26pm_fpol%3Dfalse%26pm_fposp%3D%26p

m_fpup%3D%26pm_fpsaw%3D1600%26pm_fpspd%3D32%26pm_fpsbd%3D%26pm_fpsdx%3D96%26

pm_fpsdy%3D96%26pm_fpslx%3D96%26pm_fpsly%3D96%26pm_fpsfse%3Dfalse%26pm_fpsui%3D%2

6pm_os%3DWindows%26pm_brmjv%3D01.005.00%26pm_br%3DSBB%26pm_inpt%3D%26pm_expt%

3D</DevicePrint>

</Fraud>

</Sign>

<Fraud>

<Login>Тестовый Пользователь</Login>

<TokenInfo> BCRYPT;;;;;</TokenInfo>

<PcProp>8FBE0BC4-5F7C-11E1-AEBF-

DF3EA9FF2800;BFEBFBFF000206A7;PBAF441;

Z2AMA1FK</PcProp>

</Fraud>

</Request>

Пример с использованием сущностей ГОЗ

<Request xmlns='http://bssys.com/upg/request'

orgId='5e218ae3-1969-4411-a9cf-b10c9f730e5c'

requestId='baa3acd4-cce3-4b81-b33b-56a89f9fce45'

version='01.011.00'

sender='Оператор услуг'

receiver='SBBOL_DBO'>

<PayDocRu

docExtId='68945284-dffc-4165-bb02-25428d147d18' cancType="99">

<AccDoc accDocNo='6' docDate='2017-05-15'

docSum='888' transKind='01' paytKind='0' priority='5'>

<Purpose>НДС не облагается</Purpose>

</AccDoc>

<Name>Индивидуальный предприниматель Григорьева Ирина

Васильевна</Name>

<Name>ПАО СБЕРБАНК</Name>

<BankCity>МОСКВА</BankCity>

</Bank>

</Payer>

<Name>ООО "Куул коннекшнс"</Name>

<Name>ПАО СБЕРБАНК</Name>

</Bank>

</Payee>

<SuppDoc essenceId="68945284-dffc-4165-bb02-25428d147d13"

essenceType="SUBST_DOC"/>

</SuppDocs>

</PayDocRu>

<Sign>

<Issuer>CN=ЛавринСВ-Тестовая печать-УЦ-9</Issuer>

<Value>Fi1cEN/tyGi2BqMHi+hDqdB9Dn6elZdy/H0YhFijruhNKLQSA7GL/7iXzhZukrTr02h1lg6c1

PymbtQorO9MsA==</Value>

<PcPropHash>EF1376EFD0D8503A6A0170F4ED2F4BDD48B48AF5058CBD8B39012E746F77

9CEC193D5C9BA9DACD42CC7B74F81F3F7965A8FF7B1CA4A9DD91D97905E632CF7F46</PcPropH

ash>

<Fraud>

<Login>Шулепов Роман</Login>

<TokenInfo>TOKEN_BU;IC0_A16P0000L_C1_VT407BU03;13:29:39

01.11.2016;TLS00456252B;11;2</TokenInfo>

<PcProp>97F8EB7C-53BC-11E6-AE58-

2096813D1B00;178BFBFF00630F01;PC0E2KEC;76FVWJKKS</PcProp>

<DevicePrint>version%3D3.4.1.0_1%26pm_fpua%3DWin32%7C0%7Cx64%7Cru%7C01.011.00

%26pm_fpsc%3D32%7C1600%7C900%7C1600%26pm_fpsw%3Dabk%3D6%2C1%2C7601%2C17514

%7Cwnt%3D6%2C1%2C7601%2C18952%7Cdht%3D11%2C0%2C9600%2C18537%7Cie5%3D11%2C

0%2C9600%2C0%7Cibe%3D11%2C0%2C9600%2C18537%7Cieh%3D11%2C0%2C9600%2C18537%

7Ciee%3D6%2C3%2C9600%2C18537%7Cwmp%3D12%2C0%2C7601%2C18840%7Cobp%3D11%2C

0%2C9600%2C18537%7Coex%3D6%2C1%2C7601%2C17514%7Cmvm%3D5%2C0%2C5000%2C0%

7Cvbs%3D5%2C6%2C0%2C8833%26pm_fptz%3D3%26pm_fpln%3Dlang%3Dru%7Csyslang%3Dru%7

Cuserlang%3Dru%26pm_fpjv%3D0%26pm_fpco%3D0%26pm_fpasw%3D%26pm_fpan%3DSBB%26pm

_fpacn%3DSBB%26pm_fpol%3Dfalse%26pm_fposp%3D%26pm_fpup%3D%26pm_fpsaw%3D1600%26

pm_fpspd%3D32%26pm_fpsbd%3D%26pm_fpsdx%3D96%26pm_fpsdy%3D96%26pm_fpslx%3D96%26

pm_fpsly%3D96%26pm_fpsfse%3Dfalse%26pm_fpsui%3D%26pm_os%3DWindows%26pm_brmjv%3D0

1.011.00%26pm_br%3DSBB%26pm_inpt%3D%26pm_expt%3D</DevicePrint>

</Fraud>

</Sign>

<Fraud>

<Login>Шулепов Роман</Login>

<TokenInfo>TOKEN_BU;IC0_A16P0000L_C1_VT407BU03;13:29:39

01.11.2016;TLS00456252B;11;2</TokenInfo>

<PcProp>97F8EB7C-53BC-11E6-AE58-

2096813D1B00;178BFBFF00630F01;PC0E2KEC;76FVWJKKS</PcProp>

</Fraud>

</Request>

2.1.2.2. Особенности получения статусов об обработке из СББОЛ

Информация об обработке документа доставляется в УС:

1. Без запроса со стороны УС:

a. В ответ на отправленный документ СББОЛ отправляет сообщение в формате

Response/Tickets, в котором передается:

 Tickets/Ticket@docId

- Идентификатор документа, с помощью которого

впоследствии можно запрашивать со стороны УС в формате

Request/DocIds/DocId - все последующие статусы обработки документа

 Tickets/Ticket/Info@statusStateCode="DELIVERED"

2. Путем запроса со стороны УС в формате Request/DocIds/DocId:

a. Имея данные идентификатора документа, которые были получены с первым

сообщением Response/Tickets->СББОЛ передает текущее состояние документа

 Tickets/Ticket/Info/BankDate/@statusDateTime

- дата и время присвоения

статуса.

Статусы обработки документа, передаваемые со стороны СББОЛ в УПШ в рамках

Response/Tickets:

Передава

емый из

Атрибут

Описание

№

СББОЛ

Описание операции

Версионно

Response/Tickets для

передаваемого из

п/

статус

на стороне СББОЛ

сть

передачи в УПШ

СББОЛ значения

документ

Проверки документа

Response/Tickets/Ticket

INVALID

INVALIDEDS

Актуально

привели к

/Info/@statusStateCode

EDS

с версии

неуспешному

(АСП/ЭП

результату

неверна)

Response/Tickets/Ticket

Может быть

(статус

/Info/MsgFromBank/@

передано

окончательный- не

Актуально

message

сообщение о том,

успешно)

с версии

что подлинность

документа не

подтверждена

Проверки документа

Response/Tickets/Ticket

VALIDE

VALIDEDS

Актуально

привели к

/Info/@statusStateCode

с версии

успешному

(АСП/ЭП

результату

верна)

SIGNED

Документ подписан

Response/Tickets/Ticket

(докумен

/Info/@statusStateCode

Актуально

с версии

подписан

)

ЭД был подписан

PARTLY

Response/Tickets/Ticket

PARTLY_SIGNED

неполным набором

_SIGNED

/Info/@statusStateCode

Актуально

подписей.

(Частичн

с версии

подписан

)

Логические

Response/Tickets/Ticket

REQUISI

REQUISITE_ERR

Актуально

проверки документа

/Info/@statusStateCode

TE_ERR

с версии

привели к

неуспешному

(Ошибка

Response/Tickets/Ticket

Должны

результату

реквизит

/Info/MsgFromBank/@

передаваться

(статус

ов)

Актуально

message

сообщения об

окончательный- не

с версии

ошибках,

успешно)

выявленных на

стороне Банка

Документ доставлен

Response/Tickets/Ticket

DELIVER

DELIVERED

на сторну Банка, но

/Info/@statusStateCode

Актуально

еще не проходил

с версии

(Доставл

проверку подписи и

ен)

реквизитов

Прием документа на

Response/Tickets/Ticket

ACCEPTED

Актуально

стороне Банка

/@statusStateCode

с версии

(Принят)

Response/Tickets/Ticket

Дата поступления

/Info/BankDate/@receip

в Банк

Актуально

tDate

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

с версии

принятия в

обработку

Отказ платежа

Response/Tickets/Ticket

DECLINED_BY_A

DECLINE

Актуально

(статус

/@statusStateCode

D_BY_A

с версии

окончательный- не

успешно)

(Отказан

Response/Tickets/Ticket

Сообщение из

Актуально

АБС)

/Info/MsgFromBank/@

Банка

с версии

message

Response/Tickets/Ticket

Реквизиты

Актуально

/Info/MsgFromBank/@a

ответственного

с версии

uthor

сотрудника Банка,

если требуется

Отказ платежа

Response/Tickets/Ticket

DECLINE

DECLINED_BY_B

Актуально

(статус

/@statusStateCode

D_BY_B

ANK

с версии

окончательный- не

ANK

успешно)

(Отвергн

Response/Tickets/Ticket

Сообщение из

Актуально

ут

/Info/MsgFromBank/@

Банка

с версии

Банком)

message

Response/Tickets/Ticket

Реквизиты

Актуально

/Info/MsgFromBank/@a

ответственного

с версии

uthor

сотрудника Банка,

если требуется

Документ выгружен

Response/Tickets/Ticket

10.

EXPORT

EXPORTED

Актуально

в АБС для

/Info/@statusStateCode

с версии

дальнейшей

(Выгруж

обработки

ен)

Response/Tickets/Ticket

Дата поступления

/Info/BankDate/@receip

в Банк

Актуально

tDate

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

с версии

принятия в

обработку

Response/Tickets/Ticket

Сообщение из

Актуально

/Info/MsgFromBank/@

Банка, если

с версии

message

требуется

Response/Tickets/Ticket

Реквизиты

Актуально

/Info/MsgFromBank/@a

ответственного

с версии

uthor

сотрудника Банка,

если требуется

Документ принят на

Response/Tickets/Ticket

11.

ACCEPTED_BY_A

Актуально

обработку в АБС

/@statusStateCode

ED_BY_

с версии

ABS

(Принят

Response/Tickets/Ticket

Сообщение из

Актуально

АБС)

/Info/MsgFromBank/@

Банка

с версии

message

12.

Электронный

Response/Tickets/Ticket

EXPORT

EXPORT_ERROR

документ не был

/Info/@statusStateCode

_ERROR

выгружен в АБС

Актуально

(Ошибка

Банка

с версии

выгрузк

(статус

и)

окончательный- не

успешно)

13.

Подтверждение

Response/Tickets/Ticket

IMPLEM

IMPLEMENTED

Актуально

исполнения платежа

/Info/@statusStateCode

ENTED

с версии

(статус

(Исполне

окончательный-

н)

Response/Tickets/Ticket

Дата поступления

успешно)

/Info/BankDate/@receip

в Банк

Актуально

tDate

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

с версии

принятия в

обработку

Response/Tickets/Ticket

Дата списания

Актуально

/Info/BankDate/@charg

средств со счета

с версии

eOffDate

плательщика

Response/Tickets/Ticket

Сообщение из

Актуально

/Info/MsgFromBank/@

Банка, если

с версии

message

требуется

Response/Tickets/Ticket

Реквизиты

Актуально

/Info/MsgFromBank/@a

ответственного

с версии

uthor

сотрудника Банка,

если требуется

Response/Tickets/Ticket

Дата и время

Актуально

/Info/BankDate/@proces

изменения

с версии

sDateTime

документа в АБС

14.

Недостаточно

Response/Tickets/Ticket

CARD2

Актуально

средств на счете

/Info/@statusStateCode

(Картоте

с версии

плательщика

ка 2)

(статус

Response/Tickets/Ticket

Дата поступления

окончательный- не

/Info/BankDate/@receip

в Банк

Актуально

успешно)

tDate

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

с версии

принятия в

обработку

Response/Tickets/Ticket

Сообщение из

Актуально

/Info/MsgFromBank/@

Банка, если

с версии

message

требуется

Response/Tickets/Ticket

Реквизиты

Актуально

/Info/MsgFromBank/@a

ответственного

с версии

uthor

сотрудника Банка,

если требуется

15.

Приостановка

Response/Tickets/Ticket

DELAYE

DELAYED

Актуально

обработки

/Info/@statusStateCode

с версии

документа

(Приоста

новлен)

Response/Tickets/Ticket

Сообщение из

Актуально

/Info/MsgFromBank/@

Банка, если

с версии

message

требуется

Response/Tickets/Ticket

Реквизиты

Актуально

/Info/MsgFromBank/@a

ответственного

с версии

uthor

сотрудника Банка,

если требуется

Документ отозван

Response/Tickets/Ticket

16.

RECALL

Актуально

(статус

/Info/@statusStateCode

(Отозван

с версии

окончательный- не

)

успешно)

Response/Tickets/Ticket

Сообщение из

Актуально

/Info/MsgFromBank/@

Банка, если

с версии

message

требуется

Response/Tickets/Ticket

Реквизиты

Актуально

/Info/MsgFromBank/@a

ответственного

с версии

uthor

сотрудника Банка,

если требуется

Response/Tickets/Ticket

17.

FRAUDR

Со стороны ФРОД-

FRAUDREVIEW

Актуально

/Info/@statusStateCode

EVIEW

анализа получен

с версии

(На

статус документа

проверке

«На проверке у

Response/Tickets/Ticket

Может быть

специалиста Банка»

/Info/MsgFromBank/@

передано

специали

message

Актуально

сообщение о том,

ста

с версии

что подлинность

Банка)

документа не

подтверждена

Response/Tickets/Ticket

18.

FRAUDS

Со стороны ФРОД-

FRAUDSMS

Актуально

/Info/@statusStateCode

анализа получен

с версии

(Требует

статус документа

ся

«Требуется

Response/Tickets/Ticket

Может быть

подтвер

подтверждение sms-

/Info/MsgFromBank/@

передано

ждение

паролем»

message

Актуально

сообщение о том,

sms-

с версии

что подлинность

паролем)

документа не

подтверждена

Response/Tickets/Ticket

Идентификатор

/Info/OtherParams/Para

смс

Актуально

m@name = smsId

с версии

Response/Tickets/Ticket

/Info/OtherParams/Para

m@value

Response/Tickets/Ticket

Сообщение для

/Info/OtherParams/Para

смс

Актуально

m@name=sms_message

с версии

Response/Tickets/Ticket

/Info/OtherParams/Para

m@value

19.

CREATE

ЭПД записан в базу

Response/Tickets/Ticket

CREATED

Актуально

данных СББОЛ

/Info/@statusStateCode

с версии

(Создан)

20.

Документ принят

Response/Tickets/Ticket

ACCEPTED_BY_C

Актуально

ED_BY_

валютным

/Info/@statusStateCode

с версии

CFE

контролем

(Принят

Response/Tickets/Ticket

Дата поступления

ВК)

/Info/BankDate/@receip

в Банк

Актуально

tDate

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

с версии

принятия в

обработку

Response/Tickets/Ticket

Дата

Актуально

/Info/

принятия/возврата

с версии

AddInfo/CurrControlInf

валютным

o/ValueDateDate

контролем

Response/Tickets/Ticket

Сообщение из

Актуально

/Info/MsgFromBank/@

Банка, если

с версии

message

требуется

Response/Tickets/Ticket

Реквизиты

Актуально

/Info/MsgFromBank/@a

ответственного

с версии

uthor

сотрудника Банка,

если требуется

21.

CHECKE

ЭД не прошел

Response/Tickets/Ticket

CHECKERROR

RROR

логические

/@statusStateCode

(Ошибка

контроли Системы

контрол

ДБО на стороне

Актуально

я)

клиента при

с версии

сохранении

(отрицательный

результат) (статус

окончательный- не

успешно)

22.

Response/Tickets/Ticket

CLOSED

Актуально

CLOSED(

Закрыт

/Info/@statusStateCode

с версии

Закрыт)

23.

IMPORT

Response/Tickets/Ticket

IMPORTED

Актуально

/Info/@statusStateCode

Импортирован

с версии

(Импорт

ирован)

24.

PROCES

Актуально

SING (В

Response/Tickets/Ticket

В обработке

PROCESSING

с версии

обработк

/Info/@statusStateCode

е)

25.

Издан Банком

PUBLISH

Response/Tickets/Ticket

PUBLISHED_BY_

ED_BY_

/Info/@statusStateCode

BANK

Актуально

BANK

с версии

(Издан

Банком)

26.

Response/Tickets/Ticket

Актуально

/Info/@statusStateCode

TRIED_BY_CFE

с версии

Response/Tickets/Ticket

Дата поступления

/Info/BankDate/@receip

в Банк

Актуально

tDate

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

с версии

принятия в

TRIED_B

обработку

Y_CFE

Проверяется ВК

Response/Tickets/Ticket

Сообщение из

Актуально

(Проверя

/Info/MsgFromBank/@

Банка, если

с версии

ется ВК)

message

требуется

Response/Tickets/Ticket

Сообщение из

Актуально

/Info/MsgFromBank@m

банка

с версии

essage

Response/Tickets/Ticket

Ответственный

Актуально

/Info/MsgFromBank@a

исполнитель

с версии

uthor

27.

Ошибка создания

Response/Tickets/Ticket

FAIL

документа в СББОЛ

/Info/@statusStateCode

Добавлено

в версии

(статус

FAIL

окончательный- не

(Ошибка

успешно)

создания

)

Response/Tickets/Ticket

Счет № <номер

Счет плательщика

Добавлено

/Info/MsgFromBank/@

счета> БИК

не найден/не

в версии

message

<номер БИК> не

валиден

найден

28.

Response/Tickets/Ticket

FRAUDDENY

Добавлено

/Info/@statusStateCode

в версии

FRAUDD

Отказан банком

ENY

(статус

(Отказан

окончательный- не

Response/Tickets/Ticket

Сообщение из

Добавлено

банком)

успешно)

/Info/MsgFromBank@m

банка

в версии

essage

29.

DELETE

Удален (статус

Response/Tickets/Ticket

DELETED

Добавлено

окончательный- не

/Info/@statusStateCode

в версии

(Удален)

успешно)

30.

REQUES

Response/Tickets/Ticket

REQUESTED_REC

TED_RE

/Info/@statusStateCode

ALL

Добавлено

Запрошен отзыв

CALL

в версии

документа

(Запроше

н отзыв)

31.

PROCES

Response/Tickets/Ticket

PROCESSING_RZ

SING_RZ

/Info/@statusStateCode

Согласование

(Согласо

Добавлено

контролирующей

вание

в версии

организацией в СБК

контрол

ирующей

организа

цией)

32.

REFUSE

Response/Tickets/Ticket

REFUSED_BY_RZ

D_BY_R

Документ отказан

/Info/@statusStateCode

контролирующей

Добавлено

(Отказан

организацией в СБК

в версии

контрол

(статус

ирующей

окончательный- не

организа

успешно)

цией)

Пример 1.

(Получение из СББОЛ IDполученного документа и статус Доставлен)

<Response sender="DBO" version="7" requestId="992eef03-9e03-4393-97c0-840a8a72c855"

responseId="ce1fbcdd-9ddd-4c9a-95aa-b10ebb32b169" createTime="2016-06-23T15:27:03.429+03:00"

xmlns="http://bssys.com/upg/response">

<Ticket createTime="2016-06-23T15:27:03.164+03:00" docId="0fa45830-ed8e-4abb-b89f-

e2fd34ce8bcb">

<Info docExtId="992eef03-9e03-4393-97c0-840a8a72c855"

statusStateCode="DELIVERED">

</Info>

<Sign>

<Issuer>E = casbrf@sberbank.ru, 2.5.4.33 = Тестирующий Q, CN = ЛавринСВ-

Тестовая печать-УЦ-9, OU = Удостоверяющий центр СБ РФ (Тестовый), O = ОАО "Сбербанк России", C =

RU</Issuer>

<Value>SqbIc0UI7ZzD76HRz001cyTrY4YaWb5qJoEX1k+5n5ATMfauryh5LRO+u0c1hlm8ZLQ2vIUJ9AH

G1hnI1rMdpQ==</Value>

</Sign>

</Ticket>

</Tickets>

</Response>

Пример2.

(Получение из СББОЛ информации об обработке документа, пример статуса FAIL)

<Response sender="DBO" version="7" requestId="45eb7367-d015-4df6-8cdf-eeb740d141ad" responseId="cbaa3d48-

17d3-489e-b142-d92cc90ac4c6" createTime="2016-06-23T15:30:08.106+03:00"

xmlns="http://bssys.com/upg/response">

<Message>Document not found id=0fa45830-ed8e-4abb-b89f-

e2fd34ce8bcb</Message>

</MsgFromBank>

</Info>

</Ticket>

</Tickets>

</Response>

2.2. Запрос выписки

Особенности:

 Запрос выписки может быть сформирован:

o По инициативе Клиента в УС в формате ЭД «Запрос выпискиª;

o Системный запрос ежедневной выписки в формате

«Запрос на получение

документов из Банкаª.

На рисунке ниже изображена схема запроса выписки в зависимости от указания параметра

@lastIncomingTime.

2.2.1. Клиентский запрос выписки

2.2.1.1. Общие сведения

Особенности:

 Если в запросе было передано наименование организации (необязательный атрибут

Request/StmtReq/@orgName) и если наименование не совпадет с платежным

наименование организации в АС СББОЛ, то в квитанции со статусом данного запроса

выписки

также

передается

предупреждение

(Response/Tickets/Ticket/Info/MsgFromBank/@message) о том, что наименование

организации не соответствует данным Банка.

 При отправке в Банк нескольких одинаковых запросов Request/Incoming

(без

LastIncomingTime либо с одинаковым значением в LastIncomingTime) на каждый такой

последующий запрос будет каждый раз сформирован ответ как минимум содержащий

информацию из ответа сформированного ранее на предыдущий такой запрос.

 В Клиентском приложении необходимо реализовать алгоритм, ориентируясь на

нижеследующие рекомендации, с целью минимизировать кол-во одинаковых запросов,

минимизировать объем обрабатываемой информации и, как следствие, сократить время

ожидания завершения сеанса связи с банком у конечного пользователя

Последовательность шагов при получении выписки по запросу Клиента

Формируем сообщение Request/StmtReq, формируем дайджест, подписываем и

передаем подписанное сообщение в УПШ в методе sendRequestsSRP

В ответ получаем ID запроса в методе sendRequestsSRPResponse

Вызываем метод getRequestStatusSRP, в котором передаем полученный тикет (ID

запроса)

В ответ синхронно от УПШ в методе getRequestStatusSRPResponse получаем

Response/Ticket, который содержит docExtID - ID запроса и docID - ID запроса на

стороне Банка

Формируем сообщение Request/DocIds/DocId и передаем в УПШ в методе

sendRequestsSRP

В ответ получаем тикет (ID запроса) в методе sendRequestsSRPResponse

Вызываем метод getRequestStatusSRP, в котором передаем полученный тикет (ID

запроса)

В ответ синхронно получаем статус запроса на получение выписки в методе

getRequestStatusSRPResponse

Повторяем п. 5-8 несколько раз до тех пор, пока не получим статус «IMPLEMENTED».

Получение этого статуса означает, что выписка сформирована в СББОЛ.

10.

Для получения самой выписки формируем сообщение Request/Incoming, где указываем

@lastIncomingTime. Т.к. на формирование выписки требуется некоторое время (обычно

несколько секунд), а в качестве времени формирования выписки указывается время

начала ее формирования в СББОЛ, поэтому, если на стороне Клиента имеются запросы

на получение выписки, по которым выписка еще не получена, то в @lastIncomingTime

рекомендуется

указывать

время

формирования

первого

ответа

(Response/Tickets/Ticket/@createTime) со статусом

«DELIVERED» полученного на

запрос статуса по запросу на формирование выписки (Stmt), причем на самый старый

такой запрос

(Stmt), чтобы время формирования выписки было точно больше

@lastIncomingTime и в УС Клиента пришли все запрошеные выписки. Давность

запросов, по которым нужно получить выписку, ограничивается на стороне Клиента.

Кроме того, время, полученное в Response/Tickets/Ticket/@createTime, необходимо

привести к временной зоне Москва

(+03:00). Из запроса формируем дайджест,

подписываем его и передаем подписанный запрос в УПШ в методе sendRequestsSRP

11.

В ответ получаем ID запроса в методе sendRequestsSRPResponse

12.

Вызываем метод getRequestStatusSRP, в котором передаем полученный тикет (ID

запроса)

13.

В ответ получаем в методе sendRequestStatusSRPResponse выписку в виде xml-

сообщения в соответствии со схемой Response.xsd либо сообщение о разбивке на части

14.

Если есть разбивка выписки на части, то запрашиваем их методом getResponsePartSRP

15.

В ответ получаем пакет с xml-сообщением в соответствии со схемой Response.xsd в

методе getResponsePartSRP

16.

Запрашиваем до тех пор, пока не получим все пакеты, они пронумерованы в порядке

следования. Пакет всегда приходит в сжатом виде и закодирован в Base64.

17.

Расшифровываем, разархивируем (архиватор zip). Затем полученные текстовые файлы

склеиваем последовательно вместе и обрабатываем полученный XML.

ВАЖНО!!!

Если выписка запрошена за дату более 3-х дней назад, то она не придет в

ответ на пустой Request/Incoming, не содержащий @lastIncomingTime.

2.2.1.2. Дайджест

Подпись документа на стороне УС:

Подписывается какой-либо одной подписью:

 Единственная подпись или

 Первая подпись или

 Вторая подпись

Дайджест: формируется

Ключевой буфер (дайджест):

 Для формирования электронной подписи из документа формируется строковая

последовательность (ключевой буфер или дайджест), включающая все значимые данные

документа, поля, содержащие пустые значения, не включаются.

 Ключевой буфер (дайджест) для подписания ЭП образует строковый массив в кодировке

UTF-8, Отдельные записи массива разделены символом перевода строки. В качестве

символа перевода строки используется 0x0A.

 При наличии в мультистроковых данных последовательности из двух символов перевода

строки CR+LF (ASCII 0x0D 0x0A) необходимо удалять символ возврата каретки CR (ASCII

0x0D) и оставлять только символ подачи строки LF (ASCII 0x0A).

 Для отделения некоторых видов данных друг от друга в дайджест включены «заголовкиª,

такие как ATTRIBUTES, FIELDS и TABLES. После TABLES необходимо указание на следующей

строке «типа таблицыª Table=Accounts, далее следуют поля записей по одному полю в

каждой строке, между отдельными записями в качестве разделителя используется строка

содержащая знак «решеткаª - #. Этот символ ставится, также после последней записью в

списке.

 Эти «заголовкиª не несут информации исходного документа, а служат для внутренней

организации данных в дайджесте. «Заголовкиª указываются в отдельной строке, где кроме

них ничего нет.

 Если наполнение всех таблиц блока TABLES пустое, то и сам TABLES в дайджест не

включается

 Если наполнение какой-то таблицы блока TABLES пустое, то Table=TableName не включать в

дайджест

Формат дайджеста:

№

Наименование

Версионно

Описание

Пример значения

п/п

поля

сть

ATTRIBUTES

Актуально

с версии 27

fb8360e9-69ae-40d4-b5e2-

OrgId

Идентификатор организации в ДБО

Актуально

b7e60f2a3fd7

с версии 27

Sender

Отправитель, а также тип

Ромашка

использованного Клиентом

Актуально

программного обеспечения при

с версии 27

отправке документа

ExtId

3a6378ef-07ee-4535-a10a-

Уникальный* идентификатор

0c82817cae23

документа в учетной системе (УС)

Актуально

Клиента.

с версии 27

*Уникальность контролируется на

стороне банка

FIELDS

<Наименование поля>=<Значение поля>, например

Актуально

BeginDate=2011-11-24

с версии 27

После последней строки НЕ делать перевод строки

BeginDate

Дата начала периода

2011-11-24

Актуально

с версии 27

EndDate

Дата окончания периода

2011-11-24

Актуально

с версии 27

StmtType

Тип запроса выписки

101

Актуально

с версии 27

Пример

TABLES

Разделитель строк таблицы - #

Сортировать сначала по БИКам,

TABLES

а потом по счетам

Table=Accounts

Bic=044525225

Account=40555810414444444

Изменено в

444

версии 32

Bic=044525225

Account=40555810414444444

447

10.

Table=Accounts

Актуально

с версии 27

11.

DocNum

Номер запроса выписки по счету

Актуально

с версии 27

12.

Bic

БИК

044555222

Актуально

с версии 27

13.

Account

Счет

40555810414444444444

Актуально

с версии 27

14.

Актуально

с версии 27

15.

DocNum

Номер запроса выписки по счету

Актуально

с версии 27

16.

Bic

БИК

044555222

Актуально

с версии 27

17.

Account

Счет

40555810414444444444

Актуально

с версии 27

Пример.

ATTRIBUTES

OrgId=fb8360e9-69ae-40d4-b5e2-b7e60f2a3fd7

Sender=Ромашка

ExtId=6590e8a2-ddee-4f1c-9237-03ef67c3b0d8

FIELDS

BeginDate=2015-04-23

EndDate=2015-04-23

StmtType=101

TABLES

Table=Accounts

DocNum=2

Bic=044555222

Account=40000000000000000000

DocNum=3

Bic=044555222

Account=40000000000000000000

DocNum=4

Bic=044555222

Account=40000000000000000000

DocNum=5

Bic=044555222

Account=40000000000000000000

DocNum=6

Bic=044555222

Account=40000000000000000000

2.2.1.3. Формат взаимодействия

Взаимодействие: Документ передается из УС в СББОЛ

Инициатор получения квитков: УС

Формат передачи документа: Request/StmtReq

Формат предоставления ответа (квитанции) со стороны СББОЛ: Response/Tickets

При передаче документана сторону СББОЛ передается информация об ошибках

безопасности в случае недопустимости использования средств удаленного управления

компьютером при работе с ТК.

2.2.1.3.1.

Формат отправки документа в СББОЛ

Request/StmtReq

Версионнос

Элемент

Описание элемента

Тип

Описание типа

Мн.

ть

Request

Запрос УС к СББОЛ

Request

Актуально

[1]

с версии 27

Уникальный

@requestId

UuidSepara

UUID с

идентификатор запроса

ted

разделителями

в виде

Актуально

дефисов.

[1]

с версии 27

Набор из 32

символов [0-9],

[a-f] и дефисов

Идентификатор

@orgId

UuidSepara

UUID с

организации в ДБО

ted

разделителями

(может быть использован

в виде

Актуально

сторонней системой для

дефисов.

[1]

с версии 27

дополнительной

Набор из 32

идентификации)

символов [0-9],

[a-f] и дефисов

Номер версии формата

@version

xs:string

Простой тип

Актуально

обмена

RegEx: "[0-

XML Schema

[1]

с версии 27

9\.]{1,20}"

Система-отправитель

@sender

xs:string

Простой тип

RegEx: «[-

XML Schema

Актуально

a-zA-Zа-

[1]

с версии 27

яА-Я0-9:

_]{1,20}»

Система-получатель -

@receiver

xs:string

Простой тип

Если система получатель

RegEx: «[-

XML Schema

[0..1

Актуально

СББОЛ, то SBBOL_DBO

a-zA-Zа-

]

с версии 27

яА-Я0-9:

_]{1,20}»

Версия протокола

@protocolVersion

xs:string

Простой тип

[0..1

Актуально

XML Schema

]

с версии 27

Запрос на получение

StmtReq

StmtReqTy

Актуально

информации о движении

[1]

с версии 27

ден. средств

*.1

@docExtId

UuidSepara

UUID с

Уникальный*

ted

разделителями

идентификатор документа

в виде

в учетной системе (УС)

Актуально

дефисов.

[1]

Клиента.

с версии 27

Набор из 32

*Уникальность

символов [0-9],

контролируется на

[a-f] и дефисов

стороне банка

0 - обычная передача на

*.2

@sentForSign

BoolType

выполнение

[0..1

Актуально

1 - передано для

]

с версии 27

подписания в ИК

Дата и время создания

*.3

@createTime

xs:dateTim

Простой тип

запроса (с час.поясами)

XML Schema

ПОЛЕ ОБЯЗАТЕЛЬНО

в формате

[0..1

Актуально

ДЛЯ ЗАПОЛНЕНИЯ

'2015-12-

]

с версии 27

23T10:49:3

Дата начала периода

*.4

@beginDate

xs:date

Простой тип

Актуально

[1]

XML Schema

с версии 27

Дата окончания периода

*.5

@endDate

xs:date

Простой тип

Актуально

[1]

XML Schema

с версии 27

Тип запроса выписки: 101

*.6

@stmtType

xs:string

Простой тип

- текущая выписка

[min: 1,

XML Schema

Актуально

max: 3]

[1]

с версии 27

Варианты:

"101"

Передается платежное

*.7

@orgName

xs:string

Простой тип

наименование

[max: 160]

XML Schema

организации. СББОЛ при

приеме проверяет на

[0..1

Актуально

соотв. справочнику и

]

с версии 27

возвращает

предупреждение о

несоответствии

*.8

Accounts

Актуально

[1]

с версии 27

Счёт, по которому

Account

Acc

[1..n

Актуально

запрашивается выписка

]

с версии 27

БИК

@bic

BicType

БИК, 9 цифр

Актуально

[1]

с версии 27

Номер документа -

@docNum

xs:string

Простой тип

Запроса на формирование

[max: 6]

XML Schema

[0..1

Актуально

выписки

]

с версии 27

ПОЛЕ ОБЯЗАТЕЛЬНО

ДЛЯ ЗАПОЛНЕНИЯ

Пример.

<Request xmlns='http://bssys.com/upg/request' orgId='fb8360e9-69ae-40d4-b5e2-b7e60f2a3fd7'

requestId='6d4d319b-8c91-43c0-aa15-421926edfa57' version='01.002.02' sender='Ромашка'

receiver='SBBOL_DBO'>

<StmtReq docExtId='6d4d319b-8c91-43c0-aa15-421926edfa57' createTime='2015-04-23T16:54:09'

beginDate='2015-04-23' endDate='2015-04-23' stmtType='101' orgName='ООО "ИП7"'>

</Accounts>

</StmtReq>