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

*.1

@opf

Наименование на иностранном языке (при наличии)

xs:string [min:

Простой тип

Актуально

[0..1

1, max: 255]

XML Schema

с версии

]

*.1

@datOGRN

Дата регистрации

xs:date

Простой тип

Актуально

[0..1

XML Schema

с версии

]

*.1

@orgAddress

Юридический адрес организации клиента

xs:string [min:

Простой тип

Актуально

[0..1

1, max: 1024]

XML Schema

с версии

]

*.1

@resident

Резидентность организации по справочнику организаций

xs:string [min:

Простой тип

Актуально

[0..1

1, max: 255]

XML Schema

с версии

]

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

Актуально

AuthPers

*.6

[0..1

с версии

]

Имя ФИО уполномоченного сотрудника организации клиента

Простой тип

Name

xs:string

*.1

Изменено

Необходимо проверять, что запись об ответственном лице

XML Schema

[1]

в версии

не пуста (содержит хоть что-то кроме пробелов)

Номер телефона, факса уполномоченного сотрудника

Простой тип

Telfax

xs:string

*.2

[0..1

Изменено

организации клиента

XML Schema

]

в версии

Необходимо проверять, что запись о телефоне

ответственного лица не пуста

[1]

Должность уполномоченного сотрудника организации

Простой тип

Актуально

Position

xs:string [min:

*.3

[0..1

клиента

XML Schema

с версии

1, max: 1024]

]

*.4

Trans

Сделка

CurrSellTrans

Актуально

[1]

с версии

*.1

SumSell

Сумма продаваемой валюты

CurrAmountTy

Актуально

[1]

с версии

*.1

@docSum

Сумма

xs:decimal

Простой тип

Формат XX.YY с точностью до сотых

XML Schema

Актуально

Необходимо проверять, что:

[1]

с версии

 сумма указана (и состоит не из одних пробелов),

 сумма не отрицательная и не ноль

*.2

@currCode

Цифровой код валюты

CurrCodeDigita

Код валюты, 3

lType

цифры либо

Поле должно быть заполнено

одна буква (A-

Актуально

Необходимо проверять, что продаваемая валюта не

Z) и 2 цифры

[1]

с версии

соответствует национальной валюте

Необходимо проверять, что код принадлежит

справочнику

*.3

@currIsoCode

ISO-код валюты

CurrCodeLetter

Код валюты, 3

Актуально

[0..1

Type

буквы

с версии

]

*.2

TermSell

Условия продажи

TermDealType

Актуально

Required

[1]

с версии

*.1

DealType

Условия сделки: 2 - по курсу Банка России с взыманием

xs:string [1]

Простой тип

комиссионного вознаграждения, 1 - по курсу Сбербанка

RegEx: "[0-

XML Schema

России, 0 - на бирже на торговой сессии

2]{1}"

Проверять, что выбрано одно из условий продажи

Актуально

С 30.09.2016 в рамках расчетно-кассового обслуживания

[0..1

с версии

изменяется порядок проведения конверсионных операций

]

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

биржевому курсу. При отправке данного признака со

значением «0ª из СББОЛ возвращается ошибка "Ошибка

реквизитов" с причиной "Некорректно указано условие

сделки"

*.2

USD_EUR

0 - USD-RUB, 1 - EUR-RUB, 2- EUR-USD

xs:string [1]

Простой тип

Актуально

[0..1

RegEx: "[0-

XML Schema

с версии

Если операция не в долларах или евро, то признак отправлять

]

2]{1}"

не нужно

*.3

TOD_TOM

0 - TOD, 1 - TOM

xs:string [1]

Простой тип

Актуально

[0..1

XML Schema

с версии

RegEx: "[0-

]

2]{1}"

*.4

Rate

на бирже на торговой сессии по курсу

С 30.09.2016 в рамках расчетно-кассового обслуживания

изменяется порядок проведения конверсионных операций

Актуально

[0..1

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

с версии

]

биржевому курсу. При отправке данного признака со

значением «0ª из СББОЛ возвращается ошибка "Ошибка

реквизитов" с причиной "Некорректно указано условие

сделки"

*.1

@type

0 - по курсу не более, 1 - биржевой

xs:string [1]

Простой тип

Актуально

XML Schema

[1]

с версии

RegEx: "[0-

2]{1}"

*.2

@rate

Курс

xs:decimal

Простой тип

Актуально

Формат XX.YY с точностью до сотых

XML Schema

[0..1

с версии

]

Проверять, что если выбран чек «по курсуª, то должен

быть указан курс в поле «по курсу не болееª

*.3

AccountSell

Реквизиты счета списания валюты

AccountRubTy

Актуально

[1]

с версии

Проверять, что счет списания обслуживается в указанном

подразделении

*.1

@accNum

Номер счёта списания (р/с) обязателен для заполнения

AccNumType

Номер счёта

или корр.

Проверять, что:

RegEx: "[0-

счёта, 20 цифр

9]{20}"

- что счет списания не пуст и не содержит одни пробелы;

- счет имеет длину 20 символов;

- номер счета содержит только цифры, исключением

является первый символ в коде валюты счета (6 символ

счета), который может быть любой буквой или цифрой

Проверять, что если счет заполнен корректно

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

счетов + организаций

Актуально

[1]

с версии

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

справочнику счетов (счет+БИК), то он не должен быть

транзитным.

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

справочнику организаций и он не транзитный, то он

должен быть:

•

Не «Закрытª, и/или

•

Не «Заблокированª, и/или

•

Не «Разрешена обработка только выписок по

счетуª, и/или

•

«Не обслуживается ДБОª

Необходимо проверять, что валюта счета списания

средств не соответствует национальной валюте (810 (код

валюты счета, 6-8 разряд), 643 (код валюты суммы))

Необходимо проверять, что счет списания валюты

соответствует валюте суммы продажи.

*.2

Bank

Реквизиты банка, в котором открыт счет

Bank

Актуально

[1]

с версии

*.1

@bic

БИК банка счета списания валюты

BicType

БИК, 9 цифр

Актуально

[1]

с версии

*.2

@correspAcc

xs:string [max:

Простой тип

Актуально

[0..1

160]

XML Schema

с версии

]

*.1

Name

Наименование банка (либо в соответствии с BNKSEEK, либо

Xs: string

Простой тип

Изменено

наименование отделения СБРФ)

[min:1, max:

XML Schema

[1]

в версии

80160]

32.001

*.2

BankCity

Населённый пункт Банка

Xs: string

Простой тип

Актуально

[0..1

[min:1, max:30]

XML Schema

с версии

]

*.3

SettlementTyp

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

xs:string [min:

Простой тип

Изменено

[0..1

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

1, max: 20 10]

XML Schema

в версии

]

*.4

AccountCredit

Реквизиты счёта зачисления рублей

OurRubAccount

Актуально

Type

[1]

с версии

Проверять, что получатель задан

*.1

@accNum

Номер счёта зачисления (р/с) обязателен для заполнения

AccNumType

Номер счёта

Актуально

[1]

или корр.

с версии

Если выполняются все проверки:

RegEx: "[0-

9]{20}"

счёта, 20 цифр

 счет списания заполнен не пустым значением

 счет имеет длину 20 символов (без учета маски)

 номер счета может содержать только цифры,

исключением является первый символ в коде валюты

счета (6 символ счета), который может быть любой

буквой или цифрой

то проверять, что

 если установлен флажок «на наш счет в Сбербанке

Россииª, то проверять, что счет принадлежит

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

признаки:

«Закрытª и/или

«Заблокированª и/или

«Разрешена обработка только выписок по счетуª

и/или

«Не обслуживается ДБОª.

 если установлен флажок «на счет в другом банкеª, то

проверять ключ счета (стандартная проверка).

Проверять, что валюта счета зачисления средств

соответствует национальной валюте (810 (код валюты

счета, 6-8 разряд), 643 (код валюты суммы)).

*.2

@type

0 - Средства в рублях перечислить на наш счет в Сбербанке

xs:string

Простой тип

Актуально

России 1 - Средства в рублях перечислить на счет в другом

XML Schema

[1]

с версии

банке / в других филиалах и отделениях Сбербанка России

*.3

@AdditionalRequisite

Дополнительные реквизиты Банка

xs:string[max:5

Простой тип

Актуально

[0..1

00]

XML Schema

с версии

]

