Заявление на страхование экспортного контракта

Сценарий заявление на страхование экспортного контракта

Для обращения к ресурсу необходимо отправлять запрос на:

Полчение заявления

Ресурс /v1/export-contract-insure/{externalId} позволяет получить заявление на страхование экспортного контракта для того, чтобы получить реквизиты созданного Клиентом документа в СББОЛ.

Шаги

1. Получить AccessToken.

2. Отправить запрос.

Для получения реквизитов по заявлению на страхование экспортного контракта необходимо отправить GET-запрос (/v1/export-contract-insure/{externalId}), в котором передать авторизационный токен к данным организации-клиента (Access Token) и идентификатор заявления. Авторизационный токен передается в параметре Authorization заголовка запроса.

Чтобы получить доступ к ресурсу, необходимо передать в scope сервис EXPORT_CONTRACT_INSURE.

Модель запроса

Header Parameters Описание
Authorization String
Access token организации-клиента, полученный через SSO.
Пример: Bearer c76fb018-27c9-43f7-a751-62646eda7e1a-1
Query Parameters Описание
externalId String
Идентификатор документа заявления, полученный из СББОЛ
Пример: 550e8400-e29b-41d4-a716-446655440000

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

curl -X GET --header 'Accept: application/json' --header

'Authorization: Bearer c76fb018-27c9-43f7-a751-62646eda7e1a-1'

' https://edupirfintech.sberbank.ru:9443 /v1/export-contract-insure?

externalId=22a6dd81-103a-4d3a-8e9b-0ba4b527f5f6'

Модель ответа

ExportContractInsure {
annualRevenue (number) Годовая выручка ,
bankComment (string, optional) Банковский комментарий к статусу заявления на страхование ,
bankStatus (string) Статус заявления на страхование ,
buyerAddress (string, optional) Покупатель. Адрес местонахождения ,
buyerCompanySite (string, optional) Покупатель. Сайт компании ,
buyerCooperationExperienceType (integer, optional) Покупатель. Наличие совместного опыта сотрудничества. 1 - Да, контракты действуют, 2 - Да, контракты исполнены, 3 - Нет. = ['1', '2', '3'],
buyerCountEmployeesType (integer, optional) Покупатель. Количество сотрудников в штате: 1 - Менее 10, 2 - От 10 (включительно) до 50, 3 - От 50 (включительно) = ['1', '2', '3'],
buyerCountry (string, optional) Покупатель. Страна регистрации ,
buyerIsLegalEntityMore2Y (boolean, optional) Покупатель. Является юридическим лицом, деятельность которого осуществляется более 2х лет с даты регистрации ,
buyerMainActivity (string, optional) Покупатель. Основной вид деятельности ,
buyerName (string, optional) Покупатель. Наименование ,
buyerRegNumber (string, optional) Покупатель. Регистрационный номер ,
contactEmail (string, optional) Экспортёр. Контактная информация. Электронная почта ,
contactFullname (string, optional) Экспортёр. Контактная информация. ФИО контактного лица ,
contactPhoneNumber (string, optional) Экспортёр. Контактная информация. Номер телефона ,
contactPosition (string, optional) Экспортёр. Контактная информация. Должность ,
contractDestinationCountry (string, optional) Страна назначения экспорта ,
contractEnsuringName (string, optional) Наименование обеспечения, если выбран тип Иное. ,
contractEnsuringType (integer, optional) Вид обеспечения (1 - Поручительство, 2 - Залог, 3 - Банковская гарантия, 4 - Аккредитив, 5 - Иное, 6 - Без обеспечения) = ['1', '2', '3', '4', '5', '6'],
contractExportSubject (string, optional) Предмет экспорта ,
contractIsEqualBuyerCountryPlace (boolean, optional) Страна назначения экспорта совпадает со страной местонахождения покупателя,
contractIsRussianGoods (boolean, optional) Предмет экспорта - российские товары (работы, услуги, в т.ч. Результаты интеллектуальной деятельности) ,
contractNotDefinedInkoterms (boolean, optional) Сделка. Базисные условия поставки еще не определены ,
contractNotProvidedInInkoterms (boolean, optional) Сделка. Инкотермс не предусмотрен в экспортном контракте ,
contractPeriodFrom (string, optional) Период отгрузок. Дата начала ,
contractPeriodTo (string, optional) Период отгрузок. Дата окончания ,
contracts (Array[Contract], optional) Контракты ,
deferredPayL90D (boolean, optional) Отсрочка платежа по указанным экспортным контрактам менее (либо равна) 90 календарных дней ,
digestSignatures (Array[Signature], optional) Электронные подписи по дайджесту документа ,
docDate (string) Дата документа ,
exportTypes (Array[ExportType], optional) Виды экспорта ,
exporterAccount (string, optional) Экспортёр. Расчетный счет ,
exporterChDelayCountType (integer, optional) Экспортёр. Кредитная история. Просрочки.
1 - Не имеется, 2 - Менее 5 календарных дней, 3 - От 5 (включительно) до 10 календарных дней, 4 - От 11 календарных дней = ['1', '2', '3', '4'],
exporterCompanySite (string, optional) Экспортёр. Сайт компании ,
exporterExecutiveBirthdate (string, optional) Экспортёр. Дата рождения ЕИО ,
exporterExecutiveBirthplace (string, optional) Экспортёр. Место рождения ЕИО ,
exporterExecutiveFullname (string, optional) Экспортёр. ФИО ЕИО ,
exporterExecutiveStartDate (string, optional) Экспортёр. Дата вступления в должность ЕИО ,
exporterFullname (string, optional) Экспортёр. Полное наименование ,
exporterHasExpExperienceType (integer, optional) Экспортёр. Наличие опыта экспорта у компании. 0 - Не имеется, 1 - Имеется = ['0', '1'],
exporterInn (string, optional) Экспортёр. ИНН ,
exporterIsBeneficarOwnerFp (boolean, optional) Экспортёр. Бенефициарный владелец является ФЛ ,
exporterMainActivity (string, optional) Экспортёр. Основной вид деятельности ,
exporterMainActivityClient (string, optional) Экспортёр. Основной вид деятельности, заполненный клиентом ,
exporterOgrn (string, optional) Экспортёр. ОГРН ,
exporterRegDate (string, optional) Экспортёр. Дата регистрации юридического лица ,
externalId (string) Идентификатор документа, присвоенный партнером ,
hasBuyerDebtToTheInsure (boolean, optional) На дату заявления на страхование у покупателя отсутствует задолженность перед страхователем ,
inkotermsConditions (Array[InkotermsCondition], optional) Условия Инкотермс ,
insuranceCost (number) Страховая стоимость ,
insuranceCoverage (number) Сумма страхового покрытия ,
offerConsent (boolean, optional) Согласие с условиями оферты ,
owners (Array[Owner], optional) Бенефициарные владельцы
}
Contract {
bankName (string, optional) Наименование банка ,
contractDate (string, optional) Дата контракта ,
contractNumber (string) Номер контракта
}
Signature {
base64Encoded (string) Значение электронной подписи, закодированное в Base64 ,
certificateUuid (string) Уникальный идентификатор сертификата ключа проверки электронной подписи (UUID)
}
ExportType {
isExportRusGoodsNoReimport (boolean, optional),
isGrantIntellectualActivity (boolean) Предоставление иностранному юридическому лицу прав использования российских результатов интеллектуальной деятельности ,
isImplRusOutServices (boolean) Осуществление российских работ (услуг) для иностранных юридических лиц за пределами РФ ,
isImplRusOutServicesToResult (boolean) Осуществление российских работ (услуг) для использования результата выполнения работ или оказания услуг за пределами РФ
}
InkotermsCondition {
code (string) Код условия Инкотермс
}
Owner {
age (integer) Возраст бенефициарного владельца
}

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

{
   "annualRevenue":1.01,
   "bankComment":"Текст комментария",
   "bankStatus":"REFUSED",
   "buyerAddress":"Baker Street, London",
   "buyerCompanySite":"https://example.com",
   "buyerCooperationExperienceType":1,
   "buyerCountEmployeesType":1,
   "buyerCountry":"Англия",
   "buyerIsLegalEntityMore2Y":true,
   "buyerMainActivity":"Производство мебели",
   "buyerName":"Example LTD",
   "buyerRegNumber":"12348765",
   "contactEmail":"address@email.ru",
   "contactFullname":"Иванов Иван Иванович",
   "contactPhoneNumber":"7916*****88",
   "contactPosition":"Менеджер",
   "contractDestinationCountry":"Австралия",
   "contractEnsuringName":"Обеспечение",
   "contractEnsuringType":2,
   "contractExportSubject":"Мебельные изделия",
   "contractIsEqualBuyerCountryPlace":true,
   "contractIsRussianGoods":true,
   "contractNotDefinedInkoterms":true,
   "contractNotProvidedInInkoterms":true,
   "contractPeriodFrom":"2018-12-31",
   "contractPeriodTo":"2018-12-31",
   "contracts":[
      {
         "bankName":"ПАО СБЕРБАНК",
         "contractDate":"2018-12-31",
         "contractNumber":"8981272"
      }
   ],
   "deferredPayL90D":true,
   "digestSignatures":[
      {
         "base64Encoded":"HlaeIHXXEcGT1bFxo1NlpAzpr+kJ2IQrcxVdvDTep6xjsmD1FDb+6NIyLT+/T24S0mPfVCU75sieOMt71TBS7w==",
         "certificateUuid":"22a6dd81-103a-4d3a-8e9b-0ba4b527f5f6"
      }
   ],
   "docDate":"2018-12-31",
   "exportTypes":[
      {
         "isExportRusGoodsNoReimport":true,
         "isGrantIntellectualActivity":true,
         "isImplRusOutServices":false,
         "isImplRusOutServicesToResult":false
      }
   ],
   "exporterAccount":"40802840600000200000",
   "exporterChDelayCountType":3,
   "exporterCompanySite":"https://example.com",
   "exporterExecutiveBirthdate":"2018-12-31",
   "exporterExecutiveBirthplace":"Сейшеллы 1003/2",
   "exporterExecutiveFullname":"Иванов Иван Иванович",
   "exporterExecutiveStartDate":"2018-12-31",
   "exporterFullname":"ООО \"Организация\"",
   "exporterHasExpExperienceType":1,
   "exporterInn":"7707083893",
   "exporterIsBeneficarOwnerFp":true,
   "exporterMainActivity":"Производство мебели",
   "exporterMainActivityClient":"Деятельность в области связи на базе проводных технологий",
   "exporterOgrn":"380123456789012",
   "exporterRegDate":"2018-12-31",
   "externalId":"22a6dd81-103a-4d3a-8e9b-0ba4b527f5f6",
   "hasBuyerDebtToTheInsure":true,
   "inkotermsConditions":[
      {
         "code":"EXW"
      }
   ],
   "insuranceCost":1.01,
   "insuranceCoverage":1.01,
   "offerConsent":true,
   "owners":[
      {
         "age":40
      }
   ]
}

Смена статуса заявления

Ресурс /v1/export-contract-insure/{externalId}/change-state позволяет сменить статус заявления на страхование экспортного контракта для того, чтобы передать решение о согласовании или отклонении заявления, полученное от клиента.

Шаги

1. Получить AccessToken.

2. Отправить запрос.

Для смены статуса заявления экспортного контракта необходимо отправить POST-запрос (/v1/export-contract-insure/{externalId}/change-state), в котором передать авторизационный токен к данным организации-клиента (Access Token), идентификатор заявления и запрос на смену статуса. Авторизационный токен передается в параметре Authorization заголовка запроса.

Чтобы получить доступ к ресурсу, необходимо передать в scope сервис EXPORT_CONTRACT_INSURE.

Модель запроса

Header Parameters Описание
Authorization String
Access token организации-клиента, полученный через SSO.
Пример: Bearer c76fb018-27c9-43f7-a751-62646eda7e1a-1
Query Parameters Описание
externalId String
Идентификатор документа заявления, полученный из СББОЛ
Пример: 550e8400-e29b-41d4-a716-446655440000
Body Описание
ExportContractInsureState {
fileId (string, optional) Идентификатор файла, который необходимо прилинковать к заявлению на страхование ,
statusComment (string, optional) Текстовый комментарий к статусу/Причина отказа ,
statusName (string) Наименование статуса = [RECEIVED_EKSAR, REFUSED, WAITING_FOR_PAY, POLICE_ACTIVATED]
}

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

{

“statusName”: RECEIVED_EKSAR

“statusComment”: некорректные условия сделки на экспорт

“fileId”: 00000000000000000000000000000000000000

}

Модель ответа

DocStateShort {
bankComment (string, optional, read only): Банковский комментарий к статусу документа ,
bankStatus (string, optional): Статус документа

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

{

"bankComment": "string",

"bankStatus": "string"

}

Наименование статуса

Статус Событие Пояснение
RECEIVED_EKSAR Партнёр успешно получил данные заяви по GET сервису
REFUSED Партнёр принял отрицательное решение по заявке (отказ) Статус REFUSED является конечным, он не может смениться на какой-либо другой
WAITING_FOR_PAY Партнёр принял положительное решение по заявке (полис сформирован, ожидается оплата) Когда для заявления на страхование приходит статус WAITING_FOR_PAY, то поле fileId должно быть обязательно заполнено. В противном случае поле fileId должно оставаться пустым
POLICE_ACTIVATED Партнёр получил денежные средства, полис вступил в силу Статус POLICE_ACTIVATED является конечным, он не может смениться на какой-либо другой

Коды возврата

Код возврата Описание кода возврата Причина возникновения
200 (GET-запроса) OK
201 (POST-запрос) CREATED
Создан
400 DESERIALIZATION_FAULT
Неверный формат запроса Неверный формат запроса
VALIDATION_FAULT
Ошибка валидации Ошибка валидации данных запроса с указанием некорректных значений. Значения полей модели или параметров запроса не соответствуют допустимым и определенным в модели.
401 UNAUTHORIZED
accessToken not found by value =хххххххх-хххх-хххх-хххх-хххххххххххх-х Указан некорректный или просроченный access_token.
403 ACTION_ACCESS_EXCEPTION
Операция не может быть выполнена: доступ к ресурсу запрещен У пользователя нет прав на использование соответствующего сервиса SberBusinessAPI, доступ к которому не предусмотрен настройками scope; У пользователя отсутствует оферта с внешним сервисом.
404 NOT_FOUND
Документ с указанным ID не найден Невозможно найти документ с указанным внешним идентификатором.
415 JWS_EXCEPTED
В соответствии с текущими настройками сервиса с clientId=%s необходимо использовать запрос в формате JWS Compact Serialization Ошибка возникает, если в настройках внешних сервисов выставлен флаг «Требуется подпись для внешнего сервиса»
500 UNKNOWN_EXCEPTION
Внутренняя ошибка сервера
503 UNAVAILABLE_RESOURCE_EXCEPTION
Сервис временно недоступен Проводятся технические работы

Заметили ошибку?

Выделите текст и нажмите Ctrl + Enter, чтобы сообщить нам о ней