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

 

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

 

поиск по сайту            правообладателям  

 

   

 

   

 

содержание      ..     9      10      11      12     ..

 

 

 

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

 

 

(Отказан
контролем
de
ВК)
(статус
Response/Tickets/Tick
Сообщение
из
Актуально с
окончательный - не
et/Info/MsgFromBank/
Банка,
если
версии 27
успешно)
@message
требуется
Response/Tickets/Tick
Реквизиты
Актуально с
et/Info/MsgFromBank/
ответственного
версии 27
@author
сотрудника Банка,
если требуется
Response/Tickets/Tick
Дата
Актуально с
et/Info/
принятия/возврата
версии 27
AddInfo/CurrControlIn
валютным
fo/ValueDate
контролем
Код
причины
Актуально с
возврата
версии 27
Возможные
Response/Tickets/Tick
et/Info/AddInfo/CurrC
значения:
ontrolInfo/RejectionCa
1 - 18.6.1
uses/Cases138I/Case13
2 - 18.6.2
8I/@code
3 - 18.6.3
4 - 18.6.4
Response/Tickets/Tick
Актуально с
et/Info/AddInfo/CurrC
версии 27
Комментарий
ontrolInfo/RejectionCa
причины возврата
uses/Cases138I/Case13
8I/@comment
Response/Tickets/Tick
Актуально с
et/Info/AddInfo/CurrC
версии 27
Код
причины
ontrolInfo/RejectionCa
отказа
uses/FormalCases/For
malCase/@code
Response/Tickets/Tick
Актуально с
et/Info/AddInfo/CurrC
версии 27
Комментарий
ontrolInfo/RejectionCa
причине отказа
uses/FormalCases/For
malCase/@comment
26.
SIGNED
ЭД был подписан
Response/Tickets/Tick
SIGNED
Актуально с
(Подписан
достаточным
et/@statusStateCode
версии 27
)
набором подписей.
27.
Response/Tickets/Tick
Актуально с
et/Info/@statusStateCo
TRIED_BY_CFE
версии 27
TRIED_BY
de
_CFE
Проверяется ВК
(Проверяе
Response/Tickets/Tick
Дата поступления в
Актуально с
тся ВК)
et/Info/BankDate/@rec
Банк плательщика
версии 27
eiptDate
и принятия в
обработку
Response/Tickets/Tick
Сообщение
из
Актуально с
et/Info/MsgFromBank/
Банка,
если
версии 27
@message
требуется
Response/Tickets/Tick
Сообщение
из
Актуально с
et/Info/MsgFromBank
банка
версии 27
@message
Response/Tickets/Tick
Ответственный
Актуально с
et/Info/MsgFromBank
исполнитель
версии 27
@author
Пример 1.
(Получение из СББОЛ ID полученного документа и статус Доставлен)
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Response sender="DBO" version="1.0" requestId="FA549532-C827-49CD-B804-D4261EC45639"
responseId="c075a7f7-f9ea-4450-a24d-49716a17275f" createTime="2014-03-11T15:46:32"
<Tickets>
<Ticket createTime="2014-03-11T15:46:32" docId="bd4d9c30-260a-4e53-9eb4-fdad05edadc3">
<Info docExtId="C8D10F90-09C4-43CC-81A3-BC451D4EEB44" statusStateCode="DELIVERED"/>
<Sign>
<ISSUER>E=casbrf@sberbank.ru
2.5.4.33 =Тестирующий АдминистраторКК
CN=ПетровПП-АдминКК-ТЕСТ2
OU=Удостоверяющий центр РК РФ (Тестовый)
O=ОАО "СБЕРБАНК России"
C=RU</ISSUER>
<SN>3030434130313735</SN>
<Value>esCka4JHANbw6NvfRE1FUYvdE7U9MoRpFMsyaevrdJ9t9x1gnC9WCOXD1+DJqWwaU/TNaeywUwd/A
82DT3bqTw==</Value>
</Sign>
</Ticket>
</Tickets>
</Response>
Пример 2.
(Получение из СББОЛ информации об обработке документа, пример статуса Достален)
/в данном примере после передачи ID документа - статус документа не изменился/
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Response sender="DBO" version="1.0" requestId="A99ED217-E16C-4B4C-9197-4D133934E489"
responseId="d385873f-5df0-464f-bcb1-a290f6eb504e" createTime="2014-03-11T15:46:41"
<Tickets>
<Ticket createTime="2014-03-11T15:46:44" docId="bd4d9c30-260a-4e53-9eb4-fdad05edadc3">
<Info docExtId="C8D10F90-09C4-43CC-81A3-BC451D4EEB44" statusStateCode="DELIVERED">
<BankDate/>
<MsgFromBank/>
</Info>
<Sign>
<ISSUER>E=casbrf@sberbank.ru
2.5.4.33 =Тестирующий АдминистраторКК
CN=ПетровПП-АдминКК-ТЕСТ2
OU=Удостоверяющий центр РК РФ (Тестовый)
O=ОАО "СБЕРБАНК России"
C=RU</ISSUER>
<SN>3030434130313735</SN>
<Value>FczAzU1cFYBxU9wF01OtYml18L3ZAjzS0UpCd/15HWkOHKX1C6dKMPOO3QlMX1EpQJ+tNuZ87PTN+
QplHd5PvQ==</Value>
</Sign>
</Ticket>
</Tickets>
</Response>
3.2. Письмо из банка (функционал отключен и более не
поддерживается)
3.2.1.Общие сведения
Порядок предоставления документов со стороны СББОЛ следующий:
 Если запрос на предоставление документов «Письма из банкаª направляется первый раз,
то:
o Взапросе Request/Incoming не передается дата.
o Со стороны СББОЛ вернется сообщение, содержащее все документы «Письма из
банкаª, которые не были переданы в УС ранее.
 В последующие разы:
o Направляется сообщение Request/Incoming, где должен быть указан атрибут
@lastIncomingTime
(равный дате ответа Response/@createTime, содержащего
предыдущий документ «Письмо и банкаª).
o Со стороны СББОЛ должно быть передано сообщение, в котором будут содержаться
документы «Письма из банкаª за дату больше указанной в Request/Incoming
@lastIncomingTime.
3.2.2.Дайджест
Подпись документа на стороне УС:
 Технологическая подпись
Дайджест: формируется
Ключевой буфер (дайджест):
 Для формирования электронной подписи из документа формируется строковая
последовательность (ключевой буфер или дайджест), включающая все значимые данные
документа, поля, содержащие пустые значения, не включаются.
 Ключевой буфер (дайджест) для подписания ЭП образует строковый массив в кодировке
UTF-8, Отдельные записи массива разделены символом перевода строки. В качестве
символа перевода строки используется 0x0A.
 При наличии в мультистроковых данных последовательности из двух символов перевода
строки CR+LF (ASCII 0x0D 0x0A) необходимо удалять символ возврата каретки CR (ASCII
0x0D) и оставлять только символ подачи строки LF (ASCII 0x0A).
 Если наполнение всех таблиц блока TABLES пустое, то и сам TABLES в дайджест не
включается
 Если наполнение какой-то таблицы блока TABLES пустое, то Table=TableName не включать в
дайджест
Формат дайджеста:
Версионно
п/
Наименование поля
Описание
Пример значения
сть
п
1.
ATTRIBUTES
Актуально
<Наименование поля>=<Значение поля>
с версии 27
2.
FIELDS
<Наименование поля>=<Значение поля>, например
Актуально
BeginDate=2011-11-24
с версии 27
После последней строки НЕ делать перевод строки
3.
DocData.DocDate
Дата составления документа
2012-11-21
Актуально
с версии 27
4.
DocData.DocNumber
Номер документа
1
Актуально
с версии 27
5.
DocData.BankName
Наименование подразделения банка
Головное
Актуально
получателя заявления
подразделение СБРФ
с версии 27
6.
Type
Тип письма
Досыл уточненных
Актуально
реквизитов
с версии 27
7.
Theme
Тема письма
12341234
Актуально
с версии 27
8.
AddInfo
Текст сообщения
Текст письма
Актуально
с версии 27
9.
Разделитель строк таблицы - #
Актуально
TABLES
с версии 27
10.
Table=Attachments
Актуально
Разделитель строк таблицы - #
с версии 27
Сортировать сначала по имени файла (цифры, латинские буквы, русские буквы), затем по
размеру файла
11.
Attachment.Attachme
Имя файла вложения
f1311fff.TXT
Актуально
ntName
с версии 27
12.
Пользовательское описание файла
Attachment.Descriptio
Описание файла
Актуально
вложения
n
с версии 27
13.
Вложение в бинарном
Attachment.Body
VGVzdA==
Актуально
представлении в сжатом и
с версии 27
несжатом виде
Пример.
ATTRIBUTES
FIELDS
DocData.DocDate=2014-03-11
DocData.DocNumber=140
DocData.BankName=СБЕРБАНК РОССИИ ОАО
Type=Досыл уточненных реквизитов
Theme=tryrt
AddInfo=sr6tuhsthsth
TABLES
Table=Attachments
Attachment.AttachmentName=Копия СКОУП1.xlsx
Attachment.Description=syjsfg
Attachment.Body=UEsDBBQABgAIAAAAIQCqhKdUlgEAACwIAAATAAgCW0NvbnRlbnRfVHlw
ZXNdLnhtbCCiBAIooAACAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAADMVVtPwjAUfjfxPyx9NazgLcYwePDyqCTiDyjrGWvY2qb
niPDvPStilCBkkURe1qzt+S6nab/+cFFXyRwCGmcz0Uu7IgGbO23sNBOv48fOjUiQlNWqchYysQQU
w8HpSX+89IAJV1vMREnkb6XEvIRaYeo8WF4pXKgV8W+YSq/ymZqCPO92r2XuLIGlDjUYYtC/h
0K9VZQ8LHh6pWRirEjuVvsaqkwo7yuTK2Khcm71BknHFYXJQbv8rWboFH0ApbEEoLpKfTDMG
F6AiI2hkFs5A1TYjvTTVcqVURiWxuMZW/+FoVn53dVn3TMfRzAakpEK9KRq9i4XlXx3YTZxbpb
uBmnbmtiitFbGrnXv4I+bUcahd2Ahjb8I3FLH+ZHouDgSHZdHouPqSHRc/5MO4rcQZPz+/AAAAAE
OdAAB4bC90YWJsZXMvdGFibGUxLnhtbFBLAQItABQABgAIAAAAIQBDa8/52QsAANwcAAAn
AAAAAAAAAAAAAAAAAICfAAB4bC9wcmludGVyU2V0dGluZ3MvcHJpbnRlclNldHRpbmdzNS
5iaW5QSwECLQAUAAYACAAAACEAQT7Hcr4BAADmAgAAEQAAAAAAAAAAAAAAAACeq
wAAZG9jUHJvcHMvY29yZS54bWxQSwECLQAUAAYACAAAACEAmMKkhksCAACzBAAAEA
AAAAAAAAAAAAAAAACTrgAAZG9jUHJvcHMvYXBwLnhtbFBLAQItABQABgAIAAAAIQBD
a8/52QsAANwcAAAnAAAAAAAAAAAAAAAAABSyAAB4bC9wcmludGVyU2V0dGluZ3MvcHJp
bnRlclNldHRpbmdzMi5iaW5QSwECLQAUAAYACAAAACEAkH7xgPULAADEHAAAJwAAAAA
AAAAAAAAAAAAyvgAAeGwvcHJpbnRlclNldHRpbmdzL3ByaW50ZXJTZXR0aW5nczMuYmluU
EsFBgAAAAAbABsArwcAAGzKAAAAAA==
#
Attachment.AttachmentName=шаблон дефектов.xlsx
Attachment.Description=fy
Attachment.Body=UEsDBBQABgAIAAAAIQAk7FC/gwEAACQHAAATAAgCW0NvbnRlbnRfVHl
wZXNdLnhtbCCiBAIooAACAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAADMVcluwjAQvVfqP0S+VsRAF1UVgUOXY4sE/QATT4AAAAAA
AAAAAAAAArycAAHhsL3dvcmtzaGVldHMvc2hlZXQzLnhtbFBLAQItABQABgAIAAAAIQB+wY
rlYAEAAHQCAAAYAAAAAAAAAAAAAAAAAHgvAAB4bC93b3Jrc2hlZXRzL3NoZWV0MS54b
WxQSwECLQAUAAYACAAAACEAfsGK5WABAAB0AgAAGAAAAAAAAAAAAAAAAAAOM
QAAeGwvd29ya3NoZWV0cy9zaGVldDUueG1sUEsBAi0AFAAGAAgAAAAhAGQBvYGzBgAA2h
sAABMAAAAAAAAAAAAAAAAApDIAAHhsL3RoZW1lL3RoZW1lMS54bWxQSwECLQAUAA
YACAAAACEAtyCkkEMEAADkGgAADQAAAAAAAAAAAAAAAACIOQAAeGwvc3R5bGVzLn
htbFBLAQItABQABgAIAAAAIQDa0txc8AoAAHAaAAAUAAAAAAAAAAAAAAAAAPY9AAB4
bC9zaGFyZWRTdHJpbmdzLnhtbFBLAQItABQABgAIAAAAIQBHCiQEPgAAANwAAAAnAAAA
AAAAAAAAAAAAABhJAAB4bC9wcmludGVyU2V0dGluZ3MvcHJpbnRlclNldHRpbmdzMy5iaW5
QSwECLQAUAAYACAAAACEAIcqtKUUAAADcAAAAJwAAAAAAAAAAAAAAAACbSQAAe
GwvcHJpbnRlclNldHRpbmdzL3ByaW50ZXJTZXR0aW5nczIuYmluUEsBAi0AFAAGAAgAAAAhA
Guwi8ipAQAAlAMAABAAAAAAAAAAAAAAAAAAJUoAAGRvY1Byb3BzL2FwcC54bWxQSwE
CLQAUAAYACAAAACEAOrAHfkABAABRAgAAEQAAAAAAAAAAAAAAAAAETQAAZG9jU
HJvcHMvY29yZS54bWxQSwECLQAUAAYACAAAACEAyWup1EUAAADcAAAAJwAAAAAAA
AAAAAAAAAB7TwAAeGwvcHJpbnRlclNldHRpbmdzL3ByaW50ZXJTZXR0aW5nczEuYmluUEsF
BgAAAAAUABQAigUAAAVQAAAAAA==
#
3.2.3.Формат взаимодействия
Взаимодействие: Документ передается из СББОЛ в УС
Инициатор получения документа: УС
Формат передачи документа на сторону УС: Response/LetterFromBank
Формат, в котором запрашиваются документы со стороны УС: Request/Incoming
3.2.3.1. Формат
получения
документа
(функционал отключен и более не
поддерживается)
Response/LettersFromBank
Версионно
Элемент
Описание элемента
Тип
Описание типа
Мн.
сть
Ответ СББОЛ на запрос
Response
Response
Актуально
УС
[1]
с версии
27
Дата и время
1
@createTime
xs:dateTi
Простой тип
формирования ответа
me
XML Schema
Актуально
местному по времени
[0..1
с версии
запрашивающего сервера,
]
27
с указанием его часового
пояса
Уникальный
2
@responseId
UuidSepa
UUID с
идентификатор ответа
rated
разделителями
Актуально
в виде дефисов.
[0..1
с версии
Набор из 32
]
27
символов [0-9],
[a-f] и дефисов
Идентификатор запроса, в
3
@requestId
UuidSepa
UUID с
результате которого был
rated
разделителями
Актуально
сформирован данный
в виде дефисов.
[0..1
с версии
ответ
Набор из 32
]
27
символов [0-9],
[a-f] и дефисов
Номер версии формата
4
@version
xs:string
Простой тип
обмена
RegEx:
XML Schema
Актуально
[0..1
"[0-
с версии
]
9\.]{1,20}
27
"
Система-отправитель
5
@sender
xs:string
Простой тип
RegEx:
XML Schema
Актуально
«[-a-zA-
[0..1
с версии
Zа-яА-
]
27
Я0-9:
_]{1,20}»
Система-получатель-если
6
@receiver
xs:string
Простой тип
система получатель
RegEx:
XML Schema
Актуально
СББОЛ, то SBBOL_DBO
«[-a-zA-
[0..1
с версии
Zа-яА-
]
27
Я0-9:
_]{1,20}»
Письма из банка
7
LettersFromBank
Актуально
[0..1
с версии
]
27
Письмо из банка
*.1
LetterFromBank
LetterFro
Актуально
[0..n
mBank
с версии
]
27
*.
@docExtId
UuidSepa
UUID с
Уникальный*
1
rated
разделителями
идентификатор документа
в виде дефисов.
Актуально
в учетной системе (УС)
[0..1
Набор из 32
с версии
Клиента.
]
символов [0-9],
27
*Уникальность
[a-f] и дефисов
контролируется на
стороне банка
Идентификатор
*.
@orgId
UuidSepa
UUID с
организации в СББОЛ
2
rated
разделителями
Актуально
в виде дефисов.
[0..1
с версии
Набор из 32
]
27
символов [0-9],
[a-f] и дефисов
Общие реквизиты
*.
DocData
ComLett
Актуально
[0..1
документа ДБО
3
Data
с версии
]
27
Дата составления
*.
@docDate
xs:date
Простой тип
Актуально
документа
1
XML Schema
[1]
с версии
27
Номер документа
*.
@docNum
xs:string
Простой тип
Актуально
2
XML Schema
[1]
с версии
27
Наименование
*.
@bankName
xs:string
Простой тип
Актуально
[0..1
подразделения банка
3
XML Schema
с версии
]
получателя заявления
27
Номер подразделения
*.
@bankNum
xs:string
Простой тип
Актуально
[0..1
банка получателя
4
XML Schema
с версии
]
заявления в ДБО
27
Обязательно для
*.
@requiredFor
BoolType
Двоичное
Актуально
прочтения: 0-нет, 1-да
5
Read
значение: 0 или
[1]
с версии
1
27
Основные реквизиты
*.
OrgData
OrgData
[1]
Изменено
организации,
6
[0..1
в версии
указываемые в документе
]
30
КПП клиента
@kpp
KppType
КПП, 9 цифр
Актуально
[0..1
с версии
]
1
27
ОКАТО клиента
@okato
OkatoTyp
ОКАТО, от 1 до
e
11 цифр
Актуально
[0..1
2
(иногда
с версии
]
заполняется
27
нулём)
ИНН клиента
@inn
InnType
ИНН
юридического
Актуально
3
или
[0..1
с версии
физического
]
27
лица РФ, до 12
цифр
Наименование
@orgName
xs:string
Простой тип
организации клиента
XML Schema
Актуально
(сокращенное
4
[1]
с версии
наименование - как в
27
платежных руб.
документах)
ОКПО клиента
@okpo
OkpoTyp
ОКПО, от 8 до
Актуально
[0..1
e
10 цифр
с версии
]
5
27
ОГРН клиента
@orgOGRN
OgrnType
ОГРН, от 13 0
Изменено
[0..1
до 15 цифр
в версии
]
6
33
Тип
*.
Type
xs:string
Простой тип
Актуально
[0..1
3
XML Schema
с версии
]
27
Тема
*.
Theme
xs:string
Простой тип
Актуально
[0..1
4
XML Schema
с версии
]
27
Текст сообщения
*.
AddInfo
AddInfo
Актуально
[0..1
5
с версии
]
27
Связанные документы,
*.
LinkedDocs
LinkedDo
Связанные
например, реестр
Актуально
6
cs
документы
[0..1
пополнения корп. карт,
с версии
]
зарплатные ведомости и
27
т.п.
Документ, связанный с
*.
LDoc
Актуально
[0..n
поручением
1
с версии
]
27
Тип связанного
@type
xs:string
Простой тип
документа
Актуально
XML Schema
[0..1
Значение можно найти в
с версии
1
]
Части 1, п. «Типы
27
связанных документов»
@docExtId
Уникальный*
UuidSepa
UUID с
идентификатор документа
rated
разделителями
2
в учетной системе (УС)
в виде дефисов.
Клиента.
Набор из 32
символов [0-9],
Изменено
*Уникальность
[0..1
[a-f] и дефисов
в версии
контролируется на
]
33
стороне банка
ОБЯЗАТЕЛЕН ДЛЯ
ЗАПОЛНЕНИЯ, ЕСЛИ
НЕ ЗАПОЛНЕН @docId
@docId
Глобальный
UuidSepa
UUID с
идентификатор документа
rated
разделителями
3
в виде дефисов.
Изменено
[0..1
ОБЯЗАТЕЛЕН ДЛЯ
Набор из 32
в версии
]
ЗАПОЛНЕНИЯ, ЕСЛИ
символов [0-9],
33
НЕ ЗАПОЛНЕН
[a-f] и дефисов
@docExtId
Дополнительные
Params
Params
Множество
Актуально
параметры связанного с
параметров
[0..1
с версии
поручением документа
4
произвольного
]
27
вида
Параметр
Param
Param
Актуально
[0..n
(типрасш
с версии
]
1
ирен)
27
Название параметра
@nam
xs:string
Простой тип
Актуально
e
XML Schema
[1]
с версии
1
27
Значение параметра
@valu
xs:string
Простой тип
Актуально
e
XML Schema
[1]
с версии
2
27
Приложенные к
*.
Attachments
Attachme
Приложенные к
документу
7
ntsType
документу
Актуально
[0..1
отсканированные образы-
отсканированн
с версии
]
вложения
ые образы-
27
вложения
Отдельное вложение
*.
Attachment
Актуально
[0..n
1
с версии
]
27
Имя файла вложения
*.
Attachment
xs:string
Простой тип
Актуально
[0..1
1
Name
XML Schema
с версии
]
27
Пользовательское
*.
Description
xs:string
Простой тип
Актуально
[0..1
описание файла вложения
2
XML Schema
с версии
]
27
В бинарном
*.
Body
xs:base64
Простой тип
Актуально
[0..1
представлении в сжатом и
3
Binary
XML Schema
с версии
]
несжатом виде
27
Размер файла в байтах
*.
FileSize
xs:long
Простой тип
Актуально
[0..1
4
XML Schema
с версии
]
27
Дата добавления
*.
FileDate
xs:dateTi
Простой тип
Актуально
[0..1
вложения
5
me
XML Schema
с версии
]
27
*.
Sign
DigitalSig
Актуально
[0..1
8
n
с версии
]
27
Поставщик сертификата.
*.1
ISSUER
xs:string
Простой тип
Обязательно и достаточно
XML Schema
Issuer
для идентификации
Изменено
клиентского сертификата
[0..1
в версии
в СББОЛ передавать
]
30
атрибут CNполя ISSUER
в виде «CN=<значение
атрибута>»
Серийный номер
*.2
SN
xs:string
Простой тип
Актуально
[0..1
сертификата
XML Schema
с версии
]
27
Значение ЭП
*.3
Value
xs:base64
Простой тип
Актуально
[0..1
Binary
XML Schema
с версии
]
27
Имя схемы подписи
*.4
DigestName
xs:string
Простой тип
Актуально
[0..1
XML Schema
с версии
]
27
Версия схемы подписи
*.5
DigestVersion
xs:string
Простой тип
Актуально
[0..1
XML Schema
с версии
]
27
Пример.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Response sender="DBO" version="1.0" requestId="3A6835D1-905B-49F8-9759-2A2DB7D0901A"
responseId="dfc87c95-08d5-4446-a995-0a0c2618befe" createTime="2014-03-11T15:55:18"
<LettersFromBank>
<LetterFromBank docExtId="18777499-2260-4b5a-b8e0-dbc5b2912e35">
<DocData requiredForRead="0" bankNum="8b8b38fa-c399-4e9e-ac77-1721556b709c"
bankName="СБЕРБАНКРОССИИОАО" docNum="140" docDate="2014-03-11">
<OrgData orgOGRN="1087746618959" okpo="76666666" orgName="ООО"РомашкаИнтернэшнл""
inn="7777777777" okato="66666666666" kpp="777000000"/>
</DocData>
<Type>Досыл уточненных реквизитов</Type>
<Theme>tryrt</Theme>
<AddInfo>sr6tuhsthsth</AddInfo>
<Attachments>
<Attachment>
<AttachmentName>Копия СКОУП1.xlsx</AttachmentName>
<Description>syjsfg</Description>
<Body>UEsDBBQABgAIAAAAIQCqhKdUlgEAACwIAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAACAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADMVVtPwjAUfjfxPyx9NazgLcY
wePDyqCTiDyjrGWvY2qbniPDvPStilCBkkURe1qzt+S6nab/+cFFXyRwCGmcz0Uu7IgGbO23sNBOv48fOjUiQlNWq
chYysQQUw8HpSX+89IAJV1vMREnkb6XEvIRaYeo8WF4pXKgV8W+YSq/ymZqCPO92r2XuLIGlDjUYYtC/h0K9VZ
Q8LHh6pWRirEjuVvsaqkwo7yuTK2Khcm71BknHFYXJQbv8rWboFH0ApbEEoLpKfTDMGF6AiI2hkFs5A1TYjvTTV
cqVURiWxuMZW/+FoVn53dVn3TMfRzAakpEK9KRq9i4XlXx3YTZxbpbuBmnbmtiitFbGrnXv4I+bUcahd2Ahjb8I3FL
H+ZHouDgSHZdHouPqSHRc/5MO4rcQZPz+/apEmD0XA2lZAR7Y7Qp0H3OpAugX4ld2enAB37H36CA14Q7IOPy
95z8jJILu4ufoGQXnkdMtQPtTWEdJU93xDASBDHyFybZH+YuRo7E94UZgQpO9GvQWbhmzfvABAAD//wMAUEs
DBBQABgAIAAAAIQC1VTAj9QAAAEwCAAALAAgCX3JlbHMvLnJlbHMgogQCKKAAAgAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAjJLPTsMwDMbvSLxD5PvqbkgIoaW7TEi7IVQ
ewCTuH7WNoyRA9/
/52QsAANwcAAAnAAAAAAAAAAAAAAAAABSyAAB4bC9wcmludGVyU2V0dGluZ3MvcHJpbnRlclNldHRpbmdzMi
5iaW5QSwECLQAUAAYACAAAACEAkH7xgPULAADEHAAAJwAAAAAAAAAAAAAAAAAyvgAAeGwvcHJpbnRlcl
NldHRpbmdzL3ByaW50ZXJTZXR0aW5nczMuYmluUEsFBgAAAAAbABsArwcAAGzKAAAAAA==</Body>
</Attachment>
<Attachment>
<AttachmentName>шаблон дефектов.xlsx</AttachmentName>
<Description>fy</Description>
<Body>UEsDBBQABgAIAAAAIQAk7FC/gwEAACQHAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAACAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAADMVcluwjAQvVfqP0S+VsRAF1UVgUOXY4sE/QATT4hFYluegcLfdxKgq
hCLoiKVS6LYnrdMrDe9wbIsogUENM4mohO3RQQ2ddrYaSI+x2+
AAADcAAAAJwAAAAAAAAAAAAAAAACbSQAAeGwvcHJpbnRlclNldHRpbmdzL3ByaW50ZXJTZXR0aW5nczIuY
mluUEsBAi0AFAAGAAgAAAAhAGuwi8ipAQAAlAMAABAAAAAAAAAAAAAAAAAAJUoAAGRvY1Byb3BzL2FwcC5
4bWxQSwECLQAUAAYACAAAACEAOrAHfkABAABRAgAAEQAAAAAAAAAAAAAAAAAETQAAZG9jUHJvcHMvY
29yZS54bWxQSwECLQAUAAYACAAAACEAyWup1EUAAADcAAAAJwAAAAAAAAAAAAAAAAB7TwAAeGwvcHJ
pbnRlclNldHRpbmdzL3ByaW50ZXJTZXR0aW5nczEuYmluUEsFBgAAAAAUABQAigUAAAVQAAAAAA==</Body>
</Attachment>
</Attachments>
<Sign>
<ISSUER>E=casbrf@sberbank.ru
2.5.4.33 =ТестирующийАдминистраторКК
CN=ПетровПП-АдминКК-ТЕСТ2
OU=УдостоверяющийцентрРКРФ (Тестовый)
O=ОАО "СБЕРБАНКРоссии"
C=RU</ISSUER>
<SN>3030434130313735</SN>
<Value>J+z7vAZl6dyx71NNQj6ixhMclBJvMPly5/I6sISeEMQW+U8Zg1I83MYxZTRcDx5WEnje6aOKhtjCDOzVgNE
rLA==</Value>
</Sign>
</LetterFromBank>
</LettersFromBank>
</Response>
3.3. Письмо свободного формата в банк
3.3.1.Общие сведения
Письма свободного формата приходят на смену обычным письмам. Механизм
взаимодействия УС Клиента с УПШ схож, но ПСФ интегрированы с CRM банка, что
позволяет ускорить их обработку.
3.3.2.Дайджест
Подпись документа на стороне УС:
 Первая подпись и вторая подпись или
 Единственная подпись