*.4

Bank

Реквизиты банка, в котором открыт счет

Bank

Актуально

[1]

с версии

*.1

@bic

БИК банка счета зачисления валюты

BicType

БИК, 9 цифр

Необходимо проверять, что поле БИК банка зачисления

Актуально

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

[1]

с версии

Необходимо проверять, что БИК банка зачисления

присутствует в справочнике БИК РФ

*.2

@correspAcc

xs:string [max:

Простой тип

Актуально

[0..1

160]

XML Schema

с версии

]

*.3

Name

Наименование банка (либо в соответствии с BNKSEEK, либо

Xs: string

Простой тип

Изменено

наименование отделения СБРФ)

[min:1, max:

XML Schema

[1]

в версии

80160]

32.001

*.4

BankCity

Населённый пункт Банка

Xs: string

Простой тип

Актуально

[0..1

[min:1, max:30]

XML Schema

с версии

]

*.5

SettlementType

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

xs:string [min:

Простой тип

Изменено

[0..1

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

1, max: 20 10]

XML Schema

в версии

]

*.5

Commis

Комиссионное вознаграждение (ComAcc ИЛИ ComOrder)

Commision

Актуально

[0..1

с версии

Элемент передается при условии, если DealType = 0 или 2

]

*.1

choice: должен присутствовать один из перечисленных ниже элементов

Актуально

[1]

с версии

*.1

ComAcc

Реквизиты счёта списания комисс. вознаграждения

ComAcc

Актуально

[1]

с версии

*.1

@accNum

Номер счёта списания комисс. Вознаграждения обязателен

AccNumType

Номер счёта

Актуально

[1]

для заполнения

или корр.

с версии

счёта, 20 цифр

Необходимо проверять, что если отмечен флажок

«списанием со счетаª, то счет списания комиссии должен

быть указан

Если выполняется:

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

счет имеет длину 20 символов (без учета маски)

номер счета может содержать только цифры,

исключением является первый символ в коде валюты

счета (6 символ счета), который может быть любой

буквой или цифрой

то проверять одно из:

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

(проверять по счет+БИК), то проверять:

•

Не «Закрытª, и/или

•

Не «Заблокированª, и/или

•

Не «Разрешена обработка только выписок по

счетуª, и/или

•

«Не обслуживается ДБОª

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

проверять ключ (стандартная проверка)

Необходимо проверять, что номер счета начинается с

401,402,403,404,405,406,407,408,409

*.2

@bic

БИК, заполняется значением справочника

BicType

БИК, 9 цифр

UpgRplDictionary/BicEntry/@bic

Актуально

Проверять, что БИК банка должен быть непустым и

[1]

с версии

является 9-значным цифровым кодом

Проверять, что БИК банка должен принадлежать

BNKSEEK

*.3

BankName

Проверять, что наименовании банка, тип населенного

xs:string [max:

Простой тип

Актуально

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

160]

XML Schema

[1]

с версии

принадлежать BNKSEEK

*.2

ComOrder

Реквизиты платёжного поручения, которым будет

ComOrder

перечислено комиссионное вознаграждение

Актуально

[1]

с версии

Необходимо проверять, что если установлен флажок

«перечислением по платежному поручениюª, то поля

«Номер п/пª и «Дата п/пª должны быть заполнены

*.1

@numPayDoc

Номер платёжного поручения

xs:string [min:

Простой тип

Актуально

1, max: 15]

XML Schema

[1]

с версии

*.2

@datePayDoc

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

xs:date

Простой тип

Актуально

XML Schema

[1]

с версии

*.3

@purposePay

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

xs:string [min:

Простой тип

Актуально

[0..1

Doc

1, max: 210]

XML Schema

с версии

]

*.5

BankAgreement

Соглашение с банком

xs:string [max:

Простой тип

Актуально

[0..1

3000]

XML Schema

с версии

]

*.6

AddInfo

Дополнительная информация

AddInfo

Актуально

[0..1

с версии

]

*.7

LinkedDocs

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

LinkedDocs

Связанные

Актуально

[0..1

валютный перевод

документы

с версии

]

*.1

LDoc

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

Актуально

[0..n

с версии

]

*.1

@type

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

xs:string [min:

Простой тип

Актуально

[0..1

1, max: 50]

XML Schema

с версии

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

]

документовª

*.2

@docExtId

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

UuidSeparated

UUID с

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

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

в виде

Изменено

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

[0..1

дефисов.

в версии

]

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

Набор из 32

@docId

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

[a-f] и дефисов

*.3

@docId

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

UuidSeparated

UUID с

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

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

в виде

Изменено

@docExtId

[0..1

дефисов.

в версии

]

Набор из 32

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

[a-f] и дефисов

*.4

Params

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

Params

Множество

Актуально

документа

параметров

[0..1

с версии

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

]

вида

Пример.

<Request xmlns='http://bssys.com/upg/request' orgId='ac24c9da-fbc1-4056-8550-cdd0c6fd5239'

requestId='ec98bcf2-eaea-4af1-a4fe-18b792148b91' version='01.002.02' sender='Ромашка'

receiver='SBBOL_DBO'>

<DocData docDate='2015-04-28' docNum='1004' bankName='ОПЕРУ Центрального

Аппарата Сбербанка РФ'>

<OrgData kpp='775551001' okato='45555555000' inn='7700000000'

orgName='ЗАО "Ромашка КИБ"' okpo='11522828'/>

<Name>Иванов Иван Иванович</Name>

</AuthPers>

</DocData>

<Trans>

<TOD_TOM>0</TOD_TOM>

</TermSell>

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

</Bank>

</AccountSell>

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

</Bank>

</AccountCredit>

<BankName>ОАО "СБЕРБАНК"</BankName>

</ComAcc>

</Commis>

</Trans>

</CurrSell>

<Sign>

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

<Value>dnenujcvma20d0W4S98ucGOcXAmFUYeevq2SVUapKbY6JdjrsGE4gvN5u6myqSBiA

XjdSD3xK3ZDoF7ixWIRmg==</Value>

<PcPropHash>ECCB0C2EA8F72D3961A9BADFC5BF67A4C1E3154A59F2CC39A62F9EA697

6426481DE75A977F79BD00CDE82E059126EBAA2B496D2F5C4182EF91EB9798EF62B32E</PcPro

pHash>

<Fraud>

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

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

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

DF3EA9FF2800;BFEBFBFF000206A7;PBAF441;

Z2AMA1FK</PcProp>

<DevicePrint>version%3D3.4.1.0_1%26pm_fpua%3DWin64%7C0%7Cx64%7Cru%7C01.005.0

0%26pm_fpsc%3D32%7C1600%7C900%7C1600%26pm_fpsw%3Dabk%3D6%2C1%2C7601%2C1751

4%7Cwnt%3D6%2C1%2C7601%2C18952%7Cdht%3D11%2C0%2C9600%2C18376%7Cie5%3D%7Ci

be%3D11%2C0%2C9600%2C18376%7Cieh%3D11%2C0%2C9600%2C18376%7Ciee%3D6%2C3%2C

9600%2C18376%7Cwmp%3D12%2C0%2C7601%2C19148%7Cobp%3D11%2C0%2C9600%2C18376

%7Coex%3D6%2C1%2C7601%2C17514%7Cvbs%3D5%2C6%2C0%2C8833%26pm_fptz%3D3%26p

m_fpln%3Dlang%3Dru%7Csyslang%3Dru%7Cuserlang%3Dru%26pm_fpjv%3D0%26pm_fpco%3D0%

26pm_fpasw%3D%26pm_fpan%3DSBB%26pm_fpacn%3DSBB%26pm_fpol%3Dfalse%26pm_fposp%

3D%26pm_fpup%3D%26pm_fpsaw%3D1600%26pm_fpspd%3D32%26pm_fpsbd%3D%26pm_fpsdx%

3D96%26pm_fpsdy%3D96%26pm_fpslx%3D96%26pm_fpsly%3D96%26pm_fpsfse%3Dfalse%26pm_f

psui%3D%26pm_os%3DWindows%26pm_brmjv%3D01.005.00%26pm_br%3DSBB%26pm_inpt%3D

%26pm_expt%3D</DevicePrint>

</Fraud>

</Sign>

<Fraud>

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

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

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

DF3EA9FF2800;BFEBFBFF000206A7;PBAF441;

