Создание договора ФЛ Иностранных Граждан на границе

Создание проекта договора, итоговый расчет стоимости договора (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=05bbbfa9-f34f-4c43-bbbf-a9f34f4c437c",
                "description": "Отказ"
            }
        }
    ]
}

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

{
    "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
}