URL | /api/v2/importBordereau |
Метод | POST |
Кодировка | UTF-8 |
Параметры URL | partnerCode - идентификатор партнера
sign - SHA-256(тело запроса + пароль) |
Запрос
Поле | Тип | Обязательность | Ограничения |
firstName | String | Да | Имя. Ограничение: <=100 символов |
lastName | String | Да | Фамилия. Ограничение: <=100 символов |
middleName | String | Нет | Отчество. Ограничение: <=100 символов |
birthdate | String | Да | Дата рождения. Ограничение: формат dd.MM.yyyy |
phoneNumber | String | Да | Номер телефона. Ограничение: формат +79161234567 |
flightNumber | String | Да | Номер рейса. Ограничение - формат
<код перевозчика>-<номер рейса>
a) <код перевозчика> - 2 символа (буквы латиница, цифры);
b) <номер рейса> - 1-4 символа (цифры)
Если параметр productType=2, то в параметр flightNumber можно указать любое значение, например “NN-0000“ |
departureDate | String | Да | Дата и время вылета. Ограничение: формат yyyy-MM-dd HH:mm XXX.
Если время неизвестно можно передать любое значение, соответствующее формату, но параметр ignoreDepartureTime поставить в значение True. |
policyNumber | String | Да | Номер полиса. Ограничение: 45 символов |
currency | String | Да | Валюта. Ограничение: =3 символа |
insuranceSum | Number | Да | Страховая сумма. Ограничение: диапазон (0,) |
limitSumPerFlight | Number | Нет | Ограничение суммы выплаты на 1 рейс для 1 застрахованного.
Ограничение: диапазон (0,) |
delayTimeHours | Number | Да | Сколько часов невылета после запланированного времени считать задержкой, когда клиент получает СМС. Ограничение: диапазон (0,) |
firstCountHours | Number | Да | Через сколько часов после запланированного времени вылета начисляется первая сумма для выплаты.
Через сколько часов после запланированного времени вылета начисляется первая сумма для выплаты.
Ограничение: диапазон (0,) |
repeatedCountHours | Number | Да | Какой будет период повторного начисления в часах.
Ограничение: диапазон (0,) |
firstCountPercent | Number | Да | Сколько процентов от страховой суммы начислять в первый раз. Ограничение: диапазон [0,100].
Можно пользоваться парой параметров (firstCountPercent, repeatedCountPercent) или (firstCountSum, repeatedCountSum). На ваш выбор. |
repeatedCountPercent | Number | Да | Сколько процентов от страховой суммы начислять в следующие разы. Ограничение: диапазон [0,100].
Можно пользоваться парой параметров (firstCountPercent, repeatedCountPercent) или (firstCountSum, repeatedCountSum). На ваш выбор. |
firstCountSum | Number | Да | Какая сумма будет начисляться в первый раз. Если заполнено, то firstCountPercent игнорируется.
Ограничение: целое или дробное число |
repeatedCountSum | Number | Да | Какая сумма будет начисляться в следующие разы. Если заполнено, то repeatedCountPercent игнорируется.
Ограничение: целое или дробное число |
paymentType | Number | Да | Способ выплаты
Ограничение: перечисление 1,2
1 - после каждого начисления
2 - после вылета |
ignoreDepartureTime | Boolean | Нет | Необязательный параметр, принимает значения true или false, по умолчанию false. Если true, то считаем, что в departureDate передается только ЛОКАЛЬНАЯ дата вылета. Точное время вылета вычисляется позже, за день до даты вылета |
override | Boolean | Нет | Необязательный параметр, принимает значения true или false, по умолчанию false. Если true, то осуществляется попытка обновить данные существующего риска |
productType | Number | Нет | Необязательный параметр, 1 - страховка от задержки авиарейса, 2 - страховка ВЗР. По умолчанию = 1 |
startInsurancePeriod | String | Нет | Дата начала действия полиса. Ограничение: формат yyyy-MM-dd, обязательный, если productType=2 |
finishInsurancePeriod | String | Нет | Дата окончания действия полиса. Ограничение: формат yyyy-MM-dd, обязательный, если productType=2 |
cancelSum | Number | Нет | Сумма выплаты при отмене рейса. Необязательный параметр. Ограничение: 0 <= cancelSum <= insuranceSum |
Пример запроса
{
"risks": [
{
"firstName": "Пассажиров",
"lastName": "Пассажир",
"middleName": "Пассажирович",
"birthdate": "11.01.1986",
"flightNumber": "S7-155",
"phoneNumber": "+79161234567",
"departureDate": "2018-04-09 20:00 +03:00",
"policyNumber": "policy_number1",
"currency": "RUB",
"insuranceSum": 12000,
"delayTimeHours": 2,
"firstCountHours": 2,
"repeatedCountHours": 1,
"firstCountPercent": 10,
"repeatedCountPercent": 30,
"productType":1,
"paymentType": 1,
"override": true
},
{
"firstName": "Клиентов",
"lastName": "Клиент",
"middleName": "Клиентович",
"birthday": "23.02.1988",
"flightNumber": "RU-243",
"departureDate": "2018-04-11 02:10 +10:00",
"policyNumber": "policy_number2",
"currency": "RUB",
"insuranceSum": 12000,
"delayTimeHours": 2,
"firstCountHours": 2,
"repeatedCountHours": 1,
"firstCountPercent": 10,
"repeatedCountPercent": 30,
"productType":1
"paymentType": 1,
"ignoreDepartureTime": true
}
]
}
Ответ
Поле | Тип | Ограничения |
flightNumber | String | Номер рейса |
policyNumber | String | Номер полиса |
uuid | String | Уникальный идентификатор импортированного риска |
errors | array of JSON object | Список ошибок. Возможные ошибки описаны в разделе Объект error |
Пример ответа
{"resultImport": [
{
"flightNumber": "S7-155",
"policyNumber": "policy_number",
"uuid": "6400a8fd-d73c-4f38-abdd-90a2d4c59a5b"
},
{
"flightNumber": "policy_number",
"policyNumber": "S7-155",
"errors": [ {
"code": "WRONG_FLIGHT_DEPARTURE_TIME",
"message": "Неверное время вылета."
}]
}
]}