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

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

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

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

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

Заглушка сервиса Сервис создания черновика заявления на открытие аккредитива эмулирует сценарий создания черновика заявления на открытие аккредитива. В эмуляторе определен статичный набор значений ИНН, ОГРН и КПП организаций. При указании параметров из статичного набора в качестве реквизитов плательщика в запросе на создание черновика заявления на открытие аккредитива, заглушка будет возвращать указанный в таблице результат. Идентификатор созданного черновика через заглушку можно будет сохранить, и в последствии использовать в других заглушках API /tradefin/lc-legal/v1/.

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

	Плательщик	Входные параметры applicant.legalParty	Результат	Пример запроса/ответа
1	Организация1	ИНН=4343831135, ОГРН=2809682247999, КПП=717039050	HTTP201 Создан Черновик №1 id = 4097643769930881329	Сценарий №1 (успешный)
2	Организация2	ИНН=4100009910, ОГРН=3284510308992, КПП=550859856	HTTP201 Создан Черновик №2 id = 7882406596172428355	Сценарий №2 (успешный)
3	Организация3	ИНН=4086136512, ОГРН=8355738611210, КПП=748835440	HTTP201 Создан Черновик №3 id = 1814635534863026929	Сценарий №3 (успешный)
4	Организация4	ИНН=7847362569, ОГРН=8951537648955, КПП=551991494	HTTP403 Ошибка: "Данный вид расчета для вашей организации не доступен"	Сценарий №4 (неуспешный HTTP403)
5	любая другая	любые данные отличные от перечисленных выше	HTTP500 Ошибка: "Ошибка сервиса. Попробуйте еще раз, если ошибка повторяется, то обратитесь в службу поддержки"	Сценарий №5 (неуспешный HTTP500)

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

Создание черновика заявления на плательщика "Организация1" с ИНН=4343831135, ОГРН=2809682247999, КПП=717039050

Результат: HTTP201 + id созданного черновика №1 = 4097643769930881329

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

POST https://mc.api.sberbank.ru/prod/tradefin/lc-legal/stub/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": "Организация1",
      "inn": "4343831135",
      "ogrn": "2809682247999",
      "kpp": "717039050"
    }
  },
  "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": "OTHER"
}

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

HTTP/1.1 201 Created
Server: nginx
Date: Tue, 22 Aug 2023 12:06:30 GMT
Content-Type: application/json
Content-Length: 439
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
 
{
  "applicationId" : "4097643769930881329",
  "smsAuthorizationLink": "https://sbi.sberbank.ru:9443/ic/dcb/index.html#/ufs/letters-of-credit/applications/list/applications-details/ISSUED_DOMESTIC_LC_ISSUE_APPLICATION/4097643769930881329",
  "tokenAuthorizationLink": "http://localhost:28016/ic/dcb/index.html#/ufs/letters-of-credit/applications/list/applications-details/ISSUED_DOMESTIC_LC_ISSUE_APPLICATION/4097643769930881329"
}

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

Создание черновика заявления на плательщика "Организация2" с ИНН=4100009910, ОГРН=3284510308992, КПП=550859856

Результат: HTTP201 + id созданного черновика №2 = 7882406596172428355

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

POST https://mc.api.sberbank.ru/prod/tradefin/lc-legal/stub/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": "Организация2",
      "inn": "4100009910",
      "ogrn": "3284510308992",
      "kpp": "550859856"
    }
  },
  "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": "OTHER"
}

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

HTTP/1.1 201 Created
Server: nginx
Date: Tue, 22 Aug 2023 12:06:30 GMT
Content-Type: application/json
Content-Length: 439
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
 
{
  "applicationId" : "7882406596172428355",
  "smsAuthorizationLink": "https://sbi.sberbank.ru:9443/ic/dcb/index.html#/ufs/letters-of-credit/applications/list/applications-details/ISSUED_DOMESTIC_LC_ISSUE_APPLICATION/7882406596172428355",
  "tokenAuthorizationLink": "http://localhost:28016/ic/dcb/index.html#/ufs/letters-of-credit/applications/list/applications-details/ISSUED_DOMESTIC_LC_ISSUE_APPLICATION/7882406596172428355"
}

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

Создание черновика заявления на плательщика "Организация3" с ИНН=4086136512, ОГРН=8355738611210, КПП=748835440

Результат: HTTP201 + id созданного черновика №3 = 1814635534863026929

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

POST https://mc.api.sberbank.ru/prod/tradefin/lc-legal/stub/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": "Организация3",
      "inn": "4086136512",
      "ogrn": "8355738611210",
      "kpp": "748835440"
    }
  },
  "additionalConditions": "Документы по аккредитиву могут быть представлены в электронном виде, в виде сканированных копий документов, указанных в поле «Перечень документов, представляемых Получателем, и требования к представляемым документам» с использованием системы дистанционного банковского обслуживания «Сбербанк Бизнес Онлайн». Допускается представление черно-белых сканированных копий документов, указанных в поле «Перечень документов, представляемых Получателем, и требования к представляемым документам».",
  "beneficiaryAccount": "40802000000000000000",
  "expiryDate": "2023-08-13",
  "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"
}

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

POST https://mc.api.sberbank.ru/prod/tradefin/lc-legal/stub/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": "Организация3",
      "inn": "4086136512",
      "ogrn": "8355738611210",
      "kpp": "748835440"
    }
  },
  "additionalConditions": "Документы по аккредитиву могут быть представлены в электронном виде, в виде сканированных копий документов, указанных в поле «Перечень документов, представляемых Получателем, и требования к представляемым документам» с использованием системы дистанционного банковского обслуживания «Сбербанк Бизнес Онлайн». Допускается представление черно-белых сканированных копий документов, указанных в поле «Перечень документов, представляемых Получателем, и требования к представляемым документам».",
  "beneficiaryAccount": "40802000000000000000",
  "expiryDate": "2023-08-13",
  "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"
}

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

Создание черновика заявления на плательщика "Организация4" с ИНН=7847362569, ОГРН=8951537648955, КПП=551991494

Результат: HTTP403 +ошибка "Данный вид расчета для вашей организации не доступен"

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

POST https://mc.api.sberbank.ru/prod/tradefin/lc-legal/stub/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": "Организация4",
      "inn": "7847362569",
      "ogrn": "8951537648955",
      "kpp": "551991494"
    }
  },
  "additionalConditions": "Документы по аккредитиву могут быть представлены в электронном виде, в виде сканированных копий документов, указанных в поле «Перечень документов, представляемых Получателем, и требования к представляемым документам» с использованием системы дистанционного банковского обслуживания «Сбербанк Бизнес Онлайн». Допускается представление черно-белых сканированных копий документов, указанных в поле «Перечень документов, представляемых Получателем, и требования к представляемым документам».",
  "beneficiaryAccount": "40802000000000000000",
  "expiryDate": "2023-08-13",
  "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 403 Forbidden
Server: nginx
Date: Tue, 22 Aug 2023 12:06:30 GMT
Content-Type: application/json
Content-Length: 439
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": "Данный вид расчета для вашей организации не доступен"
}

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

Создание черновика заявления на плательщика отличного от "Организация1", "Организация2", "Организация3" и "Организация4"

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

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

GET https://mc.api.sberbank.ru/prod/tradefin/lc-legal/stub/v1/application/open-domestic-lc
Authorization: Bearer 5a9143e9-e39b-4130-958e-558524dc622a
Content-Type: application/json
RqUID: c6da1b21f459433da289f5684dba5b67

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

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": "Ошибка сервиса. Попробуйте еще раз, если ошибка повторяется, то обратитесь в службу поддержки"
}