содержание .. 16 17 18
Спецификация форматов и порядок обмена данными в канале «Сбербанк Интеграция» (API). Версия 33.000 - часть 18
(сокращенное наименование - как в
«Тестовая
версии 27
платежных руб. документах)
организацияª
9.
TABLES
Актуально с
Разделитель строк таблицы - # Сортировать сначала по типу адреса, потом по
версии 27
индексу
Актуально с
10.
Table=VBKInfo
версии 27
Актуально с
11.
Номер строки по порядку
LineNumber
1
версии 27
11111111/111
Актуально с
12.
Номер ПС полностью (со слешами)
DealPassNum
1/1111/1/1
версии 27
13.
Признак наличия номера контракта
Contract.NumCheck
(кредитного договора)
Актуально с
Возможные значения:
1
версии 27
1 - признак установлен
0 - признак снят
Актуально с
14.
Номер контракта (кредитного договора)
Contract.Num
12415113
версии 27
15.
Признак того, что ВБК запрашивается
VBKInfoReqParam.Ful
полностью
lPart
Актуально с
Возможные значения:
1
версии 27
1 - признак установлен
0 - признак снят
16.
Запросить информацию из раздела II.
VBKInfoReqParam.Pa
Сведения о платежах
rt2
Актуально с
Возможные значения:
0
версии 27
1 - признак установлен
0 - признак снят
17.
Запросить информацию из раздела III.
VBKInfoReqParam.Pa
Сведения о подтверждающих
rt3Contract
документах
Актуально с
1
Возможные значения:
версии 27
1 - признак установлен
0 - признак снят
18.
Запросить информацию из раздела V.
VBKInfoReqParam.
Итоговые данные расчетов по контракту
Part5Contract
Актуально с
Возможные значения:
1
версии 27
1 - признак установлен
0 - признак снят
19.
Запросить информацию из раздела III.
VBKInfoReqParam.Pa
Сведения об исполнении обязательств
rt3Credit
по основному долгу по иным
Актуально с
0
основаниям, отличным от проведения
версии 27
расчетов в денежной форме
Возможные значения:
1 - признак установлен
0 - признак снят
20.
Запросить информацию из раздела IV.
VBKInfoReqParam.Pa
Расчет задолженности по основному
rt4Credit
долгу
Актуально с
0
Возможные значения:
версии 27
1 - признак установлен
0 - признак снят
Пример дайджеста
ATTRIBUTES
OrgId=ac24c9da-fbc1-4056-8550-cdd0c6fd5239
Sender=Ромашка
ExtId=c902dc01-6608-436d-9b0c-ee2d469c0d37
FIELDS
DocData.DocNum = 1
DocData.BankName = ДО 1175 Московского Банка Сбербанк России
OrgData.OrgName = ОАО "Ромашка"
TABLES
Table= VBKInfo =
LineNumber = 1
DealPassNum = 11111111/1111/1111/1/1
Contract.NumCheck = 1
Contract.Num = 12415113
VBKInfoReqParam.FullPart = 1
VBKInfoReqParam.Part2 = 0
VBKInfoReqParam.Part3Contract = 1
VBKInfoReqParam. Part5Contract = 1
VBKInfoReqParam.Part3Credit = 0
VBKInfoReqParam.Part4Credit = 0
3.7.2.Формат взаимодействия
Взаимодействие: Документ передается из УС в СББОЛ
Инициатор получения справочника: УС
Формат передачи документа на сторону СББОЛ: Request/CurrControlInfoRequest
Формат предоставления ответа (квитанции) об исполнении документа со стороны СББОЛ:
Response/Tickets
3.7.2.1.
Формат отправки документов в СББОЛ
Request/CurrControlInfoRequest
Версионно
Элемент
Описание элемента
Тип
Описание типа
Мн.
сть
Актуально
Request
[1]
с версии 27
Уникальный идентификатор запроса
UUID с
1
@requestId
UuidSeparated
разделителями в
Актуально
виде дефисов. Набор
[1]
с версии 27
из 32 символов [0-
9], [a-f] и дефисов
Идентификатор организации в ДБО (может
UUID с
2
@orgId
UuidSeparated
быть использован сторонней системой для
разделителями в
Актуально
дополнительной идентификации)
виде дефисов. Набор
[1]
с версии 27
из 32 символов [0-
9], [a-f] и дефисов
Номер версии формата обмена
Простой тип XML
Актуально
3
@version
xs:string
[1]
Schema
с версии 27
RegEx: "[0-9\.]{1,20}"
Система-отправитель
xs:string
Простой тип XML
4
@sender
Актуально
RegEx: «[-a-zA-Zа-
Schema
[1]
с версии 27
яА-Я0-9: _]{1,20}ª
Система-получатель Если система получатель
xs:string
Простой тип XML
5
@receiver
[0..1
Актуально
СББОЛ, то SBBOL_DBO
RegEx: «[-a-zA-Zа-
Schema
]
с версии 27
яА-Я0-9: _]{1,20}ª
6
@protocolVersion
Версия протокола
xs:string
Простой тип XML
[0..1
Актуально
Schema
]
с версии 27
Запрос информации ВК
Актуально
7
CurrControlInfoRequest
CurrControlInfoReques
[1]
с версии 27
t
UUID с
*.1
@docExtId
Уникальный* идентификатор документа в
UuidSeparated
разделителями в
учетной системе (УС) Клиента.
Актуально
виде дефисов. Набор
[1]
*Уникальность контролируется на стороне
с версии 27
из 32 символов [0-
банка
9], [a-f] и дефисов
*.2
@sentForSign
0 - обычная передача на выполнение 1 -
BoolType
[0..1
Актуально
передано для подписания в ИК
]
с версии 27
Общие реквизиты документа
Реквизиты
Актуально
*.3
DocData
ComDocData
[1]
документа
с версии 27
Дата составления документа
Простой тип XML
Актуально
@docDate
xs:date
*.1
[1]
Schema
с версии 27
Значение
Простой тип XML
@bankName
xs:string [min: 1, max:
*.2
Response/OrganizationsInfo/OrganizationInfo/Bran
Schema
255]
[0..1
Актуально
ches/Branch/SystemName - наименование
]
с версии 27
подразделения банка, которое передается в
рамках OrganizationsInfo
Номер подразделения банка получателя
Простой тип XML
@bankNum
xs:string
*.3
заявления в ДБО
Schema
Значение
Response/OrganizationsInfo/OrganizationInfo/Bran
[0..1
Изменено в
ches/Branch/SystemName - наименование
]
версии 33
подразделения банка, которое передается в
рамках OrganizationsInfo
В настоящее время не используется
Идентификатор договора депозита
UUID с
@initialCard
UuidSeparated
*.4
разделителями в
виде дефисов. Набор
[0..1
Актуально
из 32 символов [0-
]
с версии 27
9], [a-f] или [A-F] и
дефисов
Номер документа
Простой тип XML
Актуально
@docNum
xs:string [max: 6]
*.5
[1]
Schema
с версии 27
Основные реквизиты организации, указываемые
Актуально
OrgData
OrgData
*.6
[1]
в документе
с версии 27
КПП клиента
КПП, 9 цифр
[0..1
Актуально
@kpp
KppType
*.1
]
с версии 27
ОКАТО клиента
ОКАТО, от 1 до 11
@okato
OkatoType
*.2
[0..1
Актуально
цифр (иногда
]
с версии 27
заполняется нулём)
ИНН клиента
ИНН юридического
@inn
InnType
*.3
или физического
Актуально
[1]
лица РФ, до 12
с версии 27
цифр
Наименование организации клиента
Простой тип XML
@orgName
xs:string [min: 1, max:
*.4
Актуально
(сокращенное наименование - как в платежных
Schema
[1]
160]
с версии 27
руб. документах)
ОКПО клиента
ОКПО, от 8 до 10
[0..1
Актуально
@okpo
OkpoType
*.5
цифр
]
с версии 27
ОГРН клиента
@orgOGRN
OgrnType
*.6
ОГРН, от 13 0 до 15
Изменено в
[0..1]
цифр
версии 33
*.7
@clientNameInth
Cокращенное наименование организации в
xs:string [min: 1, max:
Простой тип XML
[0..1
Актуально
eGenitive
родительном падеже
255]
Schema
]
с версии 27
*.8
@fullName
Полное наименование
xs:string [min: 1, max:
Простой тип XML
[0..1
Актуально
500]
Schema
]
с версии 27
*.9
@internationalNa
Наименование на иностранном языке (при
xs:string [min: 1, max:
Простой тип XML
[0..1
Актуально
me
наличии)
500]
Schema
]
с версии 27
*.1
@opf
Наименование на иностранном языке (при
xs:string [min: 1, max:
Простой тип XML
[0..1
Актуально
0
наличии)
255]
Schema
]
с версии 27
*.1
@datOGRN
Дата регистрации
xs:date
Простой тип XML
[0..1
Актуально
1
Schema
]
с версии 27
*.1
@orgAdress
Юридический адрес организации клиента
xs:string [min: 1, max:
Простой тип XML
[0..1
Актуально
2
1024]
Schema
]
с версии 27
*.1
@resident
Резидентность организации по справочнику
xs:string [min: 1, max:
Простой тип XML
[0..1
Актуально
3
организаций
255]
Schema
]
с версии 27
Уполномоченный сотрудник организации
*.7
AuthPers
AuthPers
[0..1
Актуально
клиента
]
с версии 27
Изменено в
*.1
Name
Имя ФИО уполномоченного сотрудника
xs:string
Простой тип XML
[1]
версии 31
организации клиента
Schema
*.2
Telfax
Номер телефона, факса уполномоченного
xs:string
Простой тип XML
[0..1
Изменено в
сотрудника организации клиента
Schema
]
версии 30
[1]
Изменено в
*.3
Position
Должность уполномоченного сотрудника
xs:string [min: 1, max:
Простой тип XML
[0..1
версии 31
организации клиента
1024]
Schema
]
Ведомость банковского контроля
Простой тип XML
Актуально
*.4
VBKInfos
[1]
Schema
с версии 27
[1..n
Актуально
*.1
VBKInfo
VBKInfo
]
с версии 27
Номер строки
Актуально
*.1
LineNumber
int
[1]
с версии 27
Номер ПС
Актуально
*.2
DealPassNum
string
[1]
с версии 27
Информация о контраке/ кредитном договоре
Актуально
*.3
Contract
Contract
[1]
с версии 27
0 - с номером, 1 - без номера
Актуально
*.1
@numCheck
string [max: 1]
[1]
с версии 27
Номер контракта
[0..1
Актуально
*.2
@num
string
]
с версии 27
Дата контракта
Актуально
*.3
@date
date
[1]
с версии 27
Запросить информацию из ВБК
Актуально
*.4
VBKInfoReqPara
[1]
с версии 27
m
Предоставить ВБК полностью или частично.
*.
FullPart
boolean
Актуально
Возможные значения: 1 - полностью, 0 -
[1]
1
с версии 27
частично
Предоставить ВБК по контракту или
*.
ContractCredi
boolean
Актуально
кредитному договору. Возможные значения: 2 -
[1]
2
t
с версии 27
По контракту, 0 - по кредитному догвору
Раздел II. Сведения о платежах
[0..1
Актуально
*.
Part2
boolean
]
с версии 27
3
Раздел III. Сведения о подтверждающих
[0..1
Актуально
*.
Part3Contract
boolean
документах
]
с версии 27
4
Раздел V. Итоговые данные расчетов по
[0..1
Актуально
*.
Part5Contract
boolean
контракту
]
с версии 27
5
Раздел III. Сведения об исполнении
*.
Part3Credit
boolean
обязательств по основному долгу по иным
[0..1
Актуально
6
основаниям, отличным от проведения расчетов
]
с версии 27
в денежной форме
Раздел IV. Расчет задолженности по основному
[0..1
Актуально
*.
Part4Credit
boolean
долгу
]
с версии 27
7
Запросить поступившую в банк информацию о
*.5
CustomsDeclaration
Period
[0..1
Актуально
зарегистрированных таможенными органами
]
с версии 27
декларациях на товары
Дата начала запрашиваемого периода
Актуально
*.1
BeginDate
xs:date
[1]
с версии 27
Дата завершения запрашиваемого периода
Актуально
*.2
EndDate
xs:date
[1]
с версии 27
Запросить информацию о зарегистрированных
*.6
ViolationCurrencyLaws
Period
[0..1
Актуально
банком нарушениях валютного
]
с версии 27
законодательства
Дата начала запрашиваемого периода
Актуально
*.1
BeginDate
xs:date
[1]
с версии 27
Дата завершения запрашиваемого периода
Актуально
*.2
EndDate
xs:date
[1]
с версии 27
Пример
<Request xmlns='http://bssys.com/upg/request' orgId='4dd71d3b-3d16-44ce-8fb0-7a2f3626b494' requestId='897af24d-7bb8-439d-9a09-
b25e7f61a6af' version='01.004.01' sender='Ромашка' receiver='SBBOL_DBO'>
<CurrControlInfoRequest docExtId="7cEC18D5-77af-F061-CEfa-DdFCbdE55445">
<DocData docDate="2017-05-06" docNum="15">
<OrgData inn="20272" orgName="GQyZ7NFeXjHbiR"/>
</DocData>
<VBKInfos>
<VBKInfo>
<LineNumber>993270451</LineNumber>
<DealPassNum>_kmDq27FCGPjDXzhxF0u</DealPassNum>
<Contract numCheck="0" date="2017-09-20"/>
<VBKInfoReqParam>
<FullPart>0</FullPart>
<ContractCredit>1</ContractCredit>
</VBKInfoReqParam>
</VBKInfo>
<VBKInfo>
<LineNumber>-1353788869</LineNumber>
<DealPassNum>oITPaz</DealPassNum>
<Contract numCheck="1" date="2016-07-05"/>
<VBKInfoReqParam>
<FullPart>0</FullPart>
<ContractCredit>0</ContractCredit>
</VBKInfoReqParam>
</VBKInfo>
</VBKInfos>
</CurrControlInfoRequest>
</Request>
3.7.3.Особенности получения статусов об обработке из ССБОЛ
Информация об обработке документа доставляется в УС:
3. Без запроса со стороны УС:
a. В ответ на отправленный документ СББОЛ отправляет сообщение в формате
Response/Tickets, в котором передается:
Tickets/Ticket@docId
- Идентификатор документа, с помощью которого
впоследствии можно запрашивать со стороны УС в формате Request/DocIds/DocId -
все последующие статусы обработки докуемнта
Tickets/Ticket/ Info@statusStateCode="DELIVERED"
4. Путем запроса со стороны УС в формате Request/DocIds/DocId:
a. Имея данные идентификатора документа, которые были получены с первым сообщением
Response/Tickets ->СББОЛ передает текущее состояние документа.
Tickets/Ticket/Info/BankDate/@statusDateTime - дата и время присвоения статуса.
Статусы обработки документа, передаваемые со стороны СББОЛ в УПШ в рамках
Response/Tickets:
Передаваемый
№
из СББОЛ
Описание операции на стороне
Атрибут Response/Tickets для
Описание передаваемого из
Версионно
п/п
статус
СББОЛ
передачи в УПШ
СББОЛ значения
сть
документа
Response/Tickets/Ticke
Проверки документа
Актуально
INVALIDE
t/Info/@statusStateCod
INVALIDEDS
привели к
с версии 27
DS
e
неуспешному
1.
(АСП/ЭП
результату
Response/Tickets/Ticke
Может быть передано
Актуально
не верна)
(статус
t/Info/MsgFromBank/
сообщение о том, что
с версии 27
окончательный - не
@message
подлинность
успешно)
документа не
подтверждена
VALIDEDS
Проверки документа
Response/Tickets/Ticke
Актуально
(АСП/ЭП
привели к успешному
t/Info/@statusStateCod
VALIDEDS
2.
с версии 27
верна)
результату
e
Логические проверки
Response/Tickets/Ticke
Актуально
REQUISIT
документа привели к
t/Info/@statusStateCod
REQUISITE_ERROR
с версии 27
E_ERROR
неуспешному
e
(Ошибка
результату
Должны передаваться
3.
Response/Tickets/Ticke
реквизито
(статус
сообщения об
Актуально
t/Info/MsgFromBank/
в)
окончательный - не
ошибках, выявленных
с версии 27
@message
успешно)
на стороне Банка
Документ доставлен
DELIVERE
на сторну Банка, но
Response/Tickets/Ticke
D
еще не проходил
Актуально
t/Info/@statusStateCod
DELIVERED
4.
(Доставле
проверку подписи и
с версии 27
e
н)
реквизитов
Response/Tickets/Ticke
Актуально
ACCEPTED
ACCEPTE
Прием документа на
t/@statusStateCode
с версии 27
D
стороне Банка
Response/Tickets/Ticke
Дата поступления в
5.
Актуально
(Принят)
t/Info/BankDate/@recei
Банк плательщика и
с версии 27
ptDate
принятия в обработку
Response/Tickets/Ticke
Актуально
DECLINED_BY_ABS
t/@statusStateCode
с версии 27
Response/Tickets/Ticke
DECLINED
Отказ платежа
Актуально
t/Info/MsgFromBank/
Сообщение из Банка
_BY_ABS
(статус
с версии 27
@message
6.
(Отказан
окончательный - не
Реквизиты
АБС)
успешно)
Response/Tickets/Ticke
ответственного
Актуально
t/Info/MsgFromBank/
сотрудника Банка,
с версии 27
@author
если требуется
Response/Tickets/Ticke
Актуально
t/Info/@statusStateCod
EXPORTED
с версии 27
e
Response/Tickets/Ticke
Дата поступления в
Актуально
t/Info/BankDate/@recei
Банк плательщика и
EXPORTE
с версии 27
Документ выгружен в
ptDate
принятия в обработку
D
АБС для дальнейшей
7.
(Выгруже
Response/Tickets/Ticke
обработки
Сообщение из Банка,
Актуально
н)
t/Info/MsgFromBank/
если требуется
с версии 27
@message
Реквизиты
Response/Tickets/Ticke
ответственного
Актуально
t/Info/MsgFromBank/
сотрудника Банка,
с версии 27
@author
если требуется
Response/Tickets/Ticke
Актуально
ACCEPTE
ACCEPTED_BY_ABS
t/@statusStateCode
с версии 27
D_BY_AB
Документ принят на
8.
S (Принят
обработку в АБС
Response/Tickets/Ticke
Актуально
Сообщение из Банка
АБС)
t/Info/MsgFromBank/
с версии 27
@message
Response/Tickets/Ticke
Актуально
t/Info/@statusStateCod
PROCESSED
с версии 27
e
Response/Tickets/Ticke
t/Info/AddInfo/
Актуально
Дата обработки
CurrControlInfo/Value
с версии 27
Date
Response/Tickets/Ticke
Актуально
t/Info/MsgFromBank@
Сообщение из банка
с версии 27
message
Response/Tickets/Ticke
Ответственный
Актуально
t/Info/MsgFromBank/
исполнитель
с версии 27
@author
Response/Tickets/Ticke
t/Info/AddInfo/CurrCon
Актуально
trolInfo/CurrControlInf
Номер строки
с версии 27
oRequest/VBKInfo/Lin
eNumber
Response/Tickets/Ticke
Номер ПС
t/Info/AddInfo/CurrCon
Актуально
trolInfo/CurrControlInf
с версии 27
oRequest/VBKInfo/Dea
Подтверждение
lPassNum
PROCESSE
исполнения платежа
Response/Tickets/Ticke
0 - с номером, 1 - без
D
(статус
t/Info/AddInfo/CurrCon
номера
9.
(Обработа
Актуально
окончательный -
trolInfo/CurrControlInf
н)
с версии 27
успешно)
oRequest/VBKInfo/Con
tract/@numCheck
Response/Tickets/Ticke
Номер контракта
t/Info/AddInfo/CurrCon
Актуально
trolInfo/CurrControlInf
с версии 27
oRequest/VBKInfo/Con
tract/@num
Response/Tickets/Ticke
Дата контракта
t/Info/AddInfo/CurrCon
Актуально
trolInfo/CurrControlInf
с версии 27
oRequest/VBKInfo/Con
tract/@date
XML-сообщение,
Response/Tickets/Ticke
содержащее ВБК в
t/Info/AddInfo/CurrCon
соответствии с
Актуально
trolInfo/CurrControlInf
форматом,
с версии 27
oRequest/VBKInfo/XM
предписанным
LMessage
Инстуркции 138-И
Response/Tickets/Ticke
Номер строки по
t/Info/AddInfo/CurrCon
порядку
Актуально
trolInfo/CurrControlInf
с версии 27
oRequest/ViolationCurr
Law/LineNumber
Response/Tickets/Ticke
Дата нарушения
t/Info/AddInfo/CurrCon
Актуально
trolInfo/CurrControlInf
с версии 27
oRequest/ViolationCurr
Law/ViolationDate
Response/Tickets/Ticke
Сумма нарушения
t/Info/AddInfo/CurrCon
Актуально
trolInfo/CurrControlInf
с версии 27
oRequest/ViolationCurr
Law/ViolationSum
Response/Tickets/Ticke
Цифровой код валюты
t/Info/AddInfo/CurrCon
Актуально
trolInfo/CurrControlInf
с версии 27
oRequest/ViolationCurr
Law/@currCode
Response/Tickets/Ticke
ISO-код валюты
t/Info/AddInfo/CurrCon
Актуально
trolInfo/CurrControlInf
с версии 27
oRequest/ViolationCurr
Law/@currIsoCode
Response/Tickets/Ticke
Нормативный
t/Info/AddInfo/CurrCon
правовой акт
Актуально
trolInfo/CurrControlInf
с версии 27
oRequest/ViolationCurr
Law/NormLegalAct
Response/Tickets/Ticke
Нарушенная норма
t/Info/AddInfo/CurrCon
Актуально
trolInfo/CurrControlInf
с версии 27
oRequest/ViolationCurr
Law/ViolationNorm
Response/Tickets/Ticke
Описание нарушения
t/Info/AddInfo/CurrCon
Актуально
trolInfo/CurrControlInf
с версии 27
oRequest/ViolationCurr
Law/Comment
Response/Tickets/Ticke
Номер ПС
t/Info/AddInfo/CurrCon
Актуально
trolInfo/CurrControlInf
с версии 27
oRequest/ViolationCurr
Law/DealPassNum
Response/Tickets/Ticke
0 - с номером, 1 - без
t/Info/AddInfo/CurrCon
номера
trolInfo/CurrControlInf
Актуально
oRequest/ViolationCurr
с версии 27
Law/Contract/@numCh
eck
Response/Tickets/Ticke
Номер контракта
t/Info/AddInfo/CurrCon
Актуально
trolInfo/CurrControlInf
с версии 27
oRequest/ViolationCurr
Law/Contract/@num
Response/Tickets/Ticke
Дата контракта
t/Info/AddInfo/CurrCon
Актуально
trolInfo/CurrControlInf
с версии 27
oRequest/ViolationCurr
Law/Contract/@date
CHECKER
ЭД не прошел
Response/Tickets/Ticke
CHECKERROR
ROR
логические контроли
t/@statusStateCode
(Ошибка
Системы ДБО на
контроля)
стороне клиента при
Актуально
сохранении
10.
с версии 27
(отрицательный
результат) (статус
окончательный- не
успешно)
CREATED
ЭД сформирован
Response/Tickets/Ticke
CREATED
(Создан)
пользователем на
t/@statusStateCode
стороне клиента, при
этом документ
Актуально
11.
прошел логические
с версии 27
контроли с
положительным
результатом.
IMPORTE
Response/Tickets/Ticke
IMPORTED
D
t/Info/@statusStateCod
Актуально
12.
Импортирован
(Импорти
e
с версии 27
рован)
IMPLEME
ЭД успешно
Response/Tickets/Ticke
IMPLEMENTED
NTED
обработан в ЕКС
t/@statusStateCode
Актуально
13.
(Обработа
(статус
с версии 27
н)
окончательный-
успешно)
SIGNED
ЭД был подписан
Response/Tickets/Ticke
SIGNED
Актуально
(Подписан
достаточным набором
t/@statusStateCode
14.
с версии 27
)
подписей.
3.8. Письмо для целей ВК (в банк)
3.8.1.Дайджест
Запрос данных:
Подпись документа на стороне УС: Первая, Вторая или Единственная подпись
Дайджест: формируется
Ключевой буфер (дайджест):
Для формирования электронной подписи из документа формируется строковая последовательность
(ключевой буфер или дайджест), включающая все значимые данные документа, поля, содержащие
пустые значения, не включаются.
Ключевой буфер (дайджест) для подписания ЭП образует строковый массив в кодировке UTF-8,
Отдельные записи массива разделены символом перевода строки. В качестве символа перевода
строки используется 0x0A.
При наличии в мультистроковых данных последовательности из двух символов перевода строки
CR+LF (ASCII 0x0D 0x0A) необходимо удалять символ возврата каретки CR (ASCII 0x0D) и
оставлять только символ подачи строки LF (ASCII 0x0A).
В случае использования 2-х ЭП дайджест строится точно также как и при единственной ЭП.
Примечание:
Для отделения некоторых видов данных друг от друга в дайджест включены «заголовкиª,
такие как ATTRIBUTES и FIELDS. Эти «заголовкиª не несут информации исходного
документа, а служат для внутренней организации данных в дайджесте. «Заголовкиª
указываются в отдельной строке, где кроме них ничего нет.
Для ЭД «ВБКª не полная корреляция наименования полей дайджеста с xPath элемента в
формате отправки не является ошибкой.
Формат дайджеста:
№
Версионно
Наименование поля
Описание
Пример значения
п/п
сть
1.
ATTRIBUTES
Актуально
<Наименование поля>=<Значение поля>, например:
с версии 27
OrgId=963084ba-7079-4b9d-bbab-c4972dee82d9
2.
Идентификатор организации
963084ba-7079-4b9d-
Актуально
OrgId
в ДБО
bbab-c4972dee82d9
с версии 27
3.
Отправитель, а также тип
Ромашка
Sender
использованного Клиентом
Актуально
программного обеспечения
с версии 27
при отправке документа
4.
3a6378ef-07ee-4535-
ExtId
Уникальный* идентификатор
a10a-0c82817cae23
документа в учетной системе
Актуально
(УС) Клиента.
с версии 27
*Уникальность
контролируется на стороне
банка
5.
FIELDS
<Наименование поля>=<Значение поля>, например:
Актуально
BeginDate=2011-11-24
с версии 27
После последней строки НЕ делать перевод строки
6.
Номер документа
123
Актуально
DocData.DocNum
с версии 27
7.
Наименование
Имя подразделения
DocData.BankName
Актуально
подразделения банка
банка
с версии 27
получателя заявления
8.
Тип письма
Досыл уточненных
Актуально
Type
реквизитов
с версии 27
9.
Тема письма
Тема
Актуально
Theme
с версии 27
10.
Текст сообщения
Текст письма
Актуально
AddInfo
с версии 27
11.
Тип документа
ВБК
Актуально
TemplateDocumentType
с версии 27
12.
Номер документа
1
Актуально
TemplateDocumentNum
с версии 27
ber
13.
Дата документа
2016-01-13
Актуально
TemplateDocumentDate
с версии 27
14.
Тип документа
ВБК
Актуально
TemplateDocumentNam
с версии 27
e
15.
TABLES
Актуально
Разделитель строк таблицы - #
с версии 27
Table=Attachments
Разделитель строк таблицы - #
Исключено
в версии 32
Сортировать сначала по имени файла (цифры, латинские буквы, русские буквы), затем
по размеру файла
Имя файла вложения
f1311fff.TXT
Исключено
Attachment.Attachment
в версии 32
Name
Пользовательское описание
Описание файла
Исключено
Attachment.Description
файла вложения
в версии 32
Вложение в бинарном
VGVzdA==
Attachment.Body
Исключено
представлении в сжатом и
в версии 32
несжатом виде
16.
Table=BigFileAttachments EssenceAttachment
Изменено в
версии
Таблица данных вложений. Сортировка - по возрастанию UploadJobId
32.001
17.
UploadJobId
Идентификатор задания на
7b8360e9-69ae-34d4-
Добавлено в
загрузку файла в БФ
b5e2-b7e60f2a3fdf
версии 30
18.
FileHash
Представление хэш файла по
5C00CCC2734CDD333
одному из алгоритмов: ГОСТ
2D3D4749576E3C1A7D
34.11 94 или ГОСТ 34.11 2012 в
BAF0E7EA74E9FA6024
зависимости от значения
13C90A129FA
системного параметра
Изменено в
big_file_sms_digest_hash_algorit
версии
hm (Справочник
32.001
CommonSetting)
Параметр заполняется, если
BF_TOKEN_SIGN_ENABLED =
true (Справочник
DocTypeParam)
Пример
ATTRIBUTES
OrgId=ea53da8f-8225-4f16-a53f-6f9a19531fe3
Sender= Ромашка
ExtId=02ab9ca5-0b61-4e7c-8c26-b5491155633c
FIELDS
DocData.DocNum=2
DocData.BankName=Имя подразделения банка
Theme=Тема
AddInfo=Сообщение
TemplateDocumentType=ВБК
TemplateDocumentNumber=1
TemplateDocumentDate=2016-01-13
TemplateDocumentName=ВБК
TABLES
Table=EssenceAttachment
UploadJobId=7b8360e9-69ae-34d4-b5e2-b7e60f2a3fdf
FileHash=5C00CCC2734CDD3332D3D4749576E3C1A7DBAF0E7EA74E9FA602413C90A129FA
#
3.8.2.Формат взаимодействия
Взаимодействие: Документ передается из УС в СББОЛ
Инициатор получения справочника: УС
Формат передачи документа на сторону СББОЛ: RequestExchangeMessagesWithBank
Формат предоставления ответа (квитанции) об исполнении документа со стороны СББОЛ:
Response/Tickets
3.8.2.1. Формат отправки документа в СББОЛ
Request/ExchangeMessagesWithBank
Версионност
Элемент
Описание элемента
Тип
Описание типа
Мн.
ь
Запрос УС к СББОЛ
Request
Актуально с
Request
[1]
версии 27
1
Уникальный идентификатор запроса
UUID с
@requestId
UuidSeparated
разделителями в
виде дефисов.
Актуально с
[1]
Набор из 32
версии 27
символов [0-9], [a-
f] и дефисов
2
Идентификатор организации в ДБО (может
UUID с
@orgId
UuidSeparated
быть использован сторонней системой для
разделителями в
дополнительной идентификации)
виде дефисов.
Актуально с
[1]
Набор из 32
версии 27
символов [0-9], [a-
f] и дефисов
3
Номер версии формата обмена
Простой тип XML
@version
xs:string
Актуально с
Schema
[1]
RegEx: "[0-
версии 27
9\.]{1,20}"
4
Система-отправитель
xs:string
Простой тип XML
@sender
RegEx: «[-a-zA-
Schema
Актуально с
Zа-яА-Я0-9:
[1]
версии 27
_]{1,20}ª
5
Система-получатель Если система
xs:string
Простой тип XML
@receiver
получатель СББОЛ, то SBBOL_DBO
RegEx: «[-a-zA-
Schema
[0..1
Актуально с
Zа-яА-Я0-9:
]
версии 27
_]{1,20}ª
6
@protocolVersion
Версия протокола
xs:string
Простой тип XML
[0..1
Актуально с
Schema
]
версии 27
7
Запрос ТК к СББОЛ
Актуально с
ExchangeMessagesWithBank
ExchangeMessag
[1]
версии 27
esWithBank
*.1
@docExtId
UuidSeparated
UUID с
Уникальный* идентификатор документа в
разделителями в
учетной системе (УС) Клиента.
виде дефисов.
Актуально с
*Уникальность контролируется на стороне
[1]
Набор из 32
версии 27
банка
символов [0-9], [a-
f] и дефисов
*.2
@sentForSign
0 - обычная передача на выполнение 1 -
BoolType
Двоичное
[0..1
Актуально с
передано для подписания в ИК
значение: 0 или 1
]
версии 27
*.3
@docExtGuid
Уникальный* идентификатор документа в
xs:string
системе ВК Банка.
*Уникальность контролируется на стороне
банка
[0..1
Добавлено в
Заполняется идентификатором связанного
]
версии 29
документа ВБК
(IntCtrlStatement181I.externalSystemGuid)
Заполняется только для писем по
Ведомостям банковского контроля
*.4
DocData
ComDocData
Актуально с
[1]
версии 27
*.1
@docDate
Дата составления документа
xs:date
Актуально с
[1]
версии 27
*.2
@bankName
Значение
xs:string [min: 1,
Response/OrganizationsInfo/OrganizationsInfo/
max: 255]
[0..1
Актуально с
Branches/Branch/SystemName - системное
]
версии 27
имя подразделения банка, которое
передается в рамках OrganizationsInfo
*.3
@bankNum
Номер подразделения банка получателя
xs:string
[0..1
Изменено в
заявления в ДБО
]
версии 33
В настоящее время не используется
*.4
@initialCard
Идентификатор договора депозита
UuidSeparated
UUID с
разделителями в
виде дефисов.
[0..1
Актуально с
Набор из 32
]
версии 27
символов [0-9], [a-
f] или [A-F] и
дефисов
*.5
@docNum
Номер документа
xs:string [max: 6]
Актуально с
[1]
версии 27
*.6
OrgData
Основные реквизиты организации,
OrgData
Актуально с
[1]
указываемые в документе
версии 27
*.1
@kpp
КПП клиента
KppType
КПП, 9 цифр, 6-я
[0..1
Актуально с
позиция м.б. буква
]
версии 27
лат. буква
*.2
@okato
ОКАТО клиента
OkatoType
ОКАТО, от 1 до 11
[0..1
Актуально с
цифр (иногда
]
версии 27
заполняется нулём)
*.3
@inn
ИНН клиента
InnType
ИНН
юридического или
Актуально с
[1]
физического лица
версии 27
РФ, до 12 цифр
*.4
@orgName
Наименование организации клиента
xs:string [min: 1,
Актуально с
(сокращенное наименование - как в
max: 160]
[1]
версии 27
платежных руб. документах)
*.5
@okpo
ОКПО клиента
OkpoType
ОКПО, от 8 до 10
[0..1
Актуально с
цифр
]
версии 27
*.6
@orgOGRN
ОГРН клиента
OgrnType
ОГРН, от 13 0 до
Изменено в
[0..1]
15 цифр
версии 33
*.7
@clientNameIntheGenitiv
Cокращенное наименование организации в
xs:string [min: 1,
[0..1
Актуально с
e
родительном падеже
max: 255]
]
версии 27
*.8
@fullName
Полное наименование
xs:string [min: 1,
[0..1
Актуально с
max: 500]
]
версии 27
*.9
@internationalName
Наименование на иностранном языке (при
xs:string [min: 1,
[0..1
Актуально с
наличии)
max: 500]
]
версии 27
*.10 @opf
Наименование на иностранном языке (при
xs:string [min: 1,
[0..1
Актуально с
наличии)
max: 255]
]
версии 27
*.11 @datOGRN
Дата регистрации
xs:date
[0..1
Актуально с
]
версии 27
*.12 orgAddress
Юридический адрес организации Клиента
xs:string [min: 1,
Простой тип XML
[0..1
Изменено в
@orgAddress
max: 1024]
Schema
]
версии 29
*.13 resident
Резидентность организации по справочнику
xs:string [min: 1,
Простой тип XML
[0..1
Изменено в
@resident
организаций
max: 255]
Schema
]
версии 29
*.7
AuthPers
Уполномоченный сотрудник организации
AuthPers
[0..1
Актуально с
клиента
]
версии 27
*.1
Name
Имя ФИО уполномоченного сотрудника
xs:string [min: 1,
[0..1
Изменено в
организации клиента
max: 60]
]
версии 31
*.2
Telfax
Номер телефона, факса уполномоченного
xs:string [min: 1,
[0..1
Изменено в
сотрудника организации клиента
max: 40]
]
версии 30
[1]
*.3
Position
Должность уполномоченного сотрудника
xs:string [min: 1,
Простой тип XML
[0..1
Изменено в
организации клиента
max: 1024]
Schema
]
версии 31
Type
Тип
xs:string
[0..1
Изменено в
]
версии 30
*.5
Theme
Тема
xs:string
Актуально с
[1]
версии 27
*.6
AddInfo
Текст сообщения
AddInfo
[0..1
Актуально с
[min: 1, max:
]
версии 27
4000]
*.7
TemplateDocumentType
Тип документа
xs:string [min: 1,
Актуально с
[1]
max: 350]
версии 27
*.8
TemplateDocumentNumber
Номер документа
Max6Text
[1]
Изменено в
[0..1
версии 29
]
*.9
TemplateDocumentDate
Дата документа
xs:date
[1]
Изменено в
[0..1
версии 29
]
*.10
TemplateDocumentName
Тип документа
xs:string [min: 1,
[1]
Изменено в
max: 255]
[0..1
версии 29
]
*.11
LinkedDocs
Связанные документы, например, реестр
LinkedDocs
Связанные
[0..1
Изменено в
пополнения корп. карт, зарплатные
LinkedDocsEM
документы
]
версии 29
ведомости и т.п.
*.1
LDoc
Документ, связанный с поручением
[0..n
Актуально с
]
версии 27
*.1
@type
Тип связанного документа
xs:string [min: 1,
[0..1
Актуально с
max: 50]
]
версии 27
*.2
@docExtId
Уникальный* идентификатор документа в
UuidSeparated
UUID с
учетной системе (УС) Клиента.
разделителями в
виде дефисов.
*Уникальность контролируется на стороне
[0..1
Изменено в
Набор из 32
банка
]
версии 33
символов [0-9], [a-
ОБЯЗАТЕЛЕН ДЛЯ ЗАПОЛНЕНИЯ, ЕСЛИ
f] и дефисов
НЕ ЗАПОЛНЕН @docId
*.3
@docId
Глобальный идентификатор документа
UuidSeparated
UUID с
разделителями в
ОБЯЗАТЕЛЕН ДЛЯ ЗАПОЛНЕНИЯ, ЕСЛИ
виде дефисов.
[0..1
Изменено в
НЕ ЗАПОЛНЕН @docExtId
Набор из 32
]
версии 33
символов [0-9], [a-
f] и дефисов
*.4
Params
Дополнительные параметры связанного с
Params
Множество
поручением документа
параметров
[0..1
Актуально с
произвольного
]
версии 27
вида
*.1
Param
Параметр
Param
Отдельный
параметр
[1..n
Актуально с
произвольного
]
версии 27
вида
*.1
@name
Название параметра
xs:string [min: 1,
Актуально с
[1]
max: 255]
версии 27
*.2
@value
Значение параметра
xs:string [min: 1,
Актуально с
[1]
max: 255]
версии 27
*.12
BigFileAttachments
Приложенные к документу отсканированные
BigFileAttachm
[0..1
Добавлено в
образы-вложения - для АС БФ
ents
]
версии 29
*.1
BigFileAttachment
Файл в БФ
BigFileAttachm
[1..n
Добавлено в
ent
]
версии 29
*.1
UploadJobId
Идентификатор задания на загрузку файла в
UuidSeparated
UUID с
БФ
разделителями в
виде дефисов.
Добавлено в
[1]
Набор из 32
версии 29
символов [0-9], [a-
f] и дефисов
*.2
Description
Пользовательское описание файла вложения
xs:string [max:
Простой тип XML
[0..1
Добавлено в
1024]
Schema
]
версии 29
*.13
Attachments
Приложенные к документу отсканированные
AttachmentsTyp
Приложенные к
[0..1
Исключено в
образы-вложения
e
документу файлы
]
версии 32
*.1
Attachment
Отдельное вложение
[1..n
Исключено в
]
версии 32
*.1
Type
Тип файла вложения
xs:string
[0..1
Исключено в
]
версии 32
*.2
AttachmentName
Имя файла вложения
xs:string [min: 1,
[0..1
Исключено в
max: 255]
]
версии 32
[1]
*.3
Description
Пользовательское описание файла вложения
xs:string [min: 1,
[0..1
Исключено в
max: 1024]
]
версии 32
*.4
Date
Дата добавления вложения
xs:date
[0..1
Исключено в
]
версии 32
*.5
Size
Размер вложения
xs:int
[0..1
Исключено в
]
версии 32
*.6
Body
В бинарном представлении в сжатом и
xs:base64Binary
Исключено в
[1]
несжатом виде
версии 32
*.7
AttachmentSign
Подпись вложения
AttachmentSign
Подпись вложения
[0..1
Исключено в
]
версии 32
*.1
Sign
ЭП клиента
DigitalSign
[1..n
Исключено в
]
версии 32
*.1
Issuer
Идентификатор поставщика сертификата
xs:string [min: 1,
Например, " issuer="E=IdleCA, C=RU, S=Idle
max: 1024]
Исключено в
[1]
CA, L=Idle CA, O=Idle CA, OU=Idle CA,
версии 32
CN=Idle CA" "
*.2
SN
Серийный номер сертификата
xs:string [min: 1,
Исключено в
[1]
max: 255]
версии 32
*.3
Value
Значение ЭП
xs:base64Binary
Исключено в
[1]
версии 32
*.4
DigestName
Имя схемы подписи
xs:string
[0..1
Исключено в
]
версии 32
*.5
DigestVersion
Версия схемы подписи
xs:string
[0..1
Исключено в
]
версии 32
*.6
PcPropHash
Уникальные свойства компьютера,
xs:string
осуществляющего установку сеанса связи,
SHA 512 от значения PcProp. Содержит
следующие параметры:
∙ UUID
∙ Идентификатор процессора
∙ Серийный номер BIOS
[0..1
Исключено в
∙ Серийный номер жесткого диска.
]
версии 32
Передаваться должны в виде строки с
разделителем «;ª.
Формат передачи: «UUID;Идентификатор
процессора;Серийный номер
BIOS;Серийный номер жесткого дискаª.
*.7
Fraud
Данные для fraud-мониторинга. Информация
Fraud
[0..1
Исключено в
о подписи
]
версии 32
*.1
Login
Логин
xs:string
Исключено в
[1]*
версии 32
*.2
TokenInfo
Данные токена Отображение в запросе
xs:string
(разделитель «;ª):
TOKEN;IС1_A10D0010L_C1_VT01KA02;201
2-04-13 09:44:59.003;TLS00041485B;100;1
Отображение в интерфейсе: 1. Тип токена:
Исключено в
TOKEN 2. Информация о конфигурации
[1]*
версии 32
токена: IС1_A10D0010L_C1_VT01KA02 3.
Дата конфигурации: 2012-04-13 09:44:59.003
4. Серийный номер токена: TLS00041485B 5.
Номер сборки токена: 100 6. Текущая
учетная запись (ПИН): 1
*.3
HttpAcceptL
Список поддерживаемых естественных
xs:string
anguage
языков Требуется указать локализацию ОС
компьютера, на котором установлен БК,
Исключено в
Например, для английской локализации в
[1]*
версии 32
качестве значения атрибута указывается - 'en-
US', для русской локализации указывается -
'ru-RU'.
*.4
IpMACAddr
IP и Mac адреса компьютера отправившего
xs:string
Исключено в
esses
или подписавшего. Формат:
[1]*
версии 32
«remoteIP;remoteMac;ip1;mac1;ip2;mac2ª
*.5
GeolocationI
Геопозиционирование компьютера
xs:string
nfo
отправившего или подписавшего. Формат:
Исключено в
[1]*
«Longitude;Latitude;HorizontalAccuracy;Times
версии 32
tamp;Statusª
*.6
PcProp
Уникальные свойства компьютера
xs:string
отправившего или подписавшего. Формат:
Исключено в
«UUID;Идентификатор
[1]*
версии 32
процессора;Серийный номер
BIOS;Серийный номер жесткого дискаª.
*.7
DevicePrint
Закодированное значение, полученное из
xs:string [min: 1]
[0..1
Исключено в
скрипта "rsa.js" (Фрод).
]
версии 32
*.8
Order
Очередность наложения подписи (какая
xs:int
подпись когда была наложена) в случае
[0..1
Исключено в
наложения подписи и удаления ее, порядок
]
версии 32
должен сдвигаться соответственно влево
*.9
SignDate
Дата/Время подписи Пример: 2012-04-13
xs:dateTime
[0..1
Исключено в
09:44:59.003
]
версии 32
*Если нет технической возможности предоставить данные раздела фрод - мониторинга, то поле можно передавать cо значением «nullª
3.8.3.Особенности получения статусов для обработки из
СББОЛ
Информация об обработке документа доставляется в УС:
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/Ticke
Актуально
t/Info/@statusStateCod
INVALIDEDS
с версии 27
e
Проверки документа
Response/Tickets/Ticke
привели к неуспешному
INVALIDEDS
Может быть
t/Info/MsgFromBank/
1.
результату
(АСП/ЭП не
передано
(статус окончательный -
@message
Актуально
верна)
сообщение о том,
не успешно)
с версии 27
что подлинность
документа не
подтверждена
Проверки документа
VALIDEDS
Response/Tickets/Ticke
Актуально
2.
привели к успешному
(АСП/ЭП
t/Info/@statusStateCod
VALIDEDS
с версии 27
результату
верна)
e
ЭД был подписан
PARTLY_SIG
Response/Tickets/Ticke
PARTLY_SIGNE
неполным набором
NED
t/Info/@statusStateCod
D
Актуально
3.
подписей.
(Частично
e
с версии 27
подписан)
Response/Tickets/Ticke
Актуально
REQUISITE_ERR
t/Info/@statusStateCod
с версии 27
OR
Логические проверки
e
REQUISITE_
документа привели к
Response/Tickets/Ticke
Должны
ERROR
4.
неуспешному результату
t/Info/MsgFromBank/
передаваться
(Ошибка
(статус окончательный -
Актуально
@message
сообщения об
реквизитов)
не успешно)
с версии 27
ошибках,
выявленных на
стороне Банка
Документ доставлен на
Response/Tickets/Ticke
сторну Банка, но еще не
t/Info/@statusStateCod
Актуально
DELIVERED
5.
проходил проверку
DELIVERED
e
с версии 27
(Доставлен)
подписи и реквизитов
SUBMITTED
Документ находится в
Response/Tickets/Ticke
SUBMITTED
Актуально
6.
(Представлен
обработке на стороне
t/Info/@statusStateCod
с версии 27
)
банка
e
Актуально
Response/Tickets/Ticke
ACCEPTED
с версии 27
t/@statusStateCode
Прием документа на
Response/Tickets/Ticke
Дата поступления
ACCEPTED
7.
стороне Банка
t/Info/BankDate/@recei
в Банк
(Принят)
Актуально
ptDate
плательщика и
с версии 27
принятия в
обработку
Актуально
Response/Tickets/Ticke
DECLINED_BY_
с версии 27
t/@statusStateCode
ABS
Response/Tickets/Ticke
Актуально
DECLINED_B
Сообщение из
Отказ платежа
t/Info/MsgFromBank/
с версии 27
Y_ABS
Банка
8.
(статус окончательный -
@message
(Отказан
не успешно)
АБС)
Response/Tickets/Ticke
Реквизиты
Актуально
t/Info/MsgFromBank/
ответственного
с версии 27
@author
сотрудника Банка,
если требуется
Актуально
Response/Tickets/Ticke
DECLINED_BY_
с версии 27
t/@statusStateCode
CFE
Response/Tickets/Ticke
Актуально
Сообщение из
Отказ платежа
DECLINED_B
t/Info/MsgFromBank/
с версии 27
Банка
9.
(статус окончательный -
Y_CFE
@message
не успешно)
(Отказан ВК)
Response/Tickets/Ticke
Реквизиты
Актуально
t/Info/MsgFromBank/
ответственного
с версии 27
@author
сотрудника Банка,
если требуется
Response/Tickets/Ticke
Актуально
t/Info/@statusStateCod
EXPORTED
с версии 27
e
Response/Tickets/Ticke
Дата поступления
Документ выгружен в
t/Info/BankDate/@recei
в Банк
Актуально
EXPORTED
10.
АБС для дальнейшей
ptDate
плательщика и
с версии 27
(Выгружен)
обработки
принятия в
обработку
Response/Tickets/Ticke
Сообщение из
Актуально
t/Info/MsgFromBank/
Банка, если
с версии 27
@message
требуется
Response/Tickets/Ticke
Реквизиты
Актуально
t/Info/MsgFromBank/
ответственного
с версии 27
@author
сотрудника Банка,
если требуется
Актуально
Response/Tickets/Ticke
ACCEPTED_BY_
ACCEPTED_
с версии 27
t/@statusStateCode
ABS
Документ принят на
BY_ABS
11.
обработку в АБС
Response/Tickets/Ticke
(Принят
Актуально
Сообщение из
t/Info/MsgFromBank/
АБС)
с версии 27
Банка
@message
Электронный документ
Response/Tickets/Ticke
EXPORT_ER
не был выгружен в АБС
t/Info/@statusStateCod
Актуально
ROR
12.
Банка
EXPORT_ERROR
e
с версии 27
(Ошибка
(статус окончательный -
экспорта)
не успешно)
Response/Tickets/Ticke
Актуально
t/Info/@statusStateCod
TRIED_BY_CFE
с версии 27
e
Response/Tickets/Ticke
Дата поступления
t/Info/BankDate/@recei
в Банк
Актуально
ptDate
плательщика и
с версии 27
принятия в
TRIED_BY_C
обработку
Документ «Взят в
FE
13.
Response/Tickets/Ticke
Сообщение из
работуª в АБС
Актуально
(Проверяется
t/Info/MsgFromBank/
Банка, если
с версии 27
ВК)
@message
требуется
Response/Tickets/Ticke
Сообщение из
Актуально
t/Info/MsgFromBank@
банка
с версии 27
message
Response/Tickets/Ticke
Ответственный
Актуально
t/Info/MsgFromBank/
исполнитель
с версии 27
@author
Response/Tickets/Ticke
DELAYED
Актуально
t/Info/@statusStateCod
с версии 27
e
Response/Tickets/Ticke
Сообщение из
Актуально
DELAYED
Приостановка обработки
t/Info/MsgFromBank/
Банка, если
14.
с версии 27
(Приостанов
документа
@message
требуется
лен)
Response/Tickets/Ticke
Реквизиты
Актуально
t/Info/MsgFromBank/
ответственного
с версии 27
@author
сотрудника Банка,
если требуется
Подтверждение
ACCEPTED_
Response/Tickets/Ticke
ACCEPTED_BY_
Актуально
15.
исполнения платежа
BY_CFE
t/Info/@statusStateCod
CFE
с версии 27
(статус окончательный-
(Принят ВК)
e
успешно)
Response/Tickets/Ticke
Дата обработки
Актуально
t/Info/AddInfo/
с версии 27
CurrControlInfo/Value
Date
Response/Tickets/Ticke
Сообщение из
Актуально
t/Info/MsgFromBank@
банка
с версии 27
message
Response/Tickets/Ticke
Ответственный
Актуально
t/Info/MsgFromBank/
исполнитель
с версии 27
@author
Response/Tickets/Ticke
Наименование
t/Info/AddInfo/
файла
Актуально
CertifRequestQualified/
с версии 27
Attachments/Attachmen
t/ AttachmentName
Response/Tickets/Ticke
Вложенный файл
t/Info/AddInfo/
Актуально
CertifRequestQualified/
с версии 27
Attachments/Attachmen
t/ Body
Актуально
Description
Описание файла
с версии 27
вложения
CHECKERRO
ЭД не прошел
Response/Tickets/Ticke
CHECKERROR
R (Ошибка
логические контроли
t/@statusStateCode
контроля)
Системы ДБО на
стороне клиента при
Актуально
16.
сохранении
с версии 27
(отрицательный
результат) (статус
окончательный- не
успешно)
CREATED
ЭД сформирован
Response/Tickets/Ticke
CREATED
(Создан)
пользователем на
t/@statusStateCode
стороне клиента, при
Актуально
17.
этом документ прошел
с версии 27
логические контроли с
положительным
результатом.
SIGNED
ЭД был подписан
Response/Tickets/Ticke
SIGNED
Актуально
18.
(Подписан)
достаточным набором
t/@statusStateCode
с версии 27
подписей.
3.9. Письмо для целей ВК (из банка)
3.9.1.Общие сведения
Порядок предоставления документов со стороны СББОЛ следующий:
Если запрос на предоставление документов «Письмо для целей ВК (из Банка)ª
направляется
первый раз, то:
o В запросе Request/Incoming не передается дата.
o Со стороны СББОЛ вернется сообщение, содержащее все документы «Письма для целей
ВК (из Банка)ª, которые не были переданы в УС ранее.
В последующие разы:
o Направляется сообщение Request/Incoming, где должен быть указан атрибут
@lastIncomingTime
(равный дате начала формирования последнего запроса
Request/Incoming, переданный на предыдущем этапе в атрибуте Response@createTime).
o Со стороны СББОЛ должно быть передано сообщение, в котором будут содержаться
документы «Письма для целей ВК (из Банка)ª за дату больше указанной в Request/Incoming
@lastIncomingTime.
3.9.1.1. Дайджест отправки запроса на получение писем
для целей ВК из банка
Подпись документа на стороне УС:
Подписывается какой-либо одной подписью:
Единственная подпись или
Первая подпись или
Вторая подпись
Дайджест: формируется
Ключевой буфер (дайджест):
Для формирования электронной подписи из документа формируется строковая последовательность
(ключевой буфер или дайджест), включающая все значимые данные документа, поля, содержащие
пустые значения, не включаются.
Ключевой буфер (дайджест) для подписания ЭП образует строковый массив в кодировке UTF-8,
Отдельные записи массива разделены символом перевода строки. В качестве символа перевода
строки используется 0x0A.
При наличии в мультистроковых данных последовательности из двух символов перевода строки
CR+LF (ASCII 0x0D 0x0A) необходимо удалять символ возврата каретки CR (ASCII 0x0D) и
оставлять только символ подачи строки LF (ASCII 0x0A).
Для отделения некоторых видов данных друг от друга в дайджест включены «заголовкиª, такие как
ATTRIBUTES. Эти
«заголовкиª не несут информации исходного документа, а служат для
внутренней организации данных в дайджесте. «Заголовкиª указываются в отдельной строке, где
кроме них ничего нет.
Формат дайджеста:
№
Наименование
Описание
Пример значения
Версионность
п/п
поля
1.
ATTRIBUTES
Актуально с
версии 27
<Наименование поля>=<Значение поля>, например
OrgId=963084ba-7079-4b9d-bbab-c4972dee82d9
2.
OrgId
Идентификатор
963084ba-7079-4b9d-bbab-
Актуально с
организации в ДБО
c4972dee82d9
версии 27
3.
RequestId
Идентификатор
163084ba-7079-4b9d-bbab-
Актуально с
запроса в УС
c4972dee82d2
версии 27
клиента
4.
TABLES
Разделитель строк
Актуально с
таблицы - #
версии 27
5.
Table=Accounts
Актуально с
версии 27
6.
Value
Счет
40666840277777777777
Актуально с
версии 27
7.
Bic
БИК счета
044525225
Актуально с
версии 27
Пример.
ATTRIBUTES
OrgId=8b8b38fa-c399-4e9e-ac77-1721556b709c
RequestId=3D948067-66F2-496E-B657-2ED46E6DAB8A
TABLES
Table=Accounts
Value=123
Bic=000555
#
Value=124
Bic=000555
#
3.9.1.2. Дайджест передачи клиенту письма для целей ВК
из банка
Запрос данных:
Подпись документа на стороне УС: нет
Дайджест: не формируется
Ответ с данными:
Подпись документа на стороне СББОЛ: Технологическая подпись
Дайджест: формируется
Примечание: При получении на стороне УС из СББОЛ персональных данных - на стороне УС
должен быть активный банковский сертификат, позволяющий проверить банковскую подпись
Ключевой буфер (дайджест):
Для формирования электронной подписи из документа формируется строковая последовательность
(ключевой буфер или дайджест), включающая все значимые данные документа, поля, содержащие
пустые значения, не включаются.
Ключевой буфер (дайджест) для подписания ЭП образует строковый массив в кодировке UTF-8,
Отдельные записи массива разделены символом перевода строки. В качестве символа перевода
строки используется 0x0A.
При наличии в мультистроковых данных последовательности из двух символов перевода строки
CR+LF (ASCII 0x0D 0x0A) необходимо удалять символ возврата каретки CR (ASCII 0x0D) и
оставлять только символ подачи строки LF (ASCII 0x0A).
Если наполнение всех таблиц блока TABLES пустое, то и сам TABLES в дайджест не включается
Если наполнение какой-то таблицы блока TABLES пустое, то Table=TableName не
включать в
дайджест
Формат дайджеста:
№
Версионно
Наименование поля
Описание
Пример значения
п/п
сть
ATTRIBUTES
1.
Актуально
<Наименование поля>=<Значение поля>, например:
с версии 27
OrgId=963084ba-7079-4b9d-bbab-c4972dee82d9
2.
FIELDS
<Наименование поля>=<Значение поля>, например:
Актуально
BeginDate=2011-11-24
с версии 27
После последней строки НЕ делать перевод строки
Дата составления документа
2017-01-28
Актуально
3.
DocData.DocDate
с версии 27
Номер документа
123
Актуально
4.
DocData.DocNumber
с версии 27
Наименование подразделения банка
Банк Name
Актуально
5.
DocData.BankName
получателя заявления
с версии 27
Тип письма
Досыл уточненных
Актуально
6.
Type
реквизитов
с версии 27
Тема письма
Тема
Актуально
7.
Theme
с версии 27
Текст сообщения
Текст письма
Актуально
8.
AddInfo
с версии 27
9.
TABLES
Разделитель строк таблицы - #
Актуально
с версии 27
10.
Table=Attachments
Актуально
с версии 27
Имя файла вложения
f1311fff.TXT
11.
Актуально
Attachment.Attachme
с версии 27
ntName
Пользовательское описание файла
Описание файла
12.
Актуально
Attachment.Descriptio
вложения
с версии 27
n
Вложение в бинарном
VGVzdA==
13.
Attachment.Body
Актуально
представлении в сжатом и
с версии 27
несжатом виде
Пример дайджеста
ATTRIBUTES
FIELDS
DocData.DocDate=2017-01-28
DocData.DocNumber=7
DocData.BankName=ДО №1769 Московского банка ПАО Сбербанк
Type=Результаты обработки документов валютного контроля
Theme=Валютным контролем обработаны документы
AddInfo=ВБК № 4 от 28.01.2017 Принят ВК
TABLES
Table=Attachments
Attachment.AttachmentName = f1311fff.TXT
Attachment.Description = Описание файла
Attachment.Body = VGVzdA
#
3.9.2.Формат взаимодействия
Взаимодействие: Документ передается из СББОЛ в УС
Инициатор получения документа: УС
Формат передачи документа на сторону УС: Response/ExchangeMessagesFromBank
Формат, в котором запрашиваются документы со стороны УС: Request/Incoming
3.9.2.1.
Формат отправки запроса на получение писем для
целей ВК из банка
Request/Incoming
Версионно
Элемент
Описание элемента
Тип
Описание типа
Мн.
сть
Request
Запрос УС к СББОЛ
Request
Актуально
[1]
с версии 27
1
@requestId
Уникальный
UuidSepa
UUID с
идентификатор запроса
rated
разделителями
в виде
Актуально
дефисов.
[1]
с версии 27
Набор из 32
символов [0-9],
[a-f] и дефисов
2
@orgId
Идентификатор
UuidSepa
UUID с
организации в ДБО
rated
разделителями
(может быть использован
в виде
Актуально
сторонней системой для
дефисов.
[1]
с версии 27
дополнительной
Набор из 32
идентификации)
символов [0-9],
[a-f] и дефисов
3
@version
Номер версии формата
xs:string
Простой тип
обмена
RegEx:
XML Schema
Актуально
"[0-
[1]
с версии 27
9\.]{1,20}
"
4
@sender
Система-отправитель
xs:string
Простой тип
RegEx:
XML Schema
«[-a-zA-
Актуально
[1]
Zа-яА-
с версии 27
Я0-9:
_]{1,20}ª
5
@receiver
Система-получатель Если
xs:string
Простой тип
система получатель
RegEx:
XML Schema
СББОЛ, то SBBOL_DBO
«[-a-zA-
[0..1
Актуально
Zа-яА-
]
с версии 27
Я0-9:
_]{1,20}ª
6
@protocolVersion
Версия протокола
xs:string
Простой тип
[0..1
Актуально
XML Schema
]
с версии 27
7
Incoming
Запрос о получении
данных, подготовленных
дляУС ("ночных
Актуально
[1]
выписок", выписок,
с версии 27
тикетов после отказа в
РС, новостей)
Идентификатор
*.1
@correspondentDi
xs:long
Простой тип
последнего обновления
Актуально
ctStepId
[0..1
XML Schema
справочника
с версии 27
]
контрагентов
Идентификатор
*.2
@bicDictStepId
xs:long
Простой тип
Актуально
[0..1
последнего обновления
XML Schema
с версии 27
]
справочника БИК
Дата и время последнего
*.3
@lastIncomingTim
xs:dateTi
Простой тип
запроса Incoming(всегда
Актуально
e
me
[0..1
XML Schema
идёт во временной зоне
с версии 27
]
«Москваª)
Идентификатор
*.4
@beneficiarDictSte
xs:long
Простой тип
последнего обновления
Актуально
pId
[0..1
XML Schema
справочника
с версии 27
]
бенефициаров
Признак того, что
*.5
@includeRZKPay
BoolType
Простой тип
необходимо выгружать
Актуально
DocsRu
[0..1
XML Schema
рублевые платежные
с версии 27
]
поручения
Признак того, что
*.6
@includeRZKPay
BoolType
Простой тип
необходимо выгружать
Актуально
DocsCurr
[0..1
XML Schema
валютные платежные
с версии 27
]
поручения
Признак того, что
*.7
@includeRZKSala
BoolType
Простой тип
[0..1
Актуально
необходимо выгружать
ryDocs
XML Schema
]
с версии 27
зарплатную ведомость
Признак того, что
*.8
@includeStatement
BoolType
Простой тип
[0..1
Актуально
необходимо выгружать
s
XML Schema
]
с версии 27
выписки
Признак того, что
*.9
@includeExchange
BoolType
Простой тип
[0..1
Актуально
необходимо выгружать
MessageFromBank
XML Schema
]
с версии 27
сообщения из банка
Признак того, что
*.1
@includeNews
BoolType
Простой тип
Актуально
[0..1
необходимо выгружать
0
XML Schema
с версии 27
]
новости
Признак того, что
*.1
@includeLetterFro
BoolType
Простой тип
Актуально
[0..1
необходимо выгружать
1
mBanks
XML Schema
с версии 27
]
сообщения из банка
Признак того, что
*.1
@includePayReque
BoolType
Простой тип
Актуально
[0..1
необходимо выгружать
2
sts
XML Schema
с версии 27
]
платежные требования
Признак того, что
*.1
@includeChanged
BoolType
Простой тип
необходимо выгружать
3
Docs
XML Schema
информацию о
Актуально
[0..1
документах, принявших,
с версии 27
]
либо изменивших
финальный статус.
Признак того, что
*.1
@includeOrgSettin
BoolType
Простой тип
необходимо выгружать
Актуально
4
gs
[0..1
XML Schema
информацию об
с версии 27
]
организации
Признак того, что
*.1
@includeIntCtrlSt
BoolType
Простой тип
необходимо выгружать
5
atement
XML Schema
Добавлено
[0..1
ведомости банковского
в версии 28
]
контроля по контрактам,
кредитным договорам
Признак того, что
*.1
@includeDealPass
BoolType
Простой тип
необходимо выгружать
6
Con138I
[0..1
Актуально
XML Schema
паспорта сделок по
]
с версии 27
контракту
Признак того, что
*.1
@includeDealPass
BoolType
Простой тип
необходимо выгружать
7
Cred138I
[0..1
Актуально
XML Schema
паспорта сделок по
]
с версии 27
кредиту
Признак того, что
*.1
@includeCurrency
BoolType
Простой тип
необходимо выгружать
8
Notice
XML Schema
уведомления о
[0..1
Актуально
поступлении денежных
]
с версии 27
средств на транзитный
валютный счет
Идентификатор
*.1
dictsForDepositsDi
BoolType
Простой тип
последнего обновления
Актуально
9
ctStepId
[0..1
XML Schema
справочника
с версии 27
]
актуальных ставок
*.2
cardDepositDictSte
Идентификатор
BoolType
Простой тип
последнего обновления
Актуально
0
pId
[0..1
XML Schema
справочника карточек
с версии 27
]
депозита
Идентификатор
*.2
cardPermBalance
BoolType
Простой тип
последнего обновления
Актуально
1
DictStepId
[0..1
XML Schema
справочника карточек
с версии 27
]
НСО
Счёта, подготовленные
*.2
Accounts
выписки, по которым
2
нужно выгрузить. Для
счетов, не вошедших в
Актуально
[0..1
список, предоставлять
с версии 27
]
выписки по запросу с
данным элементом не
требуется
*.1
Account
Acc,
расширен
ие
AccNumT
[1..1
Актуально
ype
000]
с версии 27
(xs:string[
20]
RegEx:
[0-9])
*.1
@bic
БИК
BicType
БИК, 9 цифр
Актуально
[1]
с версии 27
*.2
@docNum
Номер документа
xs:string [
[0..1
Изменено в
max: 6]
]
версии 29
*.23
Orgs
Организации, письма по
[0..1
Актуально
которым нужно
]
с версии 27
выгрузить. Если список
пуст, возвращаются
только письма по
организации, указанной в
верхнем элементе
*.1
Org
UuidSepa
UUID с
[1..1
Актуально
rated
разделителями
000
с версии 27
в виде
дефисов.
Набор из 32
символов [0-9],
[a-f] или [A-F]
и дефисов
3.9.2.2. Формат отправки документа в УС Клиента
Response/ExchangeMessagesFromBank
Версионнос
Элемент
Описание элемента
Тип
Описание типа
Мн.
ть
Ответ СББОЛ на запрос УС
Response
Response
Актуально
[1]
с версии 27
Дата и время формирования ответа
Простой тип XML
1
@createTime
xs:dateTime
[0..1
Актуально
местному по времени запрашивающего
Schema
]
с версии 27
сервера, с указанием его часового пояса
Уникальный идентификатор ответа
UUID с
2
@responseId
UuidSeparated
разделителями в
[0..1
Актуально
виде дефисов. Набор
]
с версии 27
из 32 символов [0-
9], [a-f] и дефисов
Идентификатор запроса, в результате
UUID с
3
@requestId
UuidSeparated
которого был сформирован данный ответ
разделителями в
[0..1
Актуально
виде дефисов. Набор
]
с версии 27
из 32 символов [0-
9], [a-f] и дефисов
Номер версии формата обмена
Простой тип XML
4
@version
xs:string
[0..1
Актуально
Schema
RegEx: "[0-
]
с версии 27
9\.]{1,20}"
Система-отправитель
xs:string
Простой тип XML
5
@sender
[0..1
Актуально
RegEx: «[-a-zA-Zа-
Schema
]
с версии 27
яА-Я0-9: _]{1,20}ª
Система-получатель Если система
xs:string
Простой тип XML
6
@receiver
[0..1
Актуально
получатель СББОЛ, то SBBOL_DBO
RegEx: «[-a-zA-Zа-
Schema
]
с версии 27
яА-Я0-9: _]{1,20}ª
ExchangeMessagesFr
[0..1
Актуально
7
ExchangeMessagesFromBank
Письмо для целей ВК (из банка)
omBank
]
с версии 27
Письмо для целей ВК (из банка)
*.1
ExchangeMessagesFromBank
ExchangeMessagesFr
[0..n
Изменено в
ExchangeMessageFromBank
omBank
]
версии 29
UUID с
*.1
@docExtId
UuidSeparated
Уникальный* идентификатор документа в
разделителями в
учетной системе (УС) Клиента.
Актуально
виде дефисов. Набор
[1]
*Уникальность контролируется на стороне
с версии 27
из 32 символов [0-
банка
9], [a-f] и дефисов
Уникальный* идентификатор документа в
*.2
@docExtGuid
xs:string
системе ВК Банка.
[0..1
Добавлено
*Уникальность контролируется на стороне
]
в версии 29
банка
Идентификатор организации в СББОЛ
UUID с
*.3
@orgId
UuidSeparated
разделителями в
[0..1
Актуально
виде дефисов. Набор
]
с версии 27
из 32 символов [0-
9], [a-f] и дефисов
Общие реквизиты документа ДБО
*.4
DocData
ComDocData
[0..1
Актуально
]
с версии 27
Дата составления документа
Простой тип XML
*.1
@docDate
xs:date
Актуально
[1]
Schema
с версии 27
Номер документа
Простой тип XML
*.2
@docNum
xs:string [max: 6]
Актуально
Schema
[1]
с версии 27
Наименование подразделения банка
Простой тип XML
*.3
@bankName
xs:string [min: 1,
[0..1
Актуально
получателя заявления
Schema
max: 255]
]
с версии 27
Номер подразделения банка получателя
Простой тип XML
*.4
@bankNum
xs:string
[0..1
Актуально
заявления в ДБО
Schema
]
с версии 27
Обязательно для прочтения:
*.5
@requiredForRead
BoolType
Актуально
[1]
0 - нет, 1 - да
с версии 27
Основные реквизиты организации,
*.6
OrgData
OrgData
[0..1
Актуально
указываемые в документе
]
с версии 27
КПП клиента
КПП, 9 цифр
*.1
@kpp
KppType
[0..1
Актуально
]
с версии 27
ОКАТО клиента
ОКАТО, от 1 до 11
*.2
@okato
OkatoType
[0..1
Актуально
цифр (иногда
]
с версии 27
заполняется нулём)
ИНН клиента
ИНН юридического
*.3
@inn
InnType
или физического
[0..1
Актуально
лица РФ, до 12
]
с версии 27
цифр
Наименование организации клиента
Простой тип XML
*.4
@orgName
xs:string [min: 1,
Актуально
(сокращенное наименование - как в
Schema
[1]
max: 160]
с версии 27
платежных руб. документах)
ОКПО клиента
ОКПО, от 8 до 10
*.5
@okpo
OkpoType
[0..1
Актуально
цифр
]
с версии 27
ОГРН клиента
*.6
@orgOGRN
OgrnType
ОГРН, от 13 0 до 15
Изменено в
[0..1]
цифр
версии 33
Уполномоченный сотрудник организации
*.6
AuthPers
AuthPers
[0..1
Актуально
клиента
]
с версии 27
Имя ФИО уполномоченного сотрудника
Простой тип XML
*.1
Name
xs:string
[0..1
Изменено в
организации клиента
Schema
]
версии 31
Номер телефона, факса уполномоченного
Простой тип XML
*.2
Telfax
xs:string
[0..1
Актуально
сотрудника организации клиента
Schema
]
с версии 27
Тип
Простой тип XML
*.5
Type
xs:string
[0..1
Актуально
Schema
]
с версии 27
Тема
Простой тип XML
*.6
Theme
xs:string
[0..1
Актуально
Schema
]
с версии 27
Текст сообщения
*.7
AddInfo
AddInfo
[0..1
Актуально
]
с версии 27
История сообщений
*.8
MessageHistory
xs:string [max: 4000]
[0..1
Добавлено
]
в версии 29
Приложенные к документу
Приложенные к
*.9
Attachments
AttachmentsType
отсканированные образы-вложения
документу
[0..1
Актуально
отсканированные
]
с версии 27
образы-вложения
Отдельное вложение
*.1
Attachment
[0..n
Актуально
]
с версии 27
Имя файла вложения
Простой тип XML
*.1
AttachmentName
xs:string [min: 1,
[0..1
Актуально
Schema
max: 64]
]
с версии 27
Пользовательское описание файла
Простой тип XML
*.2
Description
xs:string [min: 1,
[0..1
Актуально
вложения
Schema
max: 1024]
]
с версии 27
В бинарном представлении в сжатом и
Простой тип XML
*.3
Body
xs:base64Binary
[0..1
Актуально
несжатом виде
Schema
]
с версии 27
Размер вложенного файла в байтах
Простой тип XML
*.4
FileSize
xs:long
[0..1
Актуально
Schema
]
с версии 27
Дата создания файла
Простой тип XML
*.5
FileDate
xs:dateTime
[0..1
Актуально
Schema
]
с версии 27
Связанные документы, например, реестр
LinkedDocs
Связанные
*.10LinkedDocs
[0..1
Изменено в
пополнения корп. карт, зарплатные
LinkedDocsEM
документы
]
версии 29
ведомости и т.п.
Документ, связанный с поручением
*.1
LDoc
[0..n
Актуально
]
с версии 27
Тип связанного документа
Простой тип XML
*.1
@type
xs:string [min: 1,
[0..1
Актуально
Значение можно найти в Части 1, п. «Типы
Schema
max: 50]
]
с версии 27
связанных документовª
*.2
@docExtId
Уникальный* идентификатор документа в
UuidSeparated
UUID с
[0..1
Изменено в
учетной системе (УС) Клиента.
разделителями в
]
версии 33
виде дефисов. Набор
*Уникальность контролируется на стороне
из 32 символов [0-
банка
9], [a-f] и дефисов
ОБЯЗАТЕЛЕН ДЛЯ ЗАПОЛНЕНИЯ,
ЕСЛИ НЕ ЗАПОЛНЕН @docId
*.3
@docId
Глобальный идентификатор документа
UuidSeparated
UUID с
разделителями в
ОБЯЗАТЕЛЕН ДЛЯ ЗАПОЛНЕНИЯ,
[0..1
Изменено в
виде дефисов. Набор
ЕСЛИ НЕ ЗАПОЛНЕН @docExtId
]
версии 33
из 32 символов [0-
9], [a-f] и дефисов
Дополнительные параметры связанного с
Множество
*.4
Params
Params
[0..1
Актуально
поручением документа
параметров
]
с версии 27
произвольного вида
Параметр
*.1
Param
Param
[0..n
Актуально
(тип расширен)
]
с версии 27
Название параметра
Простой тип XML
*.1
@name
xs:string [min: 1,
Актуально
[1]
Schema
max: 255]
с версии 27
Значение параметра
Простой тип XML
*.2
@value
xs:string [min: 1,
Актуально
[1]
Schema
max: 255]
с версии 27
*.11Sign
DigitalSign
[0..1
Актуально
]
с версии 27
Поставщик сертификата.
Простой тип XML
*.1
Issuer
xs:string [min: 1,
Обязательно и достаточно для
Schema
max: 1024]
[0..1
Актуально
идентификации клиентского сертификата
]
с версии 27
в СББОЛ передавать атрибут CN поля
Issuer в виде «CN=<значение атрибута>ª
Серийный номер сертификата
Простой тип XML
*.2
SN
xs:string [min: 1,
[0..1
Актуально
Schema
max: 255]
]
с версии 27
Значение ЭП
Простой тип XML
*.3
Value
xs:base64Binary
[0..1
Актуально
Schema
]
с версии 27
Имя схемы подписи
Простой тип XML
*.4
DigestName
xs:string
[0..1
Актуально
Schema
]
с версии 27
Версия схемы подписи
Простой тип XML
*.5
DigestVersion
xs:string
[0..1
Актуально
Schema
]
с версии 27
3.10. Передача клиенту документа Уведомление о зачислении
(поступлении) иностранной валюты на транзитный валютный
счет
3.10.1.
Общие сведения
Состав передаваемых данных в рамках персонализации:
Уведомление о зачислении (поступлении) иностранной валюты на транзитный валютный
счет
Response/CurrencyNotices
3.10.2.1.
Дайджест отправки
запроса
на
предоставление документа Уведомление о
зачислении (поступлении) иностранной валюты на
транзитный валютный счет
Подпись документа на стороне УС:
Подписывается какой-либо одной подписью:
Единственная подпись или
Первая подпись или
Вторая подпись
Дайджест: формируется
Ключевой буфер (дайджест):
Для формирования электронной подписи из документа формируется строковая последовательность
(ключевой буфер или дайджест), включающая все значимые данные документа, поля, содержащие
пустые значения, не включаются.
Ключевой буфер (дайджест) для подписания ЭП образует строковый массив в кодировке UTF-8,
Отдельные записи массива разделены символом перевода строки. В качестве символа перевода
строки используется 0x0A.
При наличии в мультистроковых данных последовательности из двух символов перевода строки
CR+LF (ASCII 0x0D 0x0A) необходимо удалять символ возврата каретки CR (ASCII 0x0D) и
оставлять только символ подачи строки LF (ASCII 0x0A).
Для отделения некоторых видов данных друг от друга в дайджест включены «заголовкиª, такие как
ATTRIBUTES. Эти
«заголовкиª не несут информации исходного документа, а служат для
внутренней организации данных в дайджесте. «Заголовкиª указываются в отдельной строке, где
кроме них ничего нет.
Формат дайджеста:
№
Наименование поля
Описание
Пример значения
п/п
Версионность
1.
ATTRIBUTES
Актуально с
версии 27
<Наименование поля>=<Значение поля>, например
OrgId=963084ba-7079-4b9d-bbab-c4972dee82d9
2.
Актуально с
OrgId
Идентификатор
963084ba-7079-4b9d-bbab-
версии 27
организации в ДБО
c4972dee82d9
3.
Актуально с
RequestId
Идентификатор
163084ba-7079-4b9d-bbab-
версии 27
запроса в УС
c4972dee82d2
клиента
4.
Актуально с
TABLES
Разделитель строк
версии 27
таблицы - #
5.
Актуально с
Table=Accounts
версии 27
6.
Актуально с
Value
Счет
40666840277777777777
версии 27
7.
Актуально с
Bic
БИК счета
044525225
версии 27
Пример.
ATTRIBUTES
OrgId=8b8b38fa-c399-4e9e-ac77-1721556b709c
RequestId=3D948067-66F2-496E-B657-2ED46E6DAB8A
TABLES
Table=Accounts
Value=123
Bic=000555
#
Value=124
Bic=000555
#
3.10.2.2. Дайджест
передачи клиенту
документа
Уведомление о зачислении
(поступлении)
иностранной валюты на транзитный валютный
счет
Запрос данных:
Подпись документа на стороне УС: нет
Дайджест: не формируется
Ответ с данными:
Подпись документа на стороне СББОЛ: Технологическая подпись
Дайджест: формируется
Примечание: При получении на стороне УС из СББОЛ персональных данных - на стороне УС
должен быть активный банковский сертификат, позволяющий проверить банковскую подпись
Ключевой буфер (дайджест):
Для формирования электронной подписи из документа формируется строковая последовательность
(ключевой буфер или дайджест), включающая все значимые данные документа, поля, содержащие
пустые значения, не включаются.
Ключевой буфер (дайджест) для подписания ЭП образует строковый массив в кодировке UTF-8,
Отдельные записи массива разделены символом перевода строки. В качестве символа перевода
строки используется 0x0A.После последней строки в дайджесте этот символ не ставится.
При наличии в мультистроковых данных последовательности из двух символов перевода строки
CR+LF (ASCII 0x0D 0x0A) необходимо удалять символ возврата каретки CR (ASCII 0x0D) и
оставлять только символ подачи строки LF (ASCII 0x0A).
Для отделения некоторых видов данных друг от друга в дайджест включены «заголовкиª, такие как
ATTRIBUTES, FIELDS и TABLES. После TABLES необходимо указание на следующей строке «типа
таблицыª Table=Accounts, далее следуют поля записей по одному полю в каждой строке, между
отдельными записями в качестве разделителя используется строка содержащая знак «решеткаª - #.
При включении вложнных таблиц Table=Accounts и Table=Accounts.Docsставитится два знака
решетки для закрытия двух таблиц (основной и вложенной).
Эти «заголовкиª не несут информации исходного документа, а служат для внутренней организации
данных в дайджесте. «Заголовкиª указываются в отдельной строке, где кроме них ничего нет.
Если наполнение всех таблиц блока TABLES пустое, то и сам TABLES в дайджест не включается.
Если наполнение какой-то таблицы блока TABLES пустое, то Table=TableName не включать в
дайджест.
Формат дайджеста:
N
Наименование
Версионно
Описание
Пример значения
п/п
поля
сть
1.
ATTRIBUTES
<Наименование
OrgId=963084ba-7079-
Актуально
поля>=<Значение
поля>,
4b9d-bbab-c4972dee82d9
с версии
например:
27
2.
FIELDS
<Наименование
DocAccept
=2013-11-24
Актуально
поля>=<Значение
поля>,
После последней строки
с версии
например:
НЕ делать перевод
27
строки
3.
DocDate
Дата уведомления
2017-01-12
Актуально
с версии
27
4.
DocNum
Номер уведомления
12
Актуально
с версии
27
5.
DocExtId
Уникальный* идентификатор
3a6378ef-07ee-4535-a10a-
документа в учетной системе
0c82817cae23
Актуально
(УС) Клиента.
с версии
27
*Уникальность контролируется
на стороне банка
6.
BankName
Значение
ОПЕРУ Центрального
Изменено
Аппарата Сбербанка РФ
в версии
33
7.
Inn
ИНН получателя
7770000000
Актуально
с версии
27
8.
Kpp
КПП получателя
775551001
Актуально
с версии
27
9.
OrgName
Наименование организации
Ромашка
Актуально
клиента (сокращенное
с версии
наименование - как в платежных
27
руб. документах)
10.
AccDoc.AccNu
Номер счёта обязателен для
40000000000000000000
Актуально
m
заполнения
с версии
27
11.
AccDoc.Bic
БИК
044555222
Актуально
с версии
27
12.
ReceiveDate
Дата поступления средств на
2017-01-12
Актуально
транзитный счет
с версии
27
13.
DeadLine
Срок предоставления
2017-01-13
Актуально
обосновывающих документов
с версии
27
14.
CurrencyNotice
Сумма уведомления
1234
Актуально
Sum.DocSum
с версии
Формат XX.YY с точностью до
27
сотых
15.
CurrencyNotice
ISO код валюты
810
Актуально
Sum.CurrCode
с версии
27
16.
Author
Подписант уведомления
Иванов Иван Иванович
Актуально
с версии
27
17.
Message
Сообщение из банка
Сообщение из банка
Актуально
с версии
27
Пример
ATTRIBUTES
FIELDS
DocDate=2017-01-12
DocNum=12
DocExtId=3a6378ef-07ee-4535-a10a-0c82817cae23
BankName= ОПЕРУ Центрального Аппарата Сбербанка РФ
Inn=7770000000
Kpp=775551001
OrgName=Ромашка
AccDoc.AccNum=40000000000000000000
AccDoc.Bic=044555222
ReceiveDate=2017-01-12
DeadLine=2017-01-13
CurrencyNoticeSum.DocSum=1234
CurrencyNoticeSum.CurrCode=810
3.10.3. Формат взаимодействия
Взаимодействие: Документ передается из СББОЛ в УС
Инициатор получения справочника: УС
Формат передачи документа сторону УС: Response/CurrencyNotices
Формат передачи запроса персональных данных на сторону СББОЛ:
Со стороны УС направляется Request/Incoming, в котором указывается атрибут
@lastIncomingTime.
3.10.3.1. Формат отправки запроса на предоставление
документа Уведомление о зачислении
(поступлении) иностранной валюты на
транзитный валютный счет
Request/Incoming
Версионно
Элемент
Описание элемента
Тип
Описание типа
Мн.
сть
Request
Запрос УС к СББОЛ
Request
Актуально
[1]
с версии 27
1
@requestId
Уникальный
UuidSepa
UUID с
идентификатор запроса
rated
разделителями
в виде
Актуально
дефисов.
[1]
с версии 27
Набор из 32
символов [0-9],
[a-f] и дефисов
2
@orgId
Идентификатор
UuidSepa
UUID с
организации в ДБО
rated
разделителями
(может быть использован
в виде
Актуально
сторонней системой для
дефисов.
[1]
с версии 27
дополнительной
Набор из 32
идентификации)
символов [0-9],
[a-f] и дефисов
3
@version
Номер версии формата
xs:string
Простой тип
обмена
RegEx:
XML Schema
Актуально
"[0-
[1]
с версии 27
9\.]{1,20}
"
4
@sender
Система-отправитель
xs:string
Простой тип
RegEx:
XML Schema
«[-a-zA-
Актуально
[1]
Zа-яА-
с версии 27
Я0-9:
_]{1,20}ª
5
@receiver
Система-получатель Если
xs:string
Простой тип
система получатель
RegEx:
XML Schema
СББОЛ, то SBBOL_DBO
«[-a-zA-
[0..1
Актуально
Zа-яА-
]
с версии 27
Я0-9:
_]{1,20}ª
6
@protocolVersion
Версия протокола
xs:string
Простой тип
[0..1
Актуально
XML Schema
]
с версии 27
7
Incoming
Запрос о получении
данных, подготовленных
дляУС ("ночных
Актуально
[1]
выписок", выписок,
с версии 27
тикетов после отказа в
РС, новостей)
Идентификатор
*.1
@correspondentDi
xs:long
Простой тип
последнего обновления
Актуально
ctStepId
[0..1
XML Schema
справочника
с версии 27
]
контрагентов
Идентификатор
*.2
@bicDictStepId
xs:long
Простой тип
Актуально
[0..1
последнего обновления
XML Schema
с версии 27
]
справочника БИК
Дата и время последнего
*.3
@lastIncomingTim
xs:dateTi
Простой тип
запроса Incoming(всегда
Актуально
e
me
[0..1
XML Schema
идёт во временной зоне
с версии 27
]
«Москваª)
Идентификатор
*.4
@beneficiarDictSte
xs:long
Простой тип
последнего обновления
Актуально
pId
[0..1
XML Schema
справочника
с версии 27
]
бенефициаров
Признак того, что
*.5
@includeRZKPay
BoolType
Простой тип
необходимо выгружать
Актуально
DocsRu
[0..1
XML Schema
рублевые платежные
с версии 27
]
поручения
Признак того, что
*.6
@includeRZKPay
BoolType
Простой тип
необходимо выгружать
Актуально
DocsCurr
[0..1
XML Schema
валютные платежные
с версии 27
]
поручения
Признак того, что
*.7
@includeRZKSala
BoolType
Простой тип
[0..1
Актуально
необходимо выгружать
ryDocs
XML Schema
]
с версии 27
зарплатную ведомость
Признак того, что
*.8
@includeStatement
BoolType
Простой тип
[0..1
Актуально
необходимо выгружать
s
XML Schema
]
с версии 27
выписки
Признак того, что
*.9
@includeExchange
BoolType
Простой тип
[0..1
Актуально
необходимо выгружать
MessageFromBank
XML Schema
]
с версии 27
сообщения из банка
Признак того, что
*.1
@includeNews
BoolType
Простой тип
Актуально
[0..1
необходимо выгружать
0
XML Schema
с версии 27
]
новости
Признак того, что
*.1
@includeLetterFro
BoolType
Простой тип
Актуально
[0..1
необходимо выгружать
1
mBanks
XML Schema
с версии 27
]
сообщения из банка
Признак того, что
*.1
@includePayReque
BoolType
Простой тип
Актуально
[0..1
необходимо выгружать
2
sts
XML Schema
с версии 27
]
платежные требования
Признак того, что
*.1
@includeChanged
BoolType
Простой тип
необходимо выгружать
3
Docs
XML Schema
информацию о
Актуально
[0..1
документах, принявших,
с версии 27
]
либо изменивших
финальный статус.
Признак того, что
*.1
@includeOrgSettin
BoolType
Простой тип
необходимо выгружать
Актуально
4
gs
[0..1
XML Schema
информацию об
с версии 27
]
организации
Признак того, что
*.1
@includeIntCtrlSt
BoolType
Простой тип
необходимо выгружать
5
atement
XML Schema
Добавлено
[0..1
ведомости банковского
в версии 28
]
контроля по контрактам,
кредитным договорам
Признак того, что
*.1
@includeDealPass
BoolType
Простой тип
необходимо выгружать
6
Con138I
[0..1
Актуально
XML Schema
паспорта сделок по
]
с версии 27
контракту
Признак того, что
*.1
@includeDealPass
BoolType
Простой тип
необходимо выгружать
7
Cred138I
[0..1
Актуально
XML Schema
паспорта сделок по
]
с версии 27
кредиту
Признак того, что
*.1
@includeCurrency
BoolType
Простой тип
необходимо выгружать
8
Notice
XML Schema
уведомления о
[0..1
Актуально
поступлении денежных
]
с версии 27
средств на транзитный
валютный счет
Идентификатор
*.1
dictsForDepositsDi
BoolType
Простой тип
последнего обновления
Актуально
9
ctStepId
[0..1
XML Schema
справочника
с версии 27
]
актуальных ставок
*.2
cardDepositDictSte
Идентификатор
BoolType
Простой тип
последнего обновления
Актуально
0
pId
[0..1
XML Schema
справочника карточек
с версии 27
]
депозита
Идентификатор
*.2
cardPermBalance
BoolType
Простой тип
последнего обновления
Актуально
1
DictStepId
[0..1
XML Schema
справочника карточек
с версии 27
]
НСО
Счёта, подготовленные
*.2
Accounts
выписки, по которым
2
нужно выгрузить. Для
счетов, не вошедших в
Актуально
[0..1
список, предоставлять
с версии 27
]
выписки по запросу с
данным элементом не
требуется
*.1
Account
Acc,
расширен
ие
AccNumT
[1..1
Актуально
ype
000]
с версии 27
(xs:string[
20]
RegEx:
[0-9])
*.1
@bic
БИК
BicType
БИК, 9 цифр
Актуально
[1]
с версии 27
*.2
@docNum
Номер документа
xs:string [
[0..1
Изменено в
max: 6]
]
версии 29
*.23
Orgs
Организации, письма по
[0..1
которым нужно
]
выгрузить. Если список
Актуально
пуст, возвращаются
с версии 27
только письма по
организации, указанной в
верхнем элементе
*.1
Org
UuidSepa
UUID с
[1..1
rated
разделителями
000
в виде
дефисов.
Актуально
Набор из 32
с версии 27
символов [0-9],
[a-f] или [A-F]
и дефисов
3.10.3.2. Формат передачи клиенту документа Уведомление о зачислении
(поступлении) иностранной валюты на транзитный валютный счет
Response/CurrencyNotices
Версионно
Элемент
Описание элемента
Тип
Описание типа
Мн.
сть
Response
Ответ СББОЛ на запрос ТК
Response
Актуально
[1]
с версии 27
1
Дата и время формирования ответа местному по
xs:dateTime
Простой тип
@createTime
[0..1
Актуально
времени запрашивающего сервера, с указанием его
XML Schema
]
с версии 27
часового пояса
2
Уникальный идентификатор ответа
UuidSeparated
UUID с
@responseId
разделителями в
виде дефисов.
[0..1
Актуально
Набор из 32
]
с версии 27
символов [0-9],
[a-f] и дефисов
3
Идентификатор запроса, в результате которого был
UuidSeparated
UUID с
@requestId
сформирован данный ответ
разделителями в
виде дефисов.
[0..1
Актуально
Набор из 32
]
с версии 27
символов [0-9],
[a-f] и дефисов
4
Номер версии формата обмена
xs:string
Простой тип
@version
[0..1
Актуально
RegEx: "[0-
XML Schema
]
с версии 27
9\.]{1,20}"
5
Система-отправитель
xs:string
Простой тип
@sender
RegEx: "[-a-zA-
XML Schema
[0..1
Актуально
Zа-яА-Я0-
]
с версии 27
9]{1,20}"
6
Система-получатель. Если система получатель
xs:string
Простой тип
@receiver
[0..1
Актуально
СББОЛ, то SBBOL_DBO
RegEx: "[-a-zA-
XML Schema
]
с версии 27
Zа-яА-Я0-
9]{1,20}"
7
Уведомления о поступлении денежных средств на
Актуально
CurrencyNotices
транзитный валютный счет
[0..1]
с версии
27
*.1
Уведомление о послуплении денежных средств на
СurrencyNotice
Изменено
СurrencyNotice
[0..1]
транзитный валютный счет
в версии
[0..n]
31
*.1
@docDate
Дата уведомления
xs:date
Актуально
[0..1]
с версии
27
*.2
@docNum
Номер уведомления
string [max: 50]
Актуально
[0..1]
с версии
27
*.3
@docId
Идентификатор документа в СББОЛ
UuidSeparated
Актуально
[0..1]
с версии
27
@docExtId
UuidSeparated
UUID с
Уникальный* идентификатор документа в учетной
разделителями в
системе (УС) Клиента.
Изменено
виде дефисов.
*Уникальность контролируется на стороне банка
[0..1]
в версии
Набор из 32
33
символов [0-9],
[a-f] и дефисов
*.4
@bankName
Значение
xs:string [min: 1,
Простой тип
Response/OrganizationsInfo/OrganizationInfo/Branches/B
max: 255]
XML Schema
Актуально
ranch/BranchData/FullName - наименование
[0..1]
с версии
подразделения банка, которое передается в рамках
27
OrganizationsInfo
*.5
@orgId
Идентификатор организации в СББОЛ
UuidSeparated
Актуально
[0..1]
с версии
27
*.6
@orgName
Наименование организации клиента (сокращенное
xs:string [min: 1,
Простой тип
Актуально
наименование - как в платежных руб. документах)
max: 160]
XML Schema
[0..1]
с версии
27
*.7
@author
Подписант уведомления
string [max: 355]
Актуально
[1]
с версии
27
*.8
Inn
ИНН получателя
InnType
ИНН
юридического
Актуально
или
[0..1]
с версии
физического
27
лица РФ, до 12
цифр
*.9
Kpp
КПП получателя
KppType
Актуально
[0..1]
с версии
27
*.1
AccDoc
Номер счёта и БИК перевододателя Customer Account
AccNumBicType
Номер счёта и
Актуально
0
БИК
[0..1]
с версии
27
*.1
@accNum
Номер счёта обязателен для заполнения
AccNumType
Простой тип
Актуально
RegEx: "[0-
XML Schema
[1]
с версии
9]{20}"
27
*.2
@bic
БИК
BicType
БИК, 9 цифр
Актуально
[1]
с версии
27
*.3
BankName
Наименование банка, где открыт счет
xs:string [min: 1,
Простой тип
Актуально
max: 140]
XML Schema
[0..1]
с версии
27
*.1
ReceiveDate
Дата поступления средств на транзитный счет
xs:date
Актуально
1
[0..1]
с версии
27
*.1
DeadLine
Срок предоставления обосновывающих документов
xs:date
Актуально
2
[0..1]
с версии
27
*.1
СurrencyNoticeSum
Сумма
СurrencyNoticeSu
Актуально
3
m
[0..1]
с версии
27
*.1
@docSum
Сумма уведомления
xs:decimal
Актуально
Формат XX.YY с точностью до сотых
[1]
с версии
27
*.2
@curCode
ISO код валюты
CurrCodeLetterTy
Актуально
pe
[1]
с версии
27
*.1
Message
Сообщение Клиенту
xs:string
Актуально
4
[0..1]
с версии
27
*.1
Attachments
Приложенные к документу отсканированные образы-
AttachmentsType
Приложенные к
5
вложения
документу
[0..1
Актуально
отсканированны
]
с версии 27
е образы-
вложения
*.1
Attachment
Отдельное вложение
[0..n
Актуально
]
с версии 27
*.1
AttachmentName
Имя файла вложения
xs:string [min: 1,
Простой тип
[0..1
Актуально
max: 64]
XML Schema
]
с версии 27
*.2
Description
Пользовательское описание файла вложения
xs:string [min: 1,
Простой тип
[0..1
Актуально
max: 1024]
XML Schema
]
с версии 27
*.3
Body
В бинарном представлении в сжатом и несжатом виде
xs:base64Binary
Простой тип
[0..1
Актуально
XML Schema
]
с версии 27
*.4
FileSize
Размер вложенного файла в байтах
xs:long
[0..1
Актуально
]
с версии 27
*.5
FileDate
Дата создания файла
xs:dateTime
[0..1
Актуально
]
с версии 27
*.1
Sign
Электронная подпись
DigitalSign
[0..1
Актуально
6
]
с версии 27
*.1
Issuer
Идентификатор поставщика сертификата
xs:string [min: 1,
Например, " issuer="E=IdleCA, C=RU,
max: 1024]
[0..1
Актуально
S=Idle CA, L=Idle CA, O=Idle CA, OU=Idle CA,
]
с версии 27
CN=Idle CA" "
*.2
SN
Серийный номер сертификата
xs:string [min: 1,
[0..1
Актуально
max: 255]
]
с версии 27
*.3
Value
Значение ЭП
xs:base64Binary
[0..1
Актуально
]
с версии 27
*.4
DigestName
Имя схемы подписи
xs:string
[0..1
Актуально
]
с версии 27
*.5
DigestVersion
Версия схемы подписи
xs:string
[0..1
Актуально
]
с версии 27
Пример
<Response sender="DBO" version="7" requestId="19d9fd5d-2ae4-4990-9a33-057d900a2e0e"
responseId="49cba80d-a0bc-4afc-abbf-8c8d25ca7131" createTime="2015-11-27T12:41:17.799+03:00"
xmlns="http://bssys.com/upg/response">
<CurrencyNotices>
<CurrencyNotice author="В электронном виде. " orgName="Общество с ограниченной
ответственностью "ДИАМЕД"" bankName="0038-1569-01840" docId="25835dd7-8e7e-
060c-e053-0a4318992e93" docNum="27119998" docDate="2015-11-27">
<Inn>7734008542</Inn>
<Kpp/>
<AccDoc bic="044525225" accNum="40702978438170208272">
<BankName>ПАО СБЕРБАНК</BankName>
</AccDoc>
<ReceiveDate>2015-11-27</ReceiveDate>
<DeadLine>2015-12-08</DeadLine>
<CurrencyNoticeSum currCode="EUR" docSum="33"/>
<Message/>
<Sign>
<Issuer>E = casbrf@sberbank.ru,2.5.4.33 = Тестирующий Q,CN =
ЛавринСВ-Тестовая печать-УЦ-9,OU = Удостоверяющий центр СБ РФ (Тестовый),O = ОАО
"Сбербанк России",C = RU</Issuer>
<SN>73962A41020BA7F60715</SN>
<Value>PAFQ4yblejT6bgdl4BF7B3RrmXNLMPYvsIv64cEOWDR5UXA2FE6nOc7a7mk/3vFo
U+e0und2C3Zv3vmLqxhqWQ==</Value>
<DigestName>for_upg</DigestName>
<DigestVersion>1</DigestVersion>
</Sign>
</CurrencyNotice>
</CurrencyNotices>
</Response>
3.11.
Обновление справочника курсов валют
3.11.1. Формат взаимодействия
Взаимодействие: Документ передается из СББОЛ в УС
Инициатор получения справочника: УС
Формат передачи запроса на сторону СББОЛ: Request/CurrCourseEntry
Формат передачи справочника сторону УС: Response/CurrCourseEntry
3.11.1.1.
Формат отправки запроса в СББОЛ
Request/CurrCourseEntry
Описание
Версионно
Элемент
Описание элемента
Тип
Мн.
типа
сть
Request
Запрос УС к СББОЛ
Request
Актуально
[1]
с версии
27
UuidSeparated
UUID с
1
@requestId
Уникальный
разделителями в
Актуально
идентификатор запроса
виде дефисов.
[1]
с версии
Набор из 32
символов [0-9], [a-
27
f] и дефисов
UuidSeparated
UUID с
2
@orgId
Идентификатор
разделителями в
организации в ДБО (может
виде дефисов.
Актуально
быть использован
Набор из 32
[1]
с версии
символов [0-9], [a-
сторонней системой для
f] и дефисов
27
дополнительной
идентификации)
xs:string
Простой тип XML
3
@version
Номер версии формата
Актуально
RegEx: "[0-
Schema
обмена
[1]
с версии
9\.]{1,20}"
27
xs:string
Простой тип XML
4
@sender
Система-отправитель
Актуально
RegEx: «[-a-zA-
Schema
Zа-яА-Я0-9:
[1]
с версии
_]{1,20}ª
27
xs:string
Простой тип XML
5
@receiver
Система-получатель Если
Актуально
RegEx: «[-a-zA-
Schema
[0..1
система получатель
с версии
Zа-яА-Я0-9:
]
СББОЛ, то SBBOL_DBO
_]{1,20}ª
27
6
@ protocolVersion
Версия протокола
xs:string
Простой тип
Актуально
[0..1
XML Schema
с версии
]
27
7
CurrCourseEntry
Запрос обновления
Актуально
справочника курсов валют
[1]
с версии
27
*.1
@lastRequestTime
Дата и время последнего
xs:dateTime
Простой тип XML
Актуально
Schema
[0..1
запроса обновления
с версии
справочника(с час.
]
27
поясами)
xs:date
Простой тип XML
*.2
@beginDate
Дата начала периода
Актуально
Schema
[0..1
с версии
]
27
xs:date
Простой тип XML
*.3
@endDate
Дата конца
Schema
Актуально
периодапоследнего
[0..1
с версии
обновления справочника
]
27
бенефициаров
*.4
@branchSystemName
Наименование
xs:string
Простой тип
подразделения -
[min: 1, max:
XML Schema
получателя поручения
255]
Должно передаваться
значение из из первого
Branch
Response/OrganizationsInfo/
OrganizationsInfo/Branches/
Изменено
Branch/SystemName-
[1]
в версии
системное имя п
33
одразделение, за которым
закреплена организация,
если значение SystemName
пустое, то берется
следующая Branch, т.е.
родительское
подразделение и т.д.
вплоть до головного "ПАО
СБЕРБАНК".
3.11.1.2.
Формат получения справочника из СББОЛ
Response/CurrCourseEntry
Версионнос
Элемент
Описание элемента
Тип
Описание типа
Мн.
ть
Response
Ответ СББОЛ на запрос ТК
Response
Актуально с
[1]
версии 27
1
Дата и время формирования
xs:dateTime
Простой тип XML Schema
@createTime
ответа местному по времени
[0..1
Актуально с
запрашивающего сервера, с
]
версии 27
указанием его часового пояса
2
Уникальный идентификатор
UuidSeparated
UUID с разделителями в
@responseId
ответа
виде дефисов. Набор из 32
[0..1
Актуально с
символов [0-9], [a-f] и
]
версии 27
дефисов
3
Идентификатор запроса, в
UuidSeparated
UUID с разделителями в
@requestId
результате которого был
виде дефисов. Набор из 32
[0..1
Актуально с
сформирован данный ответ
символов [0-9], [a-f] и
]
версии 27
дефисов
4
Номер версии формата обмена
xs:string
Простой тип XML Schema
@version
[0..1
Актуально с
RegEx: "[0-
]
версии 27
9\.]{1,20}"
5
Система-отправитель
xs:string
Простой тип XML Schema
@sender
RegEx: "[-a-zA-
[0..1
Актуально с
Zа-яА-Я0-
]
версии 27
9]{1,20}"
6
Система-получатель. Если
xs:string
Простой тип XML Schema
@receiver
система получатель СББОЛ, то
RegEx: "[-a-zA-
[0..1
Актуально с
SBBOL_DBO
Zа-яА-Я0-
]
версии 27
9]{1,20}"
7
Запись справочника курсов валют
[0..1
Актуально с
CurrCourseEntry
]
версии 27
*.1
Значение котировок валют для
ExRateDetail
[0..n
Актуально с
ExRateDetails
данного вида курса
]
версии 27
*.1
Код ТБ, в котором
xs:string
[0..1
Актуально с
RegionId
устанавливается курс
]
версии 27
*.2
Запись о валюте, против которой
[0..1
Актуально с
Ccy
рассчитывается курс
]
версии 27
*.1
Буквенно-цифровой код валюты
xs:string
Простой тип XML Schema
@currName
согласно Общероссийскому
Актуально с
[1]
классификатору валют (Доллары
версии 27
США -840 , Евро -978 и т.д.)
*.2
Цифровой код валюты ISO
xs:string
Простой тип XML Schema
Актуально с
@currIsoCode
[1]
версии 27
*.3
Цифровой код валюты
xs:string
Простой тип XML Schema
Актуально с
@currCode
[1]
версии 27
*.4
Дата и время, на которые
xs:dateTime
Простой тип XML Schema
[0..1
Актуально с
@beginDate
устанавливается курс
]
версии 27
Значение котировок валют для
[0..1
Актуально с
*.3
CurrencyRates
данного вида курса
]
версии 27
*.1
CurrencyRate
[0..n
Актуально с
CurrencyRate
]
версии 27
*.1
Код базовой валюты. Буквенно-
xs:string
Простой тип XML Schema
@currBaseCode
цифровой код валюты согласно
Общероссийскому
классификатору валют (Доллары
Актуально с
[1]
США -840 , Евро -978 и т.д.)Поле
версии 27
«Цифровой код валютыª для
конкретного курса
*.2
Масштаб валюты
xs:string
Простой тип XML Schema
Актуально с
@currUnits
[1]
версии 27
*.3
Дата выставления курса
xs:dateTime
Простой тип XML Schema
Актуально с
@courseDateTime
[1]
версии 27
*.4
Поле «Курс ЦБ РФª для
xs:string
Простой тип XML Schema
[0..1
Актуально с
ValueRate
конкретного курса
]
версии 27
*.5
Поле «Курс покупкиª для
xs:string
Простой тип XML Schema
[0..1
Актуально с
RateBuyRate
конкретного курса
]
версии 27
*.6
Поле «Курс продажиª для
xs:string
Простой тип XML Schema
[0..1
Актуально с
RateSellRate
конкретного курса
]
версии 27
4.
Подтверждение сделок Foreign Exchange Operations
4.1. Общие сведения
В УПШ реализована возможность подтверждения сделок FX (Foreign Exchange Operations) -
сделки участников валютного рынка по обмену оговоренных сумм денежной единицы одной
страны на валюту другой страны по согласованному курсу с проведением расчетов на
определенную дату. При этом взаимодействие происходит по следующему алгоритму:
1. Для получения новых сообщений о необходимости подтверждения сделок УС Клиента
отправляет в СББОЛ запрос Request/IncomingDealConf, в ответ на который получает
документ
«Уведомление о необходимости подтверждения сделкиª в xml-сообщении в
составном элементе Response/DealConfs. При этом УПШ возвращает уведомления только о
тех сообщениях о подтверждении сделки, которые находятся в статусе
«Ожидает
подтвержденияª.
2. После того, как пользователь в УС Клиента выбрал платежную инструкцию, подтвердил
либо отклонил сделку и подписал документ «Сообщение о подтверждении сделкиª, в
СББОЛ отправляется ответ о подтверждении сделки в xml-сообщении в составном элементе
Request/DealAns, после чего УС Клиента получает в ответ тикет со статусом запроса
«Сообщение о подтверждении сделкиª.
3. На стороне СББОЛ в случае успешного прохождения контролей запросом «Сообщение о
подтверждении сделкиª сделка принимается либо отклоняется.
4.2. Дайджест запроса
«Уведомлений о необходимости
подтверждения сделкиª
Подпись документа на стороне УС:
Единственная подпись или
Первая и Вторая подписи
Дайджест: формируется
Ключевой буфер (дайджест):
Для формирования электронной подписи из документа формируется строковая последовательность
(ключевой буфер или дайджест), включающая все значимые данные документа, поля, содержащие
пустые значения, не включаются.
Ключевой буфер (дайджест) для подписания ЭП образует строковый массив в кодировке UTF-8,
Отдельные записи массива разделены символом перевода строки. В качестве символа перевода
строки используется 0x0A.
Формат дайджеста:
№п
Наименование поля
Описание
Пример значения
Версионнос
/п
ть
1.
ATTRIBUTES
Актуально
<Наименование поля>=<Значение поля>, например:
с версии 27
OrgId=963084ba-7079-4b9d-bbab-c4972dee82d9
Идентификатор
963084ba-7079-4b9d-
OrgId
организации в ДБО
bbab-c4972dee82d9
(может быть использован
Актуально
2.
сторонней системой для
с версии 27
дополнительной
идентификации)
Отправитель, а также тип
3a6378ef-07ee-4535-
RequestId
использованного
a10a-0c82817cae23
Актуально
3.
Клиентом программного
с версии 27
обеспечения при отправке
документа
4.3. Дайджест «Сообщения о подтверждении сделкиª
Подпись документа на стороне УС:
Единственная подпись или
Первая и Вторая подписи
Дайджест: формируется
Ключевой буфер (дайджест):
Для формирования электронной подписи из документа формируется строковая последовательность
(ключевой буфер или дайджест), включающая все значимые данные документа, поля, содержащие
пустые значения, не включаются.
Ключевой буфер (дайджест) для подписания ЭП образует строковый массив в кодировке UTF-8,
Отдельные записи массива разделены символом перевода строки. В качестве символа перевода
строки используется 0x0A.
Формат дайджеста:
№
Наименование
Описание
Пример значения
Версионность
поля
п/п
1.
ATTRIBUTES
Актуально с
версии 27
2.
OrgId
Идентификатор организации
963084ba-7079-4b9d-
в ДБО (может быть
bbab-c4972dee82d9
использован сторонней
Актуально с
системой для
версии 27
дополнительной
идентификации)
3.
Sender
Отправитель
Ромашка
Актуально с
версии 27
4.
DocExtId
Идентификатор документа в
3a6378ef-07ee-4535-
Актуально с
СББ
a10a-0c82817cae23
версии 27
5.
FIELDS
Актуально с
версии 27
6.
Decision
Решение по сделке
1
Актуально с
версии 27
7.
SIID
Идентификатор выбранной
3343434
Актуально с
платежной инструкции
версии 27
8.
NSIText
Комментарий к новой
Новая платежная
Актуально с
платежной инструкции
инструкция
версии 27
9.
SIID2
Актуально с
версии 27
10.
NSIText2
Идентификатор сообщения о
Актуально с
подтверждении сделки АС
версии 27
СББОЛ
4.4. Форматы взаимодействия
Взаимодействие: Документ передается из СББОЛ в УС
Инициатор получения документа: УС
Формат запроса «Уведомлений о необходимости подтверждения сделкиª со стороны УС:
Request/IncomingDealConf
Формат ответа с «Уведомлением о необходимости подтверждения сделкиª со стороны
СББОЛ: Response/DealConfs
Формат запроса с «Сообщением о подтверждении сделкиª со стороны УС: Request/DealAns
4.4.1.Формат
запроса
«Уведомлений
о
необходимости подтверждения сделкиª
Request/IncomingDealConf
Версионно
Элемент
Описание элемента
Тип
Описание типа
Мн.
сть
Request
Запрос УС к СББОЛ
Request
Актуально
[1]
с версии 27
1
@requestId
Уникальный
UuidSepa
UUID с
идентификатор запроса
rated
разделителями
в виде
дефисов.
Актуально
[1]
Набор из 32
с версии 27
символов [0-
9], [a-f] и
дефисов
2
@orgId
Идентификатор
UuidSepa
UUID с
организации в ДБО
rated
разделителями
(может быть использован
в виде
сторонней системой для
дефисов.
Актуально
[1]
дополнительной
Набор из 32
с версии 27
идентификации)
символов [0-
9], [a-f] и
дефисов
3
@version
Номер версии формата
xs:string
Простой тип
обмена
RegEx:
XML Schema
Актуально
"[0-
[1]
с версии 27
9\.]{1,20}
"
4
@sender
Система-отправитель
xs:string
Простой тип
RegEx:
XML Schema
«[-a-zA-
Актуально
[1]
Zа-яА-
с версии 27
Я0-9:
_]{1,20}ª
5
@receiver
Система-получатель Если
xs:string
Простой тип
система получатель
RegEx:
XML Schema
СББОЛ, то SBBOL_DBO
«[-a-zA-
[0..1
Актуально
Zа-яА-
]
с версии 27
Я0-9:
_]{1,20}ª
6
@ protocolVersion
Версия протокола
xs:string
Простой тип
[0..1
Актуально
XML Schema
]
с версии 27
IncomingDealConf
Запрос сообщений о
Актуально
7
[1]
подтверждении сделки
с версии 27
@lastIncomingTi
Дата и время последнего
xs:dateTi
*.1
Актуально
me
запроса Incoming(с час.
me
[1]
с версии 27
поясами)
4.4.2.Формат ответа с «Уведомлением о необходимости подтверждения сделкиª
Response/DealConfs
Версионно
Элемент
Описание элемента
Тип
Описание типа
Мн.
сть
Request
Запрос УС к СББОЛ
Request
Актуально
[1]
с версии 27
1
@createTime
Дата и время формирования ответа местному
xs:dateTime
Простой тип XML
Актуально
[0..1
по времени запрашивающего сервера, с
Schema
с версии 27
]
указанием его часового пояса
2
@responseId
Уникальный идентификатор ответа
UuidSeparated
UUID с
Актуально
разделителями в
с версии 27
виде дефисов.
[0..1
Набор из 32
]
символов [0-9], [a-
f] и дефисов
3
@requestId
Идентификатор запроса, в результате которого
UuidSeparated
UUID с
Актуально
был сформирован данный ответ
разделителями в
с версии 27
виде дефисов.
[0..1
Набор из 32
]
символов [0-9], [a-
f] и дефисов
4
Номер версии формата обмена
xs:string
Простой тип XML
Актуально
@version
[0..1
RegEx: "[0-
Schema
с версии 27
]
9\.]{1,20}"
5
Система-отправитель
xs:string
Простой тип XML
Актуально
@sender
RegEx: "[-a-zA-
Schema
[0..1
с версии 27
Zа-яА-Я0-
]
9]{1,20}"
6
Система-получатель. Если система получатель
xs:string
Простой тип XML
Актуально
@receiver
СББОЛ, то SBBOL_DBO
RegEx: "[-a-zA-
Schema
[0..1
с версии 27
Zа-яА-Я0-
]
9]{1,20}"
7
Сообщения о подтверждении сделки
[0..1
Актуально
DealConfs
]
с версии 27
Сообщение о подтверждении сделки
tns:DealConfTyp
[0..n
Актуально
*.1
DealConf
e
]
с версии 27
Заголовок
tns:HDRType
[0..1
Актуально
*.1
HDR
]
с версии 27
*.1
@mesUID
Уникальный идентификатор сообщения,
xs:string [min: 1,
Простой тип XML
Актуально
[1]
присваивается DSA
max: 32]
Schema
с версии 27
*.2
@confType
Тип сообщения.
xs:int
Простой тип XML
Актуально
Возможные значения:
Schema
с версии 27
[1]
«1ª - Подтверждение по сделке без ПИ.
«2ª - Подтверждение по сделке с ПИ.
ПИ.
*.3
@sICnt
xs:int
Простой тип XML
Актуально
Возможные значения:
Schema
с версии 27
«0ª - указывается, в случае если подтверждение
[1]
по сделке без ПИ.
«Nª - где N - количество ПИ приложенных к
подтверждению.
*.4
@docSum
Сумма
xs:decimal
Простой тип XML
Актуально
Schema
[1]
с версии 27
@docDate
Дата документа
xs:date
*.5
Актуально
[1]
с версии 27
Валюта
*.6
@docSumCurrency
CurrCodeLetterT
Простой тип XML
Актуально
ype
Schema
[1]
с версии 27
Счет плательщика
*.7
@docAccount
AccNumType
Простой тип XML
Актуально
Schema
[1]
с версии 27
*.8
ExtID
Уникальный идентификатор сообщения в
UuidSeparated
Простой тип XML
Актуально
[0..1
СББОЛ
Schema
с версии
]
27
Информация по сделке
tns:DealType
[0..1
Актуально
*.2
Deal
]
с версии 27
Информация о контрагенте
tns:CptyType
[0..1
Актуально
*.1
Cpty
]
с версии 27
Уникальный идентификатор организации в АС
xs:string [min: 1,
Простой тип XML
Актуально
*.1
@uID
[1]
СББОЛ
max: 32]
Schema
с версии 27
*.2
@name
Наименование организации в АС СББОЛ
xs:string [min: 1,
Простой тип XML
Актуально
[1]
max: 255]
Schema
с версии 27
*.3
@address
Адрес организации в АС СББОЛ
xs:string [min: 1,
Простой тип XML
Актуально
[1]
max: 255]
Schema
с версии 27
*.4
@newSIInd
Признак определяет, возможен ли для данного
BoolType
Простой тип XML
Актуально
клиента ввод новых ПИ.
Schema
с версии 27
Возможные значения:
[1]
«1ª - Клиент может ввести новую ПИ по сделке в
АС СББОЛ.
«0ª - Клиент не может вводить новые ПИ по
сделке через АС СББОЛ.
Номер генерального соглашения
*.5
@genAgrNum
xs:string [min: 1,
Простой тип XML
Актуально
[1]
max: 255]
Schema
с версии 27
Дата заключения генерального соглашения
*.6
@genAgrDate
xs:date
Простой тип XML
Актуально
[1]
Schema
с версии 27
Детальная информация о сделке
tns:DealInfoType
[0..1
Актуально
*.2
DealInfo
]
с версии 27
Номер сделки в DD
xs:string [min: 1,
Простой тип XML
Актуально
*.1
@dealIDDD
[1]
max: 255]
Schema
с версии 27
Номер подтверждения в DD
xs:string [min: 1,
Простой тип XML
Актуально
*.2
@dealConfID
[1]
max: 255]
Schema
с версии 27
*.3
@instr
Тип сделки (инструмент).
xs:int
Простой тип XML
Актуально
Возможные значения:
Schema
с версии 27
«1ª - FX OTC SPOT (Today).
[1]
«2ª - FX OTC SPOT (Tomorrow).
«3ª - FX OTC SPOT (T+2).
«4ª - FX OTC Forward.
«5ª - FX OTC SWAP (1-я нога).
«6ª - FX OTC SWAP (2-я нога).
@dealDateTime
Дата и время заключения сделки
xs:dateTime
Актуально
*.4
[1]
с версии 27
@BankName
Наименование Банка
xs:string
Актуально
*.5
[1]
с версии 27
@ClientName
Наименование Клиента
xs:string
Актуально
*.6
[1]
с версии 27
*.7
@TradeType
Признак сделка покупки/продажи. Возможные
xs:string
Актуально
значения: «Bª - Сделка покупки. «Sª - Сделка
[1]
с версии 27
продажи.
*.8
@dealerSB
Наименование дилера со стороны Сбербанка
xs:string [min: 1,
Простой тип XML
Изменено в
[1]
max: 255]
Schema
версии 30
@DealerSB
*.9
@Rate
Обменный курс сделки
xs:string
Актуально
[1]
с версии 27
*.10
@OtherDetails
Иные условия
xs:string
[0..1
Актуально
]
с версии 27
*.11
@DealQuantity
Сумма сделки в валюте расчетов
xs:string
[0..1
Актуально
]
с версии 27
*.12
@Swap
Сделка СВОП
BoolType
Двоичное
Актуально
[1]
значение: 0 или 1
с версии 27
*.13
@payeeAccount
Счет получателя
AccNumType
Простой тип XML
Изменено в
Schema
[1]
версии 30
@PayeeAccount
БИК
*.14
@bic
BicType
Простой тип XML
Изменено в
Schema
[1]
версии 30
@Bic
*.15
@swift
SWIFT-код
BICIdentifier
Простой тип XML
Изменено в
[1]
Schema
версии 30
@Swift
Ноги сделки
tns:DealLegType
[0..1
Актуально
*.3
DealLegs
]
с версии 27
CurSumA
Сумма и валюта, выплачиваемая стороной А
xs:string
[0..1
Актуально
*.1
]
с версии 27
CurSumB
Сумма и валюта, выплачиваемая стороной Б
xs:string
[0..1
Актуально
*.2
]
с версии 27
*.3
ValueDateA
Дата валютирования для стороны А
xs:date
[0..1
Актуально
]
с версии 27
*.4
ValueDateB
Дата валютирования для стороны Б
xs:date
[0..1
Актуально
]
с версии 27
BankDetailsA
Банковские реквизиты Стороны А
xs:string
[0..1
Актуально
*.5
]
с версии 27
BankDetailsB
Банковские реквизиты Стороны Б
xs:string
[0..1
Актуально
*.6
]
с версии 27
FirstPaymentRat
Обменный курс первоначального платежа
xs:string
[0..1
Актуально
*.7
eSwap
]
с версии 27
LastPaymentRat
Обменный курс окончательного платежа
xs:string
[0..1
Актуально
*.8
eSwap
]
с версии 27
*.9
CurSumASwap
Сумма первоначального платежа и валюта для
xs:string
[0..1
Актуально
Стороны А
]
с версии 27
*.10
CurSumBSwap
Сумма первоначального платежа и валюта для
xs:string
[0..1
Актуально
Стороны Б
]
с версии 27
FistPaymentDate
Дата первоначального платежа для Стороны А
xs:date
[0..1
Актуально
*.11
ASwap
]
с версии 27
FistPaymentDate
Дата первоначального платежа для Стороны Б
xs:date
[0..1
Актуально
*.12
BSwap
]
с версии 27
PaymentDetails
Сумма окончательного платежа и валюта для
xs:string
[0..1
Актуально
*.13
ASwap
Стороны А
]
с версии 27
PaymentDetailsB
Сумма окончательного платежа и валюта для
xs:string
[0..1
Актуально
*.14
Swap
Стороны Б
]
с версии 27
*.15
LastPaymentDat
Дата окончательного платежа для Стороны А
xs:date
[0..1
Актуально
eASwap
]
с версии 27
*.16
LastPaymentDat
Дата окончательного платежа для Стороны Б
xs:date
[0..1
Актуально
eBSwap
]
с версии 27
*.17
Currency1
Первая валюта из пары
xs:string
[0..1
Актуально
]
с версии 27
Currency2
Вторая валюта из пары (валюта расчетов)
xs:string
[0..1
Актуально
*.18
]
с версии 27
Currencies
Валюты: cCY1/cCY2
xs:string
[0..1
Актуально
*.19
]
с версии 27
ПИ
tns:SIType
[0..1
Актуально
*.3
SI
]
с версии 27
SIInfos
ПИ для всей сделки или для первой ноги
SIInfoTypes
ПИ
[0..1
Актуально
*.1
]
с версии 27
SIInfo
ПИ
SIInfoType
ПИ по сделке
[0..n
Актуально
*.1
]
с версии 27
Идентификатор ПИ в DD
xs:string [min: 1,
Простой тип XML
Актуально
*.1
@sIID
[1]
max: 255]
Schema
с версии 27
*.2
@isSSI
Признак ПИ привязанной под сделку.
BoolType
Простой тип XML
Актуально
Возможные значения:
Schema
с версии 27
[1]
«0ª - ПИ не является стандартной.
«1ª - ПИ является стандартной (SSI).
Наименование ПИ
xs:string [min: 1,
Простой тип XML
Актуально
*.3
@sIName
[1]
max: 255]
Schema
с версии 27
Полное наименование ПИ
xs:string [min: 1,
Простой тип XML
Актуально
*.4
@sIFullNa
[0..1
max: 255]
Schema
с версии 27
me
]
*.5
@Correspo
Банковские реквизиты стороны Контрагента
xs:string
[0..1
Актуально
ndentBank
с версии 27
Details
*.6
@BankDet
Банковские реквизиты стороны Сбербанка
xs:string
[0..1
Актуально
ails
]
с версии 27
Валюта ПИ
xs:string [min: 1,
Простой тип XML
Актуально
*.7
@sICcy
[1]
max: 3]
Schema
с версии 27
*.8
@sIType
Тип ПИ.
xs:string [min: 2,
Простой тип XML
Актуально
Возможные значения:
max: 2]
Schema
с версии 27
«FXª - Валютная ПИ.
[1]
«RUª - Рублевая ПИ.
«FSª - ПИ для мягких валют.
Счет Клиента.
xs:string [min: 1,
Простой тип XML
Актуально
*.9
@sIAcc
[1]
max: 255]
Schema
с версии 27
Наименование Клиента
xs:string [min: 1,
Простой тип XML
Актуально
*.10
@cptyNam
[1]
max: 255]
Schema
с версии 27
e
Счет - корреспондент
xs:string [min: 1,
Простой тип XML
[0..1
Актуально
*.11
@sICorAcc
max: 255]
Schema
]
с версии 27
Наименование Банка
xs:string [min: 1,
Простой тип XML
Актуально
*.12
@sIBankN
[0..1
max: 255]
Schema
с версии 27
ame
]
SWIFT-код Банка
xs:string [min: 1,
Простой тип XML
Актуально
*.13
@sIBankS
[0..1
max: 255]
Schema
с версии 27
WIFT
]
Наименование Банка, где открыт
xs:string [min: 1,
Простой тип XML
Актуально
*.14
@sICorBa
[0..1
корреспондентский счет
max: 255]
Schema
с версии 27
nkName
]
SWIFT-код Банка корреспондентского счета
xs:string [min: 1,
Простой тип XML
Актуально
*.15
@sICorBa
[0..1
max: 255]
Schema
с версии 27
nkSWIFT
]
SIInfos2
ПИ по второй ноге сделки
SIInfoTypes
ПИ
[0..1
Актуально
*.2
]
с версии 27
SIInfo
ПИ
SIInfoType
ПИ по сделке
[0..n
Актуально
*.1
]
с версии 27
Идентификатор ПИ в DD
xs:string [min: 1,
Простой тип XML
Актуально
*.1
@sIID
[1]
max: 255]
Schema
с версии 27
*.2
@isSSI
Признак ПИ привязанной под сделку.
BoolType
Простой тип XML
Актуально
Возможные значения:
Schema
с версии 27
[1]
«0ª - ПИ не является стандартной.
«1ª - ПИ является стандартной (SSI).
Наименование ПИ
xs:string [min: 1,
Простой тип XML
Актуально
*.3
@sIName
[1]
max: 255]
Schema
с версии 27
Полное наименование ПИ
xs:string [min: 1,
Простой тип XML
Актуально
*.4
@sIFullNa
[0..1
max: 255]
Schema
с версии 27
me
]
@Correspo
Банковские реквизиты стороны Контрагента
xs:string
[0..1
Актуально
*.5
ndentBank
с версии 27
Details
*.6
@BankDet
Банковские реквизиты стороны Сбербанка
xs:string
[0..1
Актуально
ails
]
с версии 27
Валюта ПИ
xs:string [min: 1,
Простой тип XML
Актуально
*.7
@sICcy
[1]
max: 3]
Schema
с версии 27
*.8
@sIType
Тип ПИ.
xs:string [min: 2,
Простой тип XML
Актуально
Возможные значения:
max: 2]
Schema
с версии 27
«FXª - Валютная ПИ.
[1]
«RUª - Рублевая ПИ.
«FSª - ПИ для мягких валют.
Счет Клиента.
xs:string [min: 1,
Простой тип XML
Актуально
*.9
@sIAcc
[1]
max: 255]
Schema
с версии 27
Наименование Клиента
xs:string [min: 1,
Простой тип XML
Актуально
*.10
@cptyNam
[1]
max: 255]
Schema
с версии 27
e
Счет - корреспондент
xs:string [min: 1,
Простой тип XML
[0..1
Актуально
*.11
@sICorAcc
max: 255]
Schema
]
с версии 27
Наименование Банка
xs:string [min: 1,
Простой тип XML
Актуально
*.12
@sIBankN
[0..1
max: 255]
Schema
с версии 27
ame
]
SWIFT-код Банка
xs:string [min: 1,
Простой тип XML
Актуально
*.13
@sIBankS
[0..1
max: 255]
Schema
с версии 27
WIFT
]
Наименование Банка, где открыт
xs:string [min: 1,
Простой тип XML
Актуально
*.14
@sICorBa
[0..1
корреспондентский счет
max: 255]
Schema
с версии 27
nkName
]
SWIFT-код Банка корреспондентского счета
xs:string [min: 1,
Простой тип XML
Актуально
*.15
@sICorBa
[0..1
max: 255]
Schema
с версии 27
nkSWIFT
]
Электронная подпись
DigitalSign
Актуально
*.4
Sign
[0..1
с версии
]
27
Поставщик сертификата.
Простой тип XML
Актуально
*.1
Issuer
xs:string [min: 1,
Обязательно и достаточно для идентификации
Schema
с версии
max: 1024]
[0..1
клиентского сертификата в СББОЛ передавать
27
]
атрибут CN поля Issuer в виде «CN=<значение
атрибута>ª
Серийный номер сертификата
Простой тип XML
Актуально
*.2
SN
xs:string [min: 1,
[0..1
Schema
с версии
max: 255]
]
27
Значение ЭП
Простой тип XML
Актуально
*.3
Value
xs:base64Binary
[0..1
Schema
с версии
]
27
Имя схемы подписи
Простой тип XML
Актуально
*.4
DigestName
xs:string
[0..1
Schema
с версии
]
27
Версия схемы подписи
Простой тип XML
Актуально
*.5
DigestVersion
xs:string
[0..1
Schema
с версии
]
27
4.4.3.Формат запроса с «Сообщением о подтверждении сделкиª
Request/DealAns
Версионнос
Элемент
Описание элемента
Тип
Описание типа
Мн.
ть
Request
Запрос УС к СББОЛ
Request
Актуально с
[1]
версии 27
1
@requestId
Уникальный идентификатор запроса
UuidSeparated
UUID с
разделителями в
виде дефисов.
Актуально с
[1]
Набор из 32
версии 27
символов [0-9], [a-
f] и дефисов
2
@orgId
Идентификатор организации в ДБО (может
UuidSeparated
UUID с
быть использован сторонней системой для
разделителями в
дополнительной идентификации)
виде дефисов.
Актуально с
[1]
Набор из 32
версии 27
символов [0-9], [a-
f] и дефисов
3
@version
Номер версии формата обмена
xs:string
Простой тип XML
Актуально с
RegEx: "[0-
Schema
[1]
версии 27
9\.]{1,20}"
4
@sender
Система-отправитель
xs:string
Простой тип XML
RegEx: «[-a-zA-
Schema
Актуально с
[1]
Zа-яА-Я0-9:
версии 27
_]{1,20}ª
5
@receiver
Система-получатель Если система получатель
xs:string
Простой тип XML
СББОЛ, то SBBOL_DBO
RegEx: «[-a-zA-
Schema
[0..1
Актуально с
Zа-яА-Я0-9:
]
версии 27
_]{1,20}ª
6
@ protocolVersion
Версия протокола
xs:string
Простой тип XML
[0..1
Актуально с
Schema
]
версии 27
7
DealAns
Ответ о подтверждении сделки
DealAns
Ответ о
Актуально с
подтверждении
[1]
версии 27
сделки
*.1
@docExtId
Идентификатор сообщения о подтверждении
UuidSeparated
UUID с
сделки АС СББОЛ
разделителями в
виде дефисов.
Актуально с
Набор из 32
[1]
версии 27
символов [0-9], [a-
f] или [A-F] и
дефисов
*.2
Decision
Решение о подтверждении сделки
BoolType
Двоичное
Актуально с
[1]
значение: 0 или 1
версии 27
*.3
choice: должен присутствовать один из перечисленных ниже элементов
Актуально с
[1]
версии 27
*.1
SiId
Идентификатор платежной инструкции для
xs:string
Актуально с
[1]
сделки или для первой ноги
версии 27
*.2
NsiText
Комментарий к новой платежной инструкции
xs:string
Актуально с
[1]
для сделки или для первой ноги
версии 27
*.4
choice: должен присутствовать один из перечисленных ниже элементов
[0..1
Актуально с
]
версии 27
*.1
SiId2
Идентификатор платежной инструкции для
xs:string
Актуально с
[1]
второй ноги
версии 27
*.2
NsiText2
Комментарий к новой платежной инструкции
xs:string
Актуально с
[1]
для сделки или для первой ноги
версии 27
*.5
Sign
Подпись документа "Сообщение о
DigitalSign
Актуально с
[1]
подтверждении сделки"
версии 27
*.1
Issuer
Идентификатор поставщика сертификата
xs:string [min: 1,
Например, " issuer="E=IdleCA, C=RU, S=Idle
max: 1024]
Актуально с
[1]
CA, L=Idle CA, O=Idle CA, OU=Idle CA,
версии 27
CN=Idle CA" "
*.2
SN
Серийный номер сертификата
xs:string [min: 1,
Актуально с
[1]
max: 255]
версии 27
*.3
Value
Значение ЭП
xs:base64Binary
Актуально с
[1]
версии 27
*.4
DigestName
Имя схемы подписи
xs:string
[0..1
Актуально с
]
версии 27
*.5
DigestVersion
Версия схемы подписи
xs:string
[0..1
Актуально с
]
версии 27
*.6
PcPropHash
Уникальные свойтсва компьютера
xs:string
[0..1
Актуально с
отправителя (ХЭШ)
]
версии 27
*.7
Fraud
Данные для fraud-мониторинга. Информация о
Fraud
[0..1
Актуально с
подписи
]
версии 27
*.1
Login
Логин
xs:string
Актуально с
[1]
версии 27
*.2
TokenInfo
Данные токена Отображение в запросе
xs:string
(разделитель «;ª):
TOKEN;IС1_A10D0010L_C1_VT01KA02;2012
-04-13 09:44:59.003;TLS00041485B;100;1
Отображение в интерфейсе: 1. Тип токена:
Актуально с
TOKEN 2. Информация о конфигурации
[1]
версии 27
токена: IС1_A10D0010L_C1_VT01KA02 3.
Дата конфигурации: 2012-04-13 09:44:59.003 4.
Серийный номер токена: TLS00041485B 5.
Номер сборки токена: 100 6. Текущая учетная
запись (ПИН): 1
*.3
HttpAcceptLanguage
Список поддерживаемых естественных языков
xs:string
Требуется указать локализацию ОС
компьютера, на котором установлен БК,
Актуально с
Например, для английской локализации в
[1]
версии 27
качестве значения атрибута указывается - 'en-
US', для русской локализации указывается -
'ru-RU'.
*.4
IpMACAddresses
IP и Mac адреса компьютера отправившего
xs:string
Актуально с
или подписавшего. Формат:
[1]
версии 27
«remoteIP;remoteMac;ip1;mac1;ip2;mac2ª
*.5
GeolocationInfo
Геопозиционирование компьютера
xs:string
отправившего или подписавшего. Формат:
Актуально с
[1]
«Longitude;Latitude;HorizontalAccuracy;Timesta
версии 27
mp;Statusª
*.6
PcProp
Уникальные свойтсва компьютера
xs:string
отправившего или подписавшего. Формат:
Актуально с
«UUID;Идентификатор процессора;Серийный
[1]
версии 27
номер BIOS;Серийный номер жесткого
дискаª.
*.7
DevicePrint
Закодированное значение, полученное из
xs:string [min: 1]
[0..1
Актуально с
скрипта "rsa.js" (Фрод).
]
версии 27
*.8
Order
Очередность наложения подписи (какая
xs:int
подпись когда была наложена) в случае
[0..1
Актуально с
наложения подписи и удаления ее, порядок
]
версии 27
должен сдвигаться соответственно влево
*.9
SignDate
Дата/Время подписи Пример: 2012-04-13
xs:dateTime
[0..1
Актуально с
09:44:59.003
]
версии 27
4.5. Особенности получения статусов обработки из СББОЛ
Статус
№
(Клиент)/системное
Комментарий
п/п
название статуса на
англ. яз.
Ожидает
ЭД сформирован и предзаполнен поступившими параметрами на стороне
1
подтверждения/ToBeCo
Клиента по запросу от СББОЛ
nfirmed
ЭД не прошел логические контроли СББОЛ при сохранении (отрицательный
результат)
2
Ошибка контроля/Invalid
В случае, если ошибки будут исправлены, документ может быть сохранен в
статусе «На подтвержденииª
ЭД был изменен Клиентом, при этом документ соответствует всем правилам
оформления (прошел все логические контроли на стороне Клиента при
Ожидает
3
сохранении (положительный результат))
подписи/ToBeSigned
На данном статусе Клиент принимает решение о подтверждении или
отклонении сделки.
5
Подписан/Signed
ЭД был подписан единственной, или первой, или второй подписью
PARTLY_SIGNED
6
ЭД был подписан неполным набором подписей.
(Частично подписан)
ЭД принят Банком и успешно сохранен в БД
С данного статуса документ может быть переведен автоматически на статусы
7
Доставлен/Delivered
«Ошибка реквизитовª, «АСП/ЭЦП не вернаª, «Принятª и «вручнуюª на статус
«Принятª
ЭП/АСП не
8
Проверка подписи под ЭД на стороне Банка дала отрицательный результат
верна/Invalideds
Ошибка реквизитов/
ЭД не прошел логические контроли системы ДБО при приеме на стороне
9
Requisite_Error
Банка (отрицательный результат)
10
Принят/Accepted
ЭД принят на стороне Банка
12
Подтвержден/Confirmed
ЭД прошел все контроли, сделка принята.
13
Отклонен/Rejected
ЭД прошел все контроли, сделка отклонена
Отказан
14
ЭД не прошел контроли системы (отрицательный результат)
АБС/DeclinedByBank
История изменений
Дата
Версия
Описание
Флаг
совместимости
Версия 31.000.00
30.08.
1.70
Совместимо с
В дайджесте СВО изменено описание поля
2018
предыдущей
CurDeal.Contract.NumCheck
версией
30.08.
1.71
Рекомендуется
2018
Изменено описание поля
тестирование со
Response/CurrencyNotices/СurrencyNotice
стороны УС
клиента
25.09.
1.72
Не совместимо с
Из дайджеста документа «Сведения о валютной операцииª
2018
предыдущей
удалено поле DocData.Adjustment
версией
26.09.
1.73
Не совместимо с
Изменено описание поля ICSContractTypeCode для
2018
предыдущей
Request/DealPassICS и Request/IcsRestruct181I
версией
26.09.
1.74
Рекомендуется
2018
Изменено описание полей блока AuthPers в формате запроса и
тестирование со
даджесте документов
стороны УС
клиента
27.09.
1.75
Изменено описание элемента AttachmentSign для
Совместимо с
2018
Request/CurrDealCertificate181I, Request/ConfDocCertificate181I,
предыдущей
Request/DealPassICS
версией
27.09.
1.76
Рекомендуется
Изменено описание элемента ICSContractSubTypeCode для
2018
тестирование со
Request/DealPassICS, Response/ListIntCtrlStatement181I,
стороны УС
Request/IcsRestruct181I
клиента
28.09.
1.77
Уточнены возможные значения элементов блока
Совместимо с
2018
TrancheInfo/Code и изменено описание элемента BasePay для
предыдущей
Request/DealPassICS и Request/IcsRestruct181I
версией
Изменено описание элементов и соответствующих элементов в
02.10.
1.78
Рекомендуется
дайджесте (уточнение типа xs:date):
2018
тестирование со
Request/CurrDealCertificate181I/DocData/@docDate
Request/CurrDealCertificate181I/DocData/Payment/DocDate
стороны УС
Request/CurrDealCertificate181I/CurrDealCertificateDocs181I/Curr
клиента
DealCertificateDoc181I/Contract/@date
Request/CurrDealCertificate181I/CurrDealCertificateDocs181I/Curr
DealCertificateDoc181I/ExpectedTerm
Request/ConfDocCertificate181I/DocData/@docDate
Request/ConfDocCertificate181I/DocData/@statementFrom
Request/ConfDocCertificate181I/ConfDocCertificateDocs181I/Conf
DocCertificateDoc181I/ConfDoc/@date
Request/ConfDocCertificate181I/ConfDocCertificateDocs181I/Conf
DocCertificateDoc181I/ExpectedTerm
Request/DealPassICS/DocData/@docDate
Request/DealPassICS/ICSData/EndDate
Request/DealPassICS/TrancheInfo/Oper/Date
Request/DealPassICS/HelpInfo/PaymentLoan/DebtPaymentLoan/
PrincipalDate
Request/DealPassICS/HelpInfo/PaymentLoan/DebtPaymentLoan/
DatePay
Response/ListIntCtrlStatement181I/IntCtrlStatement181I/DocData/
@docDate
Response/ListIntCtrlStatement181I/IntCtrlStatement181I/ComData
ConCred/Date
Response/ListIntCtrlStatement181I/IntCtrlStatement181I/ComData
ConCred/EndDate
Response/ListIntCtrlStatement181I/IntCtrlStatement181I/TrancheIn
fo/Oper/Date
Response/ListIntCtrlStatement181I/IntCtrlStatement181I/HelpInfo/
PaymentLoan/DebtPaymentLoan/PrincipalDate
Response/ListIntCtrlStatement181I/IntCtrlStatement181I/HelpInfo/
PaymentLoan/DebtPaymentLoan/DatePay
Response/ListIntCtrlStatement181I/IntCtrlStatement181I/DPEnd/D
PEndData/ValueDate
Response/ListIntCtrlStatement181I/IntCtrlStatement181I/DPEnd/D
PEndData/DPEndDate
Response/ListIntCtrlStatement181I/IntCtrlStatement181I/DPRe/DP
ReissueData/DPReDate
Response/ListIntCtrlStatement181I/IntCtrlStatement181I/DPRe/DP
ReissueData/DocDate
Request/IcsRestruct181I/DocData/@docDate
Request/IcsRestruct181I/IcsRestruct/ICSData/ICSDate
Request/IcsRestruct181I/IcsRestruct/ICSData/TableDealPassIcs/C
hapterInfo/ConCredInfo/EndDate
Request/IcsRestruct181I/IcsRestruct/ICSData/TableDealPassIcs/C
hapterInfo/TrancheInfo/Date
Request/IcsRestruct181I/IcsRestruct/ICSData/TableDealPassIcs/C
hapterInfo/HelpInfo/PaymentLoan/DebtPaymentLoan/PrincipalDate
Request/IcsRestruct181I/IcsRestruct/ICSData/TableDealPassIcs/C
hapterInfo/HelpInfo/PaymentLoan/DebtPaymentLoan/DatePay
Request/IcsRestruct181I/IcsRestruct/ICSData/GroundInfo/Ground/
DocData/@docDate
03.10.
1.79
Не совместимо с
Изменено описание поля
2018
предыдущей
Request/MandatorySal/Subtract/Sum/@docSum
версией
03.10.
1.80
В Request/DealPassICS добавлены новые элементы:
Совместимо с
ICSData/RegistrationDate
2018
предыдущей
ICSData/CloseDate
ICSData/RegBankNum
версией
Изменено максимальное кол-во символов в элементах:
04.10.
1.81
Совместимо с
Request/CurrDealCertificate181I/CurrDealCertificateDocs181I/Curr
2018
DealCertificateDoc181I/OperInfo/OperName - 2000
предыдущей
Request/ConfDocCertificate181I/ConfDocCertificateDocs181I/Doc
версией
Name - 2048
Версия 32.000.00
Из формата запроса и дайджеста ВПП исключены группы полей
19.12.
1.82
Не совместимо с
Request/PayDocCur/VoSumInfo(Коды видов валютных операций
2018
предыдущей
(Инструкция ЦБ РФ № 138-И от 04.06.2012)) и
версией
Request/PayDocCur/VoDocs(Обосновывающие документы),
поскольку не используются по инструкции 181I,
соответствующая информация теперь передается в СВО
19.12.
1.83
Совместимо с
Формулировка «с двумя точками после запятойª изменена на «с
2018
предыдущей
точностью до сотыхª
версией
19.12.
1.84
Раздел «Заявление о внесении изменений в сведения о
Совместимо с
2018
контрактеª переименован в «Заявление о внесении изменений в
предыдущей
I раздел ВБКª
версией
09.01.
1.85
Не совместимо с
Из форматов и даджестов запросов в банк исключен блок полей
2019
предыдущей
Attachments
версией
Версия 32.001.00
Для использования версии документации 32.001.00, следует
указывать в запросах и документах значение
@protocolVersion=32
Добавлено уточнение, что значение
18.02.
1.86
Совместимо с
big_file_sms_digest_hash_algorithm нужно брать из справочника
2019
предыдущей
CommonSetting, а BF_TOKEN_SIGN_ENABLED из справочника
версией
DocTypeParam
28.02.
1.87
Рекомендуется
2019
В формате запроса ВПП Request/PayDocCur исключено
тестирование со
описание обязательного указания элемента @option56a
стороны УС
клиента
В связи с изменения по 595-П, увеличиена размерность
07.03.
1.88
Совместимо с
следующих элементов до 160 символов:
2019
предыдущей
Request/CurrSell/Trans/AccountSell/Bank/Name
версией
Request/CurrSell/Trans/AccountCredit/Bank/Name
Request/MandatorySale/AccDoc/Bank/Name
Request/MandatorySale/ObligatorySale/Account/Bank/Name
Request/MandatorySale/Sell/Acc/Bank/Name
Не совместимо с
03.04.
1.89
В описании формирования дайджестов документов исправлено
2019
предыдущей
Table=BigFileAttachments на Table=EssenceAttachment
версией
16.04.
1.90
Рекомендуется
2019
тестирование со
Изменено описание Request/PayDocCur/BankPayer_52/Name
стороны УС
клиента
16.04.
1.91
Рекомендуется
В Request/PayDocCur/Payer_50 добавлено уточнение о
2019
тестирование со
максимальной длине полей Name, Address, Place, при
стороны УС
использовании @option50a="K"
клиента
В СВО стали обязательными поля:
Не совместимо с
16.04.
1.92
DocData/Payment/OperDate
2019
предыдущей
DocData/@docDate
версией
Изменено описание
CurrDealCertificateDocs181I/CurrDealCertificateDoc181I/DataCom
position
CurrDealCertificateDocs181I/CurrDealCertificateDoc181I/TermOfP
ayment
CurrDealCertificateDocs181I/CurrDealCertificateDoc181I/OperInfo
CurrDealCertificateDocs181I/CurrDealCertificateDoc181I/Expected
Term
BigFileAttachments
Версия 33.000.00
Не совместимо с
28.06.
1.92
В дайджесте справки о подтверждающих документах
2019
исправлено правило сортировки элемента TABLES:
предыдущей
Сортировать в порядке следования элементов в xml
версией
Не совместимо с
01.07.
1.93
В Request/MandatorySale/CurrDealInquiry/@docNum не должно
2019
предыдущей
быть “null”
версией
01.07.
1.94
Совместимо с
Для запросов в банк, элемент DocData/@bankNum помечен как
2019
предыдущей
«В настоящее время не используетсяª
версией
В разделы «Особенности получения статусов об обработке из
01.07.
1.95
Совместимо с
СББОЛª добавлена информация о том, что Путем запроса со
2019
предыдущей
стороны УС в формате Request/DocIds/DocId в
версией
Tickets/Ticket/Info/BankDate/@statusDateTime возвращается дата
и время присвоения статуса.
В формате ответа «Формат передачи клиенту документа
02.07.
1.96
Рекомендуется
Уведомление о зачислении (поступлении) иностранной валюты
2019
тестирование со
на транзитный валютный счетª удален элемент
стороны УС
Response/CurrencyNotices/СurrencyNotice/@docExtId
клиента
Исправлено наименование элемента
Не совместимо с
02.07.
1.97
Request/DealPassICS/NumPSOtherBank в NumOtherBank,
предыдущей
2019
изменен пример в дайджесте
версией
Из описания элементов Option50a, Option56a, Option57a,
02.07.
1.98
Совместимо с
Option59a, в дайджесте ВПП, удалены возможные их значения,
2019
предыдущей
т.к. значения описаны в формате запроса.
версией
Изменено описание элементов ..LinkedDocs/LDoc/@docExtId и
02.07.
1.99
Рекомендуется
..LinkedDocs/LDoc/@docId
2019
тестирование со
стороны УС
клиента
В форматах запросов изменено описание @branchSystemName.
02.07.
2.00
Рекомендуется
2019
тестирование со
стороны УС
клиента
Из дайджестов исключено описания правила заполнения поля
02.07.
2.01
Совместимо с
BankName.
2019
предыдущей
версией
Request/MandatorySale/ObligatorySale обязателен для передачи,
02.07.
2.02
Рекомендуется
Уточнено возможное значение
2019
тестирование со
Request/MandatorySale/ObligatorySale/Sum/@docSum
стороны УС
клиента
Переименованы(приведены в соответствие с XSD) в
Не совместимо с
02.07.
2.03
Request/DealPassICS/ICSData/Curr элементы:
предыдущей
2019
@code->@currCode
версией
@IsoCode->@currIsoCode
Элемент Commision.ComAcc.Bank.Name удален из дайджеста
Не совместимо с
02.07.
2.04
документа «Распоряжение на осуществление обязательной
предыдущей
2019
продажиª
версией
Уменьшена длина поля (приведена в соответствие с мастер-
Не совместимо с
02.07.
2.05
системой) SettlementType в документах: Поручение на продажу
предыдущей
2019
валюты, Распоряжение на осуществление обязательной продажи
версией
Изменено описание полей в Request/IcsRestruct181I:
02.07.
2.06
Рекомендуется
BeneficiarInfo
2019
тестирование со
BeneficiarInfo/BeneficiarId
стороны УС
клиента
Снято нижнее ограничение количества цифр ОГРН
02.07.
2.07
Рекомендуется
2019
тестирование со
стороны УС
клиента
В дайджесте Request/MandatorySale исправлено описание
20.11.
2.08
Рекомендуется
ObligatorySale.Type
2020
тестирование со
стороны УС
клиента
В Response/Tickets/Ticket/Info/AddInfo/PayDocCur добавлен блок
29.01.
2.09
Рекомендуется
CurComplianceInquiries для получения информации по
2021
тестирование со
уточнению валютного перевода. Для статуса документа
IMPLEMENTED Response/PayDocCur дополнены параметры
стороны УС
ответа.
клиента
Для статуса документа IMPLEMENTED Response/PayDocCur
11.02.
2.10
Рекомендуется
дополнен параметром @docExtId
2021
тестирование со
стороны УС
клиента
В запросе Request/IcsRestruct181I добавлено описание поля
27.09.
2.11
Рекомендуется
ChangedContentInfo.
2022
тестирование со
стороны УС
клиента
Работа канала УПШ в режиме «Stand-in 99.99»
Режим «Stand-in 99.99» - это предоставления пользователям ограниченного набора услуг в режиме
технологического окна.
Вопрос:
Как узнать, что Банк (СББОЛ) в режиме «Stand-in 99.99»?
Ответ:
В ответе на запрос preLogin \ preLoginSign, последний параметр <return> принимает значение
U1RBTkRJTl85OTk5 в кодировке Base64, что с декодирования означает STANDIN_9999, в обычном режиме
<return> принимает значение <return>TUFJTg==</return> , что с декодирования означает MAIN
Пример:
<preLoginResponse xmlns="http://upg.sbns.bssys.com/">
<return>MTg4NTMxMmZhMA==</return>
<return>UdDLEjjYMcJxMjUVW+aayK77AAxW5thpsGCVbewk22Q=</return>
<return>NTcwNjM1ZjgtMGZjZC00YjEwLWEwMDMtNDVhY2M3ZTkwNjZk</return>
<return>AA==</return>
<return>U1RBTkRJTl85OTk5</return>
</preLoginResponse>
<preLoginSignResponse xmlns="http://upg.sbns.bssys.com/">
<return/>
<return>KWNNGSnmM9K/fiItRSdpxT4yDs3YXfUbBar+Mwfe6xg=</return>
<return>M2E3OGQzZjktMDg0Zi00OWMzLTkyNDgtM2MxNjkxM2I1Yzg2</return>
<return>AA==</return>
<return>U1RBTkRJTl85OTk5</return>
</preLoginSignResponse>
Услуги, с которыми можно работать в режиме «Stand-in 99.99»:
№
Наименование услуги в СББОЛ
Request \ Response в УПШ
1
Входящее платежное требование
PayRequest
2
Запрос на выписку по рублевому счету
StmtReqType
3
Заявление на акцепт/частичный акцепт/отказ от акцепта
Accept
4
Исходящее Платежное требование
PayRequest
5
Письмо в Банк
LetterInBank
6
Письмо из Банка
LettersFromBank
7
Платежное поручение
PayDocRu
8
Реестр задолженностей
DebtRegistry
9
Реестр платежей
FeesRegistry
10
Электронный реестр (Зарплатная ведомость)
SalaryDoc
11
Электронный реестр на открытие счетов и выпуск карт
RegOfIssCards
Загрузка файла в систему БФ
1. Для этого требуется сформировать запрос EssenceLinks, используя метод sendRequestsSRP. В
запросе требуется указать тип загружаемой сущности (DOC - документов), тип передаваемого
документа(DebtRegistry) и уникальный идентификатор запроса(LinkUUID), который
генерируется на стороне клиента, формат см͘ в файле ниже͘
В ответ получаем тикет͘ По тикету методом getRequestStatusSRP получаем ссылки на загрузку
реестра WebUploadLink, идентификатор задачи на загрузку файла UploadJobId.
Пример запроса EssenceLinks и получение ссылки на загрузку:
EssenceLinks .txt
2. Загрузить файл в БФ методом POST͘ Чтобы запросить статус загруженного файла использовать
запрос BigFilesStatusRequest. По ссылке методом Http Post отправляем файл͘ Ссылка состоит из
двух частей: ссылка на систему Большие файлы и ссылка, полученная из предыдущего шага͘
Можно воспользоваться плагином для браузера postman͘ Через плагин выглядит так:
Пример запроса на проверку статуса файла вложения загруженного в БФ
<Request xmlns='http://bssys.com/upg/request' orgId='4ede2656-2923-4567-a679-100000000002'
requestId='e556c2e7-46f5-4f22-86f8-fb68a95965ef' version='01.016.01' sender='Сбербанк Бизнес'
receiver='SBBOL_DBO' protocolVersion = '31'>
<BigFilesStatusRequest>
<UploadJobId>d159ec45-cbac-4d4c-81b7-34d28ce567ce</UploadJobId>
</BigFilesStatusRequest>
<Sign>
<Issuer>CN=УЦ ПАО Сбербанк</Issuer>
<SN>76AA2B94E50FDF33139D</SN>
<Value>Tlcjy4aLqCVMweNKLjdkwPrws5jPAS6yZSrjtdkcJco4NYdt25DuKigPkYb84s1SG800vUkzjXs
dS5aITDUUuA==</Value>
<PcPropHash>18700A147E4CA94D4310E2048D78A5C46F5554CE2BBF120A08807AF71532507B
693CA6610E17D04487F481C569624C6BB442819975595732F06165DD0FF5504E</PcPropHash>
<Order>0</Order>
<SignDate>2018-11-24T18:00:26</SignDate>
</Sign>
</Request>
Ответ на запрос статуса файла загруженного в БФ
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Response
sender="DBO"
version="7"
requestId="e556c2e7-46f5-4f22-86f8-fb68a95965ef"
responseId="d87bb5dd-c6af-4736-8f7e-05e3ad059cbf" createTime="2018-11-24T18:00:33.699+03:00"
xmlns="http://bssys.com/upg/response">
<BigFilesStatus>
<BigFilesStatus>
<UploadJobId>d159ec45-cbac-4d4c-81b7-34d28ce567ce</UploadJobId>
<Status>FINISHED_DMZ_TO_ALPHA</Status>
</BigFilesStatus>
</BigFilesStatus>
</Response>
Если в ответ вернулись статусы FINISHED или FINISHED_DMZ_TO_ALPHA, то загрузка больших
файлов закончена.
Выписка Холдинги
Получение персональных данных Головной компанией.
Для получения персональных данных Головной Компании и идентификаторов Дочерних Организаций,
требуется отправить запрос PersonalInfo с orgId="00000000-0000-0000-0000-000000000000", если orgId
Головной Компании известен, то нули нужно заполнить orgId Головной Компании.
В полученном ответе OrganizationsInfo на запрос PersonalInfo приходят все реквизиты и идентификаторы для
дальнейшей работы͘
В теге <OrgId> приходит идентификатор ГК организации;
В теге <HoldingOrgs> приходят идентификаторы подключенных ДО;
Пример:
Получение персональных данных Головной Компанией по Дочерним
Организациям.
Далее нужно получить персональные данные Дочерних Организаций, для этого нужно:
1.
Получить сессию по сертификату пользователем Головной Компании preLoginSign, loginSign.
2. Сформировать запрос PersonalInfo c указанием orgId Дочерних Организации пришедших в теге
<HoldingOrgs>
3. В ответе OrganizationsInfo придет персональные данные ДО.
Если ДО множество, то нужно сделать аналогичный запрос на каждый orgId ДО.
Пример:
13.02.2018 v1.0
Запрос на формирование информации о движении денежных средств Головной
Компанией по счетам Дочерних Организаций.
Пример запроса StmtReq до получения конечного статуса IMPLEMENTED: ↓
Запрос StmtReq.txt
1. Формируем запрос Головной Компанией StmtReq (Запрос на формирование информации о движении
денежных средств), перечисляем счета в рамках одной Дочерней Организации (одного orgId);
2. Получаем сессию по сертификату (preLoginSign, loginSign) пользователем Головной Компании,
отправляем запрос StmtReq с помощью метода sendRequestsSRP;
3. В ответ приходит тикет
4. Запрашиваем статус запроса, используем метод getRequestStatusSRP, в теге requests указываем тикет
из п.3., в теге sessionId указываем идентификатор сессии Головной Компании, полученный в п.2, в теге
orgId указываем идентификатор Головной Компании͘
5. В ответ приходит статус запроса --- statusStateCode, идентификатор документа в Банке --- docId, время
начала обработки документа --- createTime;
ВАЖНО!!!
Время начала обработки документа createTime="2018-02-08T13:10:00.161+03:00" требуется
запомнить для получения выписок описанного в пункте 9.
13.02.2018 v1.0
statusStateCode="DELIVERED" - это конечный, положительный статус запроса XML, НЕ
результат обработки документа, статус означает, что запрос доставлен до Банка͘
6. Запрашиваем информацию о результатах обработки документа из п.1, используя запрос docId и метод
sendRequestsSRP͘ При формировании запроса, в теге orgId требуется указать идентификатор Дочерней
Организации, в теге docId указать идентификатор документа пришедший в п.5.
В ответ приходит тикет:
7. Запрашиваем статус запроса docId, используем метод getRequestStatusSRP, в теге requests указываем
тикет из п.6͘, в теге sessionId указываем идентификатор сессии, полученный в п.2 или новый, в теге
orgId указываем идентификатор Дочерней Организации.
8. В ответ приходит статус обработки документа, конечный, положительный статус для запроса StmtReq
является statusStateCode="IMPLEMENTED", это означает, что выписка сформирована, и лежит на Банке
для забора͘
Получение информации о движении денежных средств (Выписка) Головной
Компанией по счетам Дочерних Организаций.
Пример запроса Incoming и получение Выписки:↓
Incoming.txt
9. Что бы забрать подготовленную выписку по запросу StmtReq из п.1, требуется сформировать запрос
Incoming (Запрос о получении подготовленных данных) используя метод sendRequestsSRP. В запросе
перечисляем счета по которым запрашивали выписку из п.1., в теге orgId идентификатор Головной
организации͘
13.02.2018 v1.0
В ответ приходит тикет:
10. Запрашиваем статус запроса, используем метод getRequestStatusSRP, в теге requests указываем тикет
из п.9͘, в теге sessionId указываем идентификатор сессии Головной компании, в теге orgId указываем
идентификатор Головной Компании͘
В ответе в теге <Statementsх͙͙ </Statementsх приходит выписка:
13.02.2018 v1.0
Зарплатная ведомость
I.
Получаем реквизиты Дочерних Организаций для формирования документа SalaryDoc (Зарплатная ведомость)
см͘ инструкцию «Получение Реквизитов»
↓
Инструкция.
Получение Реквизит
В ответе на получение реквизитов по Дочерней Организации в <OrganizationsInfo> в теге <SalaryContracts>
приходят реквизиты зарплатного договора:
accept="0" - Без резервирования
accept="1"- Резервирование
II.
Формируем документ SalaryDoc (Зарплатная ведомость), зарплатный договором с Резервированием͘
Пример:
↓
SalaryDoc_accept=1.xml
Описание заполнения полей:
¾ Для заполнения тега bankName требуется:
a. Получить реквизиты Дочерней Организации, смотри п͘1, в блоке <OrgBranches> запомнить значение
тега branchId="4ede2656-2923-4567-a679-100000001388".
b. Найти блок <Branches> с тегом равным значению branchId из пункта «а».
c. В найденном блоке <Branches> в теге <SystemName>1387</SystemName> находится значение для
заполнения bankName = '1387'
¾ Для заполнения атрибута admissionValue блока <SalContract> требуется запросить справочник «Видов
зачисленияͩ SalType. В данном примере используется значение «1» - Заработная плата͘
¾ Для заполнения атрибутов блока <SalContract> требуется взять данные, из блока <SalaryContracts> смотри
пункт «1».
Мапинг полей <SalContract> → <SalaryContracts>:
contrNum='38186689' → contrNum='38186689'
contrDate='2017-11-27' → contrDate='2017-11-27'
filialBankName='ДО №0173 Московского банка ПАО Сбербанк' → VSPName=ΗДО №0173 Московского
банка ПАО СбербанкΗ
filialBankNum='7970' → filialNum="7970"
bankINN='7715920898' → inn="7715920898"
III. Формируем документ SalaryDoc (Зарплатная ведомость), зарплатный договор без Резервирования͘
Пример:
↓
SalaryDoc_accept=0.xml
Важно!!!
Зарплатная ведомость с договором без резервирования, предполагает отправку Рублевого платежного
поручения на сумму равную ИТОГО документа Зарплатная ведомость͘
В назначении платежа «Рублевого платежного порученияͩ обязательно должна присутствовать запись
«Для зачисления по реестру 13 цель платежа - 01 Заработная плата в соответствии с договором 38186693 от
27.11.2017», где
13 - это номер документа Зарплатная ведомость,
38186693 - номер зарплатного договора,
27.11.2017 - дата заключения зарплатного договора͘
Описание заполнения полей:
Данный тип документа (договор без Резервирования) заполняется аналогично пункту «2», с добавлением
полей для указания реквизитов платёжного документа, чем было оплачено поступление средств, для
зачисления заработной платы͘
IV. Отправка документа в Банк͘
Пример всего транспорта:
↓
SalaryDoc.xml
1. Сформированный запрос подписываем пользователем Дочерней Организации.
2. Получаем сессию по сертификату (preLoginSign, loginSign) пользователем Головной Компании.
3. Отправляем сформированный запрос SalaryDoc с помощью метода sendRequestsSRP
4. В ответе приходит тикет
5. Запрашиваем статус запроса, используем метод getRequestStatusSRP, в теге requests указываем тикет из
п͘4͘, в теге sessionId указываем идентификатор сессии Головной Компании, в теге orgId указываем
идентификатор Дочерней Организации.
6. В ответ приходит статус запроса statusStateCode="DELIVERED", идентификатор документа на Банке docId=
"f045f104-1764-447d-81f7-684ddbd67c51":
¾ statusStateCode="DELIVERED" - это конечный, положительный статус запроса XML, НЕ результат
обработки документа, статус означает, что запрос доставлен до Банка͘
7. Запрашиваем информацию о результатах обработки документа, используем запрос docId и метод
sendRequestsSRP͘ При формировании запроса, в теге orgId требуется указать идентификатор Дочерней
Организации, в теге docId указать идентификатор документа пришедший в пункте «6».
В ответе приходит тикет:
8. Запрашиваем статус запроса docId, используем метод getRequestStatusSRP, в теге requests указываем
тикет из пункта «7», в теге sessionId указываем идентификатор сессии Головной Компании, в теге orgId
указываем идентификатор Дочерней Организации.
9. В ответе приходит статус обработки документа, конечный, положительный статус для запроса SalaryDoc
является statusStateCode="IMPLEMENTED" или statusStateCode="PARTIMPLEMENTED"
statusStateCode="IMPLEMENTED" - статус означает «Исполнен», все записи в Зарплатной Ведомости
обработаны без ошибок, и получили зачисление͘
Пример:
↓
IMPLEMENTED.xml
statusStateCode="PARTIMPLEMENTED" - статус означает «Частично исполнен», НЕ все записи в Зарплатной
Ведомости получили зачисление, с результатами и аннотации по каждой записи͘
Пример:
↓
PARTIMPLEMENTED.xml
1. Общие сведения
В промышленной среде после генерации ключей и отправки в банк запроса на сертификат через шлюз
СББОЛ необходимо направить в Банк печатную форму запроса на сертификат на бумажном носителе в трех
экземплярах. Данный документ, на примере запроса на выпуск нового сертификата в формате PKSC#10,
показывает, какие поля и какими значениями необходимо заполнить в печатной форме.
2. Пример запроса на выпуск нового сертификата в формате PKSC#10
-----BEGIN CMS-----
MIIIHgYJKoZIhvcNAQcCoIIIDzCCCAsCAQExDjAMBggqhQMHAQECAgUAMIICnQYJ
KoZIhvcNAQcBoIICjgSCAoowggKGMIICMwIBADCB5zE9MDsGA1UEAww00JLRgNC1
0LzQtdC90L3Ri9C5INCf0L7Qu9GM0LfQvtCy0LDRgtC10LvRjCDQotC10YHRgjEb
MBkGA1UEBAwS0JLRgNC10LzQtdC90L3Ri9C5MSowKAYDVQQqDCHQn9C+0LvRjNC3
0L7QstCw0YLQtdC70Ywg0KLQtdGB0YIxCzAJBgNVBAYTAlJVMRowGAYDVQQKDBHQ
ntCe0J4gItCS0JbQo9ClIjEVMBMGA1UEIQwM0YHRgtCw0LbQtdGAMR0wGwYJKoZI
hvcNAQkBFg5zZGZzZGZAc2Rmcy5kZjBmMB8GCCqFAwcBAQEBMBMGByqFAwICIwIG
CCqFAwcBAQICA0MABEBEIP6vInjiCkKUwCzTMsiXga8ABTZks2Vnv2m9zrgTD4zL
984HNewJS8BHEjcDe7DW0zQSsEp2ViSuzr0kj/ZfoIHbMIHIBgkqhkiG9w0BCQ4x
gbowgbcwLQYFKoUDZG8EJAwiVlBOLUtleS1UTFMg0LjRgdC/0L7Qu9C90LXQvdC4
0LUgMjAZBgcqhQMDewMFBA4MDFRMUzAwOTYwNTU5QjATBgNVHSAEDDAKMAgGBiqF
A2RxATAwBgcqhQMDewMBBCUMI0EwMDFZQTJGc9CS0YDQtdC80LXQvdC90YvQuSDQ
ny4g0KIuMBQGByqFAwN7AwQECQYHKoUDA3sFBDAOBgNVHQ8BAf8EBAMCA/gwDgYH
KoUDA3sECTEDAgEDMAoGCCqFAwcBAQMCA0EAbzQxBYWkupbxS/rHS4JtTxSEmJtI
GiDu4WVjDK6QotYtRSx2a378vktzY60XY16XOf12bP6z6QhGSv67Di/KwaCCAzkw
ggM1MIIC4qADAgECAhB5aZ7zDISG1StAolP7Y4pqMAoGCCqFAwcBAQMCMIIBLjEL
MAkGA1UEBhMCUlUxGzAZBgNVBAgMEjc3INCzLtCc0L7RgdC60LLQsDEYMBYGA1UE
BwwP0LMu0JzQvtGB0LrQstCwMSAwHgYDVQQKDBfQn9CQ0J4g0KHQsdC10YDQsdCw
0L3QujEXMBUGBSqFA2QEEgwwMDc3MDcwODM4OTMxJjAkBgNVBAkMHdGD0LsuINCS
0LDQstC40LvQvtCy0LAsINC0LjE5MRgwFgYFKoUDZAESDTEwMjc3MDAxMzIxOTUx
MzAxBgNVBAMMKtCQ0KDQnCDQmNC90LjRhtC40LDQu9C40LfQsNGG0LjQuCDQotCV
0KHQojE2MDQGA1UECwwt0KPQv9GA0LDQstC70LXQvdC40LUg0LHQtdC30L7Qv9Cw
0YHQvdC+0YHRgtC4MB4XDTIxMDcyMjAwMDAwMFoXDTI0MDcyMjAwMDAwMFowRjFE
MEIGA1UEAww70KLRgNCw0L3RgdC/0L7RgNGC0L3Ri9C5INGB0LXRgNGC0LjRhNC4
0LrQsNGCLiBUTFMwMDk2MDU1OUIwZjAfBggqhQMHAQEBATATBgcqhQMCAiMBBggq
hQMHAQECAgNDAARAl6hkzzUJ8qqkWxhbsV1BCumh9KdDl2SpKqJSs4jF7BV3uyDN
vUsx4SwMts7uy5iiV9/InXQLegb/fnf+6+tzUqOBujCBtzAdBgNVHQ4EFgQUJ03A
4+n6vPsAuAKV1Ek0Nr6ELI4wHwYDVR0jBBgwFoAUdU+DWah9yVYhdzYiHqk3u7XX
8SswCQYDVR0TBAIwADAUBgcqhQMDewMEBAkGByqFAwN7BQMwGQYHKoUDA3sDBQQO
DAxUTFMwMDk2MDU1OUIwDgYDVR0PAQH/BAQDAgXgMCkGA1UdHwQiMCAwHqAcoBqG
GDc5Njk5RUYzMEM4NDg2RDVERDAwLmNybDAKBggqhQMHAQEDAgNBADcnk8gNbSSO
jzp9nSbbw8KycA7zQNj6m29XXgV3fSdXSMgJdXAXITQGmhpnesLEBUBW8pufO4Uv
aLAV0A6+ciUxggIWMIICEgIBATCCAUQwggEuMQswCQYDVQQGEwJSVTEbMBkGA1UE
CAwSNzcg0LMu0JzQvtGB0LrQstCwMRgwFgYDVQQHDA/Qsy7QnNC+0YHQutCy0LAx
IDAeBgNVBAoMF9Cf0JDQniDQodCx0LXRgNCx0LDQvdC6MRcwFQYFKoUDZAQSDDAw
NzcwNzA4Mzg5MzEmMCQGA1UECQwd0YPQuy4g0JLQsNCy0LjQu9C+0LLQsCwg0LQu
MTkxGDAWBgUqhQNkARINMTAyNzcwMDEzMjE5NTEzMDEGA1UEAwwq0JDQoNCcINCY
0L3QuNGG0LjQsNC70LjQt9Cw0YbQuNC4INCi0JXQodCiMTYwNAYDVQQLDC3Qo9C/
0YDQsNCy0LvQtdC90LjQtSDQsdC10LfQvtC/0LDRgdC90L7RgdGC0LgCEHlpnvMM
hIbVK0CiU/tjimowDAYIKoUDBwEBAgIFAKBpMBgGCSqGSIb3DQEJAzELBgkqhkiG
9w0BBwEwHAYJKoZIhvcNAQkFMQ8XDTIzMDcyMjE4MzUzNFowLwYJKoZIhvcNAQkE
MSIEIOaNx2qYEp+SlIUFehg1NXhPkyIXVOrThxXoPJE2j1V6MAoGCCqFAwcBAQEB
BEAQUqZnaQjNA989ACB/b+3OdEGtLLzPebw51wgWLrjJz5KcX3jx+m+MgRXeKVS7
6mvD/oDAuWYdoCfVnnKyBft3
-----END CMS-----
3. Пример печатной формы запроса на сертификат
4. Источники заполнения полей печатной формы
1.
C - countryName - страна, Значение ячейки 2.5.4.6 запроса PKSC#10
2. CN - commonName - ФИО полностью, Значение ячейки 2.5.4.3 запроса PKSC#10
3. O - organizationName - Наименование организации, Значение ячейки 2.5.4.10 запроса PKSC#10
4. TITLE - Должность - Значение ячейки 2.5.4.12 или 2.5.4.33 запроса PKSC#10
5. SERIALNUMBER - S\N устройства СКЗИ - Значение ячейки 2.5.4.5 запроса PKSC#10 (Проставляется,
если используется TLS-токен - серийный номер)
6. SN - surname - Фамилия, Значение ячейки 2.5.4.4 запроса PKSC#10
7. GN - givenName - Имя Отчество, Значение ячейки 2.5.4.42 запроса PKSC#10
8. EMAIL - адрес эектронной почты, Значение ячейки 1.2.840.113549.1.9.1 запроса PKSC#10
9. Значение - Открытый ключ - Местонахождение значения в запросе PKSC#10(для отображения
содержимого запроса, используется ASN.1 Editor):
10. Идентификатор - идентификатор BicryptId или Значение ячейки 1.2.643.3.123.3.1 запроса PKSC#10
11. Используемый алгоритм - Хэш - ГОСТ Р 34.11-12, ЭП - ГОСТ Р 34.10-2012
12. Используемое средство ЭП - Наименование используемого средства криптографической защиты
информации
Формирование запроса на выпуск нового сертификатаǤ
В данной инструкции не описан процесс формирования тела сертификата <Body>͙.</Body>, где
задействуются библиотеки крипто провайдера, для разрешения вопросов, обратитесь к службе поддержки
вашего крипто провайдера.
Заполнение атрибутов сертификата описано в API «1 часть Документация по PI УПШ 31ͩ п. 2.8.4.1.4.
Поля запроса на новый сертификат.
Данные для формирования запроса CertifRequest приходят в ответе PersonalInfo:
Уникальный идентификатор средства подписи. Соответствует значению
Response/OrganizationsInfo/OrganizationInfo/SignDevices/SignDevice/SignDeviceId
ВАЖНО!!!
Поиск значения SignDeviceId происходит по Логину пользователя в блоке <AuthPerson blocked="0">
смотри Рис.1, далее нужно убедиться, что найденный идентификатор, соответствует значению блока
<SignDevice> с тегом <CryptoTypeName>Инфокрипт</CryptoTypeName>, смотри Рис.2
Рис.1
idCrypto
Рис.2
ФИО - фамилия, имя и отчество уполномоченного лица клиента
Должно передаваться значение из
CommonName
Response/OrganizationsInfo/OrganizationInfo/SignDevices/SignDevice/ProfileName для соответствующего
пользователя.
Краткое наименование организации
Organization
Подставить значение из поля Response/OrganizationsInfo/OrganizationInfo/OrgData/ShortName,
служебные символы заменить на соответствующие коды
Наименование подразделения банка, где заключен контракт с организацией. Должно передаваться
OrganizationUnit
значение Response/OrganizationsInfo/OrganizationInfo/Branches/Branch/SystemName из первого Branch
Locality
Город местонахождения ЮЛ
Country
Страна. Должен передаваться 2-х символьный код страны из справочника стран. RU
Email
Электронная почта
Должность физического лица. Должно передаваться значение из
Position
Response/OrganizationsInfo/OrganizationInfo/SignDevices/SignDevice/Post для соответствующего
пользователя.
Версия 1.5 от 17.10.2018
type
Тип запроса, передается константа: «sign» - для запроса сертификата для подписи
Отдельное вложение
Attachment
(Запрос на новый сертификат, в формате PKSC#10)
AttachmentName
Имя файла вложения
В бинарном представлении в сжатом и несжатом виде (Запрос на новый сертификат CSR в кодировке
base64, данные по владельцу сертификата и организации должны быть идентичны данным, указанным в
Body
основном запросе) см. API «1 часть Документация по PI УПШ 28ͩ п. 2.8.4.1.4. Поля запроса на новый
сертификат.
Дополнительные параметры.
ОБЯЗАТЕЛЬНО ДОБАВЛЕНИЕ ПАРАМЕТРА bicryptId, его @value должно соответствовать значению
Params
идентификатора Бикрипт в запросе PKCS#10(см. в таблица 8 - «Сведения о владельце и атрибутах
сертификатаͩ пункт 2.8.4.1.4. Поля запроса на новый сертификат)
Пример:
Запрос на выпуск нового сертификатаǤ
1. Отправляем, сформированы запрос CertifRequest (Запрос на выпуск нового сертификата) используя
метод web-сервиса sendRequestsSRP, в ответе получаем тикет «005056b0-20e0-1ed8-b2dd-
3efcee2e97fe».
2. Запрашиваем статус запроса CertifRequest используя метод getRequestStatusSRP, приходит ответ
statusStateCode="DELIVERED"(доставлен) и docId="122f18b9-cd35-4556-bf98-23851157c3af".
3. Зная docId документа, запрашиваем статус документа, через метод sendRequestsSRP используя запрос
DocIds (Запрос информации о результатах обработки документов), в ответ получаем тикет «8acee5a0-
7e17-4b0e-b38b-200f4c67b6b0».
4. Запрашиваем статус запроса DocIds, используем метод getRequestStatusSRP, приходит ответ
statusStateCode="ACCEPTED" (принят).
5. Через какой-то время Банк издает сертификат, чтобы узнать конечный статус, нужно запросить статус
документа описанного в п.3-4, в ответ придет конечный статус statusStateCode="PUBLISHED_BY_BANK"
(издан банком).
Пример:
Версия 1.5 от 17.10.2018
Получение изданного сертификата и активация.
1. После того как Банк издал сертификат, нужно запросить персональную информацию, сформировать и
отправить запрос PersonalInfo (Запрос персональных данных) используя метод sendRequestsSRP, в
ответе придет тикет «005056b0-3a13-1ee7-afdb-f92beb16a48e».
2. Запрашиваем по тикету из п.1 статус запроса PersonalInfo используя метод getRequestStatusSRP, в
ответе придет XML OrganizationsInfo со всеми реквизитами организации.
3. В ответе OrganizationsInfo ищем блок <AuthPerson> где указывается логин пользователя <Login>, ФИО
<FIO> , уникальный гуид подписи пользователя <SignDeviceId >.
В данном примере:
<Login>smirnov-gg</Login>
<FIO>Смирнов Геннадий Генрихович</FIO>
<SignDeviceId>f1d91a4a-cccb-47ef-a28e-07da9714b5d3</SignDeviceId>
4. Зная <SignDeviceId> пользователя, ищем блок <SignDevice> в ответе OrganizationsInfo,
В тэге <Certificates> отображается изданный сертификат, кодированный в base64 (LS0tL͙͙0NCg==) с
параметрами:
valid = «1» --- валидный, можно использовать после активации.
active = «0» --- не активированный, не активный.
Версия 1.5 от 17.10.2018
Пример:
Пример декодированного сертификата в base64:
Если поменять расширение на Cert.cer, то отобразится сам сертификат.
Пример:
5. Далее нужно активировать сертификат, формируем и отправляем запрос ActivateCert используя метод
sendRequestsSRP, получаем тикет «005056b0-3a13-1ee7-afdc-06010470a4d3».
Версия 1.5 от 17.10.2018
6. Запрашиваем статус запроса ActivateCert используя метод getRequestStatusSRP и тикет из п.1,
приходит ответ <Info statusStateCode="ACCEPTED"> (сертификат активирован).
Пример:
7. В заключительном шаге запрашиваем персональную информацию PersonalInfo, в ответе
OrganizationsInfo в блоке <SignDevice> в тэге <Certificates> отображается изданный сертификат с
параметрами:
valid = «1» --- валидный, можно использовать после активации.
active = «1» --- активированный, активный.
Пример:
Версия 1.5 от 17.10.2018
Пакетная отправка в многопоточном режиме УПШ.
Унифицированный Платежный Шлюз (УПШ) - поддерживает многопоточный SOAP-сервис и пакетную
обработку. В учетной системе клиента можно использовать одновременно несколько потоков к Web-сервису
УПШ(рекомендуемое значение 5) и отправить единовременно по 1 пакету в каждом потоке, в 1 пакет
может входить не более 30 документов-запросов (requests). Таким образом, единовременно можно
отправить 150 документов (requests) = 5 потоков * 1 пакет (30 requests).
Пример отправки одного пакета c 20-ю документами через SoapUI:
Requests 1-пакет с 20 документами.xml
Response 20 тикетов.xml
Получение информации о движении денежных средств Головной
Компанией по счетам Дочерних Организаций.
Пример запроса Incoming и получение Выписки:↓
Incoming.txt
1.
Что бы забрать подготовленную выписку из Банка, требуется сформировать запрос Incoming (Запрос о
получении подготовленных данных) используя метод sendRequestsSRP. В запросе перечисляем счета Дочерних
Организаций, по которым требуется получить выписку, в теге orgId указываем идентификатор Головной
Компании͘ В теге lastIncomingTime указывается время последнего ответа на запрос incoming͘ Если запрос
отправляется впервые, то тег lastIncomingTime не указываем, тогда придет информация за последние три дня
от текущей даты, в последующих запросах incoming в теге lastIncomingTime нужно указывать время ответа из
тега createTime.
Пример:
Допустим выписка на Банке сформировалась в 15:00, если в lastIncomingTime укажем время 14:59, то
получим сформированную выписку, если указать время 15:01, то выписку не получим͘
2.
В ответ приходит тикет:
3.
Запрашиваем статус запроса, используем метод getRequestStatusSRP, в теге requests указываем тикет, в теге
sessionId указываем идентификатор сессии Головной Компании, в теге orgId указываем идентификатор Головной
Компании͘
4. Получаем ответ, где в теге createTime приходит время, которое нужно указывать, в последующих запросах
incoming в теге lastIncomingTime. В теге <Statementsх…… </Statementsх приходит выписка по
запрашиваемым счетам͘
05.06.2018 v1.0
05.06.2018 v1.0