Дайджест: формируется
Ключевой буфер (дайджест):
 Для формирования электронной подписи из документа формируется строковая
последовательность (ключевой буфер или дайджест), включающая все значимые данные
документа, поля, содержащие пустые значения, не включаются.
 Ключевой буфер (дайджест) для подписания ЭП образует строковый массив в кодировке
UTF-8, Отдельные записи массива разделены символом перевода строки. В качестве
символа перевода строки используется 0x0A.
 При наличии в мультистроковых данных последовательности из двух символов перевода
строки CR+LF (ASCII 0x0D 0x0A) необходимо удалять символ возврата каретки CR (ASCII
0x0D) и оставлять только символ подачи строки LF (ASCII 0x0A).
 Если наполнение всех таблиц блока TABLES пустое, то и сам TABLES в дайджест не
включается
 Если наполнение какой-то таблицы блока TABLES пустое, то Table=TableName не включать в
дайджест
Формат дайджеста:
Наименование
Версионност
Описание
Пример значения
п/п
поля
ь
1.
ATTRIBUTES
Актуально с
<Наименование поля>=<Значение поля>, например:
версии 32
OrgId=963084ba-7079-4b9d-bbab-c4972dee82d9
2.
OrgId
Идентификатор организации в
fb8360e9-69ae-40d4-
Актуально с
ДБО
b5e2-b7e60f2a3fd7
версии 32
3.
Sender
Отправитель, а также тип
Сбербанк Бизнес
использованного Клиентом
Актуально с
программного обеспечения при
версии 32
отправке документа
4.
ExtId
Уникальный* идентификатор
3a6378ef-07ee-4535-
документа в учетной системе
a10a-0c82817cae23
Актуально с
(УС) Клиента.
версии 32
*Уникальность контролируется
на стороне банка
5.
FIELDS
<Наименование поля>=<Значение поля>, например:
Актуально с
DocData.DocDate=2018-07-21
версии 32
После последней строки НЕ делать перевод строки
6.
DocData.DocDate
Дата составления документа
2018-07-21
Актуально с
версии 32
7.
DocData.DocNumbe
Номер документа
12
Актуально с
r
версии 32
8.
DocData.BankName
Наименование подразделения
Банк
Актуально с
банка получателя заявления
версии 32
9.
PSFType
Тип письма
Уточнение
Актуально с
реквизитов
версии 32
10.
PSFTypeSystemNa
Системное имя типа ПСФ
payment_ajustment
Актуально с
me
версии 32
11.
Text
Текст ПСФ
Уточняю реквизиты
Актуально с
версии 32
3.3.3.Формат взаимодействия
Взаимодействие: Документ передается из УС в СББОЛ
Формат передачи документа на сторону СББОЛ: Request/GenericLetterToBank
Формат предоставления ответа (квитанции) об исполнении документа со стороны
СББОЛ: Response/Tickets
3.3.3.1. Формат отправки документа в СББОЛ
Request/GenericLetterToBank
Описание
Версио
Элемент
Описание элемента
Тип
Мн.
типа
нность
Request
Запрос УС к СББОЛ
Request
Актуально с
[1]
версии 32
Уникальный идентификатор
UUID с
1
@requestId
UuidSe
запроса
разделителя
parated
ми в виде
Актуально с
дефисов.
[1]
версии 32
Набор из 32
символов
[0-9], [a-f] и
дефисов
Идентификатор организации
UUID с
2
@orgId
UuidSe
в ДБО (может быть
разделителя
parated
использован сторонней
ми в виде
системой для
дефисов.
Актуально с
[1]
дополнительной
Набор из 32
версии 32
идентификации)
символов
[0-9], [a-f] и
дефисов
Номер версии формата
Простой
3
@version
xs:string
обмена
тип XML
RegEx:
Актуально с
Schema
"[0-
[1]
версии 32
9\.]{1,2
0}"
Система-отправитель
Простой
4
@sender
xs:string
тип XML
RegEx:
Schema
«[-a-zA-
Актуально с
Zа-яА-
[1]
версии 32
Я0-9:
_]{1,20
Система-получатель - если
Простой
5
@receiver
xs:string
система получатель СББОЛ,
тип XML
RegEx:
то SBBOL_DBO
Schema
«[-a-zA-
Актуально с
Zа-яА-
[0..1]
версии 32
Я0-9:
_]{1,20
Версия протокола
Простой
6
@protocolVersion
xs:string
Актуально с
тип XML
[0..1]
версии 32
Schema
GenericLetterToBank
Письмо свободного формата
Generic
7
Актуально с
в банк
LetterT
[1]
версии 32
oBank
*.1
@docExtId
Уникальный* идентификатор
UuidSe
UUID с
документа в учетной системе
parated
разделителя
(УС) Клиента.
ми в виде
дефисов.
Актуально с
*Уникальность
[1]
Набор из 32
версии 32
контролируется на стороне
символов
банка
[0-9], [a-f] и
дефисов
*.2
@sentForSign
0 - обычная передача на
BoolTy
Двоичное
Актуально с
выполнение 1 - передано для
pe
значение: 0
[0..1]
версии 32
подписания в ИК
или 1
*.3
DocData
Общие реквизиты документа
ComLet
Актуально с
[1]
ДБО
tData
версии 32
*.1
@docDate
Дата составления документа
xs:date
Простой
Актуально с
тип XML
[1]
версии 32
Schema
*.2
@docNum
Номер документа
xs:string
Простой
Актуально с
[max: 6]
тип XML
[1]
версии 32
Schema
*.3
@bankName
Наименование подразделения
xs:string
Простой
банка, обслуживающего
[min: 1,
тип XML
организацию.
max:
Schema
255]
Должно передаваться
Актуально с
[0..1]
значение, получаемое в
версии 32
OrganizationsInfo -
Response/OrganizationsInfo/Or
ganizationsInfo/Branches/Branc
h/SystemName из первого
Branch
*.4
@bankNum
Номер подразделения банка
xs:string
Простой
получателя заявления в ДБО
тип XML
Schema
Должно передаваться
Актуально с
значение, получаемое в
[0..1]
версии 32
OrganizationsInfo -
Response/OrganizationsInfo/Or
ganizationsInfo/Branches/Branc
h/BranchId из первого Branch
*.5
OrgData
Основные реквизиты
OrgData
Актуально с
организации, указываемые в
[1]
версии 32
документе
*.1
@kpp
КПП клиента
KppTyp
КПП, 9
Актуально с
[0..1]
e
цифр
версии 32
*.2
@okato
ОКАТО клиента
OkatoT
ОКАТО, от
ype
1 до 11
цифр
Актуально с
[0..1]
(иногда
версии 32
заполняется
нулём)
*.3
@inn
ИНН клиента
InnType
ИНН
Актуально с
[1]
юридическо
версии 32
го или
физическог
о лица РФ,
до 12 цифр
*.4
@orgNam
Наименование организации
xs:string
Простой
e
клиента (сокращенное
[min: 1,
тип XML
Актуально с
[1]
наименование - как в
max:
Schema
версии 32
платежных руб. документах)
160]
*.5
@okpo
ОКПО клиента
OkpoTy
ОКПО, от 8
Актуально с
[0..1]
pe
до 10 цифр
версии 32
*.6
@orgOGR
ОГРН клиента
OgrnTy
ОГРН, от
Изменено в
N
pe
[0..1]
13 0 до 15
версии 33
цифр
*.7
@clientNa
Cокращенное наименование
xs:string
Простой
meIntheG
организации в родительном
[min: 1,
тип XML
Актуально с
[0..1]
enitive
падеже
max:
Schema
версии 32
255]
*.8
@fullNam
Полное наименование
xs:string
Простой
e
[min: 1,
тип XML
Актуально с
[0..1]
max:
Schema
версии 32
500]
*.9
@internati
Наименование на
xs:string
Простой
onalName
иностранном языке (при
[min: 1,
тип XML
Актуально с
[0..1]
наличии)
max:
Schema
версии 32
500]
*.10
@opf
Организационно-правовая
xs:string
Простой
форма
[min: 1,
тип XML
Актуально с
[0..1]
max:
Schema
версии 32
255]
*.11
@datOGR
Дата регистрации
xs:date
Простой
Актуально с
N
тип XML
[0..1]
версии 32
Schema
*.12
@orgAddr
Юридический адрес
xs:string
Простой
ess
организации Клиента
[min: 1,
тип XML
Актуально с
[0..1]
max:
Schema
версии 32
1024]
*.13
@resident
Резидентность организации
xs:boole
Простой
Актуально с
по справочнику организаций
an
тип XML
[0..1]
версии 32
Schema
*.4
UserData
Информация об отправителе
Актуально с
[0..1]
ПСФ
версии 32
*.1
LastName
Фамилия пользователя,
xs:string
Актуально с
отправившего ПСФ
[max:
[0..1]
версии 32
50]
*.2
FirstName
Имя пользователя,
xs:string
Актуально с
отправившего ПСФ
[max:
[0..1]
версии 32
50]
*.3
MiddleName
Отчество пользователя,
xs:string
Актуально с
отправившего ПСФ
[max:
[0..1]
версии 32
50]
*.4
BirthDate
Дата рождения пользователя,
xs:date
Актуально с
[0..1]
отправившего ПСФ
версии 32
*.5
MobilePhone
Мобильный телефон
xs:string
Актуально с
пользователя, создавшего
[max:
[0..1]
версии 32
ПСФ
50]
*.6
WorkPhone
Номер рабочего телефона
xs:string
пользователя клиента,
[max:
создавшего ПСФ
50]
Актуально с
[0..1]
версии 32
(Пока не понятно откуда
брать)
*.7
Email
E-mail пользователя,
xs:string
Актуально с
создавшего ПСФ
[max:
[0..1]
версии 32
100]
*.5
PSFType
Тип
xs:string
Простой
[max:
тип XML
Актуально с
Значение из справочника
[1]
255]
Schema
версии 32
типов
писем GenericLetterType
*.6
PSFTypeSystemN
Системное имя типа ПСФ
xs:string
ame
[max:
Актуально с
[1]
@systemName из справочника
версии 32
255]
типов ПСФ
*.7
Text
Текст сообщения
xs:string
Актуально с
[max:
[1]
версии 32
4000]
*.8
Channel
Канал поступления
xs:string
[max:
Актуально с
[0..1]
Для СББ - ДБО (Сбербанк
версии 32
255]
Бизнес)
*.9
BigFileAttachment
Приложенные к документу
BigFile
Актуально с
s
отсканированные образы-
Attachm
[0..1]
версии 32
вложения - для АС БФ
ents
*.1
BigFileAttach
Данные о большом файле,
BigFile
Актуально с
ment
связанном с сущностью
Attachm
[1..n]
версии 32
ent
*.1
UploadJo
Идентификатор задания на
UuidSe
Актуально с
[1]
bId
загрузку файла в БФ
parated
версии 32
*.2
Descriptio
Пользовательское описание
xs:string
n
файла вложения
[min: 1,
Актуально с
[0..1]
max:
версии 32
1024]
3.3.4.Особенности получения статусов об обработке из
СББОЛ
Информация об обработке документа доставляется в УС:
1. Без запроса со стороны УС:
а. В ответ на отправленный документ СББОЛ отправляет сообщение в формате
Response/Tickets, в котором передается:
 Tickets/Ticket/@docId - Идентификатор документа, с помощью которого в
последствии можно запрашивать со стороны УС в формате
Request/DocIds/DocId - все последующие статусы обработки докуемнта;
 Tickets/Ticket/ Info/@statusStateCode="DELIVERED".
2. Путем запроса со стороны УС в формате Request/DocIds/DocId:
а. Имея данные идентификатора документа, которые были получены с первым
сообщением Response/Tickets ->СББОЛ передает текущее состояние документа.
 Tickets/Ticket/Info/BankDate/@statusDateTime
- дата и время присвоения
статуса.
Статусы обработки документа, передаваемые со стороны СББОЛ в УПШ в рамках
Response/Tickets:
Передавае
мый из
Атрибут
Описание
Описание операции
Версионност
п
СББОЛ
Response/Ticketsдля
передаваемогоиз
на стороне СББОЛ
ь
/
статус
передачи в УПШ
СББОЛ значения
п
документа
1.
Проверки документа
Response/Tickets/Tick
INVALIDEDS
INVALIDE
Актуально с
привели к
et/Info/@statusStateCo
DS
версии 32
неуспешному
de
(АСП/ЭП
результату
Response/Tickets/Tick
Может
быть
неверна)
(статус
et/Info/MsgFromBank/
передано
окончательный- не
@message
сообщение о том,
Актуально с
успешно)
что
версии 32
подлинностьдокум
ентанеподтвержде
на
2.
Логические
Response/Tickets/Tick
REQUISITEERRO
REQUISIT
Актуально с
проверки документа
et/Info/@statusStateCo
R
EERROR
версии 32
привели к
de
(Ошибка
неуспешному
Response/Tickets/Tick
Должны
реквизито
результату
et/Info/MsgFromBank/
передаваться
в)
(статус
@message
сообщения
об
Актуально с
окончательный- не
ошибках,
версии 32
успешно)
выявленных
на
стороне Банка
Документ доставлен
Response/Tickets/Tick
DELIVERED
3.
DELIVERE
на сторну Банка, но
et/Info/@statusStateCo
D
Актуально с
еще не проходил
de
(Доставле
версии 32
проверку подписи и
н)
реквизитов
4.
Прием документа на
Response/Tickets/Tick
ACCEPTED
ACCEPTE
Актуально с
стороне Банка
et/@statusStateCode
D
версии 32
(Принят)
Response/Tickets/Tick
Дата поступления в
Актуально с
et/Info/BankDate/@rec
Банк
версии 32
eiptDate
5.
Документ выгружен
Response/Tickets/Tick
EXPORTED
EXPORTE
в АБС для
et/Info/@statusStateCo
D(Выгруж
Актуально с
дальнейшей
de
ен)
версии 32
обработки
6.
ACCEPTE
Документ принят на
Response/Tickets/Tick
ACCEPTED_BY_A
Актуально с
D_BY_AB
обработку в АБС
et/@statusStateCode
BS
версии 32
S (Принят
Response/Tickets/Tick
Сообщение
из
АБС)
Актуально с
et/Info/MsgFromBank/
Банка
версии 32
@message
7.
Подтверждение
IMPLEME
исполнения платежа
Response/Tickets/Tick
NTED
Актуально с
et/Info/@statusStateCo
IMPLEMENTED
(Исполнен
(статус
версии 32
de
)
окончательный -
успешно)
8.
Response/Tickets/Tick
RECEIVED_BY_C
Актуально с
et/Info/@statusStateCo
RM
версии 32
de
Response/Tickets/Tick
RECEIVED
et/Info/AddInfo/Generi
Актуально с
_BY_CRM(
Номер ПСФ в CRM
Принят CRM
cLetterToBankTicket/
версии 32
Принят
@crmNum
CRM)
Response/Tickets/Tick
et/Info/AddInfo/Generi
Идентификатор
Актуально с
cLetterToBankTicket/
обращения в CRM
версии 32
@crmId
9.
IN_WORK(
Response/Tickets/Tick
Актуально с
Принят в
Принят в работу
et/Info/@statusStateCo
IN_WORK
версии 32
работу)
de
10. REFUSED
Отвергнут Банком
Response/Tickets/Tick
BYBANK(
et/Info/@statusStateCo
REFUSEDBYBAN
Актуально с
(статус
Отвергнут
de
K
версии 32
окончательный -
Банком)
неуспешно)
11. REFUSED_
Отказан CRM
Response/Tickets/Tick
BY_CRM(
et/Info/@statusStateCo
REFUSED_BY_CR
Актуально с
(статус
Отказан
de
M
версии 32
окончательный -
CRM)
неуспешно)
3.4. Письмо свободного формата из банка
3.4.1.Общие сведения
Порядок предоставления документов со стороны СББОЛ следующий:
 Если запрос на предоставление документов «Письма свободного формата из банкаª
направляется первый раз, то:
o Необходимо отправить запрос Request/Incoming с указанием protocolVersion=35,
@includeGenericLettersFromBank=1, но без атрибута @lastIncomingTime;
o Со стороны УПШ вернется сообщение, содержащее все документы
«Письма
свободного формата из банкаª, которые не были переданы в УС ранее.
 В последующие разы:
o Необходимо отправить запрос Request/Incoming с указанием protocolVersion=35,
@includeGenericLettersFromBank=1 и
@lastIncomingTime(равный дате ответа
Response/@createTime, содержащего предыдущий документ «Письмо свободного
формата из банкаª);
o Со стороны УПШ вернется сообщение, в котором будут содержаться документы
«Письма свободного формата из банкаª за дату больше указанной в
Request/Incoming/@lastIncomingTime.
3.4.2.Дайджест
Подпись документа на стороне УС:
 Технологическая подпись
Дайджест: формируется
Ключевой буфер (дайджест):
 Для формирования электронной подписи из документа формируется строковая
последовательность (ключевой буфер или дайджест), включающая все значимые данные
документа, поля, содержащие пустые значения, не включаются.
 Ключевой буфер (дайджест) для подписания ЭП образует строковый массив в кодировке
UTF-8, Отдельные записи массива разделены символом перевода строки. В качестве
символа перевода строки используется 0x0A.
 При наличии в мультистроковых данных последовательности из двух символов перевода
строки CR+LF (ASCII 0x0D 0x0A) необходимо удалять символ возврата каретки CR (ASCII
0x0D) и оставлять только символ подачи строки LF (ASCII 0x0A).
 Если наполнение всех таблиц блока TABLES пустое, то и сам TABLES в дайджест не
включается
 Если наполнение какой-то таблицы блока TABLES пустое, то Table=TableName не включать в
дайджест
Формат дайджеста:
Наименование поля
Описание
Пример значения
Версионность
п/п
1.
FIELDS
<Наименование поля>=<Значение поля>, например
Актуально с
DocData.DocDate=2018-07-21
версии 32
После последней строки НЕ делать перевод строки
2.
DocData.DocDate
Дата составления
2018-07-21
Актуально с
документа
версии 32
3.
DocData.DocNumber
Номер документа
1
Актуально с
версии 32
4.
DocData.BankName
Наименование
Банк
Актуально с
подразделения банка
версии 32
получателя заявления
5.
PSFType
Тип письма свободного
Уточнение
Актуально с
формата
реквизитов
версии 32
6.
PSFTypeSystemName
Системное наименование
payment_ajustment
Актуально с
типа ПСФ
версии 32
7.
Text
Текст письма свободного
Текст письма
Актуально с
формата
версии 32
3.4.3.Формат взаимодействия
Взаимодействие: Документ передается из СББОЛ в УС
Инициатор получения документа: УС
Формат передачи документа на сторону УС: Response/GenericLettersFromBank
Формат, в котором запрашиваются документы со стороны УС: Request/Incoming
3.4.3.1. Формат получения документа
Response/GenericLettersFromBank
Элемент
Описание элемента
Тип
Описание
Версионно
Мн.
типа
сть
Ответ СББОЛ на запрос УС
Response
Respons
Актуально с
[1]
e
версии 32
Дата и время формирования
1
@createTime
xs:dateT
Простой
ответа местному по времени
Актуально с
ime
тип XML
[0..1]
запрашивающего сервера, с
версии 32
Schema
указанием его часового пояса
Уникальный идентификатор
2
@responseId
UuidSe
UUID с
ответа
parated
разделителя
ми в виде
дефисов.
Актуально с
[0..1]
Набор из 32
версии 32
символов
[0-9], [a-f] и
дефисов
Идентификатор запроса, в
3
@requestId
UuidSe
UUID с
результате которого был
parated
разделителя
сформирован данный ответ
ми в виде
дефисов.
Актуально с
[0..1]
Набор из 32
версии 32
символов
[0-9], [a-f] и
дефисов
Номер версии формата
4
@version
xs:string
Простой
обмена
RegEx:
тип XML
Актуально с
"[0-
Schema
[0..1]
версии 32
9\.]{1,2
0}"
Система-отправитель
5
@sender
xs:string
Простой
RegEx:
тип XML
«[-a-zA-
Schema
Актуально с
Zа-яА-
[0..1]
версии 32
Я0-9:
_]{1,20
Система-получатель-если
6
@receiver
xs:string
Простой
система получатель СББОЛ,
RegEx:
тип XML
Актуально с
[0..1]
то SBBOL_DBO
версии 32
«[-a-zA-
Schema
Zа-яА-
Я0-9:
_]{1,20
7
GenericLettersFromB
Письма свободного формата
Актуально с
[0..1]
ank
из банка
версии 32
*.1
GenericLetterFrom
Письмо свободного формата
Generic
Актуально с
Bank
из банка
LetterFr
[0..n]
версии 32
omBank
*.1
@docExtId
Уникальный* идентификатор
UuidSe
UUID с
документа в учетной системе
parated
разделителя
(УС) Клиента.
ми в виде
дефисов.
Актуально с
*Уникальность
[0..1]
Набор из 32
версии 32
контролируется на стороне
символов
банка
[0-9], [a-f] и
дефисов
*.2
@orgId
Идентификатор организации
UuidSe
UUID с
в СББОЛ
parated
разделителя
ми в виде
дефисов.
Актуально с
[0..1]
Набор из 32
версии 32
символов
[0-9], [a-f] и
дефисов
*.3
DocData
Общие реквизиты документа
ComLet
Актуально с
[0..1]
ДБО
tData
версии 32
*.1
@docDate
Дата составления документа
xs:date
Простой
Актуально с
тип XML
[1]
версии 32
Schema
*.2
@docNum
Номер документа
xs:string
Простой
Актуально с
тип XML
[1]
версии 32
Schema
*.3
@bankName
Наименование подразделения
xs:string
Простой
Актуально с
банка получателя заявления
тип XML
[0..1]
версии 32
Schema
*.4
@bankNum
Номер подразделения банка
xs:string
Простой
Актуально с
получателя заявления в ДБО
тип XML
[0..1]
версии 32
Schema
*.5
@crmNum
Номер ПСФ в CRM
xs:string
Простой
[min: 1,
тип XML
Актуально с
[0..1]
max:
Schema
версии 32
64]
*.6
@crmId
Идентификатор обращения в
xs:string
Простой
CRM
[min: 1,
тип XML
Актуально с
[0..1]
max:
Schema
версии 32
15]
*.7
@integration
Идентификатор цепочки
UuidSe
UUID с
Id
parated
разделителя
ми в виде
дефисов.
Актуально с
[0..1]
Набор из 32
версии 35
символов
[0-9], [a-f] и
дефисов
*.8
OrgData
Основные реквизиты
OrgData
[1
Актуально с
организации, указываемые в
]
версии 32
документе
*.1
@kpp
КПП клиента
KppTyp
КПП, 9
Актуально с
[0..1]
e
цифр
версии 32
*.2
@okato
ОКАТО клиента
OkatoT
ОКАТО, от
ype
1 до 11
цифр
Актуально с
[0..1]
(иногда
версии 32
заполняется
нулём)
*.3
@inn
ИНН клиента
InnType
ИНН
юридическо
го или
Актуально с
[0..1]
физическог
версии 32
о лица РФ,
до 12 цифр
*.4
@orgNam
Наименование организации
xs:string
Простой
e
клиента (сокращенное
тип XML
Актуально с
[1]
наименование - как в
Schema
версии 32
платежных руб. документах)
*.5
@okpo
ОКПО клиента
OkpoTy
ОКПО, от 8
Актуально с
[0..1]
pe
до 10 цифр
версии 32
*.6
@orgOG
ОГРН клиента
OgrnTy
ОГРН, от
Изменено
RN
pe
[0..1]
13 0 до 15
в версии
цифр
33
*.4
PSFType
Тип
xs:string
Простой
Актуально с
тип XML
[0..1]
версии 32
Schema
*.5
PSFTypeSystem
Системное наименование
xs:string
Простой
Актуально с
Name
типа ПСФ
тип XML
[0..1]
версии 32
Schema
*.6
Text
Текст сообщения
xs:string
Простой
Актуально с
тип XML
[0..1]
версии 32
Schema
BigFileAttachme
Приложенные к документу
BigFile
Приложенн
*.7
nts
отсканированные образы-
Attachm
ые к
вложения - для АС БФ
ents
документу
Актуально с
отсканиров
[0..1]
версии 35
анные
образы-
вложения
*.1
BigFileAttachme
Файл в БФ
BigFile
Файл в БФ
[1..n]
Актуально с
nt
Attachm
версии 35
ent
*.2
FileID
Уникальный идентификатор
xs:string
Простой
Актуально с
файла
тип XML
[0..1]
версии 35
Schema
*.3
AttachmentNa
Наименование файла
xs:string
Простой
Актуально с
me
вложения
тип XML
[0..1]
версии 35
Schema
*.4
Size
Размер файла вложения
xs:string
Простой
Актуально с
тип XML
[0..1]
версии 35
Schema
*.8
Sign
DigitalS
Актуально с
[0..1]
ign
версии 32
*.1
Поставщик сертификата.
Issuer
xs:string
Простой
Обязательно и достаточно
тип XML
для идентификации
Schema
Актуально с
клиентского сертификата в
[0..1]
версии 32
СББОЛ передавать атрибут
CN поля ISSUER в виде
«CN=<значение атрибута>»
*.2
Серийный номер сертификата
SN
xs:string
Простой
Актуально с
тип XML
[0..1]
версии 32
Schema
*.3
Значение ЭП
Value
xs:base6
Простой
Актуально с
4Binary
тип XML
[0..1]
версии 32
Schema
*.4
Имя схемы подписи
DigestName
xs:string
Простой
Актуально с
тип XML
[0..1]
версии 32
Schema
*.5
DigestVersio
Версия схемы подписи
xs:string
Простой
Актуально с
n
тип XML
[0..1]
версии 32
Schema
3.5. Обмен сообщениями с Банком
3.5.1.Дайджест запроса чата с Банком
Ключевой буфер (дайджест):
 Для формирования электронной подписи из документа формируется строковая
последовательность (ключевой буфер или дайджест), включающая все значимые данные
документа, поля, содержащие пустые значения, не включаются.
 Ключевой буфер (дайджест) для подписания ЭП образует строковый массив в кодировке
UTF-8, Отдельные записи массива разделены символом перевода строки. В качестве
символа перевода строки используется 0x0A.
 При наличии в мультистроковых данных последовательности из двух символов перевода
строки CR+LF (ASCII 0x0D 0x0A) необходимо удалять символ возврата каретки CR (ASCII
0x0D) и оставлять только символ подачи строки LF (ASCII 0x0A).
 Если наполнение всех таблиц блока TABLES пустое, то и сам TABLES в дайджест не
включается
 Если наполнение какой-то таблицы блока TABLES пустое, то Table=TableName не включать в
дайджест
Подпись запроса Request/RequestChatFromBankMsgs на стороне УС:
 Первая подпись или
 Вторая подпись или
 Единственная подпись
Дайджест: формируется
Формат дайджеста:
Наименов
п/
Описание
Пример значения
Версионность
ание поля
п
1.
ATTRIBUTES
Актуально с
<Наименование поля>=<Значение поля>, например
версии 27
OrgId=963084ba-7079-4b9d-bbab-c4972dee82d9
2.
OrgId
Идентификатор организации в
963084ba-7079-4b9d-bbab-
Актуально с
ДБО
c4972dee82d9
версии 27
3.
RequestId
Идентификатор запроса
963084ba-7079-4b9d-bbab-
Актуально с
c4972dee8777
версии 27
3.5.2.Дайджест получения сообщения из Банка
Подпись ответа Response/ChatWithBankMsgs на стороне СББОЛ:
 Технологическая подпись
Дайджест: формируется
Подпись запроса Request/ChatWithBank на стороне УС:
 Первая подпись или
 Вторая подпись или
 Единственная подпись
Дайджест: формируется
Формат дайджеста:
п/
Наименование поля
Описание
Пример значения
Версионность
п
1.
ATTRIBUTES
Актуально с
<Наименование поля>=<Значение поля>, например
версии 27
OrgId=963084ba-7079-4b9d-bbab-c4972dee82d9
2.
OrgId
Идентификатор
963084ba-7079-4b9d-
Актуально с
организации в ДБО
bbab-c4972dee82d9
версии 27
3.
Sender
Отправитель, а также тип
Ромашка
использованного Клиентом
Актуально с
программного обеспечения
версии 27
при отправке документа
4.
ExtId
3a6378ef-07ee-4535-
Уникальный*
a10a-0c82817cae23
идентификатор документа
в учетной системе (УС)
Актуально с
Клиента.
версии 27
*Уникальность
контролируется на стороне
банка
5.
FIELDS
<Наименование поля>=<Значение поля>, например
Актуально с
BeginDate=2011-11-24
версии 27
После последней строки НЕ делать перевод строки
6.
DocData.Inn
ИНН Клиента
123456789123
Актуально с
версии 27
7.
DocData.Kpp
КПП Клиента
765456765
Актуально с
версии 27
8.
DocData.OrgOGRN
ОГРН Клиента
1087746286976
Актуально с
версии 27
9.
DocData.DocNumber
Номер документа
123
Актуально с
версии 27
10.
DocData.BankName
Наименование
Банк Name
Актуально с
подразделения банка
версии 27
получателя заявления
11.
Type
Тип письма
Досыл уточненных
Актуально с
реквизитов
версии 27
12.
Theme
Тема письма
Тема
Актуально с
версии 27
13.
AuthPers.Name
Исп., ФИО
Иванов
Актуально с
версии 27
14.
AddInfo
Текст сообщения
Текст письма
Актуально с
версии 27
15.
TABLES
Разделитель строк таблицы
Актуально с
- #
версии 27
16.
Table=Attachments
Актуально с
версии 27
17.
Attachment.Attachment
Имя файла вложения
f1311fff.TXT
Актуально с
Name
версии 27
18.
Attachment.Description
Пользовательское описание
Описание файла
Актуально с
файла вложения
версии 27
19.
Attachment.Body
Вложение в бинарном
VGVzdA==
Актуально с
представлении в сжатом и
версии 27
несжатом виде
3.5.3.Дайджест запроса статусов обработки сообщения
из СББОЛ
Подпись запроса Request/ChatWithBankMsgStatus на стороне УС:
 Первая подпись или
 Вторая подпись или
 Единственная подпись
Дайджест: формируется
Формат дайджеста:
п/
Наименование поля
Описание
Пример значения
Версионность
п
1.
ATTRIBUTES
Актуально с
<Наименование поля>=<Значение поля>, например
версии 27
OrgId=963084ba-7079-4b9d-bbab-c4972dee82d9
2.
OrgId
Идентификатор
963084ba-7079-4b9d-
Актуально с
организации в ДБО
bbab-c4972dee82d9
версии 27
3.
Sender
Отправитель, а также тип
Ромашка
использованного
Актуально с
Клиентом программного
версии 27
обеспечения при отправке
документа
4.
FIELDS
<Наименование поля>=<Значение поля>, например
Актуально с
BeginDate=2011-11-24
версии 27
После последней строки НЕ делать перевод строки
5.
ChatWithBankMsgStat
3a6378ef-07ee-4535-
Актуально с
us.DocExtId
a10a-0c8281713256
версии 27
6.
ChatWithBankMsgStat
Актуально с
us.Status
версии 27
3.5.4.Формат взаимодействия
Обмен сообщениями происходит по следующей схеме:
1. УС Клиента отправляет в СББОЛ запрос Request/RequestChatFromBankMsgs
2. В ответ получает Response/ChatWithBankMsgs с сообщениями из Банка
3. УС Клиента отправляет в СББОЛ запрос, содержащий ответное сообщение в виде
Request/ChatWithBank
4. УС Клиента запрашивает в СББОЛ статус сообщения Request/ChatWithBankMsgStatus
5. В ответ из СББОЛ приходит статус сообщения в элементе Response/Ticket
3.5.4.1. Формат отправки запроса чата с Банком
Request/ChatFromBankMsgs
Версионно
Элемент
Описаниеэлемента
Тип
Описаниетипа
Мн.
сть
Request
Запрос УС к СББОЛ
Request
Актуально
[1]
с версии
27
Уникальный
UUID с
1
@requestId
UuidSeparated
идентификатор запроса
разделителями
Актуально
в виде дефисов.
[1]
с версии
Набор из 32
27
символов [0-9],
[a-f] и дефисов
Идентификатор
UUID с
2
@orgId
UuidSeparated
организациив ДБО (может
разделителями
Актуально
быть использован
в виде дефисов.
[1]
с версии
сторонней системой для
Набор из 32
27
дополнительной
символов [0-9],
идентификации)
[a-f] и дефисов
Номер версии формата
Простой тип
3
@version
xs:string
Актуально
[1]
обмена
XML Schema
RegEx: "[0-
с версии
9\.]{1,20}"
27
Система-отправитель
Простой тип
4
@sender
xs:string
Актуально
XML Schema
RegEx: «[-a-
[1]
с версии
zA-Zа-яА-Я0-
27
9: _]{1,20}»
Система-получатель - если
Простой тип
5
@receiver
xs:string
Актуально
система получатель
XML Schema
RegEx: «[-a-
[0..1
с версии
СББОЛ, то SBBOL_DBO
zA-Zа-яА-Я0-
]
27
9: _]{1,20}»
Версия протокола
Простой тип
6
@protocolVersion
xs:string
[0..1
Актуально
XML Schema
]
с версии
27
Запрос сообщений чата с
7
RequestChatFromBa
RequestChatFr
Актуально
банком
nkMsgs
omBankMsgs
[1]
с версии
27
Дата и время последнего
Простой тип
*.1
@lastIncomingTi
xs:dateTime
Актуально
[0..1
запроса сообщений чата с
XML Schema
me
с версии
]
банком (с час. поясами)
27
3.5.4.2. Формат получения сообщения из Банка
Response/ChatWithBankMsgs
Описание
Версионн
Элемент
Описание элемента
Тип
Мн.
типа
ость
Ответ СББОЛ на запрос УС
Response
Актуально
Response
[1]
с версии
27
Дата и время
xs:dateTime
Простой тип
1
@createTime
формирования ответа
XML
Актуально
местному по времени
Schema
[0..1
с версии
запрашивающего сервера, с
]
27
указанием его часового
пояса
Уникальный
UuidSeparat
UUID с
2
@responseId
идентификатор ответа
ed
разделителя
ми в виде
Актуально
дефисов.
[0..1
с версии
Набор из 32
]
27
символов
[0-9], [a-f] и
дефисов
Идентификатор запроса, в
UuidSeparat
UUID с
3
@requestId
результате которого был
ed
разделителя
сформирован данный ответ
ми в виде
Актуально
дефисов.
[0..1
с версии
Набор из 32
]
27
символов
[0-9], [a-f] и
дефисов
Номер версии формата
xs:string
Простой тип
Актуально
4
@version
[0..1
обмена
RegEx: "[0-
XML
с версии
]
9\.]{1,20}"
Schema
27
Система-отправитель
xs:string
Простой тип
5
@sender
RegEx: «[-a-
XML
Актуально
[0..1
zA-Zа-яА-
Schema
с версии
]
Я0-9:
27
_]{1,20}»
Система-получатель Если
xs:string
Простой тип
6
@receiver
система получатель
RegEx: «[-a-
XML
Актуально
[0..1
СББОЛ, то SBBOL_DBO
zA-Zа-яА-
Schema
с версии
]
Я0-9:
27
_]{1,20}»
Актуально
Сообщения чата с банком
[0..1
7
ChatWithBankMsgs
с версии
(из банка)
]
27
Сообщение чата с банком
ChatWithBa
Актуально
*.1
ChatWithBankMsg
[0..n
(из банка)
nkMsg
с версии
]
27
Идентификатор сообщения
UuidSeparat
Простой тип
Актуально
*.1
@chatMsgExtId
чата в УС
ed
XML
[1]
с версии
Schema
27
UuidSeparat
UUID с
*.2
@docExtId
Уникальный*
ed
разделителя
идентификатор документа
ми в виде
в учетной системе (УС)
Актуально
дефисов.
Клиента.
[1]
с версии
Набор из 32
*Уникальность
27
символов
контролируется на стороне
[0-9], [a-f] и
банка
дефисов
Номер сообщения чата
xs:integer
Простой тип
Актуально
*.3
@chatMsgNum
XML
[1]
с версии
Schema
27
Дата создания сообщения
xs:date
Простой тип
Актуально
*.4
@chatMsgDate
чата
XML
[1]
с версии
Schema
27
Является ли создатель
xs:boolean
Простой тип
*.5
@creatorClient
Актуально
сообщения клиентом, в
XML
[1]
с версии
противном случае создал
Schema
27
сообщение банк
Наименование
xs:string
Простой тип
Актуально
*.6
@bankName
подразделения банка
XML
[1]
с версии
Schema
27
Уполномоченный
AuthPers
Актуально
*.7
AuthPers
[0..1
сотрудник организации
с версии
]
клиента
27
Имя уполномоченного
xs:string
Простой тип
Актуально
*.
Name
[0..1
сотрудника организации
XML
с версии
1
]
клиента
Schema
27
xs:string
xs:string
Простой тип
Актуально
*.
Telfax
[0..1
XML
с версии
2
]
Schema
27
Статус сообщения
xs:string
Простой тип
Актуально
*.8
Status
[0..1
XML
с версии
]
Schema
27
Текст сообщения
xs:string
Простой тип
Актуально
*.9
AddInfo
[0..1
XML
с версии
]
Schema
27
Приложенные к документу
Attachments
Актуально
*.1
Attachments
[0..1
отсканированные образы-
Type
с версии
0
]
вложения
27
Attachment
Актуально
*.1
Attachment
[0..n
с версии
]
27
Имя файла вложения
xs:string
Простой тип
*.1
Attach
Актуально
[0..1
XML
mentNa
с версии
]
Schema
me
27
Пользовательское описание
xs:string
Простой тип
Актуально
*.2
Descript
[0..1
файла вложения
XML
с версии
ion
]
Schema
27
В бинарном представлении
xs:base64Bin
Простой тип
Актуально
*.3
Body
[0..1
в сжатом и несжатом виде
ary
XML
с версии
]
Schema
27
Размер вложенного файла в
xs:long
Простой тип
Актуально
*.4
FileSize
[0..1
байтах
XML
с версии
]
Schema
27
Дата создания файла
xs:dateTime
Простой тип
Актуально
*.5
FileDate
[0..1
XML
с версии
]
Schema
27
3.5.4.3. Формат отправки сообщения в Банк
Request/ChatWithBank
Описание
Версионн
Элемент
Описание элемента
Тип
Мн.
типа
ость
Request
Актуально
Запрос ТК к СББОЛ
Request
[1]
с версии
27
Уникальный идентификатор
UUID с
1
@requestId
UuidSepa
запроса
разделител
rated
ями в виде
дефисов.
Актуально
Набор из
[1]
с версии
32
27
символов
[0-9], [a-f]
и дефисов
Идентификатор организациив
UUID с
2
@orgId
UuidSepa
ДБО (может быть использован
разделител
rated
сторонней системой для
ями в виде
дополнительной
дефисов.
Актуально
идентификации)
Набор из
[1]
с версии
32
27
символов
[0-9], [a-f]
и дефисов
Номер версии формата обмена
Простой
3
@version
xs:string
тип XML
RegEx:
Актуально
Schema
"[0-
[1]
с версии
9\.]{1,20}
27
"
Система-отправитель
Простой
4
@sender
xs:string
тип XML
RegEx:
Актуально
Schema
«[-a-zA-
[1]
с версии
Zа-яА-
27
Я0-9:
_]{1,20}»
Система-получатель - если
Простой
5
@receiver
xs:string
система получатель СББОЛ, то
тип XML
RegEx:
Актуально
SBBOL_DBO
Schema
«[-a-zA-
[0..1
с версии
Zа-яА-
]
27
Я0-9:
_]{1,20}»
Версия протокола
Простой
6
@protocolVersion
xs:string
[0..1
Актуально
тип XML
]
с версии
Schema
27
Актуально
Обмен сообщениями с банком
ChatWhit
7
ChatWithBank
[1]
с версии
(в Банк)
Bank
27
Идентификатор сообщения
UuidSepa
UUID с
@chatMsgExtId
чата в УС
rated
разделител
ями в виде
1
дефисов.
Актуально
[1]
Набор из
с версии
32
27
символов
[0-9], [a-f]
и дефисов
Идентификатор документа, к
UuidSepa
UUID с
@docId
которому относится сообщение
rated
разделител
чата, в СББОЛ
ями в виде
2
дефисов.
Актуально
[1]
Набор из
с версии
32
27
символов
[0-9], [a-f]
и дефисов
Номер сообщения чата
xs:integer
Простой
@chatMsgNum
Актуально
тип XML
[1]
с версии
Schema
3
27
Дата создания сообщения чата
xs:date
Простой
@chatMsgDate
Актуально
тип XML
[1]
с версии
Schema
4
27
Наименование подразделения
xs:string
Простой
@bankName
банка
[min:1;
тип XML
Актуально
Значение берется из
max:255]
Schema
5
[1]
с версии
Response/OrganizationsInfo/Orga
27
nizationInfo/Branches/Branch/Br
anchData/FullName
Уполномоченный сотрудник
AuthPers
AuthPers
[1]
Изменено
организации клиента
[0..1
в версии
6
]
30
Имя уполномоченного
xs:string
Простой
Name
Актуально
[0..1
сотрудника организации
[min:1;
тип XML
с версии
]
клиента
max:60]
Schema
1
27
Номер телефона, факса
xs:string
Простой
Telfax
Актуально
[0..1
уполномоченного сотрудника
[min:1;
тип XML
с версии
]
организации клиента
max:45]
Schema
2
27
Должность
xs:string
Простой
Position
Актуально
[min:1;
тип XML
[0..1
с версии
max:1024
Schema
]
3
27
]
Текст сообщения
xs:string
Простой
AddInfo
Актуально
[min:1;
тип XML
[1]
с версии
max:8000
Schema
7
27
]
Приложенные к документу
Attachme
Attachments
Актуально
[0..1
отсканированные образы-
ntsType
с версии
]
вложения
8
27
Отдельное вложение
Attachment
[1...nАктуально
с версии
]
1
27
Тип файла вложения
xs:string
Type
Актуально
[0..1
с версии
]
1
27
Имя файла вложения
xs:string
Простой
AttachmentName
[0..1
Изменено
[min:1;
тип XML
]
в версии
max:255]
Schema
2
29
[1]
xs:string
Простой
Description
Актуально
[min:1;
тип XML
[0..1
с версии
max:1024
Schema
]
3
27
]
Дата добавления вложения
xs:date
Простой
Date
Актуально
[0..1
тип XML
с версии
]
Schema
4
27
Размер вложения
xs:int
Простой
Size
Актуально
[0..1
тип XML
с версии
]
Schema
5
27
В бинарном представлении в
xs:base64
Простой
Body
Актуально
сжатом и несжатом виде
Binary
тип XML
[1]
с версии
Schema
6
27
Подпись вложения
Attachme
AttachmentSign
Актуально
[0..1
ntSign
с версии
]
7
27
ЭП клиента
DigitalSig
Sign
Актуально
[1..n
n
с версии
]
1
27
Поставщик сертификата.
xs:string
Простой
*.
Issuer
Обязательно и достаточно для
[min: 1,
тип XML
1
идентификации клиентского
max:
Schema
Актуально
сертификата в СББОЛ
1024]
[1]
с версии
передавать атрибут CN поля
27
Issuer в виде «CN=<значение
атрибута>»
Серийный номер сертификата
xs:string
Простой
Актуально
*.
SN
[min: 1,
тип XML
[1]
с версии
2
max: 255]
Schema
27
Значение ЭП
xs:base64
Простой
Актуально
*.
Value
Binary
тип XML
[1]
с версии
3
Schema
27
Имя схемы подписи
xs:string
Простой
Актуально
*.
DigestName
[0..1
"for_upg" - для ТК;
тип XML
с версии
4
]
"for_upg_onec" - для 1С;
Schema
27
Версия схемы подписи
xs:string
Простой
Актуально
*.
DigestVersio
[0..1
тип XML
с версии
5
n
]
Schema
27
Уникальные свойства
xs:string
Простой
*.
PcPropHash
компьютера, осуществляющего
тип XML
6
установку сеанса связи, SHA
Schema
512 от значения PcProp.
Содержит следующие
параметры:
∙ UUID
∙ Идентификатор процессора
∙ Серийный номер BIOS
Актуально
[0..1
∙ Серийный номер жесткого
с версии
]
диска.
27
Передаваться должны в виде
строки с разделителем «;».
Формат передачи:
«UUID;Идентификатор
процессора;Серийный номер
BIOS;Серийный номер
жесткого диска».
Данные для fraud-мониторинга.
Fraud
Актуально
*.
Fraud
[0..1
Информация о подписи
с версии
7
]
27
Логин
xs:string
Простой
Актуально
*.
Login
тип XML
[1]*
с версии
1
Schema
27
Данные токена
xs:string
Простой
*.
TokenInfo
Отображение в запросе
тип XML
2
(разделитель «;»):
Schema
BCRYPT;;;;;
Отображение в интерфейсе:
Тип токена: TOKEN
Возможные значения:
TOKEN - обычный токен,
TOKEN_BU - токен с кнопкой,
TOKEN_SC - токен с экраном
BCRYPT - ПАК ФПСУ-IP или
токен ФПСУ-IP (в этом случае
остальную информацию о
Актуально
конфигурации не заполнять),
[1]*
с версии
SMS — при подтверждении
27
операций кодом СМС (в этом
случае остальную информацию
о конфигурации не заполнять)
Информация о конфигурации
токена:
IС1_A10D0010L_C1_VT01KA0
2
Дата конфигурации: 2012-04-13
09:44:59.003
Серийный номер токена:
00041485B
Номер сборки токена: 100
Список поддерживаемых
xs:string
Простой
*.
HttpAcce
естественных языков
тип XML
3
ptLangua
Требуется указать локализацию
Schema
ge
ОС компьютера, на котором
установлен БК,
Актуально
Например, для английской
[1]*
с версии
локализации в качестве
27
значения атрибута указывается
- 'en-US', для русской
локализации указывается - 'ru-
RU'.
IP и Mac адреса компьютера
xs:string
Простой
*.
IpMACA
отправившего или
тип XML
Актуально
4
ddresses
подписавшего. Формат:
Schema
[1]*
с версии
«remoteIP;remoteMac;ip1;mac1;i
27
p2;mac2»
Геопозиционирование
xs:string
Простой
*.
Geolocatio
компьютера отправившего или
тип XML
Актуально
5
nInfo
подписавшего. Формат:
Schema
[1]*
с версии
«Longitude;Latitude;HorizontalA
27
ccuracy;Timestamp;Status»
Уникальные свойтсва
xs:string
Простой
*.
PcProp
компьютера отправившего или
тип XML
6
подписавшего. Формат:
Schema
Актуально
«UUID;Идентификатор
[1]*
с версии
процессора;Серийный номер
27
BIOS;Серийный номер
жесткого диска».
Правила формирования
xs:string
Простой
*.
DevicePri
значения данного поля описаны
[min:1]
тип XML
Актуально
7
nt
[0..1
в 1 части п. «Правила
Schema
с версии
]
формирования значения
27
параметра DevicePrint»
Очередность наложения
xs:string
Простой
*.
Order
подписи (какая подпись когда
тип XML
8
Актуально
была наложена) в случае
Schema
[0..1
с версии
наложения подписи и удаления
]
27
ее, порядок должен сдвигаться
соответственно влево
Дата/Время подписи Пример:
xs:dateTi
Простой
Актуально
*.
SignDate
[0..1
2012-04-13 09:44:59.003
me
тип XML
с версии
9
]
Schema
27
BigFileAttachments
Данные о больших файлах,
BigFileAt
Добавлено
[0..1
связанных с сущностью
tachment
в версии
]
9
s
30
BigFileAttachment
Данные о большом файле,
BigFileAt
Файл в БФ
Добавлено
[1..n
связанном с сущностью
tachment
в версии
]
1
30
UploadJobId
Идентификатор задания на
UuidSepa
UUID с
загрузку файла в БФ
rated
разделител
ями в виде
1
дефисов.
Добавлено
Набор из
[1]
в версии
32
30
символов
[0-9], [a-f]
или [A-F]
и дефисов
Description
Пользовательское описание
xs:string
Простой
Добавлено
файла вложения
[min: 1,
тип XML
[0..1
в версии
max:
Schema
]
2
30
1024]
*Если нет технической возможности предоставить данные раздела фрод -
мониторинга, то поле можно передавать cо значением «null»
3.5.4.4. Формат запроса статусов обработки
сообщения из СББОЛ
УС Клиента отправляет запрос Request/ChatWithBankMsgStatus в СББОЛ, в ответ на него
из СББОЛ приходит статус сообщения в значении атрибута
Response/Tickets/Ticket/@statusStateCode, где в •
Tickets/Ticket/Info/BankDate/@statusDateTime содержится дата и время присвоения
статуса.
Request/ChatWithBankMsgStatus
Версионно
Элемент
Описаниеэлемента
Тип
Описаниетипа
Мн.
сть
Request
Запрос УС к СББОЛ
Request
Актуально
[1]
с версии
27
Уникальный идентификатор
UUID с
1
@requestId
UuidSepa
запроса
разделителями
rated
в виде
Актуально
дефисов.
[1]
с версии
Набор из 32
27
символов [0-9],
[a-f] и дефисов
Идентификатор организации
UUID с
2
@orgId
UuidSepa
в ДБО (может быть
разделителями
rated
использован сторонней
в виде
Актуально
системой для
дефисов.
[1]
с версии
дополнительной
Набор из 32
27
идентификации)
символов [0-9],
[a-f] и дефисов
Номер версии формата
Простой тип
3
@version
xs:string
обмена
XML Schema
RegEx:
Актуально
"[0-
[1]
с версии
9\.]{1,20}
27
"
Система-отправитель
Простой тип
4
@sender
xs:string
XML Schema
RegEx:
Актуально
«[-a-zA-
[1]
с версии
Zа-яА-
27
Я0-9:
_]{1,20}»
Система-получатель - если
Простой тип
5
@receiver
xs:string
система получатель СББОЛ,
XML Schema
RegEx:
Актуально
то SBBOL_DBO
«[-a-zA-
[0..1
с версии
Zа-яА-
]
27
Я0-9:
_]{1,20}»
Версия протокола
Простой тип
6
@protocolVersion
xs:string
[0..1
Актуально
XML Schema
]
с версии
27
Получение статуса
7
ChatWithBankMsgStat
Актуально
сообщения чата с банком (в
us
[1]
с версии
Банк)
27
Идентификатор сообщения
Простой тип
*.1
@chatMsgExtId
UuidSepa
Актуально
чата в УС
XML Schema
rated
[1]
с версии
27
Идентификатор документа, к
Простой тип
*.2
@docId
UuidSepa
Актуально
которому относится
XML Schema
rated
[1]
с версии
сообщение чата, в СББОЛ
27
Статус сообщения чата с
xs:string
Простой тип
Актуально
*.3
@status
банком (вБанк)
[min: 1,
XML Schema
[1]
с версии
max: 255]
27
3.5.5.Особенности получения статусов обработки
сообщения из СББОЛ
Статусы обработки документа «Обмен сообщениями с банкомª
Передавае
Описание
мый из
передаваем
Описание операции
Атрибут Response/Tickets
Версионно
п/
СББОЛ
ого из
на стороне СББОЛ
для передачи в УПШ
сть
п
статус
СББОЛ
документа
значения
Response/Tickets/Ticket/Info/
INVALIDED
Актуально
@statusStateCode
S
с версии 27
Может быть
Проверки документа
передано
INVALIDE
привели к
сообщение о
DS
неуспешному
1
том, что
(АСП/ЭП
результату
Response/Tickets/Ticket/Info/
Актуально
подлинность
не верна)
(статус окончательный-
MsgFromBank/@message
с версии 27
документа
не успешно)
не
подтвержден
а
(VALIDED
Проверки документа
Response/Tickets/Ticket/Info/
Актуально
2
S) АСП/ЭП
привели к успешному
VALIDEDS
@statusStateCode
с версии 27
верна
результату
Response/Tickets/Ticket/Info/
REQUISITE
Актуально
@statusStateCode
_ERROR
с версии 27
Логические проверки
REQUISIT
Должны
документа привели к
E_ERROR
передаваться
неуспешному
3
(Ошибка
сообщения
результату
Response/Tickets/Ticket/Info/
Актуально
реквизитов
об ошибках,
(статус окончательный-
MsgFromBank/@message
с версии 27
)
выявленных
не успешно)
на стороне
Банка
DELIVER
Документ доставлен на
ED
сторну Банка, но еще не
Response/Tickets/Ticket/Info/
DELIVERE
Актуально
4
(Доставлен
проходил проверку
@statusStateCode
D
с версии 27
)
подписи и реквизитов
Response/Tickets/Ticket/@stat
DECLINED_
Актуально
usStateCode
BY_ABS
с версии 27
Response/Tickets/Ticket/Info/
Сообщение
Актуально
DECLINE
MsgFromBank/@message
из Банка
с версии 27
Отказ платежа
D_BY_AB
Реквизиты
5
(статус окончательный-
S (Отказан
ответственн
не успешно)
АБС)
Response/Tickets/Ticket/Info/
ого
Актуально
MsgFromBank/@author
сотрудника
с версии 27
Банка, если
требуется
PROCESS
Документ обработан
Response/Tickets/Ticket/@stat
PROCESSE
ED
usStateCode
D
Актуально
(статус окончательный-
6
(Обработан
с версии 27
успешно)
)
Получен тикет о
Response/Tickets/Ticket/@stat
READ
Актуально
прочтении сообщения в
usStateCode
с версии 27
АБС
Реквизиты
READ
Response/Tickets/Ticket/Info/
ответственн
7
(Прочитано)
MsgFromBank/@author
ого
Актуально
сотрудника
с версии 27
Банка, если
требуется
3.6. Передача скан-копий иных документов в Банк
3.6.1.Общие сведения
Отправка файлов в Банк происходит в 4 этапа:
1.
УС Клиента формирует запрос Request/SubstDocAdd, содержащий
информацию о параметрах файлов (сущность - иной документ) или формирует запрос
Request/ContractAdd, содержащий информацию о параметрах файлов (сущность -
контракт ГОЗ) или формирует запрос Request/ActAdd, содержащий информацию о
параметрах файлов (сущность - акт ГОЗ), подписывает сформированный запрос Первой и
Второй или Единственной подписью и отправляет его в СББОЛ. После этого УС Клиента
запрашивает статус и, в случае успешной доставки, получает в ответ Response/Ticket со
статустом DELIVERED и ссылки для загрузки файлов в АС БФ
Response/LinksToBigFiles. Возвращаемые ссылки - относительные
(пример:«.../upload/1eec9d62-4a13-4240-aa92-5362d169d477»), для последующего
использования, необходимо подставить в начало полученной ссылки адрес сервиса
больших файлов СББОЛ вида «http://ip:port/sbns-app/...», сведения по актуальному
адресу сервиса БФ СББОЛ содержатся инструкции по подключению, а также их можно
получить в техподдержке банка.
2.
При получении ссылок, УС Клиента осуществляет загрузку файлов в сервис
БФ, с использованием защищенного канала связи на базе ПАК ФПСУ-IP либо ФПСУ-
IP\Клиент. Непосредственно загрузка большого файла в сервис БФ выполняется в сервис
БФ СББОЛ напрямую, минуя сервис УПШ СББОЛ. Для загрузки можно воспользоваться
методом HTTP POST.
3.
УС Клиента может запрашивать состояние файла (см. таблицу «Статусы
загруженных файлов») с помощью запроса Request/BigFilesStatusRequest. В ответ на
запрос УС Клиента получает статус в ответе Response/BigFilesStatus.
4.
Если требуется прикрепить еще один или несколько файлов, то необходимо
отправить запрос Request/BigFilesUploadLinksRequest для добавления информации о
прикрепляемых файлах к уже существующей сущности SubstDocAdd, ContractAdd или
ActAdd в СББОЛ. После этого УС Клиента получает ответ Response/LinksToBigFiles со
ссылками для загрузки файлов в сервис БФ СББОЛ
Дополнительные особенности:
Для актуализации справочников ГОЗ (иного документа, контракта ГОЗ или акта
ГОЗ) УС Клиента отправляет в УПШ запрос Request/Dict или Request/GozDocUpdate
(см. ч.2, «Репликация справочников на сторону Клиента») с указанием соответствующего
наименования (SubstDoc,GozAct, GOZContract), в результате чего получает ответ в виде
справочника.
Реализация в запросах SubstDoc, GozAct, GOZContract связки идентификаторов
EssenceId + TransferJobGUID направлена на управление загруженным в СББОЛ
документом (сущностью) в части связанных с ним файлов. В запросе указываются
идентификаторы загрузки файлов, которые клиент считает актуальными, их перечень
может отличаться от первоначального перечня загруженных файлов, например, клиент
решил, что один файл лишний и его требуется удалить из ранее отправленной в банк
сущности. В этом случае Клиент направляет в банк запрос, например, SubstDocAdd, с
указанием в нем EssenceId. В запросе перечисляет ранее отправленные файлы +
TransferJobGUID, которые требуется оставить в сущности. Исключает информацию о
ранее отправленных файлах, которые требуется удалить из сущности.
СББОЛ выполняет проверку соответствия указанных идентификаторов файлов в запросе к
идентификаторам, выданным для загрузки файлов ранее в связанном документе.
¾ Если TransferJobGUID найден в запросе, то ничего не происходит. Такой файл считается
актуальным для данного документа - файл остается в документе
¾ Если TransferJobGUID отсутствует в запросе, то такой файл считается неактуальным для
данного документа и удаляется.
¾ Если необходимо загрузить дополнительный файл, то в запросе указываются его атрибуты
и для него возвращаются ссылка и идентификатор загрузки, в соответствии с которым
можно догрузить файл в БФ установленным порядком. либо можно загрузить используя
запрос с типом BigFilesUploadLinksRequest
На Рисунке ниже показана схема взаимодействия УС Клиента с СББОЛ.
Ограничения по использованию Передачи скан-копий Подтверждающих документов в Банк:
Направлять ПП с несколькими вложениями типа контракт, принадлежащему разным
контрактам не рекомендуется.
Не рекомендуется направлять ПП с контрактом и актом, с которым не связан данный контракт
3.6.2.Дайджест запроса на добавление
«Иного
документа»
Подпись документа на стороне УС:
 Первая подпись и вторая подпись или
 Единственная подпись