Z2AMA1FK</PcProp>

</Fraud>

</Request>

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

Информация об обработке документа доставляется в УС:

1. Без запроса со стороны УС:

a. В ответ на отправленный документ СББОЛ отправляет сообщение

формате

Response/Tickets, в котором передается:

 Tickets/Ticket@docId

- Идентификатор документа, с помощью

которого

впоследствии можно запрашивать со стороны УС в формате Request/DocIds/DocId -

все последующие статусы обработки докуемнта

 Tickets/Ticket/ Info@statusStateCode="DELIVERED" ИЛИ “FAIL”

Путем запроса со стороны УС в формате Request/DocIds/DocId:

Имея данные идентификатора документа, которые были получены с первым сообщением

Response/Tickets ->СББОЛ передает текущее состояние документа.

 Tickets/Ticket/Info/BankDate/@statusDateTime - дата и время присвоения статуса.

Дополнительно в каждой квитанции передаются:

 дата передачи документа на обработку

- назначен статус

«Принят АБСª

(Response/Tickets/Ticket/Info/BankDate/@receiptDate);

 сообщение из Банка, если потребуется

(Response/Tickets/Ticket/Info/MsgFromBank/message);

 реквизиты ответственного сотрудника Банка, если потребуется

(Response/Tickets/Ticket/Info/MsgFromBank/@author)

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

АС СББОЛ, пустые атрибуты опускаются.

Дополнительно в каждом сообщении со статусом передается специальный составной

элемент Response/Tickets/Ticket/Info/AddInfo/CurrConv, содержащий список сведений по

результатам обработки распоряжения, который содержит сведения:

 Дата валютирования(Response/Tickets/Ticket/Info/AddInfo/CurrConv/ValueDate);

 Курс сделки (Response/Tickets/Ticket/Info/AddInfo/CurrConv/Rate);

 Сумма

комиссии

за

продажу

валюты

(Response/Tickets/Ticket/Info/AddInfo/CurrConv/ChargeSum);

 Cумма

продаваемой

валюты

(Response/Tickets/Ticket/Info/AddInfo/CurrConv/DealSum);

 Выручка в рублях от продажи валюты

(Response/Tickets/Ticket/Info/AddInfo/

CurrConv/ RevSum).

Статусы обработки документа, передаваемые со стороны СББОЛ в УПШ в рамках

Response/Tickets:

№

Передаваемый

Описание

Описание операции на

Атрибут Response/Tickets для

п/

из СББОЛ статус

передаваемого из

Версионность

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

передачи в УПШ

документа

СББОЛ значения

INVALIDEDS

INVALIDED

Проверки документа

Response/Tickets/Ticket/

Актуально

(АСП/ЭП

привели к

Info/@statusStateCode

с версии 27

неверна)

неуспешному

Может быть

Response/Tickets/Ticket/

результату

передано

Info/MsgFromBank/@m

сообщение о том,

(статус окончательный

essage

Актуально

что подлинность

- не успешно)

с версии 27

документа не

подтверждена

VALIDEDS

Проверки документа

Response/Tickets/Ticket/

Актуально

(АСП/ЭП

привели к успешному

Info/@statusStateCode

с версии 27

верна)

результату

ЭД был подписан

PARTLY_SI

Response/Tickets/Ticket/

PARTLY_SIGNE

неполным набором

GNED

Info/@statusStateCode

Актуально

подписей.

(Частично

с версии 27

подписан)

REQUISITE_ERR

REQUISITE_

Логические проверки

Res

Актуально

ERROR

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

ponse/Tickets/Ticket/Inf

с версии 27

(Ошибка

неуспешному

o/@statusStateCode

реквизитов)

результату

Должны

Response/Tickets/Ticket/

(статус окончательный

передаваться

Info/MsgFromBank/@m

- не успешно)

сообщения об

Актуально

essage

ошибках,

с версии 27

выявленных на

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

DELIVERED

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

Response/Tickets/Ticket/

(Доставлен)

на сторну Банка, но

Info/@statusStateCode

еще не проходил

Актуально

проверку подписи и

с версии 27

реквизитов

ACCEPTED

Прием документа на

Response/Tickets/Ticket/

Актуально

(Принят)

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

@statusStateCode

с версии 27

Дата поступления

Response/Tickets/Ticket/

в Банк

Info/BankDate/@receipt

Актуально

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

Date

с версии 27

принятия в

обработку

DECLINED_BY_

DECLINED_

Отказ платежа

Response/Tickets/Ticket/

Актуально

ABS

BY_ABS

@statusStateCode

с версии 27

(статус окончательный

(Отказан

Сообщение из

- не успешно)

Response/Tickets/Ticket/

АБС)

Банка

Актуально

Info/MsgFromBank/@m

с версии 27

essage

Реквизиты

Response/Tickets/Ticket/

ответственного

Актуально

Info/MsgFromBank/@au

сотрудника Банка,

с версии 27

thor

если требуется

DECLINED_BY_

DECLINED_

Отказ платежа

Response/Tickets/Ticket/

Актуально

BANK

BY_BANK

@statusStateCode

с версии 27

(статус окончательный

(Отвергнут

Сообщение из

- не успешно)

Response/Tickets/Ticket/

Банком)

Банка

Актуально

Info/MsgFromBank/@m

с версии 27

essage

Реквизиты

Response/Tickets/Ticket/

ответственного

Актуально

Info/MsgFromBank/@au

сотрудника Банка,

с версии 27

thor

если требуется

EXPORTED

Документ выгружен в

Response/Tickets/Ticket/

Актуально

(Выгружен)

АБС для дальнейшей

Info/@statusStateCode

с версии 27

обработки

Дата поступления

Response/Tickets/Ticket/

в Банк

Info/BankDate/@receipt

Актуально

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

Date

с версии 27

принятия в

обработку

Response/Tickets/Ticket/

Сообщение из

Актуально

Info/MsgFromBank/@m

Банка, если

с версии 27

essage

требуется

Реквизиты

Response/Tickets/Ticket/

ответственного

Актуально

Info/MsgFromBank/@au

сотрудника Банка,

с версии 27

thor

если требуется

ACCEPTED_BY_

10.

ACCEPTED_

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

Response/Tickets/Ticket/

Актуально

ABS

BY_ABS

обработку в АБС

@statusStateCode

с версии 27

(Принят

Сообщение из

Response/Tickets/Ticket/

АБС)

Банка

Актуально

Info/MsgFromBank/@m

с версии 27

essage

EXPORT_ERROR

11.

EXPORT_ER

Электронный

Response/Tickets/Ticket/

ROR

документ не был

Info/@statusStateCode

(Ошибка

выгружен в АБС

Актуально

экспорта)

Банка

с версии 27

(статус окончательный

– не успешно)

IMPLEMENTED

12.

IMPLEMENT

Подтверждение

Response/Tickets/Ticket/

Актуально

исполнения платежа

Info/@statusStateCode

с версии 27

(Исполнен)

Продажа валюты -

(статус окончательный

Response/Tickets/Ticket/

Актуально

– успешно)

Info/AddInfo/CurrConv/

Дата

с версии 27

валютирования

ValueDate

Response/Tickets/Ticket/

Продажа валюты -

Актуально

Info/AddInfo/CurrConv/

Курс сделки

с версии 27

Rate

Response/Tickets/Ticket/

Списано

Актуально

Info/AddInfo/ChargeSu

комиссии - сумма

с версии 27

m/@docSum

Списано

Response/Tickets/Ticket/

Актуально

комиссии - ISO

Info/AddInfo/ChargeSu

с версии 27

код валюты

m/@currCode

Response/Tickets/Ticket/

Продано валюты -

Актуально

Info/AddInfo/DealSum/

сумма

с версии 27

@docSum

Response/Tickets/Ticket/

Продано валюты

Актуально

Info/AddInfo/DealSum/

– ISO код валюты

с версии 27

@currCode

Response/Tickets/Ticket/

Перечислено

Актуально

Info/AddInfo/RevSum/@

рублей - сумма

с версии 27

docSum

Перечислено

Response/Tickets/Ticket/

Актуально

рублей - ISO код

Info/AddInfo/RevSum/@

с версии 27

валюты

currCode

Response/Tickets/Ticket/

Сообщение из

Актуально

Info/MsgFromBank/@m

