ym88659208ym87991671
Заглушка сервиса получения параметров аккредитива | Документация для разработчиков

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

Обновлено 20 декабря 2023

Для вызова заглушки потребуется получить токен доступа. Получение токена доступа выполняется с помощью API Получение токена OAUTH. Перед тем, как использовать заглушку API, необходимо отправить запрос на формирование токена авторизации.

После успешного формирования токена в ответном сообщении будет возвращен идентификатор токена, который необходимо указывать в заголовке Authorization в каждом запросе к API.

Токен нужно получать для каждого нового запроса к заглушке API. Срок жизни токена составляет 60 сек.

Заглушка сервиса Сервис получения параметров аккредитива эмулирует сценарий получения информации по аккредитиву открытому из подписанного черновика заявления, полученного от площадки потребителя. При получении статусов черновиков заявлений через эмулятор, по некоторым черновикам был возвращен статичный номер значений референсов открытых аккредитивов. При отправке в эмулятор значений этого статичного набора заглушкой будет возвращен результат указанный таблице. Возвращенные параметры аккредитива не будут соответствовать указанным в черновике отправленном в эмулятор, они будут всегда статичны. Заглушка не проверяет требование, что сервис "Сервис получения параметров аккредитива" доступен только Партнерам банка.

Статичный набор значений:

Референс аккредитиваВходные параметры pathРезультатПример запроса/ответа
1Референс№1REF012345HTTP200 Предоставлены данные по аккредитивуСценарий №1 (успешный)
2Референс№2REF987654HTTP500 Ошибка "Ошибка сервиса. Попробуйте еще раз, если ошибка повторяется, то обратитесь в службу поддержки"Сценарий №2 (неуспешный HTTP500)
3любой другойлюбые данные отличные от перечисленных вышеHTTP404 Ошибка: "Аккредитив с {указанный на входе референс} не найден"Сценарий №3 (неуспешный HTTP404)

Сценарий №1 (успешный)

Получение параметров открытого ранее аккредитива с Референс№1=REF012345

Результат: HTTP200 + параметры аккредитива

Пример запроса

GET https://mc.api.sberbank.ru/prod/tradefin/lc-legal/stub/v1/lc/REF012345
Authorization: Bearer 06c9e75a-d22e-4703-ba1e-b62961f6ed2a
Content-Type: application/json
RqUID: abacbd47b1443bde94ad202103221649

Пример ответа:

HTTP/1.1 200 OK
Server: nginx
Date: Tue, 22 Aug 2023 12:06:30 GMT
Content-Type: application/json
Content-Length: 378
Connection: keep-alive
X-Gravitee-Transaction-Id: 8916fbae-0929-4f2f-96fb-ae0929af2fea
X-Gravitee-Request-Id: 8916fbae-0929-4f2f-96fb-ae0929af2fea
X-Rate-Limit-Limit: 20
X-Rate-Limit-Remaining: 19
X-Rate-Limit-Reset: 1692705989869
cache-control: no-cache, no-store, max-age=0, must-revalidate
pragma: no-cache
expires: 0
Allow: GET, POST, HEAD
X-Frame-Options: DENY
X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000 ; includeSubDomains
Strict-Transport-Security: max-age=31536000; includeSubDomains
Allow: GET, POST, HEAD
X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000; includeSubDomains

{
"amount": "200000.00",
"currency": "RUB",
"status": "ACTIVE",
"reference": "REF012345",
"applicantInn": "4343831135",
"applicantName": "Организация1",
"availableAmount": "100000.00",
"availableAmountCurrency": "RUB",
"beneficiaryInn": "7707083894",
"beneficiaryName": "ОАО Ромашка",
"expiryDate": "2029-04-13T10:57:23.321+03:00",
"issueDate": "2023-04-13T10:57:23.321+03:00"
}

Сценарий №2 (неуспешный HTTP500)

Получение параметров открытого ранее аккредитива с Референс№2=REF987654

Результат: HTTP500 + Ошибка "Ошибка сервиса. Попробуйте еще раз, если ошибка повторяется, то обратитесь в службу поддержки"

Пример запроса

GET https://mc.api.sberbank.ru/prod/tradefin/lc-legal/stub/v1/lc/REF987654
Authorization: Bearer 06c9e75a-d22e-4703-ba1e-b62961f6ed2a
Content-Type: application/json
RqUID: abacbd47b1443bde94ad202103221649

Пример ответа:

HTTP/1.1 500 Internal Server Error
Server: nginx
Date: Tue, 22 Aug 2023 11:57:14 GMT
Content-Type: application/json
Content-Length: 195
Connection: keep-alive
X-Gravitee-Transaction-Id: 7242a0b4-712f-44e8-82a0-b4712fa4e883
X-Gravitee-Request-Id: 7242a0b4-712f-44e8-82a0-b4712fa4e883
X-Rate-Limit-Limit: 20
X-Rate-Limit-Remaining: 19
X-Rate-Limit-Reset: 1692705426793
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
x-frame-options: DENY
Allow: GET, POST, HEAD, PUT, DELETE, CONNECT, OPTIONS, PATCH
Allow: GET, POST, HEAD
Strict-Transport-Security: max-age=31536000 ; includeSubDomains
Strict-Transport-Security: max-age=31536000; includeSubDomains
Strict-Transport-Security: max-age=31536000; includeSubDomains
Allow: GET, POST, HEAD
Strict-Transport-Security: max-age=31536000; includeSubDomains

{
"errorMessage": "Ошибка сервиса. Попробуйте еще раз, если ошибка повторяется, то обратитесь в службу поддержки"
}

Сценарий №3 (неуспешный HTTP404)

Получение параметров аккредитива с референсом отличным от Референс№1 и Референс№2

Результат: HTTP404 + ошибка "Аккредитив с {указанный на входе референс} не найден"

Пример запроса

GET https://mc.api.sberbank.ru/prod/tradefin/lc-legal/stub/v1/lc/REF000001
Authorization: Bearer 06c9e75a-d22e-4703-ba1e-b62961f6ed2a
Content-Type: application/json
RqUID: abacbd47b1443bde94ad202103221649

Пример ответа:

HTTP/1.1 404 Not Found
Server: nginx
Date: Tue, 22 Aug 2023 12:06:30 GMT
Content-Type: application/json
Content-Length: 50
Connection: keep-alive
X-Gravitee-Transaction-Id: 8916fbae-0929-4f2f-96fb-ae0929af2fea
X-Gravitee-Request-Id: 8916fbae-0929-4f2f-96fb-ae0929af2fea
X-Rate-Limit-Limit: 20
X-Rate-Limit-Remaining: 19
X-Rate-Limit-Reset: 1692705989869
cache-control: no-cache, no-store, max-age=0, must-revalidate
pragma: no-cache
expires: 0
Allow: GET, POST, HEAD
X-Frame-Options: DENY
X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000 ; includeSubDomains
Strict-Transport-Security: max-age=31536000; includeSubDomains
Allow: GET, POST, HEAD
X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000; includeSubDomains

{
"errorMessage": "Аккредитив с REF000001 не найден"
}
ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей.
Вы можете запретить сохранение cookie в настройках своего браузера.