Дайджест: формируется
Ключевой буфер (дайджест):
 Для формирования электронной подписи из документа формируется строковая
последовательность (ключевой буфер или дайджест), включающая все значимые данные
документа, поля, содержащие пустые значения, не включаются.
 Ключевой буфер (дайджест) для подписания ЭП образует строковый массив в кодировке
UTF-8, Отдельные записи массива разделены символом перевода строки. В качестве
символа перевода строки используется 0x0A.
 При наличии в мультистроковых данных последовательности из двух символов перевода
строки CR+LF (ASCII 0x0D 0x0A) необходимо удалять символ возврата каретки CR (ASCII
0x0D) и оставлять только символ подачи строки LF (ASCII 0x0A).
 Если наполнение всех таблиц блока TABLES пустое, то и сам TABLES в дайджест не
включается
 Если наполнение какой-то таблицы блока TABLES пустое, то Table=TableName не включать в
дайджест
Формат дайджеста:
Пример
Версионно
п/
Наименование поля
Описание
значения
сть
п
1.
ATTRIBUTES
Актуально
<Наименование поля>=<Значение поля>, например
с версии 27
OrgId=963084ba-7079-4b9d-bbab-c4972dee82d9
2.
OrgId
Идентификатор организации в
963084ba-7079-
ДБО (может быть использован
4b9d-bbab-
Актуально
сторонней системой для
c4972dee82d9
с версии 27
дополнительной идентификации)
3.
Sender
Отправитель, а также тип
Ромашка
использованного Клиентом
Актуально
программного обеспечения при
с версии 27
отправке документа
4.
EssenceId
Идентификатор документа в
3a6378ef-07ee-
Актуально
СББОЛ.
4535-a10a-
с версии 27
0c82817cae23
5.
FIELDS
<Наименование поля>=<Значение поля>, например
Актуально
с версии 27
AccDoc.AccDocNo=444
После последней строки НЕ делать перевод строки
6.
Тип иного документа
SubstDocAdd.SubstDoc
2
Актуально
обеспечения
Type
с версии 27
7.
Разделитель строк таблицы - #
Актуально
TABLES
Сортировать сначала по типу
с версии 27
адреса, потом по индексу
8.
Актуально
Ссылки на вложенные файлы
Table=BFAttachments
с версии 27
9.
Имя файла вложения,
BFAttachments.FileNa
необходимо для проверки в
Актуально
Desert.jpg
списке разрешенных типов
с версии 27
me
файлов
Пример дайджеста
ATTRIBUTES
OrgId=5e218ae3-1969-4411-a9cf-b10c9f730e5c
Sender=Оператор услуг
FIELDS
SubstDocAdd.SubstDocType=0
TABLES
Table=BFAttachments
BFAttachments.FileName=File(96).JPG
#Пример дайджеста на досылку
ATTRIBUTES
OrgId=5e218ae3-1969-4411-a9cf-b10c9f730e5c
Sender=Оператор услуг
EssenceId=34e9e965-fb7c-45ae-be99-6c767f2af41b
FIELDS
SubstDocAdd.SubstDocType=0
TABLES
Table=BFAttachments
BFAttachments.FileName=File(96).JPG
#
BFAttachments.FileName=File(97).JPG
#
3.6.3.Формат взаимодействия
Взаимодействие: Документ передается из УС Клиента в СББОЛ
Инициатор получения документа: УС Клиента
Формат, в котором запрашиваются документы со стороны УС: Request/SubstDocAdd
Формат передачи документа на сторону УС: Response/Ticket
3.6.3.1. Формат отправки
«Иного документа» в
СББОЛ
Request/SubstDocAdd
Описание
Версионн
Элемент
Описание элемента
Тип
Мн.
типа
ость
Request
Request
Актуально
[1]
с версии
27
1
Уникальный
UuidSeparat
UUID с
@requestId
идентификатор запроса
ed
разделителями
в виде
[1]
Актуально
дефисов.
с версии
Набор из 32
27
символов [0-
9], [a-f] и
дефисов
2
Идентификатор
UUID с
@orgId
UuidSeparat
организациив ДБО (может
разделителями
ed
быть использован
в виде
Актуально
сторонней системой для
дефисов.
[1]
с версии
дополнительной
Набор из 32
27
идентификации)
символов [0-
9], [a-f] и
дефисов
3
Номер версии формата
Простой тип
@version
xs:string
Актуально
обмена
XML Schema
RegEx: "[0-
[1]
с версии
9\.]{1,20}"
27
4
Система-отправитель
Простой тип
@sender
xs:string
XML Schema
RegEx: «[-a-
Актуально
zA-Zа-яА-
[1]
с версии
Я0-9:
27
_]{1,20}»
5
Система-получатель - если
Простой тип
@receiver
xs:string
система получатель
XML Schema
RegEx: «[-a-
Актуально
[0..1
СББОЛ, то SBBOL_DBO
zA-Zа-яА-
с версии
]
Я0-9:
27
_]{1,20}»
6
Версия протокола
Простой тип
@protocolVersion
xs:string
[0..1
Актуально
XML Schema
]
с версии
27
7
SubstDocAdd
Добавление иного
SubstDocAd
Актуально
документа
d
[1]
с версии
27
*.1
@essenceId
Идентификатор документа
UuidSeparat
UUID с
в СББОЛ.
ed
разделителями
Значение для поля
в виде
приходит в ответе на
дефисов.
запрос статуса отправки
Набор из 32
документа «Иной» (поле
символов [0-
docId)
9], [a-f] и
При отсутствии
дефисов
[0..1
Актуально
идентификатора - в СББОЛ
]
с версии
будет создана новая запись
27
в справочнике Иных
документов
SubstantiatingDocuments.
При наличии
идентификатора - в СББОЛ
будет произведено
изменение существующей
записи с данным docId.
*.2
@docDate
Дата документа
xs:date
Актуально
[0..1
с версии
]
27
*.3
@docNum
Номер документа
xs:string
Актуально
[min: 1,
[1]
с версии
max: 12]
27
*.4
@substDocType
Тип обосновывающего
SubstDocTy
документа, заполняется
pe
Актуально
значением из элемента
[1]
с версии
UpgRplDictionary/ConType
27
Entry/@code
*.5
@name
Пользовательское
xs:string
Актуально
наименование документа
[min: 1,
[1]
с версии
max: 512]
27
*.6
@accountNumb
№ отдельного счета
AccNumTyp
Актуально
er
e
[1]
с версии
27
*.7
BFAttachments
Список запросов на ссылки
BFAttachm
Актуально
в БФ
ents
[1]
с версии
27
*.
BFAttachme
Файл в системе БФ
Актуально
[1..n
1
nt
с версии
]
27
@linkUUI
Уникальный
UuidSeparat
D
идентификатор запроса,
ed
Актуально
1
используется клиентским
[1]
с версии
приложением для
27
связывания запроса ссылки
и самой ссылки
FileName
Имя файла вложения,
xs:string
Допустимые
необходимо для проверки в
[min: 1,
расширения
2
списке разрешенных типов
max: 255]
файлов, на
Актуально
файлов
момент
[1]
с версии
написания
27
документации:
pdf, tiff, jpeg,
png, pcx
FileSize
Размер пользовательского
xs:int
[min:
Актуально
[0..1
файла
1]
с версии
]
3
27
Comment
Пользовательское
xs:string
Актуально
[0..1
описание файла вложения
[min: 1,
с версии
]
4
max: 1024]
27
TransferJo
Уникальный
UuidSeparat
bGUID
идентификатор задачи на
ed
5
закачку файла в БФ.
Актуально
Значение для поля
[0..1
с версии
приходит в ответе на
]
27
запрос статуса отправки
иного документа (поле
TransferJobGUID)
Пример
<Request
orgId='5e218ae3-1969-4411-a9cf-b10c9f730e5c'
requestId='30719616-5cc2-4e9f-1358-ff9b6a91ff19'
sender='Оператор услуг'
version='123'
<SubstDocAdd accountNumber='40825810738003000088' docDate='2017-05-15'
docNum='16667' name='Тест' substDocType='0'>
<BFAttachments>
<BFAttachment linkUUID='77ce7cb9-14f4-1f98-8270-22bab1317f2c'>
<FileName>File(96).JPG</FileName>
<Comment>Это мой файл</Comment>
</BFAttachment>
</BFAttachments>
</SubstDocAdd>
<Sign>
<Issuer>CN=ЛавринСВ-Тестовая печать-УЦ-9</Issuer>
<SN>752FB189A8C1871B689F</SN>
<Value>W8zqXC0L47FUVI4oTtIzXPaWH9u2S9lahQ7i2HtLUrwKpgfRaD5KZFbqdE71LuOh5Ty//t
iieGT7fOQvI6pOog==</Value>
<DigestName>for_upg</DigestName>
<DigestVersion>1</DigestVersion>
</Sign>
</Request>
Пример на досылку
<Request
orgId='5e218ae3-1969-4411-a9cf-b10c9f730e5c'
receiver='SBBOL_DBO'
requestId='37222eb3-1bb6-4fad-79af-1888be900161'
sender='Оператор услуг'
version='123'
<SubstDocAdd accountNumber='40825810738003000088' essenceId='34e9e965-fb7c-45ae-
be99-6c767f2af41b'
docDate='2017-03-22'
docNum='134446' name='Тест' substDocType='0'>
<BFAttachments>
<BFAttachment linkUUID='21b2f64b-a3c8-4722-9263-ba6e2c4f78fa'>
<FileName>File(96).JPG</FileName>
</BFAttachment>
<BFAttachment linkUUID='76ce7cb9-54f4-4f98-8270-87bab5527f2c'>
<FileName>File(97).JPG</FileName>
<TransferJobGUID>f05c9620-a15e-4d5a-b16c-
d7f1548a26b0</TransferJobGUID>
</BFAttachment>
</BFAttachments>
</SubstDocAdd>
<Sign>
<Issuer>CN=ЛавринСВ-Тестовая печать-УЦ-9</Issuer>
<SN>752FB189A8C1871B689F</SN>
<Value>Gap5FEm56nI6+Dl2jrNrLUxFudy/84LqDnyMaecQxdp2cpEiCp+y2byCd+Ffw1yiSfdVOycI
2+9yNJp0qgpr4A==</Value>
<DigestName>for_upg</DigestName>
<DigestVersion>1</DigestVersion>
</Sign>
</Request>
3.6.4.Дайджест запроса на добавление контракта ГОЗ
Подпись документа на стороне УС:
 Первая подпись и вторая подпись или
 Единственная подпись
