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

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

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

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

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

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

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

	Черновик	Входные параметры ( path )	Результат	Пример запроса/ответа
1	Документ на исполнение №1 (id=5136846156)	5136846156	HTTP200 статус документа на исполнение=DONE статус оплаты = PAID	Сценарий №1 (успешный)
2	Документ на исполнение №2 (id=8974615654 )	8974615654	HTTP200 статус документа на исполнение=DONE статус оплаты = NOT_PAID	Сценарий №2 (успешный)
3	любая другой id	любые данные отличные от перечисленных выше	HTTP404 Ошибка " Документ для исполнения {id} не найден "	Сценарий №3 (неуспешный HTTP404)

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

Запрос статуса документа на исполнение №1 (id= 5136846156)

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

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

GET https://mc.api.sberbank.ru/prod/tradefin/lc-legal/stub/v1/execution-lc-document/5136846156/status
Authorization: Bearer 65324987-d42a-4fe4-8c24-7a4585083f17
Content-Type: application/json
RqUID: c6da1b21f459433da289f5684dba5b67

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

HTTP/1.1 200 OK
Server: nginx/1.22.1
Date: Tue, 23 May 2023 09:41:16 GMT
Content-Type: application/json
Content-Length: 338
Connection: keep-alive
X-Gravitee-Transaction-Id: fe28d89b-937e-407a-a8d8-9b937e507aff
X-Gravitee-Request-Id: fe28d89b-937e-407a-a8d8-9b937e507aff
X-Rate-Limit-Limit: 20
X-Rate-Limit-Remaining: 19
X-Rate-Limit-Reset: 1684834877210
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
Accept-Ranges: bytes
  
{
    "status" : "DONE",
    "lastStatusChangeDateTime" : "2022-04-13T10:57:23.321+03:00",
    "paymentStatus" : "PAID"
  }

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

Запрос статуса документа на исполнение №2 (id=8974615654 )

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

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

GET https://mc.api.sberbank.ru/prod/tradefin/lc-legal/stub/v1/execution-lc-document/8974615654/status
Authorization: Bearer 65324987-d42a-4fe4-8c24-7a4585083f17
Content-Type: application/json
RqUID: c6da1b21f459433da289f5684dba5b67

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

HTTP/1.1 200 OK
Server: nginx/1.22.1
Date: Tue, 23 May 2023 09:41:16 GMT
Content-Type: application/json
Content-Length: 338
Connection: keep-alive
X-Gravitee-Transaction-Id: fe28d89b-937e-407a-a8d8-9b937e507aff
X-Gravitee-Request-Id: fe28d89b-937e-407a-a8d8-9b937e507aff
X-Rate-Limit-Limit: 20
X-Rate-Limit-Remaining: 19
X-Rate-Limit-Reset: 1684834877210
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
Accept-Ranges: bytes
  
{
    "status" : "DONE",
    "lastStatusChangeDateTime" : "2022-04-13T10:57:23.321+03:00",
    "rejectReason" : "Сумма требования не равна сумме аккредитива при запрещенном частичном использовании",
    "paymentStatus" : "NOT_PAID"
  }

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

Запрос статуса любого документа на исполнение отличного от и документа№1 (id= 5136846156 ) документа№2 (id=8974615654 )

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

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

GET https://mc.api.sberbank.ru/prod/tradefin/lc-legal/stub/v1/execution-lc-document/11111111111/status
Authorization: Bearer 65324987-d42a-4fe4-8c24-7a4585083f17
Content-Type: application/json
RqUID: c6da1b21f459433da289f5684dba5b67

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

HTTP/1.1 500 Internal Server Error
Server: nginx
Date: Wed, 23 Aug 2023 09:30:04 GMT
Content-Type: application/json
Content-Length: 195
Connection: keep-alive
X-Gravitee-Transaction-Id: 085a8120-fcb2-4ab9-9a81-20fcb29ab978
X-Gravitee-Request-Id: 085a8120-fcb2-4ab9-9a81-20fcb29ab978
X-Rate-Limit-Limit: 20
X-Rate-Limit-Remaining: 19
X-Rate-Limit-Reset: 1692782997574
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": "Ошибка сервиса. Попробуйте еще раз, если ошибка повторяется, то обратитесь в службу поддержки"
}