Обновление договора
Обновление данных в ранее созданном договоре (PUT {{server}}//sales/v2/individual/osago/policies/{{policyNumber}}). Запрос заполняется ответом из ранее вызванного метода создания договора (POST {{server}}//sales/v2/individual/osago/policies), и изменяются необходимые параметры. Если метод вернул 504 ошибку, то на текущий момент сервис не доступен, необходимо повторить запрос через 600 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.
Пример запроса:
{
"product":{
"code":"OSAGO"
},
"startDate":"2024-04-11T00:00:00+03:00",
"endDate":"2025-04-11T00:00:00+03:00",
"policyHolder":{
"person":{
"firstName":"Иван",
"lastName":"Бунша",
"middleName":"Васильевич",
"birthDate":"1990-01-13",
"citizenship":"RU"
},
"phone":{
"phoneNumber":"79516658860"
},
"email":"test@test.ru",
"passport":{
"typeCode":"PASSPORT_RF",
"serial":"4007",
"number":"013584",
"dateIssue":"2021-08-08",
"whom":"УФМС",
"divisionCode":"013-451"
},
"address":{
"typeCode":"REGISTRATION",
"countryCode":"RU",
"region":"Челябинская обл",
"city":"г Челябинск",
"street":"пр-кт Ленина",
"house":"4Д",
"zipCode":"454085",
"kladrId":"7400000100005080244",
"fiasId":"c88cd1bd-6ff6-4de2-90d8-86e149ada01c",
"addressStr":"454085, Челябинская обл, г Челябинск, Телефон р-н, пр-кит Ленина, д 4Д"
}
},
"insuredObject":{
"vehicle":{
"vehicleModel":{
"mark":"KIA",
"model":"Rio",
"horsePower":"123",
"otherModelName": "Kia",
"otherMarkName": "Rio 1.6 AT"
},
"vin":"VBKJPJ405HC232666",
"licensePlate":"Е123ХМ178",
"vehicleCategoryCode" : "B",
"isNotRegistered":false,
"yearIssue":"2020-01-01"
},
"vehicleDocument":{
"typeCode":"VEHICLE_REGISTRATION_DOCUMENT",
"serial":"9907",
"number":"203341",
"dateIssue":"2022-01-01"
},
"owner":{
"vehicleOwnerPerson":{
"person":{
"firstName":"Иван",
"lastName":"Бунша",
"middleName":"Васильевич",
"birthDate":"1990-01-13",
"citizenship":"RU",
"gender":"M",
"familyState":"MARRIED"
},
"phone":{
"phoneNumber":"79516658860"
},
"email":"test@vsk.ru",
"document":{
"typeCode":"PASSPORT_RF",
"serial":"4007",
"number":"013584",
"dateIssue":"2021-08-08",
"whom":"УФМС",
"divisionCode":"013-451"
},
"address":{
"typeCode":"REGISTRATION",
"countryCode":"RU",
"region":"Челябинская обл",
"city":"г Челябинск",
"street":"пр-кт Ленина",
"house":"4Д",
"flat":"9",
"zipCode":"454085",
"kladrId":"7400000100005080244",
"fiasId":"c88cd1bd-6ff6-4de2-90d8-86e149ada01c",
"addressStr":"454085, Челябинская обл, г Челябинск, Телефон р-н, пр-кит Ленина, д 4Д, кв 9"
}
}
},
"typeLDU":"LIM",
"drivers":[
{
"person":{
"firstName":"Иван",
"lastName":"Бунша",
"middleName":"Васильевич",
"birthDate":"1990-01-13",
"gender":"M",
"familyState":"MARRIED"
},
"driversLicense":{
"typeCode":"DRIVER_LICENSE",
"serial":"4789",
"number":"032148",
"dateIssue":"2020-01-08"
},
"driveExperience":"2010-02-01",
"isOwner":true,
"isPolicyHolder":true
}
],
"trailer":false,
"transit":false,
"purpose":"PERSONAL",
"primaryDrivingArea":"a376e68d-724a-4472-be7c-891bdb09ae32"
},
"countryTs": "643",
"periods":{
"startDate1":"2024-04-11T00:00:00+03:00",
"endDate1":"2025-04-11T00:00:00+03:00"
},
"bso": {
"serial": "ААС",
"number": "0321456845"
}
}
Пример положительного ответа:
{
"policyNumber": "ХХХ0161456554",
"product": {
"code": "OSAGO"
},
"status": {
"code": "WAITING_PAYMENT"
},
"startDate": "2024-04-15T00:00:00+03:00",
"endDate": "2025-04-15T00:00:00+03:00",
"premium": 19237.16,
"currencyCode": "RUB",
"draftId": "854c862d-842a-42b8-8c86-2d842ac2b846",
"infoList": {
"partnerCode": "IP_SMYK",
"policyKind": "еОСАГО",
"channelId": "362",
"contractDivisionId": "32.24",
"contractResponsibleId": "0032155413",
"agentContractNumber": "5210760001",
"apiVersion": "11",
"applicationId": "5ea51921-855f-42e3-a544-407761aae946",
"agreementId": "bf2d1d1a-4856-4ffa-8f45-6c48ddc17bf4",
"nsiCode": "П_420214413263",
"legal_entity": "ИП Смык Владимир Владимирович"
},
"installments": [
{
"id": "227d7837-3834-4b61-8997-56b22f5ab219",
"nr": 1,
"scheduled": "2024-04-11",
"currencyCode": "RUB",
"amount": 19237.16,
"sendSms": false,
"sendEmail": false
}
],
"files": [
{
"fileTypeCode": "DRAFT",
"fileId": ""
},
{
"fileTypeCode": "DRAFT",
"fileId": ""
}
],
"policyHolder": {
"person": {
"firstName": "Иван",
"lastName": "Бунша",
"middleName": "Васильевич",
"birthDate": "1990-01-13",
"citizenship": "RU",
"familyState": "SINGLE",
"isResident": true,
"vsk_id": "37495ea1-a602-492c-9258-1c98084cc239"
},
"phone": {
"phoneNumber": "79516658860"
},
"email": "test@test.ru",
"passport": {
"typeCode": "PASSPORT_RF",
"serial": "4007",
"number": "013584",
"dateIssue": "2021-08-08",
"whom": "УФМС",
"divisionCode": "013-451"
},
"address": {
"typeCode": "REGISTRATION",
"countryCode": "RU",
"region": "Челябинская обл",
"city": "г Челябинск",
"street": "пр-кт Ленина",
"house": "4Д",
"zipCode": "454085",
"kladrId": "7400000100005080244",
"fiasId": "c88cd1bd-6ff6-4de2-90d8-86e149ada01c",
"addressStr": "454085, Челябинская обл, г Челябинск, Телефон р-н, пр-кит Ленина, д 4Д"
}
},
"insuredObject": {
"vehicle": {
"vehicleModel": {
"carId": "29643",
"mark": "KIA",
"model": "Rio",
"horsePower": "123",
"otherModelName": "Kia",
"otherMarkName": "Rio 1.6 AT"
},
"vin": "VBKJPJ405HC232666",
"licensePlate": "Е123ХМ178",
"vehicleCategoryCode" : "B",
"isNotRegistered": false,
"yearIssue": "2020-01-01"
},
"vehicleDocument": {
"typeCode": "VEHICLE_REGISTRATION_DOCUMENT",
"serial": "9907",
"number": "203341",
"dateIssue": "2022-01-01"
},
"owner": {
"vehicleOwnerPerson": {
"person": {
"firstName": "Иван",
"lastName": "Бунша",
"middleName": "Васильевич",
"birthDate": "1990-01-13",
"citizenship": "RU",
"gender": "M",
"familyState": "MARRIED",
"isResident": true,
"vsk_id": "dcecae73-0185-4b5c-957d-5db63db1784e"
},
"phone": {
"phoneNumber": "79516658860"
},
"email": "test@vsk.ru",
"document": {
"typeCode": "PASSPORT_RF",
"serial": "4007",
"number": "013584",
"dateIssue": "2021-08-08",
"whom": "УФМС",
"divisionCode": "013-451"
},
"address": {
"typeCode": "REGISTRATION",
"countryCode": "RU",
"region": "Челябинская обл",
"city": "г Челябинск",
"street": "пр-кт Ленина",
"house": "4Д",
"flat": "9",
"zipCode": "454085",
"kladrId": "7400000100005080244",
"fiasId": "c88cd1bd-6ff6-4de2-90d8-86e149ada01c",
"addressStr": "454085, Челябинская обл, г Челябинск, Телефон р-н, пр-кит Ленина, д 4Д, кв 9"
}
}
},
"typeLDU": "LIM",
"drivers": [
{
"person": {
"firstName": "Иван",
"lastName": "Бунша",
"middleName": "Васильевич",
"birthDate": "1990-01-13",
"citizenship": "RU",
"gender": "M",
"familyState": "MARRIED",
"isResident": true,
"vsk_id": "8d607187-b0d0-4269-9380-a392cafa939b"
},
"driversLicense": {
"typeCode": "DRIVER_LICENSE",
"serial": "4789",
"number": "032148",
"dateIssue": "2020-01-08"
},
"driveExperience": "2010-02-01",
"kbm": "1",
"isOwner": true,
"isPolicyHolder": true
}
],
"trailer": false,
"transit": false,
"purpose": "PERSONAL",
"primaryDrivingArea": "a376e68d-724a-4472-be7c-891bdb09ae32",
"coefficients": {
"base": "7535",
"kt": "1.88",
"kbm": "1",
"ko": "1",
"kvs": "0.97",
"km": "1.4",
"kp": "1",
"kn": "-1",
"kpr": "-1",
"ks": "1"
},
"isReinsurance": false,
"isProlongation": false,
"covers": [
{
"cover": {
"code": "117"
},
"sumInsured": 400000.00,
"premium": 19237.16
}
]
},
"countryTs": "643",
"periods": {
"startDate1": "2024-04-15T00:00:00+03:00",
"endDate1": "2025-04-15T00:00:00+03:00"
},
"bso": {
"serial": "ААС",
"number": "0321456845"
}
}
Ответ с отказом в возможности страхования (не сегмент):
{
"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
}