Дайджест: формируется
Ключевой буфер (дайджест):
 Для формирования электронной подписи из документа формируется строковая
последовательность (ключевой буфер или дайджест), включающая все значимые данные
документа, поля, содержащие пустые значения, не включаются.
 Ключевой буфер (дайджест) для подписания ЭП образует строковый массив в кодировке
UTF-8, Отдельные записи массива разделены символом перевода строки. В качестве
символа перевода строки используется 0x0A.
 При наличии в мультистроковых данных последовательности из двух символов перевода
строки CR+LF (ASCII 0x0D 0x0A) необходимо удалять символ возврата каретки CR (ASCII
0x0D) и оставлять только символ подачи строки LF (ASCII 0x0A).
 Если наполнение всех таблиц блока TABLES пустое, то и сам TABLES в дайджест не
включается
 Если наполнение какой-то таблицы блока TABLES пустое, то Table=TableName не включать в
дайджест
Формат дайджеста:
Версионно
п/
Наименование поля
Описание
Пример значения
сть
п
1.
ATTRIBUTES
Актуально
<Наименование поля>=<Значение поля>, например
с версии 27
OrgId=963084ba-7079-4b9d-bbab-c4972dee82d9
2.
OrgId
Идентификатор
963084ba-7079-
организации в ДБО (может
4b9d-bbab-
быть использован
c4972dee82d9
Актуально
сторонней системой для
с версии 27
дополнительной
идентификации)
3.
Sender
Отправитель, а также тип
Ромашка
использованного Клиентом
Актуально
программного обеспечения
с версии 27
при отправке документа
4.
EssenceId
Идентификатор документа
3a6378ef-07ee-4535-
Актуально
в СББОЛ.
a10a-0c82817cae23
с версии 27
5.
FIELDS
<Наименование поля>=<Значение поля>, например
Актуально
с версии 27
AccDoc.AccDocNo=444
После последней строки НЕ делать перевод строки
6.
Идентификатор контракта
ContractsAdd.Id_Gc
15161873452220204
Актуально
ГОЗ
04015449
с версии 27
7.
№ контракта
ContractsAdd.ContractNu
12315646546541651
Актуально
m
5
с версии 27
8.
Сумма контракта
ContractsAdd.ContractAm
12345.50
Актуально
ount
с версии 27
9.
Сумма аванса
ContractsAdd.AdvanceSu
250.50
Актуально
mm
с версии 27
10.
Согласованный размер
ContractsAdd.ProfitSumm
100.20
Актуально
прибыли по контракту
с версии 27
11.
ИНН заказчика
ContractsAdd.Customer.C
123456789945
Актуально
ustINN
с версии 27
12.
№ отдельного счета
ContractsAdd.Customer.C
40817810500000000
Актуально
заказчика
ustAcc
035
с версии 27
13.
ИНН исполнителя
ContractsAdd.Executor.Ex
545165456421
Актуально
tINN
с версии 27
14.
КПП исполнителя
ContractsAdd.Executor.Ex
40817810500000000
Актуально
tAcc
040
с версии 27
15.
Разделитель строк таблицы -
# Сортировать сначала по
Актуально
TABLES
типу адреса, потом по
с версии 27
индексу
16.
Ссылки на вложенные
Актуально
Table=BFAttachments
файлы
с версии 27
17.
Имя файла вложения,
необходимо для проверки в
Актуально
Desert.jpg
BFAttachments.FileName
списке разрешенных типов
с версии 27
файлов
Пример дайджеста
ATTRIBUTES
OrgId=5e218ae3-1969-4411-a9cf-b10c9f730e5c
Sender=Оператор услуг
FIELDS
ContractsAdd.Id_Gc=1516187345222020404015449
ContractsAdd.ContractNum=1546
ContractsAdd.ContractAmount=100000
ContractsAdd.AdvanceSumm=4
ContractsAdd.ProfitSumm=3
ContractsAdd.Customer.CustINN=232009849069
ContractsAdd.Customer.CustAcc=40825810538000000087
ContractsAdd.Executor.ExtINN=232009849069
ContractsAdd.Executor.ExtAcc=40825810538000000087
TABLES
Table=BFAttachments
BFAttachments.FileName=File(75).JPEG
Пример дайджеста на досылку
ATTRIBUTES
OrgId=5e218ae3-1969-4411-a9cf-b10c9f730e5c
Sender=Оператор услуг
EssenceId=eb3d524f-8596-445c-ac19-ad7a1ee98f47
FIELDS
ContractsAdd.Id_Gc=1516187345222020404015449
ContractsAdd.ContractNum=1546
ContractsAdd.ContractAmount=100000
ContractsAdd.AdvanceSumm=4
ContractsAdd.ProfitSumm=3
ContractsAdd.Customer.CustINN=232009849069
ContractsAdd.Customer.CustAcc=40825810538000000087
ContractsAdd.Executor.ExtINN=232009849069
ContractsAdd.Executor.ExtAcc=40825810538000000087
TABLES
Table=BFAttachments
BFAttachments.FileName=File(75).JPEG
#
BFAttachments.FileName=File(76).JPEG
#
3.6.5.Формат взаимодействия
Взаимодействие: Документ передается из УС Клиента в СББОЛ
Инициатор получения документа: УС Клиента
Формат, в котором запрашиваются документы со стороны УС: Request/ContractAdd
Формат передачи документа на сторону УС: Response/Ticket
3.6.5.1. Формат отправки запроса на добавление
контракта ГОЗ в СББОЛ
Request/ContractAdd
Описание
Версионно
Элемент
Описание элемента
Тип
Мн.
типа
сть
Request
Request
Актуально
[1]
с версии 27
1
Уникальный идентификатор
UuidSeparat
UUID с
@requestId
запроса
ed
разделител
ями в виде
дефисов.
[1]
Актуально
Набор из
с версии 27
32
символов
[0-9], [a-f]
и дефисов
2
Идентификатор организациив
UUID с
@orgId
UuidSeparat
ДБО (может быть
разделител
ed
использован сторонней
ями в виде
системой для
дефисов.
Актуально
дополнительной
Набор из
[1]
с версии 27
идентификации)
32
символов
[0-9], [a-f]
и дефисов
3
Номер версии формата
Простой
@version
xs:string
Актуально
обмена
тип XML
RegEx: "[0-
[1]
с версии 27
Schema
9\.]{1,20}"
4
Система-отправитель
Простой
@sender
xs:string
тип XML
RegEx: «[-a-
Актуально
Schema
zA-Zа-яА-
[1]
с версии 27
Я0-9:
_]{1,20}»
5
Система-получатель - если
Простой
@receiver
xs:string
система получатель СББОЛ,
тип XML
RegEx: «[-a-
[0..1
Актуально
то SBBOL_DBO
Schema
zA-Zа-яА-
]
с версии 27
Я0-9:
_]{1,20}»
6
Версия протокола
Простой
@protocolVersion
xs:string
[0..1
Актуально
тип XML
]
с версии 27
Schema
7
ContractAdd
Добавление «Контракт ГОЗ»
ContractAd
Актуально
[1]
d
с версии 27
*.1
@essenceId
Идентификатор документа в
UuidSeparat
UUID с
СББОЛ.
ed
разделител
Значение для поля приходит
ями в виде
в ответе на запрос статуса
дефисов.
отправки документа
Набор из
«Контракт ГОЗ» (поле docId)
32
При отсутствии
символов
[0..1
идентификатора - в СББОЛ
[0-9], [a-f]
Актуально
]
будет создана новая запись в
и дефисов
с версии 27
справочнике Иных
документы
SubstantiatingDocuments.
При наличии идентификатора
- в СББОЛ будет произведено
изменение существующей
записи с данным docId.
*.2
@id_GC
Идентификатор контракта
GozContract
ГОЗ
Id
Актуально
s:string [min:
[1]
с версии 27
Представляет собой 25й
1, max: 30]
цифровой код
*.3
@isCustExec
Клиент является: 1 -
BoolType
Актуально
Заказчиком, 2 -
[1]
с версии 27
Исполнителем
*.4
GOZContract
Актуально
[1]
с версии 27
*.1
@contractNu
№ контракта
xs:string
Актуально
m
[min: 1,
[1]
с версии 27
max: 255]
*.2
@createDate
Дата заключения контракта
xs:date
Актуально
[1]
с версии 27
*.3
@sendDate
Дата предоставления
xs:date
Актуально
[1]
контракта
с версии 27
*.4
@changeDate
Дата последнего изменения
xs:date
Актуально
[1]
с версии 27
*.5
@endDate
Дата завершения
xs:date
Актуально
[1]
обязательств по контракту
с версии 27
*.6
@contractSub
Предмет договора,
xs:int
jectType
заполняется кодом из
справочника(ContractSubjectT
Актуально
[1]
ype), должен быть найден на
с версии 27
УПШ по коду контракта
contractSubjectTypeId
*.5
ContractAmount
Актуально
[1]
с версии 27
*.1
ContractSum
Сумма контракта
Актуально
[1]
m
с версии 27
*.1
@summ
Сумма контракта
xs:decimal
Актуально
[1]
с версии 27
*.2
@currIso
Трёхбуквенный код валюты
CurrCodeLet
xs:string
Code
terType
RegEx: [A-
Актуально
[1]
Z]{1}[A-
с версии 27
Z0-9]{2}
*.2
AdvanceSum
Сумма аванса
xs:decimal
Актуально
[1]
m
с версии 27
*.3
ProfitSumm
Согласованный размер
xs:decimal
Актуально
[1]
прибыли по контракту
с версии 27
*.4
ExpSumm
Сумма расходов
xs:decimal
Актуально
[1]
(возмещаемые расходы)
с версии 27
*.6
TermDeliverPay
Условия поставки-оплаты
xs:string
[0..1
Актуально
[max: 512]
]
с версии 27
*.7
AddInfo
Дополнительная информация
xs:string
[0..1
Актуально
[max: 512]
]
с версии 27
*.8
Customer
заказчик
GozCustome
Актуально
[1]
r
с версии 27
*.
@custINN
ИНН заказчика
xs:string
[0..1
Актуально
1
[min: 1,
]
с версии 27
max: 12]
*.
@custKPP
КПП заказчика
xs:string
[0..1
Актуально
2
[max: 9]
]
с версии 27
*.
@custAcc
№ отдельного счета
xs:string
Актуально
[1]
3
заказчика
[max: 20]
с версии 27
*.
@custName
Наименование заказчика
xs:string
Актуально
[1]
4
[max: 255]
с версии 27
*.
@resident
1 - резидент, 0 - нерезидент
BoolType
Актуально
[1]
5
с версии 27
*.9
Executor
исполнитель
GozExecutor
Актуально
[1]
с версии 27
*.
@extINN
ИНН исполнителя
xs:string
[0..1
Актуально
1
[min: 1,
]
с версии 27
max: 12]
*.
@extKPP
КПП исполнителя
xs:string
[0..1
Актуально
2
[min: 1,
]
с версии 27
max: 9]
*.
@extAcc
№ отдельного счета
xs:string
Актуально
[1]
3
исполнителя
[max: 20]
с версии 27
*.
@extName
Наименование исполнителя
xs:string
Актуально
[1]
4
[max: 255]
с версии 27
*.
@resident
1 - резидент, 0 - нерезидент
BoolType
Актуально
[1]
5
с версии 27
*.1
BFAttachments
Список запросов на ссылки в
BFAttachm
Актуально
[1]
0
БФ
ents
с версии 27
*.
BFAttachmen
Файл в системе БФ
[1..n
Актуально
1
t
]
с версии 27
*.1
@linkUU
Уникальный идентификатор
UuidSeparat
ID
запроса, используется
ed
Актуально
клиентским приложением для
[1]
с версии 27
связывания запроса ссылки и
самой ссылки
*.2
FileName
Имя файла вложения,
xs:string
Допустим
необходимо для проверки в
[min: 1,
ые
списке разрешенных типов
max: 255]
расширени
файлов
я файлов,
на момент
Актуально
[1]
написания
с версии 27
документа
ции: pdf,
tiff, jpeg,
png, pcx
*.3
FileSize
Размер пользовательского
xs:int
[min:
[0..1
Актуально
файла
1]
]
с версии 27
*.4
Comment
Пользовательское описание
xs:string
[0..1
Актуально
файла вложения
[min: 1,
]
с версии 27
max: 1024]
*.5
TransferJ
Уникальный идентификатор
UuidSeparat
obGUID
задачи на закачку файла в
ed
БФ.
[0..1
Актуально
Значение для поля приходит
]
с версии 27
в ответе на запрос статуса
отправки иного документа
(поле TransferJobGUID)
Пример
<Request
orgId='5e218ae3-1969-4411-a9cf-b10c9f730e5c'
receiver='SBBOL_DBO'
requestId='76676c74-b25a-4c88-4c67-5cc7722e927f'
sender='Оператор услуг'
version='123'
<ContractAdd
id_GC='1516187345222020404015449'
isCustExec='0'>
<GOZContract
contractNum='1546'
createDate='2017-04-20'
sendDate='2017-04-20'
changeDate='2017-04-20'
endDate='2017-04-20'
contractSubjectType='1'/>
<ContractAmount>
<ContractSumm summ='100000' currIsoCode='RUR'/>
<AdvanceSumm>4</AdvanceSumm>
<ProfitSumm>3</ProfitSumm>
<ExpSumm>34</ExpSumm>
</ContractAmount>
<TermDeliverPay>Тест</TermDeliverPay>
<AddInfo>Тест</AddInfo>
<Customer custINN='232009849069' custKPP='770901001' custAcc='40825810538000000087'
custName='ТЕСТ' resident='1'/>
<Executor extINN='232009849069' extKPP='770901001' extAcc='40825810538000000087'
extName='ТЕСТ2' resident='1'/>
<BFAttachments>
<BFAttachment linkUUID='e8f212c7-60cf-4e16-886b-1d00000b9d11'>
<FileName>File(75).JPEG</FileName>
</BFAttachment>
</BFAttachments>
</ContractAdd>
<Sign>
<Issuer>CN=ЛавринСВ-Тестовая печать-УЦ-9</Issuer>
<SN>752FB189A8C1871B689F</SN>
<Value>H0inxClu6m4O8t61ea66X8JFPHCOR9LNhWZPYc8/iMhQgJTV81BAddlKksDSnKVD5qPPgruC+
pkS5gasYFzh8Q==</Value>
<DigestName>for_upg</DigestName>
<DigestVersion>1</DigestVersion>
</Sign>
</Request>
Пример на досылку
<Request
orgId='5e218ae3-1969-4411-a9cf-b10c9f730e5c'
receiver='SBBOL_DBO'
requestId='c9511ef1-a642-4a11-91d8-5251ff984fa2'
sender='Оператор услуг'
version='01.005.03'
<ContractAdd
id_GC='1516187345222020404015449'
essenceId='eb3d524f-8596-445c-ac19-ad7a1ee98f47'
isCustExec='0'>
<GOZContract
contractNum='1546'
createDate='2017-04-20'
sendDate='2017-04-20'
changeDate='2017-04-20'
endDate='2017-04-20'
contractSubjectType='1'/>
<ContractAmount>
<ContractSumm summ='100000' currIsoCode='RUR'/>
<AdvanceSumm>4</AdvanceSumm>
<ProfitSumm>3</ProfitSumm>
<ExpSumm>34</ExpSumm>
</ContractAmount>
<TermDeliverPay>Тест</TermDeliverPay>
<AddInfo>Тест</AddInfo>
<Customer custINN='232009849069' custKPP='770901001' custAcc='40825810538000000087'
custName='ТЕСТ' resident='1'/>
<Executor extINN='232009849069' extKPP='770901001' extAcc='40825810538000000087'
extName='ТЕСТ2' resident='1'/>
<BFAttachments>
<BFAttachment linkUUID='e2f187c7-60cf-4e66-886b-2d08045b9d11'>
<FileName>File(75).JPEG</FileName>
</BFAttachment>
<BFAttachment linkUUID='e8f187c7-60cf-4e66-886b-2d08045b9d11'>
<FileName>File(76).JPEG</FileName>
<TransferJobGUID>95f652d2-71e1-4a7e-8022-
b6db34440a39</TransferJobGUID>
</BFAttachment>
</BFAttachments>
</ContractAdd>
<Sign>
<Issuer>CN=ЛавринСВ-Тестовая печать-УЦ-9</Issuer>
<SN>752FB189A8C1871B689F</SN>
<Value>MyD9RFpld8s4VRpkR9+zH/725T7+RnFjhdy/DpJhyCkX10YgerLt1NO0q53X5ZQvFPdxlK4qQE4
1cyB+TpWY0A==</Value>
<DigestName>for_upg</DigestName>
<DigestVersion>1</DigestVersion>
</Sign>
</Request>
3.6.6.Дайджест запроса на добавление акта ГОЗ
Подпись документа на стороне УС:
 Первая подпись и вторая подпись или
 Единственная подпись
