Сервис создания черновика заявления на открытие аккредитива
Обновлено 20 декабря 2023
Сервис создает черновик заявления на открытие внутрироссийского аккредитива, где плательщиком выступает юридическое лицо.
Для вызова сервиса потребуется получить токен доступа.
Получение токена доступа выполняется с помощью API Получение токена OAUTH. Перед тем, как использовать сервис API, необходимо отправить запрос на формирование токена авторизации.
После успешного формирования токена в ответном сообщении будет возвращен идентификатор токена, который необходимо указывать в заголовке Authorization в каждом запросе к API.
Токен нужно получать для каждого нового запроса к API. Срок жизни токена составляет 60 сек.
| Scope | auth://tradefin/lc-legal/application |
| Endpoint | https://mc.api.sberbank.ru/prod/tradefin/lc-legal/v1/application/open-domestic-lc |
| Method | POST |
| Request Body | Объект draftApplicationLc (Параметры создаваемого черновика на открытие аккредитива) |
| Request Parameters | - |
| Response | HTTP 201 ОК (Черновик заявления на открытие создан) |
| HTTP 400 Ошибка валидации запроса: \<Текст ошибки валидации> | |
| HTTP 400 Не найден банк: \<БИК из запроса>, \<кор. счет из запроса> | |
| HTTP 403 Данный вид расчета для вашей организации не доступен | |
| HTTP 403 Проверка токена не пройдена | |
| HTTP 500 Ошибка сервиса. Попробуйте еще раз, если ошибка повторяется, то обратитесь в службу поддержки. | |
| Response Parameters | Объект ApplicationLcBrief (Краткая информация по созданному черновику заявления на открытие аккредитива) |
Заголовки запроса
| Наименование заголовка | Описание | Обязательность поля |
|---|---|---|
| authorization | Токен авторизации, полученный в Токен OAUTH. В начало заголовка необходимо добавить строку «Bearer» с пробелом. | Да |
| RqUID | Уникальный идентификатор сообщения, pattern=([0-9]|[a-f]|[A-F]){32})», переданный во входящем сообщении. Необходим для журналирования входящих вызовов и удобства разбора инцидентов.Чтобы обеспечить уникальность, можно использовать стандартные библиотеки и классы для генерации UUID/GUID(см. UUID), убрав из результата разделители «-». | Да |
Тело запроса draftApplicationLc (Параметры создаваемого черновика на открытие аккредитива)
| Наименование | Обязательность | Тип | Описание |
|---|---|---|---|
| additionalConditions | нет | Строка (10000) | Дополнительные условия сделки |
| amount | да | Число (15.2) | Сумма аккредитива |
| currency | да | ENUM (RUB) | Валюта аккредитива |
| applicant | да | Объект ApplicantLegalParty | Плательщик |
| legalParty | да | Объект legalParty | Данные юридического лица |
| name | да | Строка (500) | Наименование юридического лица |
| inn | да | Строка (12) | ИНН |
| kpp | нет | Строка (9) | КПП юридического лица |
| ogrn | да | Строка (15) | ОГРН юридического лица или ОГРНИП для индивидуального предпринимателя |
| legalContactPersons | нет | Коллекция объектов ContactPerson | Контактные лица юридического лица |
| name | да | Строка (100) | ФИО контактного лица |
| contactDetails | да | Объект ContactDetails | Контакты |
| нет | Строка (100) | Email контактного лица | |
| phone | нет | Строка (17) | Телефон контактного лица |
| beneficiaryAccount | да | Строка (20) | Расчетный счет получателя |
| beneficiaryBankBic | да | Строка (9) | БИК банка получателя |
| beneficiaryBankCorrAccount | да | Строка (20) | Корреспондентский счет банка получателя |
| beneficiaryIndividualParty | нет | Объект IndividualParty | Получатель физическое лицо |
| fullName | да | Строка (100) | ФИО физического лица |
| contactDetails | нет | Объект ContactDetails | Контакты получателя физического лица |
| нет | Строка (100) | Email контактного лица | |
| phone | нет | Строка (17) | Телефон контактного лица |
| beneficiaryLegalParty | нет | Объект BeneficiaryLegalParty | Получатель юридическое лицо |
| legalParty | да | Объект LegalParty | Данные юридического лица |
| name | да | Строка (500) | Наименование юридического лица |
| inn | да | Строка (12) | ИНН |
| kpp | нет | Строка (9) | КПП юридического лица |
| ogrn | да | Строка (15) | ОГРН юридического лица или ОГРНИП для индивидуального предпринимателя |
| legalContactPerson | нет | Объект ContactPerson | Контактное лицо юридического лица |
| name | да | Строка (100) | ФИО контактного лица |
| contactDetails | да | Объект ContactDetails | Контакты |
| нет | Строка (500) | Email контактного лица | |
| phone | нет | Строка (17) | Телефон контактного лица |
| expiryDate | да | Дата | Дата истечения аккредитива |
| order | да | Строка (50) | Номер заказа, оплата по которому производится через аккредитив |
| orderLink | да | Строка (500) | Ссылка на заказ, оформленный на маркетплейсе через аккредитив. Отображается в интернет банке СберБизнес в заявлении на открытие аккредитива |
| partialUse | да | Логика | Признак допустимости частичного использован |
| saleContract | да | Объект SaleContract | Договор/контракт |
| number | нет | Строка (100) | Номер договора |
| date | нет | дата | Дата договора |
| name | нет | Строка (1000) | Наименование договора |
| description | да | Строка (10000) | Наименование товаров, работ, услуг |
| requiredDocumentType | да | ENUM (OTHER; MARKETPLACE_LETTER) | Тип требуемых документов для раскрытия аккредитива |
| requiredDocuments | нет | Строка (10000) | Требуемые документы, обязательно для заполнения если тип требуемых документов "Иной" |
| vatType | да | ENUM (TAX; NOT_TAX) | НДС |
Тело ответа applicationLcBrief (Краткая информация по созданному черновику заявления на открытие аккредитива)
| Наименование | Обязательность | Тип | Описание |
|---|---|---|---|
| applicationId | да | Строка (19) | Идентификатор созданного черновика заявления на открытие аккредитива Формат: \^\d+\$ |
| smsAuthorizationLink | да | Строка (500) | Идентификатор созданного черновика заявления на открытие аккредитива |
| tokenAuthorizationLink | да | Строка (500) | Идентификатор созданного черновика заявления на открытие аккредитива |
Пример запроса
POST https://mc.api.sberbank.ru/prod/tradefin/lc-legal/v1/application/open-domestic-lc
Authorization: Bearer 06c9e75a-d22e-4703-ba1e-b62961f6ed2a
Content-Type: application/json
RqUID: abacbd47b1443bde94ad202103221649
{
"amount": "200000",
"currency": "RUB",
"applicant": {
"legalContactPersons": [
{
"name": "Иванов Иван Иванович",
"contactDetails": {
"email": "ivaniv@primer.com",
"phone": "+79999999999"
}
}
],
"legalParty": {
"name": "ОАО Ромашка",
"inn": "5630020196",
"ogrn": "1105658002339",
"kpp": "563001001"
}
},
"additionalConditions": "Документы по аккредитиву могут быть представлены в электронном виде, в виде сканированных копий документов, указанных в поле «Перечень документов, представляемых Получателем, и требования к представляемым документам» с использованием системы дистанционного банковского обслуживания «Сбербанк Бизнес Онлайн». Допускается представление черно-белых сканированных копий документов, указанных в поле «Перечень документов, представляемых Получателем, и требования к представляемым документам».",
"beneficiaryAccount": "40802000000000000000",
"expiryDate": "2023-08-13",
"requiredDocuments": "1 (Один) оригинал или 1 (Одна) копия Счета на оплату, выписанного Получателем на имя Плательщика",
"saleContract": {
"number": "123-2022",
"date": "2022-04-13",
"name": "Контракт",
"description": "Поставка бетонно строительных смесей"
},
"vatType": "TAXED",
"beneficiaryLegalParty": {
"legalContactPerson": {
"name": "Иванов Иван Иванович",
"contactDetails": {
"email": "ivaniv@primer.com",
"phone": "+79999999999"
}
},
"legalParty": {
"name": "ОАО Ромашка",
"inn": "7707083894",
"ogrn": "1027700132195",
"kpp": "973643001"
}
},
"order": "1234",
"orderLink": "http://www.sberbank.ru/ru/s_m_business",
"partialUse": true,
"beneficiaryBankBic": "044525593",
"beneficiaryBankCorrAccount": "30101810200000000593",
"requiredDocumentType": "MARKETPLACE_LETTER"
}
Пример ответа
HTTP/1.1 201 Created
Server: nginx/1.22.1
Date: Tue, 23 May 2023 09:35:07 GMT
Content-Type: application/json
Content-Length: 439
Connection: keep-alive
X-Gravitee-Transaction-Id: 7962bd79-275b-4ed2-a2bd-79275b2ed285
X-Gravitee-Request-Id: 7962bd79-275b-4ed2-a2bd-79275b2ed285
X-Rate-Limit-Limit: 20
X-Rate-Limit-Remaining: 19
X-Rate-Limit-Reset: 1684834504512
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
{
"applicationId": "7837905369094423552",
"tokenAuthorizationLink": "http://localhost:000000/ic/dcb/index.html#/ufs/letters-of-credit/applications/list/applications-details/ISSUED_DOMESTIC_LC_ISSUE_APPLICATION/7837905369094423552",
"smsAuthorizationLink": "https://efs-test-web.testsbi.sberbank.ru:9443/ic/dcb/index.html#/ufs/letters-of-credit/applications/list/applications-details/ISSUED_DOMESTIC_LC_ISSUE_APPLICATION/7837905369094423552"
}