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

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

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

Сервис для получения детальной информации по аккредитиву. Данный сервис доступен только Партнерам банка, которые являются получателями или плательщиками по данному аккредитиву.

Для вызова сервиса потребуется получить токен доступа.

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

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

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

Scopeauth://tradefin/lc-legal/lc
Endpointhttps://mc.api.sberbank.ru/prod/tradefin/lc-legal/v1/lc/{reference}
MethodGET
Request Body-
Request Parameterspath: reference, где reference - Референс аккредитива
ResponseHTTP 200 ОК
HTTP 404 Аккредитив с \<референс аккредитива> не найден
HTTP 403 Проверка токена не пройдена
HTTP 500 Внутренняя ошибка сервиса. Обратитесь в поддержку или попробуйте повторить запрос позднее
Response ParametersОбъект lcLegal (Параметры аккредитива)

Заголовки запроса

Наименование заголовкаОписаниеОбязательность поля
authorizationТокен авторизации, полученный в Токен OAUTH. В начало заголовка необходимо добавить строку «Bearer» с пробелом.Да
RqUIDУникальный идентификатор сообщения, pattern=([0-9]|[a-f]|[A-F]){32})», переданный во входящем сообщении. Необходим для журналирования входящих вызовов и удобства разбора инцидентов.Чтобы обеспечить уникальность, можно использовать стандартные библиотеки и классы для генерации UUID/GUID(см. UUID), убрав из результата разделители «-».Да
НаименованиеОбязательностьТипОписание
referenceнетСтрока (50)Референс сделки открытой по заявлению. Передается только по заявлениям в статусе Исполнено
issueDateнетДатаДата открытия аккредитива
expiryDateдаДатаДата истечения аккредитива
applicantNameдаСтрока (500)Наименование плательщика
applicantInnдаСтрока (12)ИНН плательщика
beneficiaryNameдаСтрока (500)Наименование получателя
beneficiaryInnдаСтрока (12)ИНН получателя
closeDateнетДатаДата закрытия аккредитива
statusдаENUM ( ACTIVE , CLOSED )Статус аккредитива
ACTIVE - Действующий
CLOSED - Закрыт
amountдаЧисло (19,2)Сумма аккредитива
currencyдаENUM (RUB)Валюта аккредитива
availableAmountдаЧисло (19,2)Остаток по аккредитиву
availableAmountC urrencyдаENUM (RUB)Валюта остатка по аккредитиву

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

GET https://mc.api.sberbank.ru/prod/tradefin/lc-legal/v1/lc/ROP220000053
Authorization: Bearer 9e783f18-6480-44fe-833b-f316db17ab5c
Content-Type: application/json
RqUID: c6da1b21f459433da289f5684dba5b67

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

HTTP/1.1 200 OK
Server: nginx/1.22.1
Date: Mon, 29 May 2023 05:01:45 GMT
Content-Type: application/json
Content-Length: 470
Connection: keep-alive
X-Gravitee-Transaction-Id: 72e8e880-729b-4d43-a8e8-80729b0d43f4
X-Gravitee-Request-Id: 72e8e880-729b-4d43-a8e8-80729b0d43f4
X-Rate-Limit-Limit: 20
X-Rate-Limit-Remaining: 19
X-Rate-Limit-Reset: 1685336505571
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

{
"amount": "20000",
"currency": "RUB",
"status": "ACTIVE",
"reference": "ROP220000053",
"applicantInn": "5630020111",
"applicantName": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"Ромашка - Т\"",
"availableAmount": "2",
"availableAmountCurrency": "RUB",
"beneficiaryInn": "7716763111",
"beneficiaryName": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"Лютик",
"expiryDate": "2025-07-18",
"issueDate": "2022-11-01"
}
ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей.
Вы можете запретить сохранение cookie в настройках своего браузера.