Дайджест: формируется
Ключевой буфер (дайджест):
 Для формирования электронной подписи из документа формируется строковая
последовательность (ключевой буфер или дайджест), включающая все значимые данные
документа, поля, содержащие пустые значения, не включаются.
 Ключевой буфер (дайджест) для подписания ЭП образует строковый массив в кодировке
UTF-8, Отдельные записи массива разделены символом перевода строки. В качестве
символа перевода строки используется 0x0A.
 При наличии в мультистроковых данных последовательности из двух символов перевода
строки CR+LF (ASCII 0x0D 0x0A) необходимо удалять символ возврата каретки CR (ASCII
0x0D) и оставлять только символ подачи строки LF (ASCII 0x0A).
 Если наполнение всех таблиц блока TABLES пустое, то и сам TABLES в дайджест не
включается
 Если наполнение какой-то таблицы блока TABLES пустое, то Table=TableName не включать в
дайджест
Формат дайджеста:
п
Версионно
Наименование поля
Описание
Пример значения
/
сть
п
1.
ATTRIBUTES
Актуально
<Наименование поля>=<Значение поля>, например
с версии 27
OrgId=963084ba-7079-4b9d-bbab-c4972dee82d9
2.
OrgId
Идентификатор организации в
963084ba-7079-
ДБО (может быть использован
4b9d-bbab-
Актуально
сторонней системой для
c4972dee82d9
с версии 27
дополнительной
идентификации)
3.
Sender
Отправитель, а также тип
Ромашка
использованного Клиентом
Актуально
программного обеспечения
с версии 27
при отправке документа
4.
EssenceId
Идентификатор документа в
3a6378ef-07ee-
Актуально
СББОЛ.
4535-a10a-
с версии 27
0c82817cae23
5.
FIELDS
<Наименование поля>=<Значение поля>, например
Актуально
с версии 27
AccDoc.AccDocNo=444
После последней строки НЕ делать перевод строки
6.
№ акта
ActsAdd.GOZAct.ActNu
2456782482672467
Актуально
m
2
с версии 27
7.
Сумма акта
ActsAdd.ActAmount.Sum
1250.50
Актуально
m
с версии 27
8.
ИНН заказчика
ActsAdd.Customer.CustI
123456789123
Актуально
NN
с версии 27
9.
№ отдельного счета заказчика
ActsAdd.Customer.CustA
4081781050000000
Актуально
cc
0035
с версии 27
10.
ИНН исполнителя
ActsAdd.Executor.ExtIN
845216541564
Актуально
N
с версии 27
11.
№ отдельного счета
ActsAdd.Executor.ExtAcc
4081781050000000
Актуально
исполнителя
0040
с версии 27
12.
Разделитель строк таблицы - #
Актуально
Сортировать сначала по типу
TABLES
с версии 27
адреса, потом по индексу
13.
Актуально
Ссылки на вложенные файлы
Table=BFAttachments
с версии 27
14.
Имя файла вложения,
необходимо для проверки в
Актуально
Desert.jpg
BFAttachments.FileName
списке разрешенных типов
с версии 27
файлов
Пример дайджеста
ATTRIBUTES
OrgId=5e218ae3-1969-4411-a9cf-b10c9f730e5c
Sender=Оператор услуг
FIELDS
ActsAdd.GOZAct.ActNum=84222
ActsAdd.ActAmount.Summ=100
ActsAdd.Customer.CustINN=232009849069
ActsAdd.Customer.CustAcc=40825810738003000088
ActsAdd.Executor.ExtINN=232009849069
ActsAdd.Executor.ExtAcc=40825810738003000088
TABLES
Table=BFAttachments
BFAttachments.FileName=File(77).JPEG
#Пример дайджеста на досылку
ATTRIBUTES
OrgId=5e218ae3-1969-4411-a9cf-b10c9f730e5c
Sender=Оператор услуг
EssenceId=bf351489-659e-481c-ac47-f088ef3819bc
FIELDS
ActsAdd.GOZAct.ActNum=84222
ActsAdd.ActAmount.Summ=100
ActsAdd.Customer.CustINN=232009849069
ActsAdd.Customer.CustAcc=40825810538000000087
ActsAdd.Executor.ExtINN=232009849069
ActsAdd.Executor.ExtAcc=40825810538000000087
TABLES
Table=BFAttachments
BFAttachments.FileName=File(77).JPEG
#
BFAttachments.FileName=File(78).JPEG
#
3.6.7.Формат взаимодействия
Взаимодействие: Документ передается из УС Клиента в СББОЛ
Инициатор получения документа: УС Клиента
Формат, в котором запрашиваются документы со стороны УС: Request/ActAdd
Формат передачи документа на сторону УС: Response/Ticket
3.6.7.1. Формат отправки запроса на добавление
акта ГОЗ в СББОЛ
Request/ActAdd
Описание
Версионн
Элемент
Описание элемента
Тип
Мн.
типа
ость
Request
Request
Актуальн
[1]
о с версии
27
1
@orgId
Идентификатор
UuidSepara
UUID с
организации в ДБО
ted
разделителями
(может быть использован
в виде
Актуальн
сторонней системой для
дефисов.
[1]
о с версии
дополнительной
Набор из 32
27
идентификации)
символов [0-
9], [a-f] и
дефисов
2
@requestId
Уникальный
UuidSepara
UUID с
идентификатор запроса
ted
разделителями
в виде
Актуальн
дефисов.
[1]
о с версии
Набор из 32
27
символов [0-
9], [a-f] и
дефисов
3
@version
Номер версии формата
xs:string
Простой тип
Актуальн
обмена
RegEx: "[0-
XML Schema
[1]
о с версии
9\.]{1,20}"
27
4
@sender
Система-отправитель
xs:string
Простой тип
RegEx: «[-
XML Schema
Актуальн
a-zA-Zа-
[1]
о с версии
яА-Я0-9:
27
_]{1,20}»
5
@receiver
Система-получатель -
xs:string
Простой тип
Если система получатель
RegEx: «[-
XML Schema
Актуальн
[0..1
СББОЛ, то SBBOL_DBO
a-zA-Zа-
о с версии
]
яА-Я0-9:
27
_]{1,20}»
6
@protocolVersion
Версия протокола
xs:string
Простой тип
[0..1
Актуальн
XML Schema
]
о с версии
27
7
ActAdd
Добавление акта
Актуальн
[1]
о с версии
27
*.1
@essenceId
Идентификатор
UuidSepara
UUID с
документа в СББОЛ.
ted
разделителями
Значение для поля
в виде
приходит в ответе на
дефисов.
запрос статуса отправки
Набор из 32
документа «Акт ГОЗ»
символов [0-
(поле docId)
9], [a-f] и
При отсутствии
дефисов
[0..1
Актуальн
идентификатора - в
]
о с версии
СББОЛ будет создана
27
новая запись в
справочнике GozAct. При
наличии идентификатора
- в СББОЛ будет
произведено изменение
существующей записи с
данным docId.
*.2
GOZAct
Актуальн
[1]
о с версии
27
*.1
@actNum
№ акта
xs:string
Актуальн
[min: 1,
[1]
о с версии
max: 30]
27
*.2
@actDate
Дата акта
xs:date
Актуальн
[1]
о с версии
27
*.3
@actType
Тип акта, заполняется
SubstDocT
xs:string [min:
кодом из справочника
ype
1, max: 3]
Актуальн
Типов предметов
[1]
о с версии
договоров
27
UpgRplDictionary/ConTyp
eEntry/@code
*.4
@sendDate
Дата предоставления акта
xs:date
Актуальн
[1]
о с версии
27
*.5
@actContent
Содержание акта
xs:string
Актуальн
[0..1
[min: 1,
о с версии
]
max: 512]
27
*.6
@contractEsse
Глобальный
UuidSepara
RegEx: [a-fA-
nceId
идентификатор записи
ted
F0-9]{8}-[a-
справочника (Значение
fA-F0-9]{4}-
Актуальн
приходит в ответе на
[a-fA-F0-
[1]
о с версии
запрос статуса отправки
9]{4}-[a-fA-
27
документа «Контракт
F0-9]{4}-[a-
ГОЗ» (поле docId)
fA-F0-9]{12}
*.7
ActSumm
Сумма акта
Актуальн
[1]
о с версии
27
*.
@summ
Сумма акта
xs:decimal
Актуальн
1
[1]
о с версии
27
*.
@currIsoCo
Трёхбуквенный код
CurrCodeL
xs:string
2
de
валюты
etterType
[length: 3]
Актуальн
RegEx: [A-
[1]
о с версии
Z]{1}[A-Z0-
27
9]{2}
*.3
Customer
заказчик
GozCustom
Актуальн
er
[1]
о с версии
27
*.1
@custINN
ИНН заказчика
xs:string
Актуальн
[0..1
[min: 1,
о с версии
]
max: 12]
27
*.2
@custKPP
КПП заказчика
xs:string
Актуальн
[0..1
[max: 9]
о с версии
]
27
*.3
@custAcc
№ отдельного счета
xs:string
Актуальн
заказчика
[max: 20]
[1]
о с версии
27
*.4
@custName
Наименование заказчика
xs:string
Актуальн
[max: 255]
[1]
о с версии
27
*.5
@resident
1 - резидент, 0 -
BoolType
Актуальн
нерезидент
[1]
о с версии
27
*.4
Executor
исполнитель
GozExecut
Актуальн
or
[1]
о с версии
27
*.1
@extINN
ИНН исполнителя
xs:string
Актуальн
[0..1
[min: 1,
о с версии
]
max: 12]
27
*.2
@extKPP
КПП исполнителя
xs:string
Актуальн
[0..1
[min: 1,
о с версии
]
max: 9]
27
*.3
@extAcc
№ отдельного счета
xs:string
Актуальн
исполнителя
[max: 20]
[1]
о с версии
27
*.4
@extName
Наименование
xs:string
Актуальн
исполнителя
[max: 255]
[1]
о с версии
27
*.5
@resident
1 - резидент, 0 -
BoolType
Актуальн
нерезидент
[1]
о с версии
27
*.5
BFAttachments
Список запросов на
BFAttach
Актуальн
ссылки в БФ
ments
[1]
о с версии
27
*.
BFAttachment
Файл в системе БФ
Актуальн
[1..n
1
о с версии
]
27
*.1
@linkUUI
Уникальный
UuidSepara
D
идентификатор запроса,
ted
Актуальн
используется клиентским
[1]
о с версии
приложением для
27
связывания запроса
ссылки и самой ссылки
*.2
FileName
Имя файла вложения,
xs:string
Допустимые
необходимо для проверки
[min: 1,
расширения
в списке разрешенных
max: 255]
файлов, на
Актуальн
типов файлов
момент
[1]
о с версии
написания
27
документации:
pdf, tiff, jpeg,
png, pcx
*.3
FileSize
Размер пользовательского
xs:int
Актуальн
[0..1
файла
[min: 1]
о с версии
]
27
*.4
Comment
Пользовательское
xs:string
Актуальн
[0..1
описание файла вложения
[min: 1,
о с версии
]
max: 1024]
27
*.5
TransferJo
Уникальный
UuidSepara
bGUID
идентификатор задачи на
ted
закачку файла в БФ.
Актуальн
Значение для поля
[0..1
о с версии
приходит в ответе на
]
27
запрос статуса отправки
документа «АКТ ГОЗ»
(поле TransferJobGUID)
Пример
<Request
orgId='5e218ae3-1969-4411-a9cf-b10c9f730e5c'
receiver='SBBOL_DBO'
requestId='73332c89-b25a-1c58-8c57-1cc1124e927f'
sender='Оператор услуг'
version='123'
<ActAdd >
<GOZAct actNum='84222' actDate='2017-05-15' actType='5' sendDate='2017-05-15' actContent='Тест тестовый
тест' contractEssenceId='eb3d524f-8596-445c-ac19-ad7a1ee98f47'>
<ActSumm summ='100' currIsoCode='RUR'/>
</GOZAct>
<Customer custINN='232009849069' custAcc='40825810538000000087' custName='Индивидуальный
предприниматель Григорьева Ирина Васильевна' resident='1'/>
<Executor extINN='232009849069' extAcc='40825810538000000087' extName='Индивидуальный
предприниматель Григорьева Ирина Васильевна' resident='1'/>
<BFAttachments>
<BFAttachment linkUUID='89f97627-bdc7-453e-11b9-bbf17b5749d6'>
<FileName>File(77).JPEG</FileName>
</BFAttachment>
</BFAttachments>
</ActAdd>
<Sign>
<Issuer>CN=ЛавринСВ-Тестовая печать-УЦ-9</Issuer>
<SN>752FB189A8C1871B689F</SN>
<Value>NwS8VQ5ggvk7/XDOl8IEqoqHsxtAIRPVARZy48WvWcUh9Y4BJ23oVfB4rzyNM3wVjf5HEMDcRSRLqbg
HZLtRDQ==</Value>
<DigestName>for_upg</DigestName>
<DigestVersion>1</DigestVersion>
</Sign>
</Request>
Пример на досылку
<Request
orgId='5e218ae3-1969-4411-a9cf-b10c9f730e5c'
receiver='SBBOL_DBO'
requestId='55221c79-b25a-4c28-8c27-1cc9724e927f'
sender='Оператор услуг'
version='01.005.03'
<ActAdd essenceId='bf351489-659e-481c-ac47-f088ef3819bc'>
<GOZAct actNum='84222' actDate='2017-04-20' actType='5' sendDate='2017-04-20' actContent='Тест тестовый
тест' contractEssenceId='eb3d524f-8596-445c-ac19-ad7a1ee98f47'>
<ActSumm summ='100' currIsoCode='RUR'/>
</GOZAct>
<Customer custINN='232009849069' custAcc='40825810538000000087' custName='Индивидуальный
предприниматель Григорьева Ирина Васильевна' resident='1'/>
<Executor extINN='232009849069' extAcc='40825810538000000087' extName='Индивидуальный
предприниматель Григорьева Ирина Васильевна' resident='1'/>
<BFAttachments>
<BFAttachment linkUUID='81f97627-bdc7-453e-91b9-bbf77b2749d6'>
<FileName>File(77).JPEG</FileName>
</BFAttachment>
<BFAttachment linkUUID='89f97627-bdc7-453e-91b9-bbf77b5749d6'>
<FileName>File(78).JPEG</FileName>
<TransferJobGUID>9a802b6a-4697-4c3a-ae39-070885a7737f</TransferJobGUID>
</BFAttachment>
</BFAttachments>
</ActAdd>
<Sign>
<Issuer>CN=ЛавринСВ-Тестовая печать-УЦ-9</Issuer>
<SN>752FB189A8C1871B689F</SN>
<Value>WCV3Edz6wXqa7Ef21kwmPfKPp1BS6YNKLVbRJUwLlEgpI9YQDYNEb/wVkGTbA+1dgGDQvzXzR+btj
p0O+YFujA==</Value>
<DigestName>for_upg</DigestName>
<DigestVersion>1</DigestVersion>
</Sign>
</Request>
3.6.8.Дайджест документа «Запрос ссылки на загрузку
файла»
Подпись документа на стороне УС:
 Первая подпись и вторая подпись или
 Единственная подпись
Дайджест: формируется
Ключевой буфер (дайджест):
 Для формирования электронной подписи из документа формируется строковая
последовательность (ключевой буфер или дайджест), включающая все значимые данные
документа, поля, содержащие пустые значения, не включаются.
 Ключевой буфер (дайджест) для подписания ЭП образует строковый массив в кодировке
UTF-8, Отдельные записи массива разделены символом перевода строки. В качестве
символа перевода строки используется 0x0A.
 При наличии в мультистроковых данных последовательности из двух символов перевода
строки CR+LF (ASCII 0x0D 0x0A) необходимо удалять символ возврата каретки CR (ASCII
0x0D) и оставлять только символ подачи строки LF (ASCII 0x0A).
 Если наполнение всех таблиц блока TABLES пустое, то и сам TABLES в дайджест не
включается
 Если наполнение какой-то таблицы блока TABLES пустое, то Table=TableName не включать в
дайджест
Формат дайджеста:
Версионно
п/
Наименование поля
Описание
Пример значения
сть
п
1.
ATTRIBUTES
Актуально
<Наименование поля>=<Значение поля>, например
с версии 27
OrgId=963084ba-7079-4b9d-bbab-c4972dee82d9
2.
OrgId
Идентификатор
963084ba-7079-4b9d-
организации в ДБО (может
bbab-c4972dee82d9
быть использован
Актуально
сторонней системой для
с версии 27
дополнительной
идентификации)
3.
Sender
Отправитель, а также тип
Ромашка
использованного Клиентом
Актуально
программного обеспечения
с версии 27
при отправке документа
4.
RequestId
Уникальный
3a6378ef-07ee-4535-
Актуально
идентификатор запроса
a10a-0c82817cae23
с версии 27
5.
Разделитель строк таблицы
- # Сортировать сначала по
Актуально
TABLES
типу адреса, потом по
с версии 27
индексу
6.
Table=BigFilesUploadLink
Актуально
Перечень сущностей
s
с версии 27
7.
BigFilesUploadLink.Essenc
Внешний идентификатор
3a6378ef-07ee-4535-
Актуально
сущности
eId
a10a-0c82817cae23
с версии 27
8.
Уникальный
BigFilesUploadLink.LinkU
3a6378ef-555-4535-
Актуально
идентификатор задачи на
UID
a10a-0c8kdkcae23
с версии 27
закачку файла в БФ
9.
BigFilesUploadLink.FileNa
Актуально
Имя файла вложения
File.doc
me
с версии 27
Пример дайджеста.
ATTRIBUTES
OrgId=5e218ae3-1969-4411-a9cf-b10c9f730e5c
Sender=Оператор услуг
RequestId=b49f46ef-115f-4749-b7f4-cd199aba3a51
TABLES
Table=BigFilesUploadLinks
BigFilesUploadLink.EssenceId=0842f8a6-02b4-4871-a691-4b78f1d57133
BigFilesUploadLink.LinkUUID=0bdb49d0-0b08-45c5-bca8-32b7a5b1804d
BigFilesUploadLink.FileName=File(97).jpg
#
3.6.9.Формат взаимодействия при запросе ссылки на
загрузку файла
Взаимодействие: Документ передается из УС Клиента в СББОЛ
Инициатор получения документа: УС Клиента
Формат, в котором запрашиваются документы со стороны УС:
Request/BigFilesUploadLinksRequest
Формат передачи документа на сторону УС: Response/LinksToBigFiles
3.6.9.1. Формат отправки документа
«Запрос
ссылки на загрузку файла» в СББОЛ
Request/BigFilesUploadLinksRequest
Описание
Версионн
Элемент
Описание элемента
Тип
Мн.
типа
ость
Актуальн
Request
Request
[1]
о с версии
27
1
Уникальный
UUIDс
идентификатор запроса
разделител
ями в виде
дефисов.
[1]
Актуальн
UuidSeparat
Набор из
@requestId
о с версии
ed
32
27
символов
[0-9], [a-f]
или [A-F]
и дефисов
2
Идентификатор
UUIDсразд
организациив ДБО (может
елителями
быть использован
ввидедефи
сторонней системой для
сов.
Актуальн
дополнительной
UuidSeparat
Набориз
@orgId
[1]
о с версии
идентификации)
ed
32
27
символов
[0-9], [a-f]
или [A-F]
идефисов
3
Номер версии формата
xs:string
Простой
Актуальн
@version
обмена
RegEx: "[0-
тип XML
[1]
о с версии
9\.]{1,20}"
Schema
27
4
Система-отправитель
xs:string
RegEx: «[-a-
Простой
Актуальн
@sender
zA-Zа-яА-
тип XML
[1]
о с версии
Я0-9:
Schema
27
_]{1,20}»
5
Система-получатель - если
xs:string
система получатель
RegEx: «[-a-
Простой
Актуальн
@receiver
СББОЛ, то SBBOL_DBO
zA-Zа-яА-
тип XML
[0..1]
о с версии
Я0-9:
Schema
27
_]{1,20}»
6
@protocolVersion
Версия протокола
xs:string
Простой
Актуальн
тип XML
[0..1]
о с версии
Schema
27
7
Запрос ссылок на загрузку
BigFilesUpl
Актуальн
BigFilesUploadLinksRequ
в систему БФ
oadLinksRe
[1]
о с версии
est
quest
27
*.1
BigFilesUpl
Актуальн
BigFilesUploadLinksR
oadLinksRe
[1..n]
о с версии
equest
quest
27
*.1
Внешний идентификатор
сущности
Значение для поля
приходит в ответе на
запрос статуса отправки
Актуальн
UuidSeparat
@essenceId
иного документа с типом
[0..1]
о с версии
ed
«АКТ ГОЗ» ,«ИНОЙ» или
27
«Контракт ГОЗ». Тип
зависит от значения
@essenceType
(поле
docId)
*.2
Тип сущности:
xs:string
SUBST_DOC -
Enum:"SUB
Актуальн
подтверждающий
ST_DOC";
@essenceType
[0..1]
о с версии
документ, ACT - акт,
"ACT";
27
CONTRACT - контракт
"CONTRAC
T"
*.3
Актуальн
BFAttachments
[1]
о с версии
27
*.1
Актуальн
BFAttachment
[1..n]
о с версии
27
*.1
Уникальный
идентификатор запроса,
Актуальн
@linkUUI
используется клиентским
UuidSeparat
[1]
о с версии
D
приложением для
ed
27
связывания запроса ссылки
и самой ссылки
*.2
Имя файла вложения,
Допустим
необходимо для проверки в
ые
списке разрешенных типов
расширени
файлов
я файлов,
xs:string
Актуальн
на момент
FileName
[min: 1,
[1]
о с версии
написания
max: 255]
27
документа
ции: pdf,
tiff, jpeg,
png, pcx
*.3
Размер пользовательского
Актуальн
xs:int [min:
FileSize
файла
[0..1]
о с версии
1]
27
*.4
Пользовательское
xs:string
Актуальн
Comment
описание файла вложения
[min: 1,
[0..1]
о с версии
max: 1024]
27
Пример.
<Request
orgId='5e218ae3-1969-4411-a9cf-b10c9f730e5c'
receiver='SBBOL_DBO'
requestId='b49f46ef-115f-4749-b7f4-cd199aba3a51'
sender='Оператор услуг'
version='123'
<BigFilesUploadLinksRequest>
<BigFilesUploadLinkRequest essenceId='0842f8a6-02b4-4871-a691-
4b78f1d57133' essenceType='SUBST_DOC'>
<BFAttachments>
<BFAttachment linkUUID='0bdb49d0-0b08-45c5-bca8-
32b7a5b1804d'>
<FileName>File(97).jpg</FileName>
<FileSize>245</FileSize>
</BFAttachment>
</BFAttachments>
</BigFilesUploadLinkRequest>
</BigFilesUploadLinksRequest>
<Sign>
<Issuer>CN=ЛавринСВ-Тестовая печать-УЦ-9</Issuer>
<SN>752FB189A8C1871B689F</SN>
<Value>Ai6zvf+6PjqMPhP/ZTQJvUUYV1eew1epFAdHIYfvf+NNXaMXB3a8h6NqTU
5PO89Xt24wPrxV7SzeE+DGFafwJQ==</Value>
<DigestName>for_upg</DigestName>
<DigestVersion>1</DigestVersion>
</Sign>
</Request>
3.6.9.2. Формат получения ссылки из СББОЛ
Response/LinksToBigFiles
Описание
Мн
Версионн
Элемент
Описание элемента
Тип
типа
ость
Response
Response
Актуальн
[1]
о с версии
27
1
@createTime
Дата и время
xs:dateTime
Простой тип
формирования ответа
XML
Актуальн
местному по времени
Schema
[0..1]
о с версии
запрашивающего сервера, с
27
указанием его часового
пояса
2
@responseId
Уникальный
UuidSeparat
UUID с
идентификатор ответа
ed
разделителя
ми в виде
Актуальн
дефисов.
[0..1]
о с версии
Набор из 32
27
символов [0-
9], [a-f] и
дефисов
3
@requestId
Идентификатор запроса, в
UuidSeparat
UUID с
результате которого был
ed
разделителя
сформирован данный ответ
ми в виде
Актуальн
дефисов.
[0..1]
о с версии
Набор из 32
27
символов [0-
9], [a-f] и
дефисов
4
@version
Номер версии формата
xs:string
Простой тип
Актуальн
обмена
RegEx: "[0-
XML
[0..1]
о с версии
9\.]{1,20}"
Schema
27
5
@sender
Система-отправитель
xs:string
Простой тип
RegEx: «[-a-
XML
Актуальн
zA-Zа-яА-
Schema
[0..1]
о с версии
Я0-9:
27
_]{1,20}»
6
@receiver
Система-получатель Если
xs:string
Простой тип
система получатель
RegEx: «[-a-
XML
Актуальн
СББОЛ, то SBBOL_DBO
zA-Zа-яА-
Schema
[0..1]
о с версии
Я0-9:
27
_]{1,20}»
7
LinksToBigFiles
Передача ссылки АС «БФ»
linksToBigFi
Актуальн
в УС
les
[0..1]
о с версии
27
*.1
Essence
Сущности
Актуальн
[0..n]
о с версии
27
*.1
@docId
Идентификатор сущности в
UuidSepkara
Актуальн
СББОЛ.
ted
[1]
о с версии
27
*.2
@essenceType
Тип сущности:
xs:string
SUBST_DOC -
Enum:"SUB
Актуальн
подтверждающий
ST_DOC";
[0..1]
о с версии
документ, ACT - акт,
"ACT";
27
CONTRACT - контракт
"CONTRAC
T"
*.3
Link
Ссылка на закачку в
LinkToBigFi
Актуальн
систему БФ
le
[0..n]
о с версии
27
*.1
@linkUUID
Уникальный
UuidSeparat
идентификатор запроса,
ed
Актуальн
используется клиентским
[1]
о с версии
приложением для
27
связывания запроса ссылки
и самой ссылки
*.2
WebUploadLin
Ссылка на ресурс «БФ» для
xs:string
Актуальн
k
закачивания файла
[0..1]
о с версии
27
*.3
TransferJobGU
Уникальный
UuidSeparat
Актуальн
ID
идентификатор задачи на
ed
[0..1]
о с версии
закачку файла в БФ.
27
*.4
Errors
Ошибки вложенных
Актуальн
файлов
[0..1]
о с версии
27
*.
Error
BFError
Актуальн
1
[0..n]
о с версии
27
*.
@errorMe Детали ошибки
xs:string
Актуальн
1
ssage
[0..1]
о с версии
27
Пример.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Response sender="DBO" version="7" requestId="b49f46ef-115f-4749-b7f4-cd199aba3a51"
responseId="ca8486de-61b0-4350-be61-40adf9a4c093" createTime="2017-05-
16T13:51:15.890+03:00" xmlns="http://bssys.com/upg/response">
<LinksToBigFiles>
<Essence essenceType="SUBST_DOC" docId="0842f8a6-02b4-4871-a691-
4b78f1d57133">
<Link linkUUID="0bdb49d0-0b08-45c5-bca8-32b7a5b1804d">
<WebUploadLink>http://10.43.14.2:9080/sbns-app /upload/1199f755-
f200-45b2-bcce-79758a5838c8</WebUploadLink>
<TransferJobGUID>1199f755-f200-45b2-bcce-
79758a5838c8</TransferJobGUID>
</Link>
</Essence>
</LinksToBigFiles>
</Response>
3.6.10. Дайджест документа «Запрос статуса загрузки
файла»
Подпись документа на стороне УС:
 Первая подпись и вторая подпись или
 Единственная подпись
