Сервис создания документа на исполнение
Обновлено 20 декабря 2023
Сервис создает запрос на исполнение внутрироссийского аккредитива. Сервис доступен только Партнерам банка, которые являются получателями по данному аккредитиву.
Сервис получает сообщение, представляющее собой CMS-контейнер с подписанным запросом на исполнение и данными о сертификате подписанта, сохраняет его и возвращает идентификатор созданного в банковской системе документа на исполнение.
Потребителю необходимо сгенерировать JSON документ по указанному ниже формату, затем его подписать УКЭП (например, при помощи КриптоПро) в режиме прикрепленной подписи (attached signature).
После подписания потребитель должен получить CMS-контейнер (см. RFC 5652), содержащий:
Электронный документ
Сертификат подписанта
Подпись
Полученный файл (CMS-контейнер) кодируется в base64 (см. Base64) и на выходе получается строка, которую нужно передать в теле запроса.
Для вызова сервиса потребуется получить токен доступа.
Получение токена доступа выполняется с помощью API Получение токена OAUTH. Перед тем, как использовать сервис API, необходимо отправить запрос на формирование токена авторизации.
После успешного формирования токена в ответном сообщении будет возвращен идентификатор токена, который необходимо указывать в заголовке Authorization в каждом запросе к API.
Токен нужно получать для каждого нового запроса к API. Срок жизни токена составляет 60 сек.
| Scope | auth://tradefin/lc-legal/lc |
| Endpoint | https://mc.api.sberbank.ru/prod/tradefin/lc-legal/v1/execution-lc-document |
| Method | POST |
| Request Body | строка : CMS-контейнер в base64 кодировке (см RFC 5652) CMS контейнер должен обязательно содержать: Электронный документ сформированный по JSON-схеме объекта executionLcDocument (Запрос на исполнение аккредитива) Сертификат подписанта Подпись |
| Request Parameters | - |
| Response | HTTP 201 ОК + Location: /{id} где id – идентификатор созданного документа |
| HTTP 403 Проверка токена не пройдена | |
| HTTP 403 У подписанта нет полномочий на подписание данного типа документа в системе | |
| HTTP 422 Некорректный набор данных | |
| HTTP 451 Не пройдена проверка электронной подписи или сертификат отозван | |
| HTTP 500 Ошибка сервиса. Обратитесь в службу поддержки. | |
| HTTP 500 Внутренняя ошибка сервиса. Обратитесь в поддержку или попробуйте повторить запрос позднее | |
| Response Parameters | Location: {id} где id – идентификатор созданного документа |
Объект executionLcDocument (Запрос на исполнение аккредитива)
| Наименование | Обязательность | Тип | Описание |
|---|---|---|---|
| reference | да | Строка (50) | Референс сделки |
| amount | да | Число (15.2) | Сумма аккредитива |
| currency | да | ENUM (RUB) | Валюта аккредитива |
| applicantName | да | Строка (500) | Наименование плательщика |
| applicantInn | да | Строка (12) | ИНН плательщика |
| beneficiaryName | да | Строка (500) | Наименование получателя |
| beneficiaryInn | да | Строка (12) | ИНН получателя. Для ЮЛ обязателен |
| issueDate | да | Дата | Дата открытия аккредитива |
Пример executionLcDocument
{
"amount": "1001.00",
"reference": "HG000192T01",
"applicantName": "ИП Иван Петрович Ленин",
"applicantInn": "123456789012",
"beneficiaryName": "ОАО Ромашка",
"beneficiaryInn": "1234567890",
"issueDate": "2023-04-24",
"currency": "RUB"
}
Пример запроса
POST https://mc.api.sberbank.ru/prod/tradefin/lc-legal/v1/execution-lc-document
Authorization: Bearer 9097af9b-4b8d-425b-8395-7f1ea9979aeb
Content-Type: application/cms
RqUID: aaab565555553b123455552103226123
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
Пример ответа
Обновлено 20 декабря 2023
HTTP/1.1 201 Created
Server: nginx/1.22.1
Date: Mon, 29 May 2023 05:21:04 GMT
Content-Length: 0
Connection: keep-alive
X-Gravitee-Transaction-Id: 75648cc8-8c26-4670-a48c-c88c269670d5
X-Gravitee-Request-Id: 75648cc8-8c26-4670-a48c-c88c269670d5
X-Rate-Limit-Limit: 20
X-Rate-Limit-Remaining: 19
X-Rate-Limit-Reset: 1685337660297
location: /execution-lc-document/7842126162363942912
x-content-type-options: nosniff
x-xss-protection: 1; mode=block
cache-control: no-cache, no-store, max-age=0, must-revalidate
pragma: no-cache
expires: 0
strict-transport-security: max-age=31536000 ; includeSubDomains
x-frame-options: DENY
<Response body is empty>