банка

с версии 27

essage

Response/Tickets/Ticket/

Ответственный

Актуально

Info/MsgFromBank/@au

исполнитель

с версии 27

thor

DELAYED

13.

DELAYED

Приостановка

Response/Tickets/Ticket/

Актуально

(Приостанов

обработки документа

Info/@statusStateCode

с версии 27

лен)

Сообщение из

Response/Tickets/Ticket/

Банка, если

Актуально

Info/MsgFromBank/@m

требуется

с версии 27

essage

Реквизиты

Response/Tickets/Ticket/

ответственного

Актуально

Info/MsgFromBank/@au

сотрудника Банка,

с версии 27

thor

если требуется

RECALL

14.

RECALL

Документ отозван

Response/Tickets/Ticket/

Актуально

(Отозван)

Info/@statusStateCode

с версии 27

(статус окончательный

Сообщение из

– не успешно)

Response/Tickets/Ticket/

Банка, если

Актуально

Info/MsgFromBank/@m

требуется

с версии 27

essage

Реквизиты

Response/Tickets/Ticket/

ответственного

Актуально

Info/MsgFromBank/@au

сотрудника Банка,

с версии 27

thor

если требуется

15.

ACCEPTED_

Документ

принят

Response/Tickets/Ticket/

ACCEPTED_BY_

Актуально

BY_CFE

валютным контролем

Info/@statusStateCode

CFE

с версии 27

(Принят ВК)

Response/Tickets/Ticket/

Дата поступления

Актуально

Info/BankDate/@receipt

в Банк

с версии 27

Date

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

принятия в

обработку

Response/Tickets/Ticket/

Дата

Актуально

Info/

принятия/возврата

с версии 27

AddInfo/CurrControlInfo

валютным

/ValueDateDate

контролем

Response/Tickets/Ticket/

Сообщение из

Актуально

Info/MsgFromBank/@m

Банка, если

с версии 27

essage

требуется

Response/Tickets/Ticket/

Реквизиты

Актуально

Info/MsgFromBank/@au

ответственного

с версии 27

thor

сотрудника Банка,

если требуется

Недостаточно средств

16.

CARD2

Response/Tickets/Ticket/

CARD2

Актуально

на счете плательщика