Дайджест: формируется
Ключевой буфер (дайджест):
 Для формирования электронной подписи из документа формируется строковая
последовательность (ключевой буфер или дайджест), включающая все значимые данные
документа, поля, содержащие пустые значения, не включаются.
 Ключевой буфер (дайджест) для подписания ЭП образует строковый массив в кодировке
UTF-8, Отдельные записи массива разделены символом перевода строки. В качестве
символа перевода строки используется 0x0A.
 При наличии в мультистроковых данных последовательности из двух символов перевода
строки CR+LF (ASCII 0x0D 0x0A) необходимо удалять символ возврата каретки CR (ASCII
0x0D) и оставлять только символ подачи строки LF (ASCII 0x0A).
 Если наполнение всех таблиц блока TABLES пустое, то и сам TABLES в дайджест не
включается
 Если наполнение какой-то таблицы блока TABLES пустое, то Table=TableName не включать в
дайджест
Формат дайджеста:
Версионн
Наименование поля
Описание
Пример значения
п/п
ость
1.
ATTRIBUTES
Актуально
с версии
27
2.
OrgId
Идентификатор
fb8360e9-69ae-40d4-b5e2-
Актуально
организации в
b7e60f2a3fd7
с версии
ДБО
27
3.
Sender
Отправитель
Ромашка
Актуально
с версии
27
4.
RequestId
Идентификатор
fb8360e9-69ae-40d4-b5e2-
Актуально
запроса
b7e60f2a3fd7
с версии
27
5.
TABLES
Сначала указываются все UploadJobId в порядке следования в запросе, потом все
DownloadJobId в порядке следования в запросе.
Разделитель строк таблицы — #, например:
TABLES
Актуально
Table=BigFilesStatus
с версии
BigFilesStatus.TransferJobId=fb8360e9-69ae-40d4-b5e2-b7e60f2a3fd7
27
#
BigFilesStatus.TransferJobId=fb8360e9-69ae-40d4-b5e2-b7e60f2a3fd
#
BigFilesStatus.TransferJobId=fb8360e9-69ae-40d4-b5e2-b7e60f2a3fd7
#
5.
Table=BigFilesStatus
Актуально
с версии
27
6.
BigFilesStatus.TransferJobId
fb8360e9-69ae-40d4-b5e2-
Актуально
b7e60f2a3fd7
с версии
27
7.
BigFilesStatus.TransferJobId
fb8360e9-69ae-40d4-b5e2-
Актуально
b7e60f2a3fd7
с версии
27
8.
BigFilesStatus.TransferJobId
Актуально
с версии
27
Актуально
«
с версии
27
N.
BigFilesStatus.TransferJobId
Актуально
с версии
27
Пример дайджеста.
ATTRIBUTES
OrgId=5e218ae3-1969-4411-a9cf-b10c9f730e5c
Sender=Оператор услуг
RequestId=5112c27b-e263-32b1-b35c-31283d8e678c
TABLES
Table=BigFilesStatus
BigFilesStatus.TransferJobId=4ecc638e-1576-4fef-8dcf-753af5c4a199
#
3.6.11. Формат взаимодействия при запросе статуса
загрузки файлов
Взаимодействие: Документ передается из УС Клиента в СББОЛ
Инициатор получения документа: УС Клиента
Формат, в котором запрашиваются документы со стороны УС:
Request/BigFilesStatusRequest
Формат передачи документа на сторону УС: Response/BigFilesStatus
3.6.11.1. Формат отправки документа
«Запрос
статуса загрузки файла» в СББОЛ
Request/BigFilesStatusRequest
Описание
Версионн
Элемент
Описание элемента
Тип
Мн.
типа
ость
Request
Request
Актуальн
[1]
о с версии
27
1
@requestId
Уникальный
UuidSeparated
UUIDс
идентификатор запроса
разделителя
ми в виде
дефисов.
Актуальн
Набор из 32
[1]
о с версии
символов [0-
27
9], [a-f] или
[A-F] и
дефисов
2
@orgId
Идентификатор
UuidSeparated
UUIDсразде
организациив ДБО (может
лителямивв
быть использован
идедефисов.
Актуальн
сторонней системой для
Набориз 32
[1]
о с версии
дополнительной
символов [0-
27
идентификации)
9], [a-f] или
[A-F]
идефисов
3
@version
Номер версии формата
xs:string
Простой тип
Актуальн
обмена
RegEx: "[0-
XML
[1]
о с версии
9\.]{1,20}"
Schema
27
4
@sender
Система-отправитель
xs:string
Простой тип
Актуальн
RegEx: «[-a-
XML
[1]
о с версии
zA-Zа-яА-Я0-
Schema
27
9: _]{1,20}»
5
@receiver
Система-получатель - если
xs:string
Простой тип
Актуальн
система получатель
RegEx: «[-a-
XML
[0..1]
о с версии
СББОЛ, то SBBOL_DBO
zA-Zа-яА-Я0-
Schema
27
9: _]{1,20}»
6
@protocolVersion
Версия протокола
xs:string
Простой тип
Актуальн
XML
[0..1]
о с версии
Schema
27
7
BigFilesStatusRequest
Запрос статуса
BigFilesStatus
Запрос
загруженных файлов
Request
статусов
Актуальн
При загрузке указывается
сущностей
[1]
о с версии
UploadJobId, при
«Гос.
27
скачивании DownloadJobId
контракт»
*.1
UploadJobId
Уникальный
UuidSeparated
Изменено
[0..1]
идентификатор задачи на
в версии
[0..n]
закачку файла в БФ
32.001
*.2
DownloadJobId
Уникальный
UuidSeparated
Изменено
[0..1]
идентификатор задачи на
в версии
[0..n]
скачивание файла из БФ
32.001
Пример.
<Request
orgId='5e218ae3-1969-4411-a9cf-b10c9f730e5c'
requestId='5112c27b-e263-32b1-b35c-31283d8e678c'
sender='Оператор услуг'
version='123'
receiver='SBBOL_DBO'
<BigFilesStatusRequest>
<UploadJobId>4ecc638e-1576-4fef-8dcf-753af5c4a199</UploadJobId>
</BigFilesStatusRequest>
<Sign>
<Issuer>CN=ЛавринСВ-Тестовая печать-УЦ-9</Issuer>
<SN>752FB189A8C1871B689F</SN>
<Value>NPN2PiVTuU9UGF+yH/ugV5tMKYHEssvWgb4rYc4Npxpn+snR6VHiyMdos
oV5kM2qhmaIHU+M5QoD5tkOTVRp5g==</Value>
<DigestName>for_upg</DigestName>
<DigestVersion>1</DigestVersion>
</Sign>
</Request>
3.6.11.2. Формат получения статуса загрузки
файла из СББОЛ
Response/BigFilesStatus
Описание
Версионно
Элемент
Описание элемента
Тип
Мн.
типа
сть
Response
Response
Актуально
[1]
с версии 27
1
@createTime
Дата и время
xs:dateTime
Простой
формирования ответа
тип XML
местному по времени
Schema
[0..1
Актуально
запрашивающего сервера,
]
с версии 27
с указанием его часового
пояса
2
@responseId
Уникальный
UuidSeparat
UUID с
идентификатор ответа
ed
разделител
ями в виде
дефисов.
[0..1
Актуально
Набор из
]
с версии 27
32
символов
[0-9], [a-f]
и дефисов
3
@requestId
Идентификатор запроса, в
UuidSeparat
UUID с
результате которого был
ed
разделител
сформирован данный
ями в виде
ответ
дефисов.
[0..1
Актуально
Набор из
]
с версии 27
32
символов
[0-9], [a-f]
и дефисов
4
@version
Номер версии формата
xs:string
Простой
[0..1
Актуально
обмена
RegEx: "[0-
тип XML
]
с версии 27
9\.]{1,20}"
Schema
5
@sender
Система-отправитель
xs:string
Простой
RegEx: «[-a-
тип XML
[0..1
Актуально
zA-Zа-яА-
Schema
]
с версии 27
Я0-9:
_]{1,20}»
6
@receiver
Система-получатель Если
xs:string
Простой
система получатель
RegEx: «[-a-
тип XML
[0..1
Актуально
СББОЛ, то SBBOL_DBO
zA-Zа-яА-
Schema
]
с версии 27
Я0-9:
_]{1,20}»
7
BigFilesStatus
Запрос статусов
BigFilesStat
[0..1
Актуально
сущностей «Гос.
usResponse
]
с версии 27
контракт»
*.1
BigFilesStatus
BigFilesStat
[0..n
Актуально
us
]
с версии 27
*.1
UploadJobId
Уникальный
UuidSeparat
[0..1
Актуально
идентификатор задачи на
ed
]
с версии 27
закачку файла в БФ
*.2
DownloadJobId
Уникальный
UuidSeparat
[0..1
Актуально
идентификатор задачи на
ed
]
с версии 27
скачивание файла из БФ
*.3
FileNetId
Уникальный
xs:string
идентификатор
[0..1
Актуально
сохраненного документа
]
с версии 27
в FileNet
*.4
Status
Статус файла,
xs:string
[0..1
Актуально
загружаемого в
]
с версии 27
БФ/скачиваемого из БФ
*.5
Errors
Описание Ошибки
[0..1
Актуально
вложенных файлов
]
с версии 27
Error
BFError
[0..n
Актуально
]
с версии 27
1
@errorMess
Детали ошибки
xs:string
[0..1
Актуально
age
]
с версии 27
1
Пример.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Response sender="DBO" version="7" requestId="5112c27b-e263-32b1-b35c-31283d8e678c"
responseId="79f0c8ba-339b-4800-8bf2-513bb032b15d" createTime="2017-05-
15T13:40:04.724+03:00" xmlns="http://bssys.com/upg/response">
<BigFilesStatus>
<BigFilesStatus>
<UploadJobId>4ecc638e-1576-4fef-8dcf-753af5c4a199</UploadJobId>
<FileNetId>{ABCC3613-CB6D-4841-A47D-
D0C6392A8981}/{66C0ADC4-3BF2-4B17-A777-0C157DAB13CE}</FileNetId>
<Status>FINISHED</Status>
</BigFilesStatus>
</BigFilesStatus>
</Response>
3.6.12. Особенности
получения
статусов
загруженных файлов
Статусы загрузки файлов:
Системное название статуса
Версионност
Комментарий
п/п
в СББОЛ
ь
ЗАГРУЗКА ФАЙЛА В БФ (BigFilesDownloadJob) (BigFilesUploadJob)
Изменено в
версии
32.001
1
STARTED_DMZ_TO_ALPHA
Начата загрузка файла из хранилища больших
Актуально с
файлов в DMZ в хранилище больших файлов в
версии 27
зоне ALPHA
2
STARTED_ALPHA_TO_FILE
Начата загрузка файла из хранилища больших
Актуально с
NET
файлов в зоне ALPHA в FileNet
версии 27
3
FINISHED
Закончена загрузка больших файлов в конечную
Изменено в
точку в FileNet
версии
32.001
Статус окончательный успешный
4
FINISHED_DMZ_TO_ALPH
Закончена загрузка больших файлов в
A
хранилище больших файлов в зоне ALPHA
Изменено в
версии
Статус окончательный успешный
32.001
(промежуточный для некоторых типов
документов)
5
ERROR_DMZ_TO_ALPHA
Ошибка при загрузке файла из хранилища
больших файлов в DMZ в хранилище больших
Изменено в
файлов в зоне ALPHA
версии
32.001
Статус окончательный неуспешный
6
ANTIVIRUS_ERROR
Файл заражен вирусом
Изменено в
версии
Статус окончательный неуспешный
32.001
7
FILE_TYPE_ERROR
Ошибка типа файла
Изменено в
версии
Статус окончательный неуспешный
32.001
8
FILE_EXTENSION_ERROR
Ошибка расширения файла
Изменено в
версии
Статус окончательный неуспешный
32.001
9
ERROR_ALPHA_TO_FILEN
Ошибка при загрузке файла из хранилища
ET
больших файлов в зоне ALPHA в хранилище
Изменено в
FileNet
версии
32.001
Статус окончательный неуспешный
10
TECHNICAL_ERROR
Техническая ошибка
Изменено в
версии
Статус окончательный неуспешный
32.001
11
MAX_SIZE_ERROR
Превышен размер файла
Изменено в
версии
Статус окончательный неуспешный
32.001
12
CLIENT_SMS_SIGN_REQUE
Клиент запросил смс код для подписи файла
Добавлено в
STED
версии
32.001
13
CLIENT_SIGN_INPROGRES
Идет процесс подписи или проверки подписи
Добавлено в
S
вложения
версии
32.001
14
CLIENT_PARTSIGN_VALID
Вложение успешно подписано одной подписью,
Добавлено в
подпись проверена, ожидается вторая подпись
версии
32.001
15
CLIENT_SIGN_VALID
Вложение успешно подписано и подпись
Добавлено в
проверена
версии
32.001
16
CLIENT_SIGN_INVALID
Ошибка при подписи или проверке подписи
Изменено в
вложения
версии
32.001
Статус окончательный неуспешный
17
CLIENT_SIGN_SKIPPED
Подпись или проверка подписи вложения была
Добавлено в
пропущена, т.к. выключена настройками
версии
системы
32.001
18
PARTIALLY_UPLOADED
Частично загружен
Добавлено в
версии
32.001
СКАЧИВАНИЕ ФАЙЛА ИЗ БФ (BigFilesUploadJob) (BigFilesDownloadJob)
Изменено в
версии
32.001
1
STARTED_ALPHA_TO_DMZ
Начата загрузка файла из хранилища больших
Актуально с
файлов в ALPHA в хранилище больших файлов
версии 27
в зоне DMZ
2
STARTED_FILENET_TO_AL
Начата загрузка файла из хранилища больших
Актуально с
PHA
файлов в зоне FileNet в ALPHA
версии 27
3
FINISHED
Файл загружен и готов к скачиванию
Изменено в
версии
Статус окончательный успешный
32.001
4
FINISHED_FILENET_TO_AL
Закончена загрузка файла из хранилища в
Актуально с
PHA
ALPHA
версии 27
5
FINISHED_ALPHA_TO_DM
Закончена загрузка файла из ALPHA в DMZ
Актуально с
Z
версии 27
6
ERROR_ALPHA_TO_DMZ
Ошибка загрузки файла из ALPHA в DMZ
Изменено в
версии
Статус окончательный неуспешный
32.001
7
ERROR_FILENET_TO_ALPH
Ошибка загрузки файла из хранилища в ALPHA
Изменено в
A
версии
Статус окончательный неуспешный
32.001
8
ERROR
Ошибка подготовки файла к скачиванию
Изменено в
версии
Статус окончательный неуспешный
32.001
9
OUTDATED
Файл устарел
Актуально с
версии 27
10
SPOILED
Файл поврежден
Изменено в
версии
Статус окончательный неуспешный
32.001
Дополнительная информация
С примером использования сущностей ГОЗ в рублевом платежном поручении, можно
ознакомиться в разделе "Платежное поручение" текущей части документации по API
УПШ.
3.7. Передача «Досылаемых документов» в Банк
3.7.1.Дайджест «Досылаемых документов»
Подпись документа на стороне УС:
 Первая подпись и вторая подпись или
 Единственная подпись
