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

Обновлено 29 февраля 2024

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

Тестовый контур https://iftfintech.testsbi.sberbank.ru:9443
Промышленный контур https://fintech.sberbank.ru:9443

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

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

Шаги

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

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

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

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

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

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

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

curl -X GET --header 'Accept: application/json' --header
'Authorization: Bearer c76fb018-27c9-43f7-a751-62646eda7e1a-1'
' `https://iftfintech.testsbi.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.

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

Наименование	Описание
Параметры заголовка
Authorization (String)	Access token организации-клиента, полученный через SSO Пример: `Bearer c76fb018-27c9-43f7-a751-62646eda7e1a-1`
Параметры запроса
externalId (String)	Идентификатор документа заявления, полученный из СББОЛ Пример: 550e8400-e29b-41d4-a716-446655440000
Параметры тела запроса
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`
	Операция не может быть выполнена: доступ к ресурсу запрещен	У пользователя нет прав на использование соответствующего сервиса Sber API, доступ к которому не предусмотрен настройками scope; У пользователя отсутствует оферта с внешним сервисом.
404	`NOT_FOUND`
	Документ с указанным ID не найден	Невозможно найти документ с указанным внешним идентификатором.
415	`JWS_EXCEPTED`
	В соответствии с текущими настройками сервиса с clientId=%s необходимо использовать запрос в формате JWS Compact Serialization	Ошибка возникает, если в настройках внешних сервисов выставлен флаг «Требуется подпись для внешнего сервиса»
500	`UNKNOWN_EXCEPTION`
	Внутренняя ошибка сервера
503	`UNAVAILABLE_RESOURCE_EXCEPTION`
	Сервис временно недоступен	Проводятся технические работы

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

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

Шаги﻿

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

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

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

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

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

Шаги﻿

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

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

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

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

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

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

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

Шаги

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

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

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

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

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

Шаги

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

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

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

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

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

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