(Картотека

Info/@statusStateCode

с версии 27

(статус

Response/Tickets/Ticket/

Дата поступления

окончательный-

не

Info/BankDate/@receipt

в Банк

успешно)

Актуально

Date

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

с версии 27

принятия в

обработку

Response/Tickets/Ticket/

Сообщение из

Актуально

Info/MsgFromBank/@m

Банка, если

с версии 27

essage

требуется

Response/Tickets/Ticket/

Реквизиты

Info/MsgFromBank/@au

ответственного

Актуально

thor

сотрудника Банка,

с версии 27

если требуется

17.

CHECKERR

ЭД не прошел

Response/Tickets/Ticket/

CHECKERROR

Актуально

OR (Ошибка

логические контроли

@statusStateCode

с версии 27

контроля)

Системы

ДБО на

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

сохранении

(отрицательный

результат)

(статус

окончательный-

не

успешно)

18.

CREATED

ЭД

сформирован

Response/Tickets/Ticket/

CREATED

(Создан)

пользователем

на

@statusStateCode

стороне клиента, при

Актуально

этом документ прошел

с версии 27

логические контроли с

положительным

результатом.

19.

CLOSED(Зак

Response/Tickets/Ticket/

CLOSED

Актуально

Закрыт

рыт)

Info/@statusStateCode

с версии 27

20.

FRAUDREVI

Со стороны ФРОД-

Response/Tickets/Ticket/

FRAUDREVIEW

Актуально

(На

анализа

получен

Info/@statusStateCode

с версии 27

проверке у

статус документа «На

Response/Tickets/Ticket/

Может быть

Актуально

специалиста

проверке

Info/MsgFromBank/@m

передано

с версии 27

Банка)

специалиста Банкаª

essage

сообщение о том,

что подлинность

документа не

подтверждена

21.

FRAUDSMS

Со стороны ФРОД-

Response/Tickets/Ticket/

FRAUDSMS

Актуально

(Требуется

анализа

получен

Info/@statusStateCode

с версии 27

подтвержден

статус

документа

Response/Tickets/Ticket/

Может быть

Актуально

ие

sms-

«Требуется

Info/MsgFromBank/@m

передано

с версии 27

паролем)

подтверждение

sms-

essage

сообщение о том,

паролемª

что подлинность

документа не

подтверждена

Response/Tickets/Ticket/

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

Актуально

Info/OtherParams/Param

смс

с версии 27

@name = smsId

Response/Tickets/Ticket/

Info/OtherParams/Param

@value

Response/Tickets/Ticket/

Сообщение для

Актуально

Info/OtherParams/Param

смс

с версии 27

@name=sms_message

Response/Tickets/Ticket/

Info/OtherParams/Param

@value

22.

IMPORTED

Импортирован

Response/Tickets/Ticket/

IMPORTED

Актуально

(Импортиро

Info/@statusStateCode

с версии 27

ван)

23.

PROCESSIN

В обработке

Response/Tickets/Ticket/

PROCESSING

Актуально

G(В

Info/@statusStateCode

с версии 27

обработке)

24.

PUBLISHED

Издан Банком

Response/Tickets/Ticket/

PUBLISHED_BY_

_BY_BANK

Info/@statusStateCode

BANK

Актуально

(Издан

с версии 27

Банком)

25.

DECLINED_

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

Response/Tickets/Ticket/

DECLINED_BY_

Актуально

BY_CFE

валютным контролем

Info/@statusStateCode

CFE

с версии 27

(Отказан

(статус окончательный

Response/Tickets/Ticket/

Сообщение из

Актуально

ВК)

– не успешно)

Info/MsgFromBank/@m

Банка, если

с версии 27

essage

требуется

Response/Tickets/Ticket/

Реквизиты

Актуально

Info/MsgFromBank/@au

ответственного

с версии 27

thor

сотрудника Банка,

если требуется

Response/Tickets/Ticket/

Дата

Актуально

Info/

принятия/возврата

с версии 27

AddInfo/CurrControlInfo

валютным

/ValueDate

контролем

Код

причины

Актуально

возврата

с версии 27

Возможные

Response/Tickets/Ticket/

значения:

Info/AddInfo/CurrContro

1 - 18.6.1

lInfo/RejectionCauses/Ca

ses138I/Case138I/@code

2 - 18.6.2

3 - 18.6.3

4 - 18.6.4

Response/Tickets/Ticket/

Актуально

Info/AddInfo/CurrContro

с версии 27

Комментарий

lInfo/RejectionCauses/Ca

причины возврата

ses138I/Case138I/@com

ment

Response/Tickets/Ticket/

Актуально

Info/AddInfo/CurrContro

с версии 27

Код причины

lInfo/RejectionCauses/Fo

отказа

rmalCases/FormalCase/

@code

Response/Tickets/Ticket/

Актуально

Info/AddInfo/CurrContro

с версии 27

Комментарий

lInfo/RejectionCauses/Fo

причине отказа

rmalCases/FormalCase/

@comment

26.

SIGNED

ЭД

был

подписан

Response/Tickets/Ticket/

SIGNED

Актуально

(Подписан)

достаточным набором

@statusStateCode

с версии 27

подписей.

27.

Response/Tickets/Ticket/

Актуально

TRIED_BY_CFE

Info/@statusStateCode

с версии 27

Response/Tickets/Ticket/

Дата поступления

Актуально

Info/BankDate/@receipt

в Банк

с версии 27

Date

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

принятия в

обработку

TRIED_BY_

CFE

Response/Tickets/Ticket/

Сообщение из

Актуально

Проверяется ВК

(Проверяетс

Info/MsgFromBank/@m

Банка, если

с версии 27

я ВК)

essage

требуется

Response/Tickets/Ticket/

Сообщение из

Актуально

Info/MsgFromBank@me

банка

с версии 27

ssage

Response/Tickets/Ticket/

Ответственный

Актуально

Info/MsgFromBank@aut

исполнитель

с версии 27

hor

28.

Ошибка создания

Response/Tickets/Ticket/

FAIL

документа в СББОЛ

Info/@statusStateCode

Добавлено

(статус

в версии 28

FAIL

окончательный-

не

(Ошибка

успешно)

создания)

Response/Tickets/Ticket/

Счет № <номер

Счет плательщика не

Info/MsgFromBank/@m

счета> БИК

Добавлено

найден/не валиден

essage

<номер БИК> не

в версии 28

найден

Пример 1.

(Получение из СББОЛ ID полученного документа и статус Отвергнут Банком)

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<Response

sender="DBO"

version="1.0"

requestId="ED9AE3B4-41F7-43A1-9DD4-92B2C775D0A9"

responseId="ddbf4261-c58b-4cf5-b7e7-f1797493d480"

createTime="2014-03-11T15:22:29"

xmlns="http://bssys.com/upg/response">

<Sign>

<ISSUER>E =casbrf@sberbank.ru

2.5.4.33 =Тестирующий АдминистраторКК

CN =ИвановИИ-АдминКК-ТЕСТ2

OU =Удостоверяющий центр СБ РФ (Тестовый)

O =ОАО «Сбербанкª

C =RU</ISSUER>

<Value>I/ze8xc1p3KyFZw6/cfrWaFazlmhvxPYq4Qtyio/arMUmuIvWHXp7slFSme5BrFj7pbNZU3+6Ye2kXiar3Fp4A

==</Value>

</Sign>

</Ticket>

</Tickets>

</Response>

Пример 2.

(Получение из СББОЛ информации об обработке документа, пример статуса

IMPLEMENTED)

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<Response

sender="DBO"

version="1.0"

requestId="E6D4DA56-8245-4B7D-B30B-45BE51E7CF41"

responseId="fa7cf792-1d82-4cd6-8eda-940e07fd74a5"

createTime="2014-03-11T15:22:44"

xmlns="http://bssys.com/upg/response">

<MsgFromBank message="

Некорректно указан код вида валютной операции” author=”Иванов Иван Иванович”/>

</Info>

</CurrConv>

</PayDocCur>

</AddInfo>

<Sign>

<ISSUER>E =casbrf@sberbank.ru

2.5.4.33 =Тестирующий АдминистраторКК

CN =ИвановИИ-АдминКК-ТЕСТ2

OU =Удостоверяющий центр РК РФ (Тестовый)

O =ОАО «Сбербанкª

C =RU</ISSUER>

<Value>GUO7t7AcqBoyBLTqy/9uvtc8pCHjTAyFozChbo5TTa1zlSeJvFztMqnRE9O8w3RYpPBg8PL4O/vgnhFs2L

NpWw==</Value>

</Sign>

</Ticket>

</Tickets>

</Response>

2.3. Поручение на покупку валюты

Следует отметить, что в поручении на покупку валюты Клиент может купить любую валюту из

справочника валют,кроме рублей, за любую валюту из справочника валют.

2.3.1.Дайджест

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

•

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

•

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

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

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

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

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

пустые значения, не включаются.

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

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

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

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

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

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

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

Примечание:

Для отделения некоторых видов данных друг от друга в дайджест включены «заголовкиª,

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

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

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

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

№

Версионно

сть

Наименование поля

Описание

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

п/

ATTRIBUTES

Актуально

с версии

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

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

Актуально

OrgId

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

963084ba-7079-4b9d-

с версии

(может быть использован сторонней

bbab-c4972dee82d9

системой для дополнительной

идентификации)

Актуально

Sender

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

Ромашка

с версии

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

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

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

Актуально

ExtId

3a6378ef-07ee-4535-

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

с версии

a10a-0c82817cae23

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

Клиента.

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

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

Актуально

FIELDS

с версии

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

AccDoc.AccDocNo=444

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

Актуально с версии 27

DocDate

2012-02-01

Актуально

с версии

DocNum

Номер документа

Актуально

с версии

BankName

Значение

ОПЕРУ

Изменено в

Центрального

версии 33

Аппарата Сбербанка

РФ

Актуально

OrgData.Inn

ИНН клиента

7000000000

с версии

10.

Актуально

OrgData.OrgName

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

OOO «Компанияª

с версии

(сокращенное наименование - как в

платежных руб. документах)

11.

Актуально

OrgData.Okpo

ОКПО клиента

77555777

с версии

12.

Изменено в

AuthPers.Name

Имя ФИО уполномоченного

ЛюдоедкаЭ.Д.

версии 31

сотрудника организации клиента

13.

Актуально

AuthPers.Telfax

Номер телефона, факса

987-898-434

с версии

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

организации клиента

14.

Актуально

Acc.Account

Расчетный счет списания средств на

400000000000000000

с версии

покупку валюты

15.

Актуально

Acc.Bic

БИК расчетного счета списания

044525225

с версии

средств на покупку валюты

16.

Актуально

Acc.BankName

Наименование подраздеелния банка

Московский банк

с версии

списания средств на покупку валюты

ОАО «Сбербанкª

17.

Актуально

AmountTransf.Buy

Сумма покупаемой валюты

1230.55

с версии

Формат суммы с дробной частью,

разделенной точкой

18.

Актуально

AmountTransf.SumCu

Цифровой код валюты суммы

840

с версии

rrCode

покупаемой валюты

19.

Актуально

AmountTransf.SumCu

ISO-код валюты суммы покупаемой

USD

с версии

rrrIsoCode

валюты

20.

Актуально

AmountTransf.SumTh

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

1230.55

с версии

rough

Формат суммы с дробной частью,

разделенной точкой

21.

Актуально

AmountTransf.SumTh

Цифровой код валюты суммы

978

с версии

roughCurrCode

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

22.

Актуально

AmountTransf.SumTh

ISO-код валюты суммы покупки за

EUR

с версии

roughCurrrIsoCode

счет средств

23.

Актуально

TermBuy.DealType

Условия сделки: 2 - по курсу Банка

с версии

России с взыманием комиссионного

вознаграждения, 1 - по курсу

Сбербанка России, 0 - на бирже на

торговой сессии

С 30.09.2016 в рамках расчетно-

кассового обслуживания

изменяется порядок проведения

конверсионных операций -

исключается возможность

проведения конверсий по

биржевому курсу. При отправке

данного признака со значением «0ª

из СББОЛ возвращается ошибка

"Ошибка реквизитов" с причиной

"Некорректно указано условие

сделки"

24.

Актуально

TermBuy.USD_EUR

0 - USD-RUB, 1 - EUR-RUB, 2- EUR-

с версии

USD

Если операция не в долларах или

евро, то признак отправлять не нужно

25.

Актуально

TermBuy.TOD_TOM

0 - TOD, 1 - TOM

с версии

26.

Актуально

TermBuy.Rate

Курс

1.2000

с версии

27.

Актуально

TermBuy.RateType

0 - по курсу не более, 1 - биржевой

с версии

28.

Актуально

AccountNumTransf.Ty

Реквизиты счёта зачисления валюты

с версии

0 - На наш счет в Сбербанке России,

1 - На счет в другом банке/ в других

филиалах и отделениях Сбербанка

29.

Актуально

AccountNumTransf.Ac

Реквизиты счёта зачисления валюты

400000000000000000

с версии

cNum

30.

Актуально

AccountNumTransf.Bi

БИК банка зачисления валюты

044444444

с версии

31.

Актуально

AccountNumTransf.Na

Наименование банка зачисления

Московский банк

с версии

валюты (либо в соответствии с

ОАО "Сбербанк

BNKSEEK либо наименование

России"

отделения СБРФ)

32.

Актуально

AccountNumTransf.Ba

SWIFT банка зачисления валюты

AAAARSBG

с версии

nkSWIFT

33.

Актуально

PayDocBuy.Type

0 - Средства в продаваемой валюте

с версии

списать со счета 1 - Перечислены с

нашего счета в Сбербанке Росии 2 -

Перечислены со счета в другом

банке/ в других филиалах и

отделениях Сбербанка России

34.

Актуально

PayDocBuy.DocAccou

Номер счёта списания продаваемой

400000000000000000

с версии

валюты

35.

Актуально

PayDocBuy.DocBic

БИК счёта списания продаваемой

044525225

с версии

валюты

36.

Актуально

PayDocBuy.DocBankN

Наименование банка счёта списания

Московский банк

с версии

ame

продаваемой валюты

ОАО "Сбербанк

России"

37.

Актуально

PayDocBuy.RecDocNu

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

123456

с версии

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

38.

Актуально

PayDocBuy.RecDocDa

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

2012-02-01

с версии

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

Формат yyyy-mm-dd

39.

Актуально

PayDocBuy.RecAccNu

Номер счёта перечисления средств на

400000000000000000

с версии

покупку

40.

Актуально

PayDocBuy.RecBic

БИК банка перечисления средств на

044444444

с версии

покупку

41.

Актуально

PayDocBuy.RecBankN

Наименование банка перечисления

Московский банк

с версии

ame

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

ОАО "Сбербанк

России"

42.

Актуально

Commis.AccNum

Реквизиты счёта списания комисс.

400000000000000000

с версии

вознаграждения

43.

Актуально

Commis.Bic

БИК банка счёта списания комисс.

044444444

с версии

вознаграждения

44.

Актуально

Commis.BankName

Наименование банка счёта списания

Московский банк

с версии

комисс. вознаграждения

ОАО "Сбербанк

России"

45.

Актуально

Commis.NumPayDoc

Номер платёжного поручения

с версии

списания комисс. вознаграждения

46.

Актуально

Commis.DatePayDoc

Дата платёжного поручения по

2012-02-01

с версии

местному времени списания комисс.

вознаграждения

47.

Актуально

BankAgreement

с версии

Изменено в

Table=LinkedDocs

Связанные документы

версии 29

Изменено в

Type

Тип документа

supplyDoc

версии 29

DocExtId

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

19a3a9ee-4a1d-26a1-

Изменено в

e154-001411f81192

версии 29

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

ATTRIBUTES

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

Sender=Ромашка

ExtId=99d02df8-af0d-4200-bbea-048fcf7f652c

FIELDS

DocDate=2015-06-03

DocNum=1

BankName=ДО №1536 Московского банка Сбербанка России ОАО

OrgData.Inn=7769288474

OrgData.OrgName=ООО "ИП7"

OrgData.Okpo=71336133

AuthPers.Name=Васин Вася Васяу

AuthPers.Telfax=03

Acc.Account=40702810738040019799

Acc.Bic=044525225

Acc.BankName=ДО №1536 Московского банка Сбербанка России ОАО

AmountTransf.Buy=400.00

AmountTransf.SumCurrCode=840

AmountTransf.SumCurrrIsoCode=USD

AmountTransf.SumThrough=400.00

AmountTransf.SumThroughCurrCode=810

AmountTransf.SumThroughCurrrIsoCode=RUR

TermBuy.DealType=1

AccountNumTransf.Type=0

AccountNumTransf.AccNum=40702840438041024008

AccountNumTransf.Bic=044525225

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

PayDocBuy.Type=0

PayDocBuy.DocAccount=40702810738040019799

PayDocBuy.DocBic=044525225

PayDocBuy.DocBankName=ОАО "СБЕРБАНК РОССИИ"

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

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

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

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

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

Response/Tickets

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

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

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

ТК.

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

Request/CurrBuy

Версионн

Элемент

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

Тип

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

Мн.

ость

Request

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

Request

Актуально

[1]

с версии

@orgId

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

UuidSeparated

UUID с

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

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

Актуально

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

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

[1]

с версии

Набор из 32

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

[a-f] и дефисов

@requestId

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

UuidSeparated

UUID с

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

Актуально

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

[1]

с версии

Набор из 32

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

[a-f] и дефисов

@version

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

xs:string

Простой тип

Актуально

RegEx: "[0-

XML Schema

[1]

с версии

9\.]{1,20}"

@sender

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

xs:string

Простой тип

Актуально

RegEx: «[-a-zA-

XML Schema

[1]

с версии

Zа-яА-Я0-9:

_]{1,20}ª

@receiver

Система-получатель Если система получатель

xs:string

Простой тип

Актуально

СББОЛ, то SBBOL_DBO

RegEx: «[-a-zA-

XML Schema

[0..1

с версии

Zа-яА-Я0-9:

]

_]{1,20}ª

@ protocolVersion

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

xs:string

Простой тип

Актуально

[0..1

XML Schema

с версии

]

CurrBuy

Поручение на покупку

CurrBuy

Актуально

[1]

с версии

Проверка на наличие дубликата документа

(уникальность по всем полям)

UUID с

*.1

@docExtId

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

UuidSeparated

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

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

Актуально

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

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

[1]

с версии

Набор из 32

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

[a-f] и дефисов

*.2

DocData

Общие реквизиты платёжного документа ДБО

ComDocData

Актуально

[1]

с версии

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

Простой тип

@docDate

xs:date

*.1

Актуально

XML Schema

[1]

с версии

Номер документа

Простой тип

@docNum

xs:string [max: 6]

*.2

Проверять, что поле «номер документаª

XML Schema

Актуально

непустое

[1]

с версии

Проверять, что номер не содержит внутри (не

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

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

Значение

Простой тип

@bankName

xs:string [min: 1,

*.3

Response/OrganizationsInfo/OrganizationInfo/Branch

XML Schema

max: 160]

Актуально

[0..1

es/Branch/ ShortNamе - системное имя

с версии

]

подразделения банка, которое передается в рамках

OrganizationsInfo

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

Простой тип

@bankNum

xs:string

*.4

Изменено

[0..1

в ДБО

XML Schema

в версии

]

В настоящее время не используется

Основные реквизиты организации, указываемые в

OrgData

*.5

документе

Необходимо проверять, что:

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

Актуально

справочнике организаций

[1]

с версии

ИНН организации соответствует

справочнику организаций

наименование организации

соответствует справочнику организаций

КПП клиента

КПП, 9 цифр

@kpp

KppType

*.1

Актуально

[0..1

с версии

]

ОКАТО клиента

ОКАТО, от 1 до

@okato

OkatoType

*.2

Актуально

11 цифр (иногда

[0..1

с версии

заполняется

]

нулём)

ИНН клиента

ИНН

@inn

InnType

*.3

Необходимо проверять, что поле заполнено

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

Актуально

или

[1]

с версии

физического

лица РФ, до 12

цифр

Наименование организации клиента (сокращенное

Простой тип

@orgName

xs:string [min: 1,

*.4

наименование - как в платежных руб. документах)

XML Schema

max: 160]

Актуально

Необходимо проверять, что:

[1]

с версии

поле заполнено,

указанной организации подключена

услуга «Поручение на покупку валютыª

ОКПО клиента

ОКПО, от 8 до

@okpo

OkpoType

*.5

Необходимо проверять, что:

10 цифр

Актуально

[0..1

поле заполнено

с версии

]

длина ОКПО может составлять 8 или 10

символов

ОГРН клиента

@orgOGRN

OgrnType

*.6

ОГРН, от 13 0

Изменено

[0..1]

до 15 цифр

в версии

*.7

@clientNameIntheGenitiv

Cокращенное наименование организации в

xs:string [min: 1,

Простой тип

Актуально

[0..1

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

max: 255]

XML Schema

с версии

]

*.8

@fullName

Полное наименование

xs:string [min: 1,

Простой тип

Актуально

[0..1

max: 500]

XML Schema

с версии

]

*.9

@internationalName

Наименование на иностранном языке (при

xs:string [min: 1,

Простой тип

Актуально

[0..1

наличии)

max: 500]

XML Schema

с версии

]

*.1

@opf

Наименование на иностранном языке (при

xs:string [min: 1,

Простой тип

Актуально

[0..1

наличии)

max: 255]

XML Schema

с версии

]

*.1

@datOGRN

Дата регистрации

xs:date

Простой тип

Актуально

[0..1

XML Schema

с версии

]

*.1

@orgAddress

Юридический адрес организации клиента

xs:string [min: 1,

Простой тип

Актуально

[0..1

max: 1024]

XML Schema

с версии

]

*.1

@resident

Резидентность организации по справочнику

xs:string [min: 1,

Простой тип

Актуально

[0..1

организаций

max: 255]

XML Schema

с версии

]

*.6

AuthPers

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

AuthPers

Актуально

[0..1

с версии

]

*.1

Name

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

xs:string

Простой тип

организации клиента

XML Schema

[0..1

Изменено

]

в версии

Необходимо проверять, что запись об

ответственном лице не пуста (содержит хоть

[1]

что-то кроме пробелов)

*.2

Telfax

Номер телефона, факса уполномоченного

xs:string

Простой тип

сотрудника организации клиента

XML Schema

[0..1

Изменено

]

в версии

Необходимо проверять, что запись о телефоне

ответственного лица не пуста (содержит хоть

[1]

что-то кроме пробелов)

*.3

Position

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

xs:string [min: 1,

Простой тип

Актуально

[0..1

организации клиента

max: 1024]

XML Schema

с версии

]

*.3

Trans

Сделка

CurrBuyTrans

Актуально

[1]

с версии

*.1

Acc

Расчетный счет списания средств на покупку

Актуально

валюты

[1]

с версии

*.1

@account

Номер счёта списания (р/с) обязателен для

AccNumType

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

заполнения

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

цифр

Проверять, что:

- что счет списания не пуст и не содержит одни

пробелы,

- счет имеет длину 20 символов;

- номер счета может содержать только цифры,

исключением является первый символ в коде

валюты счета (6 символ счета), который может

быть любой буквой или цифрой

Проверять, что если счет заполнен корректно,

Актуально

то счет принадлежит справочнику счетов +

[1]

с версии

организаций

Проверять, что если счет списания

принадлежит справочнику организаций, то он

не должен быть:

•

«Закрытª, и/или

•

«Заблокированª, и/или

•

«Разрешена обработка только выписок

по счетуª, и/или

•

«Не обслуживается ДБОª

Проверять, что счет списания обслуживается в

указанном подразделении

*.2

@bic

БИК банка счета списания рублей

BicType

БИК, 9 цифр

Актуально

[1]

с версии

*.3

BankName

Наименование подразделения банка

xs:string [max:

Простой тип

Актуально

160]

XML Schema

[1]

с версии

*.2

AmountTransf

Сумма покупки

Актуально

[1]

с версии

*.1

SumBuy

Сумма покупаемой валюты

CurrAmountType

Денежная сумма

с указанием

Проверять, что заполнено одно из полей

трёхчисленного

Актуально

«Сумма продаваемой валютыª или «Сумма

кода валюты

[1]

с версии

покупаемой валютыª

Необходимо проверять, что сумма не

отрицательная и не ноль

*.1

@docSum

Сумма

xs:decimal

Простой тип

Актуально

XML Schema

[1]

с версии

Формат XX.YY с точностью до сотых

*.2

@currCode

Цифровой код валюты

CurrCodeDigital

Код валюты, 3

Type

цифры либо

Поле должно быть заполнено

одна буква (A-

Необходимо проверять, что покупаемая

Z) и 2 цифры

Актуально

валюта не соответствует национальной валюте

[1]

с версии

Необходимо проверять, что код принадлежит

справочнику

Проверять, что валюта покупаемой и

продаваемой валюты не совпадают

*.3

@currIsoCode

ISO-код валюты

CurrCodeLetterT

Код валюты, 3

Актуально

[0..1

ype

буквы

с версии

]

*.2

SumThrough

за счет средств

CurrAmountType

Денежная сумма

Актуально

с указанием

[0..1

с версии

трёхчисленного

]

кода валюты

*.1

@docSum

Сумма

xs:decimal

Простой тип

Актуально

Формат XX.YY с точностью до сотых

XML Schema

[1]

с версии

*.2

@currCode

Цифровой код валюты

CurrCodeDigital

Код валюты, 3

Актуально

Type

цифры либо

[1]

с версии

одна буква (A-

Z) и 2 цифры

*.3

@currIsoCode

ISO-код валюты

CurrCodeLetterT

Код валюты, 3

Актуально

[0..1

ype

буквы

с версии

]

*.3

TermBuy

Условия покупки

TermDeal

Актуально

[0..1

с версии

Проверять, что выбрано одно из условий

]

покупки

*.1

DealType

Условия сделки: 2 - по курсу Банка России с

xs:string [1]

Простой тип

взыманием комиссионного вознаграждения, 1 - по

RegEx: "[0-

XML Schema

курсу Сбербанка России, 0 - на бирже на торговой

2]{1}"

сессии

С 30.09.2016 в рамках расчетно-кассового

Актуально

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

[0..1

с версии

конверсионных операций - исключается

]

возможность проведения конверсий по

биржевому курсу. При отправке данного

признака со значением «0ª из СББОЛ

возвращается ошибка "Ошибка реквизитов" с

причиной "Некорректно указано условие

сделки"

*.2

USD_EUR

0 - USD-RUB, 1 - EUR-RUB, 2- EUR-USD

xs:string [1]

Простой тип

Актуально

[0..1

RegEx: "[0-

XML Schema

с версии

Если операция не в долларах или евро, то признак

]

2]{1}"

отправлять не нужно

*.3

TOD_TOM

0 - TOD, 1 - TOM

xs:string

Простой тип

Актуально

[0..1

XML Schema

с версии

]

*.4

Rate

на бирже на тороговой сессии по курсу

Актуально

[0..1

с версии

]

*.1

@type

0 - по курсу не более, 1 - биржевой

xs:string

Простой тип

Актуально

XML Schema

[1]

с версии

*.2

@rate

Курс

xs:decimal

Простой тип

XML Schema

Формат XX.YY с точностью до сотых

Актуально

[0..1

с версии

Проверять, что если выбран чек «по курсуª, то

]

должен быть указан курс в поле «по курсу не

болееª

*.4

AccountNumTransf

Реквизиты счёта зачисления валюты

AccountCurr

Актуально

(тип расширен)

[1]

с версии

Проверять, что получатель задан

*.1

@accNum

Номер счёта зачисления валюты

AccNumType

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

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

Если выполняется:

цифр

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

значением

счет имеет длину 20 символов (без учета

маски)

номер счета может содержать только

цифры, исключением является первый символ

в коде валюты счета (6 символ счета), который

может быть любой буквой или цифрой

то проверять одно из:

если установлен флажок «на наш счет в

Сбербанке Россииª, то проверять, что счет

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

если выполняется, то проверять:

Актуально

•

Не «Закрытª, и/или

[1]

с версии

•

Не «Заблокированª, и/или

•

Не «Разрешена обработка только

выписок по счетуª, и/или

•

Не «Не обслуживается ДБОª

если установлен флажок «на счет в

другом банкеª, то проверять ключ

(стандартная проверка)

Необходимо проверять, что валюта счета

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

национальной валюте (810 (код валюты счета,

6-8 разряд), 643 (код валюты суммы))

Проверять, что если счет заполнен корректно и

он не транзитный, то валюта счета

соответствует одному из значений {036, 826, 974,

208, 840, 398

124, 428, 440, 578, 985, 702, 203, 752, 756, 392, 978}

*.2

Bank

Реквизиты банка зачисления валюты

AccCurrBank

Актуально

Необходимо проверять, что если отмечено «на

[1]

с версии

наш счет в Сбербанке Россииª, то поле БИК

банка зачисления заполнено не пустыми

символами

*.1

@bic

БИК банка зачисления валюты

BicType

БИК, 9 цифр

Необходимо проверять, что БИК банка

Актуально

[0..1

зачисления присутствует в справочнике БИК

с версии

]

РФ - если отмечено «на наш счет в Сбербанке

Россииª или справочнику SWIFT - если

отмечено «на счет в другом банкеª

*.2

@correspAcc

Коррсчёт банка зачисления валюты

xs:string

Простой тип

Актуально

[0..1

XML Schema

с версии

]

*.3

Name

Наименование банка зачисления валюты (либо в

xs:string [min: 1,

Простой тип

Актуально

соответствии с BNKSEEK либо наименование

max: 140]

XML Schema

[1]

с версии

отделения СБРФ)

*.4

BankSWIFT

SWIFT банка зачисления валюты

xs:string [min: 1,

Простой тип

Актуально

[0..1

max: 11]

XML Schema

с версии

]

*.5

BankInfo

Иные реквизиты банка зачисления валюты

xs:string [min: 1,

Простой тип

Актуально

[0..1

max: 255]

XML Schema

с версии

]

*.3

@type

0 - На наш счет в Сбербанке России, 1 - На счет в

xs:string

Простой тип

другом банке/ в других филиалах и отделениях

XML Schema

Сбербанка России

Актуально

если значение признака

[1]

с версии

Request/CurrBuy/Trans/AccountNumTransf/Bank

/type="1" , то нужно заполнить

Request/CurrBuy/Trans/AccountNumTransf/Bank

/BankSWIFT

*.1

@accNum

Номер счёта списания рублёвого покрытия

AccNumType

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

обязателен для заполнения

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

цифр

Если выполняется:

счет имеет длину 20 символов (без учета

маски)

номер счета может содержать только

цифры, исключением является первый символ

в коде валюты счета (6 символ счета), который

может быть любой буквой или цифрой

то проверять одно из:

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

счетов (проверять по счет + БИК), то

проверять:

Актуально

[1]

с версии

•

Не «Закрытª и/или

•

Не «Заблокированªи/или

•

Не «Разрешена обработка только

выписок по счетуª

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

счетов, то проверять ключ (стандартная

проверка)

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

корректно, то валюта счета списания

соответствует валюте суммы продажи (если

рубли, то 810)

Проверять, что если счет списания

принадлежит справочнику счетов (счет+БИК),

то он не должен быть транзитным

*.2

@bic

БИК

BicType

БИК, 9 цифр

Проверять, что если счет заполнен, то БИК

Параметр:

тоже заполнен (не состоит из одних пробелов)

044525225,0436

Проверять, что если БИК заполнен, то он

01607,04200768

содержит только цифры

1,040813608,044

525225,0425206

Проверять, что если БИК заполнен корректно,

07,040702660,04

то он принадлежит справочнику БИК РФ

5773603,042809

Актуально

Если реквизиты банка были заполнены из БИК

679,046614632,0

[1]

с версии

РФ (НЕ BRANCH), но проверять, что данные

42908612,04150

соответствуют справочнику БИК РФ

1601,046126614,

042520607,0464

Проверять, что если БИК заполнен корректно и

01642,04050760

принадлежит справочнику БИК РФ, то его

1,041012603,041

значение равно значению из набора в

403633,0420076

параметре

81,046850649,04

5402601,044206

604,043807606,0

42007681

*.3

BankName

Наименование банка из справочника БИК

xs:string [max:

Простой тип

Актуально

160]

XML Schema

[1]

с версии

*.2

RecAccount

Реквизиты счёта перечисления средств на покупку

AccountRub

Актуально

[0..1

с версии

]

*.1

choice:должен присутствовать один из перечисленных ниже элементов

Актуально

[1]

с версии

*.1

Account

Списание со счета

Актуально

[1]

с версии

*.1

@accNu

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

AccNumType

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

Актуально

(р/с) обязателен для заполнения

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

[1]

с версии

цифр

*.2

@bic

БИК банка счета списания рублей

BicType

БИК, 9 цифр

Актуально

[1]

с версии

*.3

BankNa

Наименование банка зачисления рублей из

xs:string [max:

Простой тип

Актуально

справочника БИК

160]

XML Schema

[1]

с версии

*.2

Doc

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

Актуально

[1]

с версии

@docTyp

*.1

Тип документа

xs:string [max:

Простой тип

30]

XML Schema

 Заполнять значением «Платежное поручение в

Актуально

рубляхª, если продаваемая валюта - рубли РФ

[1]

с версии

 Заполнять значением «Поручение на перевод

валютыª, если продаваемая валюта

- иная

валюта

*.2

@docNu

Номер документа

xs:string [max:

Простой тип

Актуально

15]

XML Schema

[1]

с версии

*.3

@docDat

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

xs:date

Простой тип

Актуально

XML Schema

[1]

с версии

*.2

@type

0 - Средства в продаваемой валюте списать со

xs:string

Простой тип

Актуально

счета 1 - Перечислены с нашего счета в Сбербанке

XML Schema

[1]

с версии

России 2 - Перечислены со счета в другом банке/ в

других филиалах и отделениях Сбербанка России

*.1

@accNum

Номер счёта списания комисс. вознаграждения

AccNumType

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

обязателен для заполнения

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

цифр

Если выполняется:

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

значением

счет имеет длину 20 символов (без учета

маски)

номер счета может содержать только

цифры, исключением является первый символ

в коде валюты счета (6 символ счета), который

может быть любой буквой или цифрой

Актуально

[1]

с версии

то проверять одно из:

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

счетов (проверять по счет+БИК), то проверять:

•

Не «Закрытª, иначе и/или

•

Не «Заблокированª, и/или

•

Не «Разрешена обработка только

выписок по счетуª и/или

•

«Не обслуживается ДБОª

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

счетов, то проверять ключ (стандартная

проверка)

*.2

@bic

БИК, заполняется значением справочника

BicType

БИК, 9 цифр

UpgRplDictionary/BicEntry/@bic

Актуально

Проверять, что БИК банка непустой и является

[1]

с версии

9-значным цифровым кодом

Проверять, что БИК банка должен

принадлежать BNKSEEK

*.3

BankName

Проверять, что наименование банка должно

xs:string [max:

Простой тип

Актуально

принадлежать BNKSEEK

160]

XML Schema

[1]

с версии

*.2

ComOrder

Реквизиты платёжного поручения, которым будет

ComOrder

Актуально

перечислено комиссионное вознаграждение

[1]

с версии

*.1

@numPayDoc

Номер платёжного поручения

xs:string [min: 1,

Простой тип

max: 15]

XML Schema

Актуально

Необходимо проверять, что если установлен

[1]

с версии

флажок «перечислением по платежному

поручениюª, то поля «Номер п/пª и «Дата п/пª

должны быть заполнены

*.2

@datePayDoc

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

xs:date

Простой тип

XML Schema

Актуально

Необходимо проверять, что если установлен

[1]

с версии

флажок «перечислением по платежному

поручениюª, то поля «Номер п/пª и «Дата п/пª

должны быть заполнены

*.3

@purposePayDoc

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

xs:string [min: 1,

Простой тип

Актуально

[0..1

max: 210]

XML Schema

с версии

]

*.4

BankAgreement

Соглашение с банком

xs:string [max:

Простой тип

Актуально

[0..1

3000]

XML Schema

с версии

]

*.5

AddInfo

Дополнительная информация

CurrBuyAddInfo

Простой тип

Актуально

[0..1

XML Schema

с версии

xs:string [min: 1,

]

max: 2000]

*.6

LinkedDocs

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

LinkedDocs

Связанные

Актуально

[0..1

поручение или валютный перевод

документы

с версии

]

*.1

LDoc

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

Актуально

[0..n

с версии

]

*.1

@type

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

xs:string [min: 1,

Простой тип

Актуально

[0..1

max: 50]

XML Schema

с версии

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

]

связанных документовª

*.2

@docExtId

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

UuidSeparated

UUID с

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

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

Изменено

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

[0..1

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

в версии

Набор из 32

]

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

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

ЗАПОЛНЕН @docId

[a-f] и дефисов

*.3

@docId

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

UuidSeparated

UUID с

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

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

Изменено

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

[0..1

ЗАПОЛНЕН @docExtId

в версии

Набор из 32

]

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

[a-f] и дефисов

*.4

Params

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

Params

Множество

Актуально

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

параметров

[0..1

с версии

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

]

вида

*.1

Param

Параметр

Param

Отдельный

Актуально

параметр

[1..n

с версии

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

]

вида

*.1

@name

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

xs:string [min: 1,

Простой тип

Актуально

max: 255]

XML Schema

[1]

с версии

Пример.

<Request xmlns='http://bssys.com/upg/request' orgId='ac24c9da-fbc1-4056-8550-cdd0c6fd5239'

requestId='d7f04699-a65b-4ffc-be05-d9c5ca41684b' version='01.002.02' sender='Ромашка'

receiver='SBBOL_DBO'>

<DocData docDate='2015-04-28' docNum='1014' bankName='ОПЕРУ Центрального

Аппарата Ромашки РФ'>

<OrgData kpp='775001001' okato='45286575000' inn='7710048970'

orgName='ЗАО "Ромашка КИБ"' okpo='11522828'/>

<Name>Петров Петр Петрович</Name>

</AuthPers>

</DocData>

<Trans>

<BankName>ОАО "СБЕРБАНК "</BankName>

</Acc>

</AmountTransf>

<TOD_TOM>0</TOD_TOM>

</TermBuy>

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

</Bank>

</AccountNumTransf>

<BankName>ОАО "СБЕРБАНК "</BankName>

</DocAccount>

</PayDocBuy>

<BankName>ОАО "СБЕРБАНК"</BankName>

</ComAcc>

</Commis>

</Trans>

</CurrBuy>

<Sign>

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