Дайджест: формируется
Ключевой буфер (дайджест):
 Для формирования электронной подписи из документа формируется строковая
последовательность (ключевой буфер или дайджест), включающая все значимые данные
документа, поля, содержащие пустые значения, не включаются.
 Ключевой буфер (дайджест) для подписания ЭП образует строковый массив в кодировке
UTF-8, Отдельные записи массива разделены символом перевода строки. В качестве
символа перевода строки используется 0x0A.
 При наличии в мультистроковых данных последовательности из двух символов перевода
строки CR+LF (ASCII 0x0D 0x0A) необходимо удалять символ возврата каретки CR (ASCII
0x0D) и оставлять только символ подачи строки LF (ASCII 0x0A).
 Если наполнение всех таблиц блока TABLES пустое, то и сам TABLES в дайджест не
включается
 Если наполнение какой-то таблицы блока TABLES пустое, то Table=TableName не включать в
дайджест
Формат дайджеста:
Пример
Версионно
п/
Наименование поля
Описание
значения
сть
п
1.
ATTRIBUTES
Актуально
<Наименование поля>=<Значение поля>, например
с версии 27
OrgId=963084ba-7079-4b9d-bbab-c4972dee82d9
2.
GlobalID
Актуально
с версии 27
3.
DocType
Актуально
с версии 27
4.
DocTypeVersion
Актуально
с версии 27
5.
CreateDate
Актуально
с версии 27
6.
CreateOrg
Актуально
с версии 27
7.
FIELDS
Актуально
<Наименование поля>=<Значение поля>После последней строки НЕ делать
с версии 27
перевод строки
8.
Дата документа, по которому
DocInfo.DocDate
2016-04-04
Актуально
досылаются сущности ГОЗ
с версии 27
9.
Номер документа, по
DocInfo.DocNumber
3905
Актуально
которому досылаются
с версии 27
сущности ГОЗ
10.
SupplyDoc.OrgName
Актуально
с версии 27
11.
Идентификатор документа,
SupplyDoc.LinkedDocExt
3a6378ef-07ee-
по которому досылаются
Актуально
Id
4535-a10a-
сущности ГОЗ
с версии 27
0c82817cae23
12.
Разделитель строк таблицы -
# Сортировать сначала по
Актуально
TABLES
типу адреса, потом по
с версии 27
индексу
13.
Актуально
Перечень сущностей
Table=SuppDocs
с версии 27
14.
3a6378ef-07ee-
Внешний идентификатор
Актуально
SuppDoc.EssenceId
4535-a10a-
сущности
с версии 27
0c82817cae23
Пример
ATTRIBUTES
OrgId=5e218ae3-1969-4411-a9cf-b10c9f730e5c
Sender=Оператор услуг
ExtId=89e20cec-02c3-8111-a322-a111a0d00ec0
FIELDS
DocDate=2017-03-16
DocNumber=9992
DocDocId=1a582a02-1218-48c0-bb39-5217bc00bdf2
TABLES
Table=SuppDocs
SuppDoc.EssenceId=902e6770-b4dd-49cc-96b9-dec8edc97a11
3.7.2. Формат
взаимодействия
при
отправке
«Досылаемых документов»
Взаимодействие: Документ передается из УС Клиента в СББОЛ
Инициатор получения документа: УС Клиента
Формат, в котором запрашиваются документы со стороны УС: Request/SupplyDoc
Формат передачи документа на сторону УС: Response/Tickets
3.7.2.1. Формат
отправки
«Досылаемых
документов» в СББОЛ
Request/SupplyDoc
Описание
Версионн
Элемент
Описание элемента
Тип
Мн.
типа
ость
Request
Досылаемые документы
Request
Актуально
[1]
с версии
27
1
Уникальный
UuidSeparated
UUID с
@requestId
идентификатор запроса
разделителя
ми в виде
[1]
Актуально
дефисов.
с версии
Набор из 32
27
символов
[0-9], [a-f] и
дефисов
2
Идентификатор
UUID с
@orgId
UuidSeparated
организациив ДБО
разделителя
(может быть использован
ми в виде
Актуально
сторонней системой для
дефисов.
[1]
с версии
дополнительной
Набор из 32
27
идентификации)
символов
[0-9], [a-f] и
дефисов
3
Номер версии формата
Простой тип
@version
xs:string
Актуально
обмена
XML
RegEx: "[0-
[1]
с версии
Schema
9\.]{1,20}"
27
4
Система-отправитель
Простой тип
@sender
xs:string
Актуально
XML
RegEx: «[-a-
[1]
с версии
Schema
zA-Zа-яА-Я0-
27
9: _]{1,20}»
5
Система-получатель -
Простой тип
@receiver
xs:string
Актуально
если система получатель
XML
RegEx: «[-a-
[0..1
с версии
СББОЛ, то SBBOL_DBO
Schema
zA-Zа-яА-Я0-
]
27
9: _]{1,20}»
6
Версия протокола
Простой тип
@protocolVersion
xs:string
[0..1
Актуально
XML
]
с версии
Schema
27
7
SupplyDoc
Досылаемые документы
SupplyDoc
Актуально
[1]
с версии
27
*.1
@docExtId
UuidSeparated
UUID с
Уникальный*
разделителя
идентификатор документа
ми в виде
в учетной системе (УС)
Актуально
дефисов.
Клиента.
[1]
с версии
Набор из 32
*Уникальность
27
символов
контролируется на
[0-9], [a-f] и
стороне банка
дефисов
*.2
@sentForSign
0 - обычная передача на
BoolType
Актуально
выполнение
[0..1]
с версии
1 - передано для
27
подписания в ИК
*.3
@docDate
Дата составления
xs:date
Актуально
документа
[1]
с версии
27
*.4
@docNum
Номер документа
xs:string
Актуально
[max: 6]
[1]
с версии
27
*.5
@bankName
Системное имя
xs:string [min:
подразделения банка
1, max: 255]
Значение брать из
Актуально
Response/OrganizationsInf
[1]
с версии
o/OrganizationInfo/Branche
27
s/Branch/BranchData/FullN
ame
*.6
PayDocRuId
Внешний идентификатор
UuidSeparated
Актуально
документа, которому
[1]
с версии
досылаются сущности
27
ГОЗ
*.7
SuppDocs
Перечень сущностей ГОЗ
Актуально
[1]
с версии
27
*.1
SuppDoc
SuppDoc
Актуально
[1..n]
с версии
27
*.1
@essenceId
Внешний идентификатор
UuidSeparated
сущности
Значение для поля
приходит в ответе на
Актуально
запрос статуса отправки с
[1]
с версии
типом «АКТ ГОЗ»
27
,«ИНОЙ» или «Контракт
ГОЗ». Тип зависит от
значения @essenceType
(поле docId)
*.2
@essenceTyp
Тип сущности:
BigFilesEssen
e
SUBST_DOC - Иной
ceType
документ, ACT - акт,
xs:string
Актуально
CONTRACT - контракт
Enum:
[1]
с версии
"SUBST_DO
27
C"; "ACT";
"CONTRACT
"
Пример
<Request
orgId='5e218ae3-1969-4411-a9cf-b10c9f730e5c'
receiver='SBBOL_DBO'
requestId='d0002ae3-0fdc-4b7d-a9c4-9c478ca9f496'
sender='Оператор услуг'
version='123'
<SupplyDoc
docExtId='49e20cec-02c3-8111-a322-a111a0d00ec0'
sentForSign='0'
docDate='2017-03-16'
docNum='9992'
bankName='ПАО СБЕРБАНК'>
<PayDocRuId>1a582a02-1218-48c0-bb39-5217bc00bdf2</PayDocRuId>
<SuppDocs>
<SuppDoc essenceId='902e6770-b4dd-49cc-96b9-dec8edc97a11'
essenceType='ACT'/>
</SuppDocs>
</SupplyDoc>
<Sign>
<Issuer>CN=ЛавринСВ-Тестовая печать-УЦ-9</Issuer>
<SN>74A7178CC3B7D3A14F0E</SN>
<Value>LvJRK9d+mjwEnNAo8R/lYDWd89PqfF06KBvp6Ija/AVQMREfUFE4MTmdpbgs48
MVC2uhuPFAHVOFJjePHhFkEg==</Value>
<DigestName>for_upg</DigestName>
<DigestVersion>1</DigestVersion>
</Sign>
</Request>
3.7.3.Особенности получения статусов обработки
«Досылаемых документов» из СББОЛ
Информация об обработке документа доставляется в УС:
1. Без запроса со стороны УС:
а. В ответ на отправленный документ СББОЛ отправляет сообщение в формате
Response/Tickets, в котором передается:
Tickets/Ticket/@docId - Идентификатор документа, с помощью которого в
последствии можно запрашивать со стороны УС в формате
Request/DocIds/DocId - все последующие статусы обработки документа;
Tickets/Ticket/ Info/@statusStateCode="DELIVERED".
2. Путем запроса со стороны УС в формате Request/DocIds/DocId:
а. Имея данные идентификатора документа, которые были получены с первым
сообщением Response/Tickets ->СББОЛ передает текущее состояние документа.
Tickets/Ticket/Info/BankDate/@statusDateTime - дата и время присвоения
статуса.
Статусы обработки документа, передаваемые со стороны СББОЛ в УПШ в
Response/Tickets/Ticket/Info/@statusStateCode:
Атрибут
Описание
Передаваемый из
Описание операции на
Response/Tickets
передаваемо
Версионно
СББОЛ статус
п/п
стороне СББОЛ
для передачи в
го из СББОЛ
сть
документа
УПШ
значения
1.
CREATED (Создан)
ЭД сформирован
Response/Tickets/T
CREATED
пользователем на стороне
icket/@statusState
Актуально с
клиента, при этом документ
Code
версии 27
прошел логические контроли с
положительным результатом.
2.
CHECKERROR
ЭД не прошел логические
Response/Tickets/T
CHECKERRO
(Ошибка контроля)
контроли Системы ДБО на
icket/@statusState
R
стороне клиента при
Code
Актуально с
сохранении (отрицательный
версии 27
результат) (статус
окончательный- не успешно)
3.
PARTLY_SIGNED
ЭД был подписан неполным
Response/Tickets/T
PARTLY_SIG
Актуально с
(Частично
набором подписей.
icket/Info/@statusS
NED
версии 27
подписан)
tateCode
4.
SIGNED (Подписан)
ЭД был подписан достаточным
Response/Tickets/T
SIGNED
Актуально с
набором подписей.
icket/@statusState
версии 27
Code
5.
DELIVERED
ЭД принят Банком и успешно
Response/Tickets/T
DELIVERED
Актуально с
(Доставлен)
сохранен в БД
icket/Info/@statusS
версии 27
tateCode
6.
REQUISITE_ERRO
ЭД не прошел логические
Response/Tickets/T
REQUISITE_E
R (Ошибка
контроли Системы при приеме
icket/@statusState
RROR
Актуально с
реквизитов)
на стороне Банка (статус
Code
версии 27
окончательный- не успешно)
7.
INVALIDEDS
Проверка подписи под ЭД на
Response/Tickets/T
INVALIDEDS
(ЭП/АСП не верна)
стороне Банка дала
icket/Info/@statusS
Актуально с
отрицательный результат.
tateCode
версии 27
Финальный статус документа
(статус окончательный- не
успешно)
Response/Tickets/T
Может быть
icket/Info/MsgFrom
передано
Bank/@message
сообщение о
Актуально с
том, что
версии 27
подлинность
документа не
подтверждена
8.
ACCEPTED
ЭД принят на стороне Банка
Response/Tickets/T
ACCEPTED
Актуально с
(Принят)
icket/@statusState
версии 27
Code
Response/Tickets/T
Дата
icket/Info/BankDate
поступления в
/@receiptDate
Банк
Актуально с
плательщика
версии 27
и принятия в
обработку
9.
ACCEPTED_BY_AB
ЭД выгружен в ЕКС
Response/Tickets/T
ACCEPTED_B
Актуально с
S (Принят АБС)
icket/@statusState
Y_ABS
версии 27
Code
Response/Tickets/T
Сообщение
Актуально с
icket/Info/MsgFrom
из Банка
версии 27
Bank/@message
10.
DECLINED_BY_ABS
Обработка данных на стороне
Response/Tickets/T
DECLINED_B
Актуально с
(Отказан АБС)
ЕКС дала отрицательный
icket/@statusState
Y_ABS
версии 27
результат (статус
Code
окончательный- не успешно)
Response/Tickets/T
Сообщение
Актуально с
icket/Info/MsgFrom
из Банка
версии 27
Bank/@message
Response/Tickets/T
Реквизиты
icket/Info/MsgFrom
ответственног
Актуально с
Bank/@author
о сотрудника
версии 27
Банка, если
требуется
11.
IMPLEMENTED
ЭД успешно обработан в ЕКС
Response/Tickets/T
IMPLEMENTE
Актуально с
(Исполнен)
(статус окончательный-
icket/@statusState
D
версии 27
успешно)
Code
12.
REFUSEDBYBANK
ЭД отвергнут банком (статус
Response/Tickets/T
REFUSEDBY
Актуально с
(Отвергнут Банком)
окончательный- не успешно)
icket/@statusState
BANK
версии 27
Code
Response/Tickets/T
Сообщение
Актуально с
icket/Info/MsgFrom
из Банка
версии 27
Bank/@message
Response/Tickets/T
Реквизиты
icket/Info/MsgFrom
ответственног
Актуально с
Bank/@author
о сотрудника
версии 27
Банка, если
требуется
13.
EXPORTED(Выгруж
Документ выгружен в АБС для
Response/Tickets/T
EXPORTED
Актуально с
ен)
дальнейшей обработки
icket/Info/@statusS
версии 27
tateCode
3.8. Работа в Личном кабинете поставщика услуг
3.8.1. Общие сведения
В СББОЛ, начиная с версии 26.000.00, предоставляется возможность работы в Личном
кабинете поставщика услуг (ЛКПУ), а именно передача в Банк реестра задолженностей и
получение из Банка реестра платежей.
Для работы в ЛКПУ необходимо, чтобы:
1. Организации в СББОЛ была подключена услуга "Переводы от физических лиц"
(Service= “PayCare2”)
2. Пользователю в СББОЛ была назначена роль "Пользователь Клиента с доступом
к услуге "Переводы от физических лиц" (UserRole=”bankClientPaymentService”)
3. Организация была зарегистрирована в Единой Платежной системе (ЕПС)
Кроме того, УС Клиента должна иметь доступ к системе Большие файлы (БФ).
Для начала работы нужно получить из СББОЛ вышеуказанные параметры:
Если настройки организации и пользователя корректны и УС Клиента имеет доступ к
системе БФ, то УС Клиента может передавать в Банк реестр задолженностей и получать
из Банка реестр платежей. Данные взаимодействия изображены на рисунках ниже:
Передача в Банк реестра задолженностей
УС Клиента
УПШ
Request/EssenceLinks
 LinkUUID
Response/UploadLinks(UploadJobId)
 LinkUUID
 UploadJobId
 WebUploadLink
HTTP методом POST загрузить БФ по ссылке
WebUploadLink
Request/BigFilesStatusRequest
 UploadJobId
Response/BigFilesStatus
 Status=FINISHED_DMZ_TO_ALPHA
Request/DebtRegistry
 UploadJobId
 FileName
 FileSize

 

 

 

 

 

 

 

содержание      ..     9      10      11      12     ..