Перейти к основному содержимому

Предварительный расчет ФЛ на Границе для ИГ:

Предварительный расчет стоимости договора для Иностранных Граждан (ИГ) на границе

(POST {{server}}/sales/v2/individual/osago/quotes).

Быстрый расчет премии по договору. Для того, чтобы премия на предварительном расчете соответствовала премии при создании договора, необходимо передавать те же данные, которые требуются при создании проекта договора (метод POST {{server}}//sales/v2/individual/osago/policies). Если метод вернул 504 ошибку, то на текущий момент сервис не доступен, необходимо повторить запрос через 60 000 миллисекунд, или установить асинхронный вызов.

Возможно асинхронное выполнение запросов, для этого в любом из методов запроса, необходимо в Headers передать тег desired-timeout и установить для него значение в миллисекундах. Рекомендую установить значение для любого запроса 59 000 миллисекунд. Если сервис не успеет ответить за переданное в параметре desired-timeout время, то в ответе вернется следующее сообщение:

{
    "draftId": "23f2792e-5396-446b-b279-2e5396846b8b",
    "method": "GET",
    "href": "/sales/v2/operations?oper_id=23f2792e-5396-446b-b279-2e5396846b8b"
}

Далее асинхронный ответ можно получить с помощью метода operations.

Для предварительного расчета Осаго на границе для ИГ нужно заполнить обязательные поля​

Обязательность заполнения в соответствии со страной ИГ:

Паспорт ТС иностранного государства, Техпаспорт иностранного государства, Свидетельство о регистрации ТС иностранного государства,
Паспорт самоходной машины иностранного государства, Технический талон иностранного государства.

Заполнить Документы, удостоверяющие личность в соответствии со справочником https://developers.vsk.ru/docs/products/osago/osago_dict/, для ИГ (FOREIGN_PASSPOR).

"passport":
        {
            "typeCode": "FOREIGN_PASSPORT"
        }

Заполнить Адрес

"address":
        {
            "typeCode": "REGISTRATION",
            "countryCode": "Страна ИГ",
            "addressStr": "Адресс ИГ"
        }

Заполнить Номер ТС insuredObject.vehicle.licensePlate

"insuredObject" : {
    "vehicle" : {
      "vehicleModel" : {
        "mark" : "Chery",
        "model" : "Tiggo 8 Pro Max",
        "horsePower" : "186"
      },
      "vin" : "LVTDB21B6RD445211",
      "licensePlate" : "HFX125",
      "isNotRegistered" : false,
      "yearIssue" : "2024-01-01",
      "vehicleCategoryCode" : "B"
    },
}

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

{
    "product":
    {
        "code": "OSAGO"
    },
    "startDate": "2025-05-24T00:00:00+03:00",
    "endDate": "2026-05-24T00:00:00+03:00",
    "policyHolder": {
        "person":
        {
            "firstName": "MAP",
            "lastName": "HAHA",
            "birthDate": "1975-08-25",
            "citizenship": "DE"
        },
        "phone":
        {
            "phoneNumber": "79668886649"
        },
        "email": "mmmm@test.ru",
        "passport":
        {
            "typeCode": "FOREIGN_PASSPORT",
            "number": "C7L88V418",
            "dateIssue": "2016-02-24"
        },
        "address":
        {
            "typeCode": "REGISTRATION",
            "countryCode": "DE",
            "addressStr": "Germany"
        }
    },
    "insuredObject": {
        "vehicle": {
            "vehicleModel":
            {
                "mark": "Opel",
                "model": "Astra",
                "horsePower": "140"
            },
            "vin": "W0LPE8ECXD8021111",
            "isNotRegistered": false,
            "licensePlate" : "HFX116",
            "yearIssue": "2012-01-01",
            "vehicleCategoryCode": "B"
        },
        "vehicleDocument":
        {
            "typeCode": "VEHICLE_REGISTRATION_CERTIFICATE_FOREIGN",
            "serial": "ZBI",
            "number": "HH-K-1-046/21-00133",
            "dateIssue": "2022-02-15"
        },
        "owner": {
            "vehicleOwnerPerson": {
                "person":
                {
                    "firstName": "MAP",
                    "lastName": "HAHA",
                    "birthDate": "1975-08-25",
                    "citizenship": "DE"
                },
                "phone":
                {
                    "phoneNumber": "79668886649"
                },
                "email": "mmmm@test.ru",
                "document":
                {
                    "typeCode": "FOREIGN_PASSPORT",
                    "number": "C7L88V418",
                    "dateIssue": "2016-02-24"
                },
                "address":
                {
                    "typeCode": "REGISTRATION",
                    "countryCode": "DE",
                    "addressStr": "Germany"
                }
            }
        },
        "typeLDU": "LIM",
        "drivers": [{
                "person":
                {
                    "firstName": "MAP",
                    "lastName": "HAHA",
                    "birthDate": "1975-08-25",
                    "citizenship": "DE"
                },
                "driversLicense":
                {
                    "typeCode": "DRIVER_LICENSE_FOREIGN",
                    "serial": "4989",
                    "number": "022158",
                    "dateIssue": "2021-01-08"
                },
                "driveExperience": "2011-02-01",
                "isOwner": true,
                "isPolicyHolder": true
            }
        ],
        "trailer": false,
        "transit": false,
        "purpose": "PERSONAL"
    },
    "periods":
    {
        "startDate1": "2025-05-24T00:00:00+03:00",
        "endDate1": "2026-05-24T00:00:00+03:00"
    }
}

Положительный ответ:

{
    "policyNumber": "ХХХ0523252936",
    "product": {
        "code": "OSAGO"
    },
    "status": {
        "code": "WAITING_PAYMENT"
    },
    "startDate": "2025-05-24T00:00:00+03:00",
    "endDate": "2026-05-24T00:00:00+03:00",
    "createDate": "2025-04-29T12:12:23+03:00",
    "premium": 19513.22,
    "currencyCode": "RUB",
    "draftId": "18c3bb77-27b4-4f8c-83bb-7727b47f8c26",
    "additionalProperties": {
        "loyalties": [
            {
                "declineCategory": "Успешно",
                "isLoyaltyDiscount": false
            }
        ]
    },
    "infoList": {
        "partnerCode": "IP_AGEEV",
        "policyKind": "еОСАГО",
        "channelId": "410",
        "contractDivisionId": "00.97.01.12.27.04",
        "contractResponsibleId": "0086001534",
        "agentContractNumber": "04856100001",
        "partnerNumber": "334",
        "apiVersion": "32",
        "applicationId": "be2372cf-80d7-4bbf-b4c2-37227ee0e92b",
        "agreementId": "79c84a72-8bdf-4bbb-87a6-9e8f931aa206",
        "nsiCode": "П_773177987632",
        "legal_entity": "ИП Агеев Марат Ряфягатович"
    },
    "installments": [
        {
            "id": "5fd5af99-1161-4b1f-acbc-3f3d5a286734",
            "nr": 1,
            "scheduled": "2025-05-24",
            "currencyCode": "RUB",
            "amount": 19513.22,
            "sendSms": false,
            "sendEmail": false
        }
    ],
    "policyHolder": {
        "person": {
            "firstName": "MAP",
            "lastName": "HAHA",
            "birthDate": "1975-08-25",
            "citizenship": "DE",
            "familyState": "SINGLE",
            "isResident": true,
            "vsk_id": "3b003217-f7ed-4011-bd23-75f9efb55403"
        },
        "phone": {
            "phoneNumber": "79668886649"
        },
        "email": "mmmm@test.ru",
        "passport": {
            "typeCode": "FOREIGN_PASSPORT",
            "number": "C7L88V418",
            "dateIssue": "2016-02-24"
        },
        "address": {
            "typeCode": "REGISTRATION",
            "countryCode": "DE",
            "addressStr": "Germany"
        }
    },
    "insuredObject": {
        "vehicle": {
            "vehicleModel": {
                "carId": "49191",
                "mark": "Opel",
                "model": "Astra",
                "horsePower": "140"
            },
            "vin": "W0LPE8ECXD8021111",
            "isNotRegistered": true,
            "yearIssue": "2012-01-01",
            "vehicleCategoryCode": "B"
        },
        "vehicleDocument": {
            "typeCode": "VEHICLE_REGISTRATION_CERTIFICATE_FOREIGN",
            "serial": "ZBI",
            "number": "HH-K-1-046/21-00133",
            "dateIssue": "2022-02-15"
        },
        "owner": {
            "vehicleOwnerPerson": {
                "person": {
                    "firstName": "MAP",
                    "lastName": "HAHA",
                    "birthDate": "1975-08-25",
                    "citizenship": "DE",
                    "familyState": "SINGLE",
                    "isResident": true,
                    "vsk_id": "3b003217-f7ed-4011-bd23-75f9efb55403"
                },
                "phone": {
                    "phoneNumber": "79668886649"
                },
                "email": "mmmm@test.ru",
                "document": {
                    "typeCode": "FOREIGN_PASSPORT",
                    "number": "C7L88V418",
                    "dateIssue": "2016-02-24"
                },
                "address": {
                    "typeCode": "REGISTRATION",
                    "countryCode": "DE",
                    "addressStr": "Germany"
                }
            }
        },
        "typeLDU": "LIM",
        "drivers": [
            {
                "person": {
                    "firstName": "MAP",
                    "lastName": "HAHA",
                    "birthDate": "1975-08-25",
                    "citizenship": "DE",
                    "familyState": "SINGLE",
                    "isResident": true,
                    "vsk_id": "3b003217-f7ed-4011-bd23-75f9efb55403"
                },
                "driversLicense": {
                    "typeCode": "DRIVER_LICENSE_FOREIGN",
                    "serial": "4989",
                    "number": "022158",
                    "dateIssue": "2021-01-08"
                },
                "driveExperience": "2011-02-01",
                "kbm": "1.17",
                "isOwner": true,
                "isPolicyHolder": true
            }
        ],
        "trailer": false,
        "transit": false,
        "purpose": "PERSONAL",
        "coefficients": {
            "base": "7535",
            "kt": "1.7",
            "kbm": "1.17",
            "ko": "1",
            "kvs": "0.93",
            "km": "1.4",
            "kp": "1",
            "kn": "-1",
            "kpr": "-1",
            "ks": "1"
        },
        "isReinsurance": false,
        "isProlongation": false,
        "covers": [
            {
                "cover": {
                    "code": "117"
                },
                "sumInsured": 400000.00,
                "premium": 19513.22
            }
        ]
    },
    "periods": {
        "startDate1": "2025-05-24T00:00:00+03:00",
        "endDate1": "2026-05-24T00:00:00+03:00"
    }
}

Ответ, если данные не прошли валидацию:

{
    "code": "3",
    "code_c": "INVALID_ARGUMENT",
    "message": "Невалидные входящие параметры",
    "details": [
        {
            "domain": "partapi-eosago-second-edition",
            "metadata": {
                "field": "draftId=b8c2e136-c43d-4251-82e1-36c43d225133",
                "description": "Fifth-element validation exception"
            }
        },
        {
            "domain": "fifth-element",
            "metadata": {
                "field": "$.attributes.INSURER.SUBJECT_MASTER_FL.FIRST_NAME",
                "description": "Недопустимый формат имени."
            }
        }
    ]
}

Ответ, если в Headers установлен desired-timeout, и ответ не получен в течении установленного времени:

{
    "draftId": "23f2792e-5396-446b-b279-2e5396846b8b",
    "method": "GET",
    "href": "/sales/v2/operations?oper_id=23f2792e-5396-446b-b279-2e5396846b8b"
}

Ответ с ошибкой 504:

<html>

<head>
    <title>504 Gateway Time-out</title>
</head>

<body>
    <center>
        <h1>504 Gateway Time-out</h1>
    </center>
    <hr>
    <center>nginx/1.25.1</center>
</body>

</html>

Ошибка 401, нет авторизации, необходимо пройти процесс авторизации

{
    "message": "Unauthorized",
    "http_status_code": 401
}