Профессиональный калькулятор КАСКО
для брокеров, агентов и автодилеров.
Расчет КАСКО и ОСАГО по нескольким страховым компаниям
API Пкаско
Расчет
Расчет - КАСКО
Базовый расчет
Для базового расчета используются параметры: марка, модель, год выпуска, мощность, цена, список водителей1 (пол, возраст, стаж, семейное положение). Данный набор параметров является минимальным и обязательным для совершения расчета.
1 Если требуется произвести расчет без ограничения по водителям (мультидрайв) параметр со списком водителей можно не указывать.
ЗАПРОС:
POST https://pkasko.com/kasko/calc?api=1
{
"issueDate": "ГГГГ-ММ-ДД", // Дата начала действия договора
"make": "Audi", // Марка из справочника марок и моделей
"model": "A4", // Модель из справочника марок и моделей
"year": "2015", // Год выпуска ТС
"power": "174", // Мощность ТС
"price": 1008000, // Стоимость ТС
"mileage": 25000, // Пробег (не обязательно)
"VIN": "Z94C241BBKR012345", // VIN номер ТС (не обязательно)
"ownerFullName": "Иванова Юлия Ивановна", // ФИО собственника ФЛ (не обязательно)
"ownerBirthDate": "1982-05-02", // Д.Р. собственника ФЛ (не обязательно)
"drivers": [ // список водителей (не обязательно при multidrive != "Ограниченный список")
{
"sex": "m", // пол, m || w
"age": "30", // возраст, min=18
"experience": "10", // стаж, min=0
"fullName": "Иванова Юлия Ивановна", // ФИО водителя
"birthdate": "1982-05-02", // Д.Р. водителя
"marriage": true, // в браке? (boolean)
"children": true // наличие детей? (boolean)
}
],
"minDriverAge": 40, // Мин. возраст (обязательно при multidrive = "С ограничением минимального стажа и возраста")
"minDriverExperience": 10, // Мин. стаж (обязательно при multidrive = "С ограничением минимального стажа и возраста")
"antihijackMake": "Sherlog", // Производитель противоугонной системы (не обязательно)
"antihijackModel": "Comfort", // Наименование системы (не обязательно)
"extended": { ... } // расширенные условия расчета (не обязательно)
"extended_{ID}": { ... } // специальные условия по страховым компаниям (не обязательно)
}
ОПИСАНИЕ
api: (int) - вернуть уникальный идентификатор расчета
codes: (int) - коды калькуляторов через запятую
timeout: (int) - кол-во секунд, выделенное на расчета (калькуляторы, не успевшие произвести расчет, будут проигнорированы)
{ID}: (int) - идентификатор страховой компании из справочника
Блок extended заполняется, если необходимо расширить условия расчета. Названия опций и значения берутся из справочника Расширенные условия расчета КАСКО. Блок может быть пустым, либо отсутствовать.
Передавая значение через extended фактически вы сообщаете системе:
- Найди в каждом калькуляторе соответсвующий параметр
- Сопоставь значение, максимально подходящее под исходное условие
- Если достаточно подходящего значения нет, поставь значение по умолчанию
Таким образом, если через расширенные условия была передана рассрочка на 4 взноса
"extended": {
"paymentOrder": "4 взноса"
}
Но в одном из калькуляторе есть варианты только на 2 и 3 взноса, то расчет произведется по наиболее ближайшему варианту, т.е. 3 взноса.
А указанная франшиза будет подобрана к максимально ближайшему доступному варианту в каждом калькуляторе
ПКАСКО не гарантирует правильности подбора значений расширенных условий, если вы передаете данные из справочника Расширенные условия расчета КАСКО вне блока extended
Пример наполнения extended некоторыми возможными значениями:
"extended": {
"carNew": "Да", // новое ТС
"explDate": "2015-01-01", // дата начала эксплуатации
"sto": "По направлению страховщика ", // способ возмещения убытка
"franchise": 15000, // франшиза, можно указывать любое цифровое значение
...
}
ОТВЕТ:
{
"id": "676984", // уникальный идентификатор расчета
"results": [
// успешный расчет
{
"info": {
"code": "RenessansWebservice",
"antiHijackRequirements": [ // требования по ПУУ (индексный массив)
"Штатный иммобилайзер"
],
"withoutCertificatesBody": "", // выплаты без справок по кузову
"withoutCertificatesGlass": "" // выплаты без справок по стёклам
},
"data": {
...,
"orig": {
"make": "Audi",
"model": "A4"
},
"meta": {
"minDriverAge": "30", // минимальный возраст водителя
"minDriverExperience": "10", // минимальный стаж водителя
"carAge": 0, // возраст ТС (текущий год = 0)
"carGuarantee": true, // гарантийное ТС (в расчет берётся возраст ТС и параметр guarantee из справочника марок и моделей)
"explAge": 0, // кол-во лет эксплуатации (равен carAge, либо высчитывается из параметра explDate из расширенных условий)
"carDomestic": false // true - отечественная ТС, false - ТС иностранного производства
},
"hidden": {},
...
},
"result": {
"total": { // итоговые премия и тариф
"premium": 155078, // премия, руб.
"rate": 15.38 // тариф, %
},
"kasko": { // по риску "Полное КАСКО"
"remium": 155078,
"rate": 15.38
},
"damage": { // по риску "Ущерб"
"premium": 143990,
"rate": 14.28
},
"hijack": { // по риску "Хищение"
"premium": 11088,
"rate": 1.1
},
"features": { // дополнительные риски (риск: премия, руб.), уже проссумированные в итоговой премии total
"Гражданская ответственность": 900,
"Несчастный случай": 1300,
"Дополнительное оборудование": 5500
...
}
},
"warnings": [
"Расчет произведён с учётом франшизы со 2-го случая" // предупреждение или особенности данного расчета
]
}
]
}
Уточняющий расчет
Для того, чтобы сделать уточняющий расчет, забираем содержимое блока data из структуры ответа базового расчета по нужному калькулятору
Пример полного ответа от калькулятора RESOWebservice:
{
"data": {
"result": { ... },
"data": {
"make": "AUDI",
"model": "A4",
"year": "2015",
"power": "152",
"drivers": [
{
"sex": "m",
"age": "30",
"experience": "10"
}
],
"price": 1320000,
"orig": {
"make": "Audi",
"model": "A4"
},
"meta": {
"minDriverAge": "30",
"minDriverExperience": "10",
"carAge": 0,
"carGuarantee": true,
"explAge": 0,
"carDomestic": false
},
"region": "Санкт-Петербург",
"carNew": false,
"purchaseDate": "2015-03-03",
"owner": "Физическое лицо",
"credit": false,
"programSpec": false,
"keyLess": false,
"bodyType": "Седан",
"engineType": "Бензиновый",
"insuranceRegion": "РФ",
"sto": "Счет за ремонт на СТОА страховщика",
"stoDealer": true,
"paymentOrder": "Единовременно",
"insurancePeriod": "10 месяцев и более",
"multidrive": "Ограниченный список водителей",
"antiHijackSystem": "Нет",
"gap": false,
"prolongation": 0,
"franchise": 0,
"help": "Нет",
"equipment": false,
"equipmentSum": 0,
"dago": false,
"dagoSum": 300000,
"ns": false,
"nsSum": 0,
"nsSystem": "Только место водителя",
"nsSeats": 5,
"hidden": {
"calcId": 25688984
},
"source": { ... }
},
"warnings": [],
"info": {
"code": "RESOWebservice",
"antiHijackRequirements": [
"Установка противоугонной системы не требуется, при условии, что ТС оборудовано заводскими (штатными) противоугонными средствами",
"Установка спутниковой охранно-поисковой системы не требуется"
]
}
}
}
Забираем всё содержимое блока data и отправляем уточняющий запрос:
ЗАПРОС
POST https://pkasko.com/kasko/options?code=RESOWebservice
{
"make": "AUDI",
"model": "A4",
"year": "2015",
"power": "152",
"drivers": [
{
"sex": "m",
"age": "30",
"experience": "10"
}
],
"price": 1320000,,
"orig": {
"make": "Audi",
"model": "A4"
},
"meta": {
"minDriverAge": "30",
"minDriverExperience": "10",
"carAge": 0,
"carGuarantee": true,
"explAge": 0,
"carDomestic": false
},
"region": "Санкт-Петербург",
"carNew": false,
"purchaseDate": "2015-03-03",
"owner": "Физическое лицо",
"credit": false,
"programSpec": false,
"keyLess": false,
"bodyType": "Седан",
"engineType": "Бензиновый",
"insuranceRegion": "РФ",
"sto": "Счет за ремонт на СТОА страховщика",
"stoDealer": true,
"paymentOrder": "Единовременно",
"insurancePeriod": "10 месяцев и более",
"multidrive": "Ограниченный список водителей",
"antiHijackSystem": "Нет",
"gap": false,
"prolongation": 0,
"franchise": 0,
"help": "Нет",
"equipment": false,
"equipmentSum": 0,
"dago": false,
"dagoSum": 300000,
"ns": false,
"nsSum": 0,
"nsSystem": "Только место водителя",
"nsSeats": 5,
"hidden": {
"calcId": 25688984
}
}
ОПИСАНИЕ
code: (string) - код калькулятора
см. Справочник калькуляторов (хеш по коду калькулятора)
ОТВЕТ:
{
"result": { ... },
"values": { ... },
"options": { ... },
"data": {
"make": "AUDI",
"model": "A4",
"year": "2015",
"power": "152",
"drivers": [
{
"sex": "m",
"age": "30",
"experience": "10"
}
],
"price": 1320000,
"meta": {
"minDriverAge": "30",
"minDriverExperience": "10",
"carAge": 0,
"carGuarantee": true,
"explAge": 0,
"carDomestic": false
},
"region": "Санкт-Петербург",
"carNew": false,
"purchaseDate": "2015-03-03",
"owner": "Физическое лицо",
"credit": false,
"programSpec": false,
"keyLess": false,
"bodyType": "Седан",
"engineType": "Бензиновый",
"insuranceRegion": "РФ",
"sto": "Счет за ремонт на СТОА страховщика",
"stoDealer": true,
"paymentOrder": "Единовременно",
"insurancePeriod": "10 месяцев и более",
"multidrive": "Ограниченный список водителей",
"antiHijackSystem": "Нет",
"gap": false,
"prolongation": 0,
"franchise": 0,
"help": "Нет",
"equipment": false,
"equipmentSum": 0,
"dago": false,
"dagoSum": 300000,
"ns": false,
"nsSum": 0,
"nsSystem": "Только место водителя",
"nsSeats": 5,
"hidden": {
"calcId": 25690654
},
"orig": {
"make": "AUDI",
"model": "A4"
}
},
"warnings": [],
"info": {
"code": "RESOWebservice",
"antiHijackRequirements": [
"Установка противоугонной системы не требуется, при условии, что ТС оборудовано заводскими (штатными) противоугонными средствами",
"Установка спутниковой охранно-поисковой системы не требуется"
]
},
"order": [ ... ],
"service": { // данные, взятые из calculate.service.json по нужному калькулятору, описанного выше
"paymentsWithoutCertificates": {
"Кузов": "Один раз в год (до 5% от страховой суммы, но не более 15000р. для иностранных ТС и 6000р. для отечественных ТС). Для VIP полисов - до 5% от страховой суммы неоднократно.",
"Стекла": "Неограниченное количество раз в течение срока действия договора"
},
"evacuation": {
"Эвакуация": "До 1% от страх.суммы (один раз в течение срока действия договора)"
},
"emergencyCommissioner": {
"Аварком": "Не предоставляется (только с РЕСО-Автопомощь)"
}
}
}
Пояснения к блокам options, values и order см. в разделе Расчет - Базовые понятия - Уточняющий расчет
Пояснения к блокам info, data и result см. выше, в разделе Расчет - КАСКО - Базовый расчет
Специальные параметры
Для увеличения точности расчетов сразу по нескольким страховым компаниям предлагаем воспользоваться допонительными блоками данных с определенными параметрами по конкретным страховым компаниям.
Пример реализации Специальных параметров представлен в нашем интерфейсе:
ЗАПРОС:
POST https://pkasko.com/kasko/calc?api=1
{
"make": "Audi", // Марка из справочника марок и моделей
"model": "A4", // Модель из справочника марок и моделей
"year": "2015", // Год выпуска ТС
"power": "174", // Мощность ТС
"price": 1008000, // Стоимость ТС
"mileage": 25000, // Пробег (не обязательно)
"drivers": [ // список водителей (не обязательно при multidrive != "Ограниченный список")
{
"sex": "m", // пол, m || w
"age": "30", // возраст, min=18
"experience": "10", // стаж, min=0
"marriage": true, // в браке? (boolean)
"children": true // наличие детей? (boolean)
}
],
"extended": { ... } // расширенные условия расчета (не обязательно)
"extended_{ID}": { // специальные условия по страховым компаниям (не обязательно)
"product": "КАСКООснова", // продукт из справочника продуктов страховой компании
"program": "АлмазноеКАСКО", // программа из справочника страховой компании
"serviceProgram": "Сервис", // сервисная программа из справочника страховой компании
"oldPremium": 99999, // страховая премия прошлого года
"equipment": true, // страхование дополнительного оборудования
"equipmentSum": 15000 // страховая сумма по дополнительному оборудованию
}
}
ОПИСАНИЕ
{ID}: (int) - идентификатор страховой компании из справочника
Параметры, которые можно указывать в блоке extended_{ID}, беруться из справочников values калькулятора Страховой компании.
Пояснения к блоку values см. в разделе Расчет - Базовые понятия - Уточняющий расчет
Справочники параметров
{
"values": {
"modification": [
"xDrive 20i M Sport Pure (Универсал, Автоматическая, Полный, Бензиновый, 184 л.с., 5032000 - 6223000 руб.)",
"Точно не знаю"
],
"visualInspection": [
true,
false
],
"VIN": [],
"numberPTS": [],
"seriesPTS": [],
"program": [
"АлмазноеКАСКО",
"Альфа Авто Защита",
"Альфа-Бизнес",
"Альфа-Все включено",
"Дай ПЯТЬ",
"КАСКО в десятку",
"КАСКО с пробегом",
"Лёгкое КАСКО",
"Оптимальное КАСКО",
"СуперКАСКО"
],
"equipment": [
false,
true
],
"equipmentSum": [
0
]
}
}
Описание параметров
{
"options": {
"Транспортное средство": {
"modification": {
"title": "Модификация",
"type": "select-100"
},
"visualInspection": {
"title": "После техосмотра",
"type": "checkbox"
}
},
"Базовые параметры": {
"program": {
"title": "Программа",
"type": "select-100"
}
},
"Скоринг": {
"VIN": {
"title": "VIN номер автомобиля",
"type": "input"
},
"seriesPTS": {
"title": "Серия ПТС автомобиля",
"type": "input"
},
"numberPTS": {
"title": "Номер ПТС автомобиля",
"type": "input"
}
},
"Дополнительное оборудование": {
"equipment": {
"title": "ДО",
"type": "checkbox"
},
"equipmentSum": {
"title": "Страховая сумма",
"type": "input"
}
}
}
}
История расчетов
Чтобы получить историю последних расчетов, соверешнных через API:
ЗАПРОС
GET https://pkasko.com/kasko/history
ОПИСАНИЕ
GET https://pkasko.com/kasko/history?page=1&search=Audi
page: (int) - номер страницы
search: (string) - поисковая строка
ОТВЕТ
{
"total": 1592, // общее кол-во уникальных расчетов
"per_page": 15,
"current_page": 1,
"last_page": 107,
"from": 1,
"to": 15,
"data": [
{
"id": "4451522", // идентификатор расчета
"user_id": "2230",
"organization_id": "1",
"division_id": "2",
"ip": "*.*.*.*",
"calcdate": "2015-03-25 14:30:58",
"data": { // исходные условия расчета
"make": "Audi",
"model": "A3",
"year": "2012",
"power": "105",
"drivers": [
{
"sex": "w",
"age": "24",
"experience": "5"
},
{
"sex": "m",
"age": "25",
"experience": "7"
}
],
"price": 700000,
"source": { // данные для внутренних нужд ПКАСКО
"make": "Audi",
"model": "A3",
"year": "2012",
"power": "105",
"drivers": [
{
"sex": "w",
"age": "24",
"experience": "5"
},
{
"sex": "m",
"age": "25",
"experience": "7"
}
],
"price": "700000"
},
"extended": { // расширенные условия, по которым производился расчет
"explDate": "2015-01-01",
"guarantee": "Нет"
}
},
"calc_code": "ErgoRuss", // код калькулятора, по которому бло произведено последнее уточнение расчета
"save": { // заметки к расчету, если он было запомнен
"name": "ФИО Клиента",
"phone": "911 5555555",
"notes": "Заметки",
"remindTime": "17:29",
"remindIs": true, // установлено ли напоминание
"remindAt": "2015-01-12 17:29:00" // на какую дату
},
"offers": [ // сохраненные коммерческие предложение, которые можно скачать повторно
"1/eb/0c4aca1d3b6d865f258d858a39af2/calculation_pkasko_Audi_A4_2230_2015-01-21_11-23-12.pdf"
],
"results": null,
"index": "",
"md5hash": "6a4dc082ac6a558f4c9939bf3045b4e3",
"created_at": "2015-03-25 12:53:53",
"updated_at": "2015-03-25 14:30:58"
},
{ ... }
]
}
Получение данных расчета по идентификатору
Чтобы получить данные расчета по уникальному идентификатору расчета:
ЗАПРОС
GET https://pkasko.com/kasko/history/3618295
ОПИСАНИЕ
id: (int) - идентификатор расчета
ОТВЕТ
{
"id": "3618295", // идентификатор расчета
"user_id": "2230",
"organization_id": "1",
"division_id": "2",
"ip": "*.*.*.*",
"calcdate": "2015-03-25 14:30:58",
"data": { // исходные условия расчета
"make": "Audi",
"model": "A3",
"year": "2012",
"power": "105",
"drivers": [
{
"sex": "w",
"age": "24",
"experience": "5"
},
{
"sex": "m",
"age": "25",
"experience": "7"
}
],
"price": 700000,
"source": { // данные для внутренних нужд ПКАСКО
"make": "Audi",
"model": "A3",
"year": "2012",
"power": "105",
"drivers": [
{
"sex": "w",
"age": "24",
"experience": "5"
},
{
"sex": "m",
"age": "25",
"experience": "7"
}
],
"price": "700000"
},
"extended": { // расширенные условия, по которым производился расчет
"explDate": "2012-08-17",
"guarantee": "Нет"
}
},
"calc_code": "ErgoRuss", // код калькулятора, по которому бло произведено последнее уточнение расчета
"save": { // заметки к расчету, если он было запомнен
"name": "ФИО Клиента",
"phone": "911 5555555",
"notes": "Заметки",
"remindTime": "17:29",
"remindIs": true, // установлено ли напоминание
"remindAt": "2015-01-12 17:29:00" // на какую дату
},
"offers": [ // сохраненные коммерческие предложение, которые можно скачать повторно
"1/eb/0c4aca1d3b6d865f258d858a39af2/calculation_pkasko_Audi_A4_2230_2015-01-21_11-23-12.pdf"
],
"results": null,
"index": "",
"md5hash": "6a4dc082ac6a558f4c9939bf3045b4e3",
"created_at": "2015-03-25 12:53:53",
"updated_at": "2015-03-25 14:30:58"
}
Сохранение контактов в расчете
Чтобы привязать контактные данные к расчету:
ЗАПРОС
POST https://pkasko.com/kasko/save?id=1
{
"save": {
"name": "Имя",
"phone": "999123456",
"notes": "Примечание"
}
}
ОПИСАНИЕ
id: (int) - идентификатор расчета