Веб сервіси ПЕП МТСБУ. Відповіді.

Інформація нажається в рамках проекту з відкритим кодом http://www.ins.com.ua/inscomsep
 

Документація веб сервісів ПЕП МТСБУ

Документ мітить опис веб сервісів для організації автоматичної взаємодії МТСБУ та страховиків - членів МТСБУ в рамках ПЕП МТСБУ

0.20151130.1 

Загальна інформація про веб сервіси

Усі зазначені в документі web-сервіси розподіляються на 2 групи: “Read-only” та “Read-write”, які розміщені на окремих серверах та повністю розмежовані на рівні сервісів.

Сервіси групи “Read-only” призначені для пошуку інформації, в тому числі про укладені договори обов’язкового страхування та довідники.

Сервіси групи “Read-write” призначені для внесення інформації про укладання договорів обов’язкового страхування, їх переоформлення та дострокового припинення.

Для роботи сервісів використовуються формати RestFUL (варіанти відповіді XML/JSON) та SOAP (формат відповіді XML), опис метаданих у форматі wsdl.

Аутентифікація

Для усіх web-сервісів аутентифікація виконується з допомогою токенів HTTP Basic Auth. Токен вказується при кожному запиті. Приклад:

GET /SomeQuery
Host: HostName
Authentication: RXhhbXBsZVVzZXI6VGVzdDExMVRlc3QK

Для використання сервісів групи “Read-write”, окрім токенів, додатково здійснюється VPN-підключення до захищеної мережі, керування доступом до якої здійснюється МТСБУ.

GetHistory

GetHistory - ByCodeAndPlateNum

1.20160519.0 

Отримання інформації про історію страхових випадків для розрахунку коефіцієнту бонус-малус, пошук за ЄДРПОУ та державним реєстраційним номером транспортного засобу (перетин результату пошуку за кожним з параметрів). Перелік символів, заборонених для використання в параметрах даного веб-сервісу: "%", "&", "*", ":", "<", ">", "+", "#", "/", "?", "". У їх випадку використання - сервер поверне помилку 400 або 404.

https://policy.mtsbu.ua/GetHistory.svc/ByCodeAndPlateNum

Параметр

НазваниеОписание
Code

ЄДРПОУ (8 цифр), ІПН (10 цифр) або серія та номер паспорту для осіб, які не мають ідентифікаційного коду (2 літери та 6 цифр)

PlateNum

Державний реєстраційний номер транспортного засобу (літери та цифри, до 10 символів)

Success 200

НазваниеОписание
BMCoef

Розрахований коефіцієнт бонус-малус (число в діапазоні від 0.5 до 2.45)

BMClass

Клас бонус-малус

History

Інформація про історію страхових випадків у форматі таблиці з полями Dinsurer.Name, MainCode, PolicySeries, PolicyNo, StartYear, DPeriod.Name, Surname, BMClass, CaseCount, DVehicleType.Type, AutoDescr, VIN, TotalClaimedAvount, TotalClaimspaid

HTTP/1.1 200 OK
Content-Length: 658
Content-Type: application/json; charset=UTF-8
Server: Microsoft-IIS/7.5
X-Powered-By: ASP.NET
Date: Fri, 02 Oct 2015 13:24:34 GMT

    {
   "RequestUID": "7a034808-b275-4aa1-8a01-bf3e82277559",
   "RequestExecTime": "00:00:00.1888641",
   "BMClass": "4",
   "BMCoef": "0,95",
   "SearchResult": [   {
      "FContract.FContractID": "273",
      "FContract.DInsurer.Name": "Мотор-Гарант",
      "FContract.MainCode": "",
      "FContract.PolicySeries": "AC",
      "FContract.PolicyNo": "65483",
      "FContract.StartYear": "2015",
      "FContract.DPeriod.Name": "1 рік",
      "FContract.DBonusMalus.Name": "3",
      "FContract.CaseCount": "",
      "FContract.AutoDescr": "VOLKSWAGEN GOLF",
      "FContract.VIN": "WVWZZZ19ZEW546535",
      "FContract.TotalClaimedAvount": "",
      "FContract.TotalClaimspaid": ""
   }]
}

GetHistory - ByID

1.20160519.0 

Отримання інформації про історію страхових випадків для розрахунку коефіцієнту бонус-малус, пошук за ідентифікаційним номером фізичної особи. Перелік символів, заборонених для використання в параметрах даного веб-сервісу: "%", "&", "*", ":", "<", ">", "+", "#", "/", "?", "". У їх випадку використання - сервер поверне помилку 400 або 404.

https://policy.mtsbu.ua/GetHistory.svc/ByID

Параметр

НазваниеОписание
ID

ЄДРПОУ (8 цифр), ІПН (10 цифр) або серія та номер паспорту для осіб, які не мають ідентифікаційного коду (2 літери та 6 цифр)

Success 200

НазваниеОписание
BMCoef

Розрахований коефіцієнт бонус-малус (число в діапазоні від 0.5 до 2.45)

BMClass

Клас бонус-малус

History

Інформація про історію страхових випадків у форматі таблиці з полями Dinsurer.Name, MainCode, PolicySeries, PolicyNo, StartYear, DPeriod.Name, Surname, BMClass, CaseCount, DVehicleType.Type, AutoDescr, VIN, TotalClaimedAvount, TotalClaimspaid

HTTP/1.1 200 OK
Content-Length: 651
Content-Type: application/json; charset=UTF-8
Server: Microsoft-IIS/7.5
X-Powered-By: ASP.NET
Date: Fri, 02 Oct 2015 13:20:55 GMT

{
   "RequestUID": "caed3e52-d729-48d9-b6df-a6eeee31d130",
   "RequestExecTime": "00:00:00.2633945",
   "BMClass": "5",
   "BMCoef": "0,9",
   "SearchResult": [   {
      "FContract.FContractID": "302",
      "FContract.DInsurer.Name": "УПСК",
      "FContract.MainCode": "",
      "FContract.PolicySeries": "AI",
      "FContract.PolicyNo": "8620806",
      "FContract.StartYear": "2015",
      "FContract.DPeriod.Name": "1 рік",
      "FContract.DBonusMalus.Name": "9",
      "FContract.CaseCount": "1",
      "FContract.AutoDescr": "MITSUBISHI LANCER BM3717AX",
      "FContract.VIN": "JMBSRCS3A4U004757",
      "FContract.TotalClaimedAvount": "",
      "FContract.TotalClaimspaid": ""
   }]
}

GetHistory - ByIDOrVIN

1.20160519.0 

Отримання інформації про історію страхових випадків для розрахунку коефіцієнту бонус-малус, пошук за ідентифікаційним номером фізичної особи та VIN транспортного засобу (об’єднання результату пошуку за кожним з параметрів). Перелік символів, заборонених для використання в параметрах даного веб-сервісу: "%", "&", "*", ":", "<", ">", "+", "#", "/", "?", "". У їх випадку використання - сервер поверне помилку 400 або 404.

https://policy.mtsbu.ua/GetHistory.svc/ByIDOrVIN

Параметр

НазваниеОписание
ID

ЄДРПОУ (8 цифр), ІПН (10 цифр) або серія та номер паспорту для осіб, які не мають ідентифікаційного коду (2 літери та 6 цифр)

VIN

VIN (літери та цифри, до 17 символів), при пошуку відбувається наступне приведення символів: I=i=1, O=o=Q=q=0, S=5, G=6, З=3

Success 200

НазваниеОписание
BMCoef

Розрахований коефіцієнт бонус-малус (число в діапазоні від 0.5 до 2.45)

BMClass

Клас бонус-малус

History

Інформація про історію страхових випадків у форматі таблиці з полями Dinsurer.Name, MainCode, PolicySeries, PolicyNo, StartYear, DPeriod.Name, Surname, BMClass, CaseCount, DVehicleType.Type, AutoDescr, VIN, TotalClaimedAvount, TotalClaimspaid

HTTP/1.1 200 OK
Content-Length: 658
Content-Type: application/json; charset=UTF-8
Server: Microsoft-IIS/7.5
X-Powered-By: ASP.NET
Date: Fri, 02 Oct 2015 13:25:08 GMT

{
   "RequestUID": "22f92097-2974-48a5-a365-236140eab001",
   "RequestExecTime": "00:00:00.2476474",
   "BMClass": "2",
   "BMCoef": "1,4",
   "SearchResult": [   {
      "FContract.FContractID": "325",
      "FContract.DInsurer.Name": "УПСК",
      "FContract.MainCode": "",
      "FContract.PolicySeries": "AI",
      "FContract.PolicyNo": "7715582",
      "FContract.StartYear": "2015",
      "FContract.DPeriod.Name": "1 рік",
      "FContract.DBonusMalus.Name": "11",
      "FContract.CaseCount": "2",
      "FContract.AutoDescr": "ВАЗ CHEVROLET NIVA АН2831С?",
      "FContract.VIN": "X9L21230040023969",
      "FContract.TotalClaimedAvount": "",
      "FContract.TotalClaimspaid": ""
   }]
}

GetHistory - ByNameAndPlateNum

1.20160519.0 

Отримання інформації про історію страхових випадків для розрахунку коефіцієнту бонус-малус, пошук за прізвищем особи та державним реєстраційним номером транспортного засобу (перетин результату пошуку за кожним з параметрів). Перелік символів, заборонених для використання в параметрах даного веб-сервісу: "%", "&", "*", ":", "<", ">", "+", "#", "/", "?", "". У їх випадку використання - сервер поверне помилку 400 або 404.

https://policy.mtsbu.ua/GetHistory.svc/ByNameAndPlateNum

Параметр

НазваниеОписание
Name

Прізвище особи (до 100 символів, допускаються літери та спеціальні символи (пробіли, апостроф, дефіс))

PlateNum

Державний реєстраційний номер транспортного засобу (літери та цифри, до 10 символів)

Success 200

НазваниеОписание
BMCoef

Розрахований коефіцієнт бонус-малус (число в діапазоні від 0.5 до 2.45)

BMClass

Клас бонус-малус

History

Інформація про історію страхових випадків у форматі таблиці з полями Dinsurer.Name, MainCode, PolicySeries, PolicyNo, StartYear, DPeriod.Name, Surname, BMClass, CaseCount, DVehicleType.Type, AutoDescr, VIN, TotalClaimedAvount, TotalClaimspaid

HTTP/1.1 200 OK
Content-Length: 637
Content-Type: application/json; charset=UTF-8
Server: Microsoft-IIS/7.5
X-Powered-By: ASP.NET
Date: Fri, 02 Oct 2015 13:23:40 GMT

{
   "RequestUID": "c4fc5b6a-8aa4-49b8-8ee6-3d41d1162b86",
   "RequestExecTime": "00:00:00.2147115",
   "BMClass": "8",
   "BMCoef": "0,75",
   "SearchResult": [   {
      "FContract.FContractID": "282",
      "FContract.DInsurer.Name": "СКАЙД",
      "FContract.MainCode": "",
      "FContract.PolicySeries": "AE",
      "FContract.PolicyNo": "4987000",
      "FContract.StartYear": "2015",
      "FContract.DPeriod.Name": "1 рік",
      "FContract.DBonusMalus.Name": "7",
      "FContract.CaseCount": "",
      "FContract.AutoDescr": "FORD TRANSIT",
      "FContract.VIN": "WF0LXXGBFL4B87080",
      "FContract.TotalClaimedAvount": "",
      "FContract.TotalClaimspaid": ""
   }]
}

GetHistory - ByVIN

1.20160519.0 

Отримання інформації про історію страхових випадків для розрахунку коефіцієнту бонус-малус, пошук за VIN транспортного засобу. Перелік символів, заборонених для використання в параметрах даного веб-сервісу: "%", "&", "*", ":", "<", ">", "+", "#", "/", "?", "". У їх випадку використання - сервер поверне помилку 400 або 404.

https://policy.mtsbu.ua/GetHistory.svc/ByVIN

Параметр

НазваниеОписание
VIN

VIN транспортного засобу (літери та цифри, до 17 символів), при пошуку відбувається наступне приведення символів: I=i=1, O=o=Q=q=0, S=5, G=6, З=3

Success 200

НазваниеОписание
BMCoef

Розрахований коефіцієнт бонус-малус (число в діапазоні від 0.5 до 2.45)

BMClass

Клас бонус-малус

History

Інформація про історію страхових випадків у форматі таблиці з полями Dinsurer.Name, MainCode, PolicySeries, PolicyNo, StartYear, DPeriod.Name, Surname, BMClass, CaseCount, DVehicleType.Type, AutoDescr, VIN, TotalClaimedAvount, TotalClaimspaid

HTTP/1.1 200 OK
Content-Length: 642
Content-Type: application/json; charset=UTF-8
Server: Microsoft-IIS/7.5
X-Powered-By: ASP.NET
Date: Fri, 02 Oct 2015 13:22:34 GMT

{
   "RequestUID": "6a2c8ca9-a16d-4630-bbaa-f377cb9633cd",
   "RequestExecTime": "00:00:00.1817401",
   "BMClass": "12",
   "BMCoef": "0,55",
   "SearchResult": [   {
      "FContract.FContractID": "286",
      "FContract.DInsurer.Name": "СКАЙД",
      "FContract.MainCode": "Q4PFR8",
      "FContract.PolicySeries": "AE",
      "FContract.PolicyNo": "4976749",
      "FContract.StartYear": "2015",
      "FContract.DPeriod.Name": "1 рік",
      "FContract.DBonusMalus.Name": "11",
      "FContract.CaseCount": "",
      "FContract.AutoDescr": "ВАЗ 2106",
      "FContract.VIN": "XTA210600H1631625",
      "FContract.TotalClaimedAvount": "",
      "FContract.TotalClaimspaid": ""
   }]
}

GetPhysical

GetPhysical - ByID

1.20160519.0 

Отримання інформації про фізичну особу, пошук за ідентифікаційним номером фізичної особи. Перелік символів, заборонених для використання в параметрах даного веб-сервісу: "%", "&", "*", ":", "<", ">", "+", "#", "/", "?", "". У їх випадку використання - сервер поверне помилку 400 або 404.

https://policy.mtsbu.ua/GetPhysical.svc/ByID

Параметр

НазваниеОписание
ID

Ідентифікаційний номер фізичної особи (10 цифр, або 2 літери та 6 цифр (серія та номер паспорту для осіб, які не мають ідентифікаційного коду))

Success 200

НазваниеОписание
Surname

Прізвище

Name

Ім'я

PName

По-батькові

HTTP/1.1 200 OK
Content-Length: 255
Content-Type: application/json; charset=UTF-8
Server: Microsoft-IIS/7.5
X-Powered-By: ASP.NET
Date: Fri, 02 Oct 2015 13:26:32 GMT

{
   "RequestUID": "93a2d474-a244-4b26-94f2-556683592fe8",
   "RequestExecTime": "00:00:00.1366442",
   "SearchResult": [   {
      "FContract.Surname": "Соколов",
      "FContract.Name": "Юрiй",
      "FContract.PName": "Вiкторович"
   }]
}

GetVehicle

GetVehicle - ByPlateNum

1.20160519.0 

Отримання інформації про транспортний засіб, пошук за державним реєстраційним номером транспортного засобу та, при необхідності, його маркою. Перелік символів, заборонених для використання в параметрах даного веб-сервісу: "%", "&", "*", ":", "<", ">", "+", "#", "/", "?", "". У їх випадку використання - сервер поверне помилку 400 або 404.

https://policy.mtsbu.ua/GetVehicle.svc/ByPlateNum

Параметр

НазваниеОписание
PlateNum

Державний реєстраційний номер транспортного засобу (літери та цифри, до 10 символів)

Mark

Марка авто (ціле число, параметр не обов’язковий)

Success 200

НазваниеОписание
VIN

VIN транспортного засобу;

FContract_RegNo

Державний реєстраційний номер транспортного засобу;

FContract_DMarkID

Код марки транспортного засобу;

FContract_DMark_Name

Назва марки транспортного засобу;

FContract_DModelID

Код моделі транспортного засобу;

FContract_DModel_Name

Назва моделі транспортного засобу;

FContract_VehicleType_Code

Тип транспортного засобу.

HTTP/1.1 200 OK
Content-Length: 426
Content-Type: application/json; charset=UTF-8
Server: Microsoft-IIS/7.5
X-Powered-By: ASP.NET
Date: Fri, 02 Oct 2015 13:31:24 GMT
{
	"RequestUID":"3f67ac5b-0e18-4b4e-a298-170f3d990e55"
	"RequestExecTime":"00:00:00.1139102"
	"SearchResult":
	[
		{
			"FContract.VIN":"VF1KSRB1547699163",
			"FContract.RegNo":"AA4057MH",
			"FContract.DMarkID":"138",
			"FContract.DMark.Name":"RENAULT",
			"FContract.DModelID":"10536",
			"FContract.DModel.Name":"Logan",
			"FContract.DVehicleType.Type":"B1",
			"FContract.FContractID":"278"
		}
	]
}

GetVehicle - ByVIN

1.20160519.0 

Отримання інформації про транспортний засіб, пошук за VIN транспортного засобу. Перелік символів, заборонених для використання в параметрах даного веб-сервісу: "%", "&", "*", ":", "<", ">", "+", "#", "/", "?", "". У їх випадку використання - сервер поверне помилку 400 або 404.

https://policy.mtsbu.ua/GetVehicle.svc/ByVIN

Параметр

НазваниеОписание
VIN

VIN транспортного засобу (літери та цифри, до 17 символів), при пошуку відбувається наступне приведення символів: I=i=1, O=o=Q=q=0, S=5, G=6, З=3

Success 200

НазваниеОписание
VIN

VIN транспортного засобу;

FContract_RegNo

Державний реєстраційний номер транспортного засобу;

FContract_DMarkID

Код марки транспортного засобу;

FContract_DMark_Name

Назва марки транспортного засобу;

FContract_DModelID

Код моделі транспортного засобу;

FContract_DModel_Name

Назва моделі транспортного засобу;

FContract_VehicleType_Code

Тип транспортного засобу.

HTTP/1.1 200 OK
Content-Length: 422
Content-Type: application/json; charset=UTF-8
Server: Microsoft-IIS/7.5
X-Powered-By: ASP.NET
Date: Fri, 02 Oct 2015 13:30:42 GMT

{
   "RequestUID": "d5786cde-79d3-49f0-9669-621183a8be98",
   "RequestExecTime": "00:00:00.1761947",
   "SearchResult": [   {
      "FContract.VIN": "XTA210600H1631625",
      "FContract.RegNo": "50769KX",
      "FContract.DMarkID": "215",
      "FContract.DMark.Name": "ВАЗ",
      "FContract.DModelID": "7291",
      "FContract.DModel.Name": "2106",
      "FContract.DVehicleType.Type": "B1",
      "FContract.FContractID": "286"
   }]
}

GetStatus

GetStatus - ByCode

1.20160519.0 

Отримання інформації про статус полісу, пошук за кодом електронного полісу. Перелік символів, заборонених для використання в параметрах даного веб-сервісу: "%", "&", "*", ":", "<", ">", "+", "#", "/", "?", "". У їх випадку використання - сервер поверне помилку 400 або 404.

https://policy.mtsbu.ua/GetStatus.svc/ByCode

Параметр

НазваниеОписание
Code

Код електронного полісу (літери та цифри, 6 символів (включаючи контрольний символ по спец. алгоритму))

Success 200

НазваниеОписание
FContract_MainCode

Код електронного полісу

FContract_PolicySeries

Серія паперового полісу

FContract_PolicyNo

Номер паперового полісу

FContract_DForm_Code

Форма договору (“Physical” - Фізичний (паперовий), “Digital” - Електронний)

FContract_DViewStatus_Code

Статус договору ("Active" - Укладений (емітований/діючий договір), "Canceled" - Достроково припинений, "Duplicate" - Дублікат (паперовий), "Renewed" - Переоформлений (паперовий), "Reserve" - Активна заявка, "CanceledReserve" - Анульована заявка, "OverDueReserve" - Прострочена заявка, "Finished" - Договір, що закінчив свою дію (строково), "NotStarted" - Договір строк дії якого ще не настав)

RequestDate

Дата запиту

FContract_DInsurer_Name

Назва страховика

FContract_DInsurer_StatusDescr

Статус страховика

FContract_DInsurer_OutDate

Дата втрати страховиком членства в МТСБУ

FContract_DInsurer_Phone

Телефон страховика

FContract_DInsurer_Fax

Факс страховика

FContract_DInsurer_EMail

E-mail страховика

FContract_DInsurer_PostAddress

Поштова адреса страховика

FContract_DInsurer_WebSite

Сайт страховика

FContract_RegNo

Державний реєстраційний номер транспортного засобу

FContract_VIN

VIN транспортного засобу

FContract_DVehicleType_Code

Код типу транспортного засобу

FContract_DVehicleType_Name

Назва типу транспортного засобу

FContract_DMarkID

Код марки транспортного засобу

FContract_DModelID

Код моделі транспортного засобу

FContract_AutoDescr

Повна назва транспортного засобу;

FContract_OldCode

Номер попереднього договору (у випадку переоформлення з іншого договору)

FContract_NewCode

Номер наступного договору (у випадку переоформлення на інший договір)

FContract_LifeLimit

Ліміт відповідальності для збитку типу "майно"

FContract_PropertyLimit

Ліміт відповідальності для збитку типу "життя та здоров'я"

FContract_Franchise

Розмір франшизи

HTTP/1.1 200 OK
Content-Length: 1029
Content-Type: application/json; charset=UTF-8
Server: Microsoft-IIS/7.5
X-Powered-By: ASP.NET
Date: Fri, 02 Oct 2015 13:32:38 GMT

{
   "RequestUID": "1c2b219d-f7ed-4117-9c6d-298f3886666e",
   "RequestExecTime": "00:00:00.1682026",
   "SearchResult": [   {
      "FContract.MainCode": "Q4PFR8",
      "FContract.PolicySeries": "",
      "FContract.PolicyNo": "",
      "FContract.DForm.Code": "Digital",
      "FContract.DViewStatus.Code": "Active ",
      "FContract.DInsurer.Name": "СКАЙД",
      "FContract.DInsurer.DInsurerStatus.Name": "Асоційований член МТСБУ",
      "FContract.DInsurer.OutDate": "",
      "FContract.DInsurer.PhoneNo": "(04596) 44-132, 44-549",
      "FContract.DInsurer.Fax": "(04596) 44-549",
      "FContract.DInsurer.EMail": "avto@skide.com.ua",
      "FContract.DInsurer.PostAddress": "07353, Київська обл., село Старі Петрівці, вул. Дніпровська, 4-А, оф. 3",
      "FContract.DInsurer.WebSite": "www.skide.com.ua",
      "FContract.RegNo": "50769KX",
      "FContract.VIN": "XTA210600H1631625",
      "FContract.DVehicleType.Type": "B1",
      "FContract.DVehicleType.Name": "легковий автомобіль до 1600 кубічних сантиметрів;",
      "FContract.DMarkID": "215",
      "FContract.DModelID": "7291",
      "FContract.AutoDescr": "ВАЗ 2106",
      "FContract.OldCode": "",
      "FContract.NewCode": "",
      "FContract.LifeLimit": "",
      "FContract.PropertyLimit": "",
      "FContract.Franchise": "500,0000"
   }]
}

GetStatus - ByPlateNum

1.20160519.0 

Отримання інформації про статус полісу, пошук за державним реєстраційним номером транспортного засобу. Перелік символів, заборонених для використання в параметрах даного веб-сервісу: "%", "&", "*", ":", "<", ">", "+", "#", "/", "?", "". У їх випадку використання - сервер поверне помилку 400 або 404.

https://policy.mtsbu.ua/GetStatus.svc/ByPlateNum

Параметр

НазваниеОписание
PlateNum

Державний реєстраційний номер транспортного засобу (літери та цифри, до 10 символів)

Success 200

НазваниеОписание
FContract_MainCode

Код електронного полісу

FContract_PolicySeries

Серія паперового полісу

FContract_PolicyNo

Номер паперового полісу

FContract_DForm_Code

Форма договору (“Physical” - Фізичний (паперовий), “Digital” - Електронний)

FContract_DViewStatus_Code

Статус договору ("Active" - Укладений (емітований/діючий договір), "Canceled" - Достроково припинений, "Duplicate" - Дублікат (паперовий), "Renewed" - Переоформлений (паперовий), "Reserve" - Активна заявка, "CanceledReserve" - Анульована заявка, "OverDueReserve" - Прострочена заявка, "Finished" - Договір, що закінчив свою дію (строково), "NotStarted" - Договір строк дії якого ще не настав)

RequestDate

Дата запиту

FContract_DInsurer_Name

Назва страховика

FContract_DInsurer_StatusDescr

Статус страховика

FContract_DInsurer_OutDate

Дата втрати страховиком членства в МТСБУ

FContract_DInsurer_Phone

Телефон страховика

FContract_DInsurer_Fax

Факс страховика

FContract_DInsurer_EMail

E-mail страховика

FContract_DInsurer_PostAddress

Поштова адреса страховика

FContract_DInsurer_WebSite

Сайт страховика

FContract_RegNo

Державний реєстраційний номер транспортного засобу

FContract_VIN

VIN транспортного засобу

FContract_DVehicleType_Code

Код типу транспортного засобу

FContract_DVehicleType_Name

Назва типу транспортного засобу

FContract_DMarkID

Код марки транспортного засобу

FContract_DModelID

Код моделі транспортного засобу

FContract_AutoDescr

Повна назва транспортного засобу;

FContract_OldCode

Номер попереднього договору (у випадку переоформлення з іншого договору)

FContract_NewCode

Номер наступного договору (у випадку переоформлення на інший договір)

FContract_LifeLimit

Ліміт відповідальності для збитку типу "майно"

FContract_PropertyLimit

Ліміт відповідальності для збитку типу "життя та здоров'я"

FContract_Franchise

Розмір франшизи

HTTP/1.1 200 OK
Content-Length: 1272
Content-Type: application/json; charset=UTF-8
Server: Microsoft-IIS/7.5
X-Powered-By: ASP.NET
Date: Fri, 23 Oct 2015 14:12:22 GMT
{
	"RequestUID":"2ed2588c-f760-4123-a7f8-ed65865b927f",
	"RequestExecTime":"00:00:00.2404533",
	"SearchResult":  [   {
      "FContract.MainCode": "",
      "FContract.PolicySeries": "AE",
      "FContract.PolicyNo": "5641495",
      "FContract.DForm.Code": "Physical",
      "FContract.DViewStatus.Code": "Active ",
      "FContract.DInsurer.Name": "УНІКА",
      "FContract.DInsurer.DInsurerStatus.Name": "Повний член МТСБУ",
      "FContract.DInsurer.OutDate": "",
      "FContract.DInsurer.PhoneNo": "+38 (044) 225-60-00, +38 (044) 225-60-02",
      "FContract.DInsurer.Fax": "+38 (044) 225-60-02",
      "FContract.DInsurer.EMail": "office@uniqa.ua",
      "FContract.DInsurer.PostAddress": "м. Київ, вул. Саксаганського, 70-А",
      "FContract.DInsurer.WebSite": "www.uniqua.com",
      "FContract.RegNo": "AA4057MH",
      "FContract.VIN": "VF1KSRB1547699163",
      "FContract.DVehicleType.Type": "B1",
      "FContract.DVehicleType.Name": "легковий автомобіль до 1600 кубічних сантиметрів;",
      "FContract.DMarkID": "138",
      "FContract.DModelID": "10536",
      "FContract.AutoDescr": "RENAULT LOGAN",
      "FContract.OldCode": "",
      "FContract.NewCode": "",
      "FContract.LifeLimit": "100000,0000",
      "FContract.PropertyLimit": "50000,0000",
      "FContract.Franchise": "500,0000"
		}
	]
}

GetStatus - BySeriesAndNumber

1.20160519.0 

Отримання інформації про статус полісу, пошук за серією та номером паперового полісу. Перелік символів, заборонених для використання в параметрах даного веб-сервісу: "%", "&", "*", ":", "<", ">", "+", "#", "/", "?", "". У їх випадку використання - сервер поверне помилку 400 або 404.

https://policy.mtsbu.ua/GetStatus.svc/BySeriesAndNumber

Параметр

НазваниеОписание
Series

Серія паперового полісу (2 літери)

Number

Номер паперового полісу (7 цифр)

Success 200

НазваниеОписание
FContract_MainCode

Код електронного полісу

FContract_PolicySeries

Серія паперового полісу

FContract_PolicyNo

Номер паперового полісу

FContract_DForm_Code

Форма договору (“Physical” - Фізичний (паперовий), “Digital” - Електронний)

FContract_DViewStatus_Code

Статус договору ("Active" - Укладений (емітований/діючий договір), "Canceled" - Достроково припинений, "Duplicate" - Дублікат (паперовий), "Renewed" - Переоформлений (паперовий), "Reserve" - Активна заявка, "CanceledReserve" - Анульована заявка, "OverDueReserve" - Прострочена заявка, "Finished" - Договір, що закінчив свою дію (строково), "NotStarted" - Договір строк дії якого ще не настав)

RequestDate

Дата запиту

FContract_DInsurer_Name

Назва страховика

FContract_DInsurer_StatusDescr

Статус страховика

FContract_DInsurer_OutDate

Дата втрати страховиком членства в МТСБУ

FContract_DInsurer_Phone

Телефон страховика

FContract_DInsurer_Fax

Факс страховика

FContract_DInsurer_EMail

E-mail страховика

FContract_DInsurer_PostAddress

Поштова адреса страховика

FContract_DInsurer_WebSite

Сайт страховика

FContract_RegNo

Державний реєстраційний номер транспортного засобу

FContract_VIN

VIN транспортного засобу

FContract_DVehicleType_Code

Код типу транспортного засобу

FContract_DVehicleType_Name

Назва типу транспортного засобу

FContract_DMarkID

Код марки транспортного засобу

FContract_DModelID

Код моделі транспортного засобу

FContract_AutoDescr

Повна назва транспортного засобу;

FContract_OldCode

Номер попереднього договору (у випадку переоформлення з іншого договору)

FContract_NewCode

Номер наступного договору (у випадку переоформлення на інший договір)

FContract_LifeLimit

Ліміт відповідальності для збитку типу "майно"

FContract_PropertyLimit

Ліміт відповідальності для збитку типу "життя та здоров'я"

FContract_Franchise

Розмір франшизи

HTTP/1.1 200 OK
Content-Length: 1010
Content-Type: application/json; charset=UTF-8
Server: Microsoft-IIS/7.5
X-Powered-By: ASP.NET
Date: Fri, 02 Oct 2015 13:33:31 GMT

{
   "RequestUID": "1976a364-44a8-4018-84fe-5c3b9ac839fc",
   "RequestExecTime": "00:00:00.1300572",
   "SearchResult": [   {
      "FContract.MainCode": "",
      "FContract.PolicySeries": "AI",
      "FContract.PolicyNo": "8620839",
      "FContract.DForm.Code": "Physical",
      "FContract.DViewStatus.Code": "Active ",
      "FContract.DInsurer.Name": "УПСК",
      "FContract.DInsurer.DInsurerStatus.Name": "Асоційований член МТСБУ",
      "FContract.DInsurer.OutDate": "",
      "FContract.DInsurer.PhoneNo": "(044) 230-86-45, 417-16-15",
      "FContract.DInsurer.Fax": "238-66-15",
      "FContract.DInsurer.EMail": "t.stoyka@upsk.com.ua",
      "FContract.DInsurer.PostAddress": "04080, м. Київ, вул. Кирилівська, 40",
      "FContract.DInsurer.WebSite": "www.upsk.com.ua",
      "FContract.RegNo": "02539CB",
      "FContract.VIN": "8832291",
      "FContract.DVehicleType.Type": "F",
      "FContract.DVehicleType.Name": "причепи до легкових автомобілів                 ",
      "FContract.DMarkID": "472",
      "FContract.DModelID": "9361",
      "FContract.AutoDescr": "МАЗ 8114 02539СВ",
      "FContract.OldCode": "",
      "FContract.NewCode": "",
      "FContract.LifeLimit": "100000,0000",
      "FContract.PropertyLimit": "50000,0000",
      "FContract.Franchise": "500,0000"
   }]
}

GetDicts

GetDicts - GetMREOCities

1.20160519.0 

Отримання повного довідника населених пунктів, що мають МРЕО

https://policy.mtsbu.ua/GetDicts.svc/GetMREOCities

Параметр

НазваниеОписание
NULL

Вхідні параметри відсутні

Success 200

НазваниеОписание
DMREOCityID

Ідентифікатор населеного пункту, що має МРЕО;

ZoneCode

Код зони реєстрації;

KOATUU

Код згідно КОАТУУ;

Name

Назва населеного пункту;

TypeOp

Статус операції;

LastDate

Дата останньої операції.

HTTP/1.1 200 OK
Content-Length: 264
Content-Type: application/json; charset=UTF-8
Server: Microsoft-IIS/7.5
X-Powered-By: ASP.NET
Date: Fri, 02 Oct 2015 14:25:24 GMT
{
	"RequestUID":"00000000-0000-0000-0000-000000000000",
	"RequestExecTime":"00:00:01.3221672",
	"DCity":
	[
		
		{
			"DMREOCityID":"8",
			"Name":"Білогірськ",
			"KOATUU":"0120710100",
			"ZoneCode":"5",
			"TypeOp":"U",
			"LastDate":"11.06.2013 13:38:36"
		},
		{
			"DMREOCityID":"9",
			"Name":"Вінниця",
			"KOATUU":"0510100000",
			"ZoneCode":"4",
			"TypeOp":"U",
			"LastDate":"11.06.2013 13:38:36"
		},
		{
			"DMREOCityID":"10",
			"Name":"Жмеринка",
			"KOATUU":"0510300000",
			"ZoneCode":"5",
			"TypeOp":"U",
			"LastDate":"11.06.2013 13:38:36"
		}
	]
}

GetDicts - GetMREOCitiesChanges

1.20160519.0 

Отримання змін у довіднику населених пунктів, що мають МРЕО, за період

https://policy.mtsbu.ua/GetDicts.svc/GetMREOCitiesChanges

Параметр

НазваниеОписание
StartDate

Дата початку періоду (у форматі ррррммдд)

EndDate

Дата закінчення періоду (у форматі ррррммдд)

Success 200

НазваниеОписание
DMREOCityID

Ідентифікатор населеного пункту, що має МРЕО;

ZoneCode

Код зони реєстрації;

KOATUU

Код згідно КОАТУУ;

Name

Назва населеного пункту;

TypeOp

Статус операції;

LastDate

Дата останньої операції.

HTTP/1.1 200 OK
Content-Length: 264
Content-Type: application/json; charset=UTF-8
Server: Microsoft-IIS/7.5
X-Powered-By: ASP.NET
Date: Fri, 02 Oct 2015 14:25:24 GMT

{
	"RequestUID":"00000000-0000-0000-0000-000000000000"
	"RequestExecTime":"00:00:00.0867270"
	"DCity":
	[
		{
			"DMREOCityID":"196",
			"Name":"Лозова",
			"KOATUU":"6311000000",
			"ZoneCode":"5",
			"TypeOp":"U",
			"LastDate":"30.09.2015 14:13:55"
		}
	]

}

GetDicts - GetMarks

1.20160519.0 

Отримання повного довідника марок авто

https://policy.mtsbu.ua/GetDicts.svc/GetMarks

Параметр

НазваниеОписание
NULL

Вхідні параметри відсутні

Success 200

НазваниеОписание
DMarkID

Ідентифікатор марки

Name

Назва марки (укр)

NameRu

Назва марки (рос)

NameEn

Назва марки (англ)

TypeOp

Статус операції

LastDate

Дата останньої операції

HTTP/1.1 200 OK
Content-Length: 207894
Content-Type: application/json; charset=UTF-8
Server: Microsoft-IIS/7.5
X-Powered-By: ASP.NET
Date: Fri, 02 Oct 2015 13:37:37 GMT

{
	"RequestUID":"00000000-0000-0000-0000-000000000000"
	"RequestExecTime":"00:00:00.0486460"
	"DMark":
	[		
		{
			"DMarkID":"1",
			"Name":"KC",
			"NameEn":"KC",
			"NameRu":"",
			"TypeOp":"I",
			"LastDate":"16.09.2011 18:14:32"
		},
		{
			"DMarkID":"2",
			"Name":"POP",
			"NameEn":"",
			"NameRu":"",
			"TypeOp":"I",
			"LastDate":"16.09.2011 18:12:20"
		}
	]
}

GetDicts - GetMarksChanges

1.20160519.0 

Отримання змін у довіднику марок авто за період

https://policy.mtsbu.ua/GetDicts.svc/GetMarksChanges

Параметр

НазваниеОписание
StartDate

Дата початку періоду (у форматі ррррммдд)

EndDate

Дата закінчення періоду (у форматі ррррммдд)

Success 200

НазваниеОписание
DMarkID

Ідентифікатор марки

Name

Назва марки (укр)

NameRu

Назва марки (рос)

NameEn

Назва марки (англ)

TypeOp

Статус операції

LastDate

Дата останньої операції

HTTP/1.1 200 OK
Content-Length: 280
Content-Type: application/json; charset=UTF-8
Server: Microsoft-IIS/7.5
X-Powered-By: ASP.NET
Date: Mon, 26 Oct 2015 13:32:47 GMT

{
	"RequestUID":"00000000-0000-0000-0000-000000000000",
	"RequestExecTime":"00:00:00.0865583",
	"DMark":
	[
		{
			"DMarkID":"22",
			"Name":"HANJIANG",
			"NameEn":"HANJIANG",
			"NameRu":"HANJIANG",
			"TypeOp":"U",
			"LastDate":"26.10.2015 15:32:41"
		}
	]

}

GetDicts - GetModels

1.20160519.0 

Отримання повного довідника моделей авто

https://policy.mtsbu.ua/GetDicts.svc/GetModels

Параметр

НазваниеОписание
NULL

Вхідні параметри відсутні

Success 200

НазваниеОписание
DModelID

Ідентифікатор моделі

DMarkID

Ідентифікатор марки

Name

Назва моделі (укр)

NameRu

Назва моделі (рос)

NameEn

Назва моделі (англ)

TypeOp

Статус операції

LastDate

Дата останньої операції

HTTP/1.1 200 OK
Content-Length: 264
Content-Type: application/json; charset=UTF-8
Server: Microsoft-IIS/7.5
X-Powered-By: ASP.NET
Date: Fri, 02 Oct 2015 14:25:24 GMT
{
	"RequestUID":"00000000-0000-0000-0000-000000000000",
	"RequestExecTime":"00:00:01.7767705",
	"DModel":
	[
				{
			"DModelID":"1",
			"Name":"ACE",
			"DMarkID":"57",
			"NameEn":"ACE",
			"NameRu":"Айс",
			"TypeOp":"U",
			"LastDate":"26.01.2010 13:07:15"
		},
		{
			"DModelID":"2",
			"Name":"COBRA",
			"DMarkID":"57",
			"NameEn":"COBRA",
			"NameRu":"Кобра",
			"TypeOp":"U",
			"LastDate":"26.01.2010 13:07:15"
		},
		{
			"DModelID":"3",
			"Name":"FRUEHAUF",
			"DMarkID":"295",
			"NameEn":"FRUEHAUF",
			"NameRu":"Фрюхауф",
			"TypeOp":"U",
			"LastDate":"26.01.2010 13:07:15"
		}
	]
}

GetDicts - GetModelsChanges

1.20160519.0 

Отримання змін у довіднику моделей авто за період

https://policy.mtsbu.ua/GetDicts.svc/GetModelsChanges

Параметр

НазваниеОписание
StartDate

Дата початку періоду (у форматі ррррммдд)

EndDate

Дата закінчення періоду (у форматі ррррммдд)

Success 200

НазваниеОписание
DModelID

Ідентифікатор моделі

DMarkID

Ідентифікатор марки

Name

Назва моделі (укр)

NameRu

Назва моделі (рос)

NameEn

Назва моделі (англ)

TypeOp

Статус операції

LastDate

Дата останньої операції

HTTP/1.1 200 OK
Content-Length: 264
Content-Type: application/json; charset=UTF-8
Server: Microsoft-IIS/7.5
X-Powered-By: ASP.NET
Date: Fri, 02 Oct 2015 14:25:24 GMT
{
	"RequestUID":"00000000-0000-0000-0000-000000000000",
	"RequestExecTime":"00:00:01.7717208",
	"DModel":
	[		
		{
			"DModelID":"1",
			"Name":"ACE",
			"DMarkID":"57",
			"NameEn":"ACE",
			"NameRu":"Айс",
			"TypeOp":"U",
			"LastDate":"26.10.2015 13:07:15"
		},
		{
			"DModelID":"2",
			"Name":"COBRA",
			"DMarkID":"57",
			"NameEn":"COBRA",
			"NameRu":"Кобра",
			"TypeOp":"U",
			"LastDate":"26.10.2015 13:07:15"
		}
	]
}

GetChanges

GetChanges - ByCode

1.20160519.0 

Отримання інформації про історію операцій щодо договору обов’язкового страхування, пошук за кодом електронного полісу.

https://policy.mtsbu.ua/GetChanges.svc/ByCode

Параметр

НазваниеОписание
Code

Код електронного полісу (літери та цифри, 6 символів (включаючи контрольний символ по спец. алгоритму))

Success 200

НазваниеОписание
TypeOp

Тип операції

DateOp

Фактична дата та час здійснення операції

OldMainCode

Номер попереднього договору страхування (у випадку здійснення операції переоформлення)

NewMainCode

Номер договору страхування, на який було переоформлено договір (у випадку здійснення операції переоформлення)

HTTP/1.1 200 OK
Content-Length: 231
Content-Type: application/json; charset=UTF-8
Server: Microsoft-IIS/7.5
X-Powered-By: ASP.NET
Date: Mon, 26 Oct 2015 13:28:55 GMT

{
	"RequestUID":"00000000-0000-0000-0000-000000000000",
	"RequestExecTime":"00:00:00.0742881",
	"":
	[
		{
			"TypeOp":"Renew",
			"DateOp":"21.10.2015 10:11",
			"OldMainCode":"7357CD",
			"NewMainCode":""
		}
	]
}

ChangeContracts

ChangeContracts - CancelActive

1.20160519.0 

Дострокове припинення дії договору. Даний web-сервіс відноситься до групи “Read-write”. Вхідні параметри потребують значної кількості перевірок коректності типів, у зв’язку з чим основним форматом роботи сервісу є SOAP. Для формування рядка для цифрового підпису можна використати запит GetSignStringFromCancelActive.

https://policyrw.mtsbu.ua/ChangeContracts.svc/CancelActive

Параметр

НазваниеОписание
CCancelActiveRequest

Контейнер для CancelActiveData, DigitalSignature

  CancelActiveData

Контейнер для MainCode, ActionDate, RetPremium

    MainCode

Код електронного полісу (заявки)

    ActionDate

Дата та час здійснення операції (допускається відхилення від серверного часу до 60 секунд, необхідна передача з боку страховика для забезпечення неспростовності за рахунок накладання на дані запиту ЕЦП)

    RetPremium

Сума повернення

  DigitalSignature

Блок ЕЦП

Success 200

НазваниеОписание
CCancelActionResult

Екземпляр класу CCancelActionResult

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/" xmlns:u="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
    <s:Header>
        <o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
            <u:Timestamp u:Id="_0">
                <u:Created>2015-11-09T14:07:35.092Z</u:Created>
                <u:Expires>2015-11-09T14:12:35.092Z</u:Expires>
            </u:Timestamp>
        </o:Security>
    </s:Header>
    <s:Body>
        <CancelActiveResponse xmlns="http://kitsoft.kiev.ua/mtsbu/2015/07/30">
            <CancelActiveResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                <CancelFault i:nil="true" xmlns:a="http://schemas.datacontract.org/2004/07/MTSBU.Service.Faults"/>
                <IsSucceded>true</IsSucceded>
                <MainCode>C1683C</MainCode>
                <RequestExecuteTime>PT0.005781S</RequestExecuteTime>
                <TransactionKey>0a997be5-a177-46d2-a91c-149fd23e9a68</TransactionKey>
            </CancelActiveResult>
        </CancelActiveResponse>
    </s:Body>
</s:Envelope>

ChangeContracts - CancelReserve

1.20160519.0 

Примусове (на відміну від автоматичного) анулювання заявки. Даний web-сервіс відноситься до групи “Read-write”. Вхідні параметри потребують значної кількості перевірок коректності типів, у зв’язку з чим основним форматом роботи сервісу є SOAP. Для формування рядка для цифрового підпису можна використати запит GetSignStringFromCancelReserve.

https://policyrw.mtsbu.ua/ChangeContracts.svc/CancelReserve

Параметр

НазваниеОписание
CCancelReserveRequest

Контейнер для CancelReserveData, DigitalSignature

  CancelReserveData

Контейнер для MainCode, ActionDate

    MainCode

Код електронного полісу (заявки)

    ActionDate

Дата та час здійснення операції (допускається відхилення від серверного часу до 60 секунд, необхідна передача з боку страховика для забезпечення неспростовності за рахунок накладання на дані запиту ЕЦП)

  DigitalSignature

Блок ЕЦП

Success 200

НазваниеОписание
CCancelActionResult

Екземпляр класу CCancelActionResult

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/" xmlns:u="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
    <s:Header>
        <o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
            <u:Timestamp u:Id="_0">
                <u:Created>2015-11-09T14:21:30.008Z</u:Created>
                <u:Expires>2015-11-09T14:26:30.008Z</u:Expires>
            </u:Timestamp>
        </o:Security>
    </s:Header>
    <s:Body>
        <CancelReserveResponse xmlns="http://kitsoft.kiev.ua/mtsbu/2015/07/30">
            <CancelReserveResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                <CancelFault i:nil="true" xmlns:a="http://schemas.datacontract.org/2004/07/MTSBU.Service.Faults"/>
                <IsSucceded>true</IsSucceded>
                <MainCode>8BFD03</MainCode>
                <RequestExecuteTime>PT0.0046241S</RequestExecuteTime>
                <TransactionKey>f72754de-ce54-4e5c-8fd2-847687c10821</TransactionKey>
            </CancelReserveResult>
        </CancelReserveResponse>
    </s:Body>
</s:Envelope>

ChangeContracts - CheckNew

1.20160519.0 

Перевірка даних заявки/договору. Даний web-сервіс відноситься до групи “Read-write”. Вхідні параметри потребують значної кількості перевірок коректності типів, у зв’язку з чим основним форматом роботи сервісу є SOAP. Для формування рядка для цифрового підпису можна використати запит GetSignFromRequest.

https://policyrw.mtsbu.ua/ChangeContracts.svc/CheckNew

Параметр

НазваниеОписание
CContractRequest

Контейнер для Contract, InputMessageID, DigitalSignature

  Contract

Дані договору (екземпляр класу CContract)

  InputMessageID

Унікальний ідентифікатор, що заповнюється зі сторони страховика для більш зручного співставлення запитів та відповідей

  DigitalSignature

Блок ЕЦП який накладається на дані договору

Success 200

НазваниеОписание
CCheckActionResult

Екземпляр класу CCheckActionResult

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/" xmlns:u="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
   <s:Header>
      <ActivityId CorrelationId="a69a73e6-38b1-4986-a140-11d972bf61b7" xmlns="http://schemas.microsoft.com/2004/09/ServiceModel/Diagnostics">fa8ee277-e4c9-4811-a5f2-99c3717a1cb8</ActivityId>
      <o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
         <u:Timestamp u:Id="_0">
            <u:Created>2015-11-02T16:28:07.307Z</u:Created>
            <u:Expires>2015-11-02T16:33:07.307Z</u:Expires>
         </u:Timestamp>
      </o:Security>
   </s:Header>
   <s:Body>
      <CheckNewResponse xmlns="http://kitsoft.kiev.ua/mtsbu/2015/07/30">
         <CheckNewResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <EndDate>2016-09-01T23:59:00</EndDate>
            <InsurerRowKey i:nil="true"/>
            <IsSucceded>true</IsSucceded>
            <RequestExecuteTime>PT0.0032273S</RequestExecuteTime>
            <TransactionKey>c59c4c49-240c-4161-a608-374c4f8b154f</TransactionKey>
            <ValidationFault i:nil="true" xmlns:a="http://schemas.datacontract.org/2004/07/MTSBU.Service.Faults"/>
         </CheckNewResult>
      </CheckNewResponse>
   </s:Body>
</s:Envelope>

ChangeContracts - Confirm

1.20160519.0 

Підтвердження укладання договору. Даний web-сервіс відноситься до групи “Read-write”. Вхідні параметри потребують значної кількості перевірок коректності типів, у зв’язку з чим основним форматом роботи сервісу є SOAP. Для формування рядка для цифрового підпису можна використати запит GetSignStringFromConfirm.

https://policyrw.mtsbu.ua/ChangeContracts.svc/Confirm

Параметр

НазваниеОписание
CConfirmRequest

Контейнер для ConfirmData, DigitalSignature

  ConfirmData

Контейнер для MainCode, AutoCorrectStartDate, ActionDate

    MainCode

Код електронного полісу (заявки)

    AutoCorrectStartDate

Ознака автоматичного корегування дати початку дії договору (враховується якщо дата та час початку дії договору вказана у заявці менша за дату здійсненої операції: якщо даний параметр = “так”, то дата початку дії договору змінюється на поточну дату та час здійснення операції; у іншому випадку повертається повідомлення про помилку «Дата початку дії договору менша за дату та час здійснення операції»)

    ActionDate

Дата та час здійснення операції (допускається відхилення від серверного часу до 60 секунд, необхідна передача з боку страховика для забезпечення неспростовності за рахунок накладання на дані запиту ЕЦП)

  DigitalSignature

Блок ЕЦП

Success 200

НазваниеОписание
CConfirmActionResult

Екземпляр класу CConfirmActionResult

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/" xmlns:u="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
    <s:Header>
        <o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
            <u:Timestamp u:Id="_0">
                <u:Created>2015-11-05T12:54:05.608Z</u:Created>
                <u:Expires>2015-11-05T12:59:05.608Z</u:Expires>
            </u:Timestamp>
        </o:Security>
    </s:Header>
    <s:Body>
        <ConfirmResponse xmlns="http://kitsoft.kiev.ua/mtsbu/2015/07/30">
            <ConfirmResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                <ConfirmFault i:nil="true" xmlns:a="http://schemas.datacontract.org/2004/07/MTSBU.Service.Faults"/>
                <EndDate>2016-09-04T23:59:00</EndDate>
                <IsSucceded>true</IsSucceded>
                <MainCode>F7CAEF</MainCode>
                <RequestExecuteTime>PT0.0299695S</RequestExecuteTime>
                <StartDate>2015-11-05T14:54:09.1027779+02:00</StartDate>
                <TransactionKey>46ff449a-f95f-482d-8d9c-c8d80f67561d</TransactionKey>
            </ConfirmResult>
        </ConfirmResponse>
    </s:Body>
</s:Envelope>

ChangeContracts - New

1.20160519.0 

Створення договору. Даний web-сервіс відноситься до групи “Read-write”. Вхідні параметри потребують значної кількості перевірок коректності типів, у зв’язку з чим основним форматом роботи сервісу є SOAP. Для формування рядка для цифрового підпису можна використати запит GetSignFromRequest.

https://policyrw.mtsbu.ua/ChangeContracts.svc/New

Параметр

НазваниеОписание
CContractRequest

Контейнер для Contract, InputMessageID, DigitalSignature

  Contract

Дані договору (екземпляр класу CContract)

  InputMessageID

Унікальний ідентифікатор, що заповнюється зі сторони страховика для більш зручного співставлення запитів та відповідей

  DigitalSignature

Блок ЕЦП який накладається на дані договору

Success 200

НазваниеОписание
CCreateActionResult

Екземпляр класу CCreateActionResult

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/" xmlns:u="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
   <s:Header>
      <o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
         <u:Timestamp u:Id="_0">
            <u:Created>2015-11-09T14:28:01.938Z</u:Created>
            <u:Expires>2015-11-09T14:33:01.938Z</u:Expires>
         </u:Timestamp>
      </o:Security>
   </s:Header>
   <s:Body>
      <NewResponse xmlns="http://kitsoft.kiev.ua/mtsbu/2015/07/30">
         <NewResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <ContractFault i:nil="true" xmlns:a="http://schemas.datacontract.org/2004/07/MTSBU.Service.Faults"/>
            <EndDate>2016-09-08T23:59:00</EndDate>
            <InsurerRowKey>testRequest</InsurerRowKey>
            <IsSucceded>true</IsSucceded>
            <MainCode>E77413</MainCode>
            <RequestExecuteTime>PT0.0047792S</RequestExecuteTime>
            <TransactionKey>0359d291-191b-4b88-bcc5-db999273ed02</TransactionKey>
         </NewResult>
      </NewResponse>
   </s:Body>
</s:Envelope>

ChangeContracts - Renew

1.20160519.0 

Здійснення переоформлення. Даний web-сервіс відноситься до групи “Read-write”. Вхідні параметри потребують значної кількості перевірок коректності типів, у зв’язку з чим основним форматом роботи сервісу є SOAP. Для формування рядка для цифрового підпису можна використати запит GetSignStringFromRenew.

https://policyrw.mtsbu.ua/ChangeContracts.svc/Renew

Параметр

НазваниеОписание
CRenewRequest

Контейнер для RenewData, Contract, ActionDate, DigitalSignature

  RenewData

Контейнер для MainCode, Contract, ActionDate

    MainCode

Номер діючого договору що підлягає переоформленню

    Contract

Дані договору (блок нових параметрів для договору: IdentCode, Surname, Name, PName, BirthDate, Address, RegNo)

    ActionDate

Дата та час здійснення операції (допускається відхилення від серверного часу до 60 секунд, необхідна передача з боку страховика для забезпечення неспростовності за рахунок накладання на дані запиту ЕЦП)

  DigitalSignature

Блок ЕЦП який накладається на дані MainCode, Contract, ActionDate

Success 200

НазваниеОписание
CCancelActionResult

Екземпляр класу CCancelActionResult

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/" xmlns:u="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
    <s:Header>
        <o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
            <u:Timestamp u:Id="_0">
                <u:Created>2015-11-09T14:01:11.196Z</u:Created>
                <u:Expires>2015-11-09T14:06:11.196Z</u:Expires>
            </u:Timestamp>
        </o:Security>
    </s:Header>
    <s:Body>
        <RenewResponse xmlns="http://kitsoft.kiev.ua/mtsbu/2015/07/30">
            <RenewResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                <IsSucceded>true</IsSucceded>
                <NewMainCode>909112</NewMainCode>
                <OldMainCode>E10504</OldMainCode>
                <RenewFault i:nil="true" xmlns:a="http://schemas.datacontract.org/2004/07/MTSBU.Service.Faults"/>
                <TransactionKey>ddf66e71-6638-43b2-aa81-bb1b549d91eb</TransactionKey>
            </RenewResult>
        </RenewResponse>
    </s:Body>
</s:Envelope>

ChangeContracts - Reserve

1.20160519.0 

Створення заявки. Даний web-сервіс відноситься до групи “Read-write”. Вхідні параметри потребують значної кількості перевірок коректності типів, у зв’язку з чим основним форматом роботи сервісу є SOAP. Для формування рядка для цифрового підпису можна використати запит GetSignFromRequest.

https://policyrw.mtsbu.ua/ChangeContracts.svc/Reserve

Параметр

НазваниеОписание
CContractRequest

Контейнер для Contract, InputMessageID, DigitalSignature

  Contract

Дані договору (екземпляр класу CContract)

  InputMessageID

Унікальний ідентифікатор, що заповнюється зі сторони страховика для більш зручного співставлення запитів та відповідей

  DigitalSignature

Блок ЕЦП який накладається на дані договору

Success 200

НазваниеОписание
CCreateActionResult

Екземпляр класу CCreateActionResult

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/" xmlns:u="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
   <s:Header>
      <o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
         <u:Timestamp u:Id="_0">
            <u:Created>2015-11-05T12:23:02.674Z</u:Created>
            <u:Expires>2015-11-05T12:28:02.674Z</u:Expires>
         </u:Timestamp>
      </o:Security>
   </s:Header>
   <s:Body>
      <ReserveResponse xmlns="http://kitsoft.kiev.ua/mtsbu/2015/07/30">
         <ReserveResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <ContractFault i:nil="true" xmlns:a="http://schemas.datacontract.org/2004/07/MTSBU.Service.Faults"/>
            <EndDate>2016-09-04T23:59:00</EndDate>
            <InsurerRowKey>testRequest</InsurerRowKey>
            <IsSucceded>true</IsSucceded>
            <MainCode>CEF6C7</MainCode>
            <RequestExecuteTime>PT0.032123S</RequestExecuteTime>
            <TransactionKey>1fdc8857-a410-4f42-9dfc-11c35274e6e6</TransactionKey>
         </ReserveResult>
      </ReserveResponse>
   </s:Body>
</s:Envelope>

Основні положення запитів до сервісу ChangeContracts

Формат даних

  • Дати передаються у форматі "yyyy-MM-ddTHH:mm:ss", де "T" - символ, який розділяє дату від часу, наприклад "2015-11-04T15:42:54". Можливий і варіант дати з вказаним відступом від Utc, наприклад "2015-11-04T17:40:18.4531142+02:00" (вказано мілісекунди та відступ (+02:00)).
  • Роздільник цілої та дробної частини - ".".
  • При передачі даних із перерахувань (enum), наприклад "DPersonStatusID", дані передаються по імені (наприклад - DPersonStatusID_1), а не по их int-аналогам. Інформація про перерахування знаходиться в WSDL.
  • Цифровий підпис передається в вигляді масиву байт, перетвореного в Base64String.
  • Всі параметри (крім цифрового підпису) перед відпроавкою проходять заміну (екранування) недопустимих XML символів - " , & , ' , < , >.

Формування рядка для цифрового підпису

  • В цифровий підпис пишутся всі дані запиту згідно WSDL (за виключенням самого поля цифрового підпису).
  • Дані запиту записуються в один рядок с роздільником "|" (без пробілів, символів переходу на новий рядок і т.д.).
  • Дані записуються в такій послідовності, в якій вони представлені у WSDL.
  • Виключення з попереднього пункту - запит Renew, тому що в структурі CRenewRequest є підструктура RenewContract. Через це спочатку у строку попадають дані із CRenewRequest (ActionDate і MainCode), потім добавляются дані із RenewContract (Address, BirthDate і т.д.). Це має наступний вигляд: ActionDate|MainCode|Address|BirthDate|IdentCode... і т.д.
  • Якщо параметр пустий - він у рядок не записується ні в якому вигляді, варіанти з пустими рядками між роздільниками ("||" чи "| |") - не коректні.
  • Параметри формуються наступним чином:
    • Бульові значення передаються у форматі 0|1 , що відповідає false|true (ні|так)
    • Дата записується у форматі "yyyyMMdd HH:mm", наприклад "20151105 09:47".
    • Роздільник цілої та дробної частини ",".
    • Перелічення (enum) передаются по значенням (наприклад - "1"), а не їх імені (наприклад - "DPersonStatusID_1").
  • Для FContract існує метод GetSignFromRequest, який повертає рядок, сформований на основі переданного FContract.

Перерахування

DPeriodEnum

  • DPeriod_1 15 діб
  • DPeriod_2 1 місяць
  • DPeriod_3 2 місяці
  • DPeriod_4 3 місяці
  • DPeriod_5 4 місяці
  • DPeriod_6 5 місяців
  • DPeriod_7 6 місяців
  • DPeriod_8 7 місяців
  • DPeriod_9 8 місяців
  • DPeriod_10 9 місяців
  • DPeriod_11 10 місяців
  • DPeriod_12 11 місяців
  • DPeriod_13 1 рік

DBonusMalusEnum

  • DBonusMalus_0 0
  • DBonusMalus_1 1
  • DBonusMalus_2 2
  • DBonusMalus_3 3
  • DBonusMalus_4 4
  • DBonusMalus_5 5
  • DBonusMalus_6 6
  • DBonusMalus_7 7
  • DBonusMalus_8 8
  • DBonusMalus_9 9
  • DBonusMalus_10 10
  • DBonusMalus_11 11
  • DBonusMalus_12 12
  • DBonusMalus_13 13
  • DBonusMalus_14 M

DPrivelegeEnum

  • DPrivelege_0 Без пільг
  • DPrivelege_1 Учасники війни, що визначені законом
  • DPrivelege_2 Інваліди II групи
  • DPrivelege_3 Особи, які постраждали внаслідок Чорнобильської катастрофи
  • DPrivelege_4 Пенсіонери громадяни України

DDiscountEnum

  • DDiscount_0 Зменшення не застосовано
  • DDiscount_1 Укладання від 5 до 9 договорів
  • DDiscount_2 Укладання від 10 до 19 договорів
  • DDiscount_3 Укладання від 20 до 99 договорів
  • DDiscount_4 Укладання від 100 до 499 договорів
  • DDiscount_5 Укладання від 500 до 1999 договорів
  • DDiscount_6 Укладання від 2000 і більше договорів

DCitizenStatusEnum

  • DCitizenStatus_1 Резидент
  • DCitizenStatus_2 Нерезидент

DPersonStatusEnum

  • DPersonStatus_1 Фізична особа
  • DPersonStatus_2 Юридична особа

DSphereUseEnum

  • DSphereUse_1 Використання в особистих та виробничих цілях (крім таксі)
  • DSphereUse_2 Послуги із перевезень (таксі)

DExpLimitEnum

  • DExpLimit_1 Без обмеження стажу
  • DExpLimit_2 Стаж не менше 3 років

DVehicleTypeEnum

  • DVehicleType_1 B1, легковий автомобіль до 1600 кубічних сантиметрів
  • DVehicleType_2 B2, легковий автомобіль від 1601 до 2000 куб. см.
  • DVehicleType_3 B3, легковий автомобіль від 2001 до 3000 куб. см.
  • DVehicleType_4 B4, легковий автомобіль більше 3000 куб. см.
  • DVehicleType_5 A1, мотоцикли та моторолери до 300 куб. см.
  • DVehicleType_6 A2, мотоцикли та моторолери більше 300 куб. см.
  • DVehicleType_7 C1, вант. автомобілі вантажопідйомністю до 2т (включ)
  • DVehicleType_8 C2, вантажні автомобілі вантажопідйомністю понад 2 т.
  • DVehicleType_9 D1, автобуси з кількістю місць до 20 чол. (включно)
  • DVehicleType_10 D2, автобуси з кількістю місць більше 20 чол.
  • DVehicleType_11 F, причепи до легкових автомобілів
  • DVehicleType_12 E, причепи до вантажних автомобілів

Класи

CContract

  • StartDate Дата та час початку дії договору (Дата та час)
  • DPeriodID Строк дії (DPeriodEnum)
  • DBonusMalusID Клас бонус-малус (DBonusMalusEnum)
  • k1 k1 (Плаваюча кома (5, 2))
  • k2 k2 (Плаваюча кома (5, 2))
  • k3 k3 (Плаваюча кома (5, 2))
  • k4 k4 (Плаваюча кома (5, 2))
  • k5 k5 (Плаваюча кома (5, 2))
  • k6 k6 (Плаваюча кома (1, 0))
  • K7 K7 (Плаваюча кома (5, 2))
  • DPrivelegeID Пільга (DPrivelegeEnum)
  • DDiscountID Знижки (DDiscountEnum)
  • Franchise Франшиза (Гроші)
  • InsPremium Страхова премія (Гроші)
  • DCitizenStatusID Статус резидента (DCitizenStatusEnum)
  • DPersonStatusID Статус особи-страхувальника (Фіз/Юр) (DPersonStatusEnum)
  • IdentCode Ідентифікаційний код страхувальника (Строка (10)). ЄДРПОУ/ІПН страхувальника / Серія та номер паспорту для фізичних осіб, що не мають ідентифікаційного коду
  • Surname Прізвище/найменування страхувальника (Строка (100))
  • Name Ім’я страхувальника (Строка (100))
  • PName По-батькові страхувальника (Строка (100)). Поле не обов'язкове для заповнення
  • BirthDate Дата народження страхувальника (Дата у форматі (ррррммдд))
  • Address Адреса страхувальника (Строка (250))
  • DCityID Населений пункт - місце реєстрації ТЗ (Ціле число - Код населеного пункту згідно довідника «Населені пункти, що мають МРЕО»)
  • RegNo Державний номер ТЗ (Строка (10))
  • VIN VIN ТЗ (Строка (17)), RegEx: ^(?=.*\\d+)[\\d,A,B,C,D,E,F,G,H,J,K,L,M,N,P,R,S,T,U,V,W,X,Y,Z]{5,20}$
  • DateNextTO Дата наступного технічного оглаяду (Дата, не обов’язкове)
  • DVehicleTypeID Тип ТЗ (DVehicleTypeEnum)
  • DMarkID Марка ТЗ (Ціле число - Код марки згідно довідника «Марки авто»)
  • DModelID Модель ТЗ (Ціле число - Код марки згідно довідника «Моделі ТЗ»)
  • AutoDescr Повна назва забезпеченого ТЗ (Заповнюється у випадку відсутності марки або моделі у довіднику)
  • DSphereUseID Призначення ТЗ (DSphereUseEnum)
  • ProdYear Рік випуску ТЗ (Ціле число у 4-х значному форматі)
  • DExpLimitID Обмеження стажу водія (DExpLimitEnum)
  • VehicleUsage Використання ТЗ у визначених місяцях року - строка з 12 символів (0 або 1). Кожний розряд являє собою ознаку використання ТЗ у календарному місяці року. Наприклад: «001111110000», означає використання ТЗ у період з третього по восьмий місяць. Значення є умовно обов'язковим і заповнюється тільки для договорів, срок дії якиї 1 рік

CCreateActionResult

  • IsSucceded Результат виконання - Успішно / не успішно (Логічний (true/false))
  • InsurerRowKey Ідентифікатор, що заповнюється зі сторони страховика для зручного співставлення запитів та відповідей (Строка(20))
  • TransactionKey Ідентифікатор, що заповнюється зі сторони ЦБД МТСБУ у форматі GUID для службових цілей (дебаг та логіювання інформації) (Строка(20))
  • MainCode Код електронного полісу, вказується виключно у випадках успішного виконання операції (Строка(6))
  • EndDate Дата та час завершення дії договору (Дата та час у форматі (ррррммдд чч:хх:сс))
  • ServiceFault Помилки при виконанні сервісу

CCheckActionResult

  • IsSucceded Результат виконання - Успішно / не успішно (Логічний (true/false))
  • InsurerRowKey Ідентифікатор (із відповідного запиту), що заповнюється зі сторони страховика для зручного співставлення запитів та відповідей (Строка(20))
  • TransactionKey Ідентифікатор, що заповнюється зі сторони ЦБД МТСБУ у форматі GUID для службових цілей (дебаг та логіювання інформації) (Строка(20))
  • StartDate Дата початку дії договору
  • RequestExecuteTime Час виконання запиту
  • ServiceFault Помилки при виконанні сервісу

CCreateActionResult

  • IsSucceded Результат виконання - Успішно / не успішно (Логічний (true/false))
  • InsurerRowKey Ідентифікатор, що заповнюється зі сторони страховика для зручного співставлення запитів та відповідей (Строка(20))
  • TransactionKey Ідентифікатор, що заповнюється зі сторони ЦБД МТСБУ у форматі GUID для службових цілей (дебаг та логіювання інформації) (Строка(20))
  • MainCode Код електронного полісу, вказується виключно у випадках успішного виконання операції (Строка(6))
  • EndDate Дата та час завершення дії договору (Дата та час у форматі (ррррммдд чч:хх:сс))
  • ServiceFault Помилки при виконанні сервісу

CConfirmActionResult

  • IsSucceded Результат виконання - Успішно / не успішно (Логічний (true/false))
  • MainCode Код електронного полісу, вказується виключно у випадках успішного виконання операції (Строка(6))
  • StartDate Дата та час початку дії договору (Дата та час у форматі (ррррммдд чч:хх:сс))
  • EndDate Дата та час завершення дії договору (Дата та час у форматі (ррррммдд чч:хх:сс))
  • TransactionKey Ідентифікатор, що заповнюється зі сторони ЦБД МТСБУ у форматі GUID для службових цілей (дебаг та логіювання інформації)
  • RequestExecuteTime Час виконання запиту
  • ServiceFault Помилки при виконанні сервісу

CCancelActionResult

  • IsSucceded Результат виконання - Успішно / не успішно (Логічний (true/false))
  • MainCode Код електронного полісу (заявки), вказується виключно у випадках успішного виконання операції (Строка(6))
  • CancelDate Дата та час дострокового припинення дії договору або анулювання заявки, заповнюється тільки у випадку успішного виконання операції (Дата та час у форматі (ррррммдд чч:хх:сс))
  • TransactionKey Ідентифікатор, що заповнюється зі сторони ЦБД МТСБУ у форматі GUID для службових цілей (дебаг та логіювання інформації)
  • RequestExecuteTime Час виконання запиту
  • ServiceFault Помилки при виконанні сервісу

CRenewContract

  • IdentCode Ідентифікаційний код страхувальника (Строка (10). ЄДРПОУ/ІПН страхувальника / Серія та номер паспорту для фізичних осіб, що не мають ідентифікаційного коду)
  • Surname Прізвище/найменування страхувальника (Строка (100))
  • Name Ім’я страхувальника (Строка (100))
  • PName По-батькові страхувальника (Строка (100))
  • BirthDate Дата народження страхувальника (Дата у форматі (ррррммдд))
  • Address Адреса страхувальника (Строка (250))
  • RegNo Державний номер ТЗ (Строка (10))

CRenewActionResult

  • IsSucceded Результат виконання - Успішно / не успішно (Логічний (true/false))
  • NewMainCode Код електронного полісу, вказується виключно у випадках успішного виконання операції (Строка(6))
  • OldMainCode Код (попереднього) договору який переоформлявся (Строка(6))
  • TransactionKey Ідентифікатор, що заповнюється зі сторони ЦБД МТСБУ у форматі GUID для службових цілей (дебаг та логіювання інформації)
  • RequestExecuteTime Час виконання запиту
  • ServiceFault Помилки при виконанні сервісу

Опис помилок

Загальні положення

Класс помилок використовується у випадках:

  • Розробник безпосередньо генерує помилку;
  • Виникає неопрацьована помилка (ніякі Exception до клієнта не доходять).

Структура помилок

Структура помилок наступна:

  • ServiceFault (root-помилка):
    • ErrorID (код помилки (Ціле число));
    • OutputRequestId (ідентифікатор запиту до системи МТСБУ (Guid));
    • InputMessageID (ідентифікатор запису у системі страховика (Строка));
    • ErrorMessage (текстова інформація, що деталізує (конкретизує) повідомлення щодо помилки (Строка));
    • ValidationFaults (список помилок валідації (тип - ValidationFaultDetails) запиту):
      • FieldID (ім’я невалідного поля (Строка, опціональне));
      • Description (детальний опис помилки валідації (Строка));
      • Annotation (додаткова технічна інформація щодо помилки (регулярний вираз, допустимий формат дати, перелік значень даних зі списку, тощо));
      • ErrorID (унікальний код помилки (Ціле число) (не перетинаються з ServiceFault.ErrorID – ці коди унікальні та не перетинаються між собою)).

Категорії помилок

Помилки розділені на категорії, в залежності від коду помилки (ServiceFault.ErrorID):

  • Помилки вводу даних (коди 1 - 9999);
  • Помилки пошуку даних (коди 10000 - 19999);
  • Помилки валідації (коди 20000 - 29999);
    • Загальні помилки (коди 20000 - 20999);
    • Помилки валідації через DataAnnotation (коди 21000 - 21999);
    • Помилки валідації через Regex (коди 22000 - 22999);
    • Помилки валідації через правила пошукових шаблонів (коди 23000 - 23999);
    • Помилки валідації через формули (коди 24000 - 24999);
  • Помилки цифрового підпису (коди 30000 - 39999);
  • Не класифіковані помилки (коди 40000 - 48999 та 0);
  • Помилки SQL (коди 49000 - 59999 (до 50000 - стандартні, після - custom).

Перелік помилок

  • 100 RequestAnnotationInvalid Надані дані не пройшли базової перевірки через DataAnnotations, дані не валідні
  • 110 RequestFormulasInvalid Надані дані не пройшли перевірку формулами, дані не валідні
  • 200 RequestEmpty Дані запиту (FContract) порожні (null)
  • 210 RequestContractInvalid DataContract переданий як репозиторій даних не має DataMember або пустий (null)
  • 300 AsyncNotSigned Спроба користувача працювати асинхронно не підписавшись на події
  • 600 InsurerQuotaNotFound Для страховика, що зробив запит, відсутня квота
  • 10100 SearchTypeNotFound Пошуковий запит відсутній у системі
  • 10200 SearchTypeLocked Використання пошукового запиту заборонено налаштуванням системи
  • 10210 SearchTypeUnauthorized Використання пошукового запиту заборонено для користувача
  • 11000 ParamNotFound Вказаний параметр відсутній у списку
  • 11100 RuleFailed Параметри не пройшли перевірку правилами
  • 11200 ParamsInvalid Параметри мають не валідні значення
  • 11300 InvalidIncomParam Дані параметра неможливо конвертувати у вказаний тип
  • 20000 Unknown Неизвестный тип ошибки валидации
  • 20010 InvalidParamCast Невозможно преобразовать входящий параметр в указанный тип
  • 20011 InvalidDateCast Невозможно преобразовать входящий параметр в тип дата
  • 21010 FieldRequired DataAnnotation: Поле помечено аттрибутом Required и является обязательнын
  • 21020 FieldRangeInvalid DataAnnotation: Поле помечено аттрибутом Range и данные не входят в диапазон min-max
  • 21021 StringLengthInvalid DataAnnotation: Поле помечено аттрибутом StringLength и размер строки выходит за пределы максимального значения
  • 21022 ActionDateRangeInvalid DataAnnotation: Поле помечено аттрибутом ActionDateRange и значение поля должно быть не больше +60 секунд от системного DateTime.Now на момент проверки
  • 21030 RegularExpressionInvalid DataAnnotation: Поле помечено аттрибутом RegularExpression и данные не проходят валидацию регулярным выражением
  • 21040 RegularVehicleUsageInvalid DataAnnotation: Поле "Використання ТЗ у визначених місяцях року" помечено аттрибутом RegularExpressionFault и не проходит валидацию
  • 21040 BirthDateRange DataAnnotation: Поле "Дата народження страхувальника" долэно быть ы заданых рамках
  • 22001 Restrict10CharDigit Regex: Літери та цифри, до 10 символів
  • 22002 Restrict17CharDigit Regex: Літери та цифри, до 17 символів
  • 22003 Restrict5Digits Regex: Цифри, до 5 символів
  • 22004 Restrict6CharDigitDPCode Regex: Літери та цифри, 6 символів (включаючи контрольний символ по спец. алгоритму)
  • 22005 Restrict2Chars Regex: Дві літери
  • 22006 Restrict7Digits Regex: цифри, максимум 7 символів
  • 22007 Restrict8Digits Regex: тільки цифри - рівно 8
  • 22008 Max50CharsAndSymbolsName Regex: до 50 символів. Допускаються літери та спеціальні символи (пробіли, апостроф, дефіс).
  • 22009 Restrict10Or8Digits Regex: Тільки цифри, 8 або 10 символів
  • 22040 IdentCodeOrPasNumAndSeriese Regex: 10 цифр, або 2 літери та 5 цифр (серія та номер паспорту для осіб, які не мають ідентифікаційного коду)
  • 23000 ParamsRuleInvalid Rule: правило параметров вернуло негативный результат - правило не срабатывает
  • 23100 AllFieldsFilled Rule: Усі полямають буті заповнені
  • 23110 AllFieldsEmpty Rule: Неможливо зробити пошук якщо усі поля порожні
  • 24999 FormulaUnknown Formula: невідома помилка підчас виконання формули
  • 24000 FormulaWrongDate Formula: дата початку дії менша дати та часу реєстрації заявки /договору
  • 24010 FormulaNoPrivilege Formula: пільга для юридичної особи
  • 24020 FormulaWrongCarName Formula: невірна назва ТЗ
  • 24030 FormulaPhysicalNotFilled Formula: ім'я та дата народження страхувальника не заповнене
  • 24040 FormulaWrongNameVIN Formula: невырний формат VIN
  • 24050 FormulaEDRPOUNotFilled Formula: ЕДРПОУ не заповнене
  • 24060 FormulaWrongFranchiseValue Formula: Невірний розмір франшизи
  • 24070 FormulaWrongIC Formula: Некоректний ідентифікаційний код
  • 24080 FormulaWrongDrivingExpirience Formula: Заповнений стаж водіння для юридичної особи
  • 24090 FormulaWrongNumberFormat Formula: Невірний формат держ. номеру для ТЗ
  • 24100 FormulaRecordNotFound Formula: Запису з вказаним кодом для страховика не знайдено
  • 24110 FormulaRecordNotActiveContract Formula: Запис не є діючим договором
  • 24120 FormulaRecordNotActive Formula: Запис не має статусу активної заявки
  • 24130 FormulaExceedQuota Formula: Перевищено квоту на видачу полісів
  • 24140 FormulaEndDateNotEvaluated Formula: Дату закінчення дії полісу не було визначено
  • 24150 FormulaStartAndActionDateConflict Formula: Дата початку дії договору менша за дату та час здійснення операції
  • 24160 FormulaContractHasNewCode Formula: Поліс вже був переоформлений
  • 24170 FormulaLegalPersonNotEmpty Formula: для юридичного лиця ім'я, по батькові та дата народження страхувальника мають бути пустими
  • 24180 FormulaVehicleUsageForYear Formula: якщо строк дії договору становить рік, необхідно вказати використання ТЗ у визначених місяцях
  • 30000 DigitalSignUnknown Невідома помилка при роботі з бібліотекой цифрового підпису
  • 30010 DigitalSignMismatchData Дані цифрового підпису не відповідають переданим даним
  • 30020 DigitalWrongCertificate Сертифікат яким було підписано дані, відрізняється від сертифікату компанії що відправила запит
  • 30030 DigitalSignRawDataError Помилка при створенні цифрового підпису (у механізмі сериалізації)
  • 0 UnhandledError Невідома не опрацьована помилка
  • 40000 CredsNotSuplied Дані аутентифікації не було передано
  • 40001 CredsTokenInvalid Наданий токен аутентифікації не валідний
  • 40010 UploadUnknown На стороні сервісу виникла невідома помилка, підчас запису полісу до бази
  • 40011 UploadResultInvalid Після завантаження полісу база повернула дані в невалідному форматі
  • 40012 UploadResultEmpty Після завантаження полісу база не повернула необхідних даних
  • 40020 ConfirmUnknown На стороні сервісу виникла невідома помилка, підчас підтвердження поліса у базі
  • 40021 ConfirmResultInvalid Пілся підтвердження поліса база повернула дані в невалідному форматі
  • 40022 ConfirmResultEmpty Пілся підтвердження поліса база не повернула необхідних даних
  • 40030 AdapterUnknown Під час запиту до бази виникла невідома помилка на стороні сервісу
  • 40031 InsurerQuotasUnknown Підчас запиту на кількість доступних електроних полісів у базі на стороні сервісу виникла невідома помилка
  • 40032 InsurerPolicyStatusUnknown Підчас запиту на кількість доступних електроних полісів у базі на стороні сервісу виникла невідома помилка
  • 40033 InsurerInfoUnknown Підчас запиту інформації про страховика з бази, на стороні сервісу виникла невідома помилка
  • 40034 CancelActiveUnknown Підчас запиту у базу про дострокове припинення дії договору, на стороні сервісу виникла невідома помилка
  • 40035 CancelReserveUnknown Підчас запиту у базу про анулювання заявки, на стороні сервісу виникла невідома помилка
  • 40036 RenewPolicyUnknown Підчас запиту до бази про переоформленяя договору, на стороні сервісу виникла невідома помилка
  • 40040 CancelActiveEmpty Пілся дострокового припинення дії договору база не повернула необхідних даних
  • 40041 CancelActiveInvalid Після дострокового припинення дії договору база повернула дані в невалідному форматі
  • 40050 CancelReserveEmpty Пілся анулювання заявки база не повернула необхідних даних
  • 40051 CancelReserveInvalid Після анулювання заявки база повернула дані в невалідному форматі
  • 40060 RenewPolicyResultEmpty Пілся переофорлмення договору база не повернула необхідних даних
  • 40061 RenewPolicyResultInvalid Після переофорлмення договору база повернула дані в невалідному форматі
  • 47000 UpdateWSDL Використовуваний WSDL не відповідає новому, необхідно оновити
  • 49000 SqlUnknown На стороні SQL виникла невідома помилка
  • 49010 SqlServerConnFailed Відсутній зв'язок з сервером
  • 49011 SqlDBConnFailed Відсутній зв'язок з базой даних
  • 49012 SqlTimeOut Сервер не відповідає
  • 49020 SqlLoginFailed Логін чи пароль не вірний
  • 49050 SqlCustom На стороні SQL виникла клієнтська помилка
  • 49060 SqlQuotasEmpty Запит на квоти страховиків повернув порожні дані
  • 49061 SqlQuotasInvalidColumns Запит на квоти страховиків має не вірну кількість даних
  • 49062 SqlQuotasInvalidType Запит на квоти страховиків повернув не валідний тип даних
  • 49070 SqlPolicyDataEmpty Запит про інформацію про страховий поліс не повернув даних
  • 49071 SqlPolicyDataInvalidFormat Запит про інформацію про страховий поліс повернув дані в невалідному форматі
  • 49080 SqlInsurerInfoDataInvalid Запит про дані страховика за токеном повернув дані в невалідному форматі

Допустимі формати державних номерних знаків

Допустимими вважаються наступні формати державних номерних знаків (в іншому випадку виникає помилка FormulaWrongNumberFormat (id 24090)):

  • умовно-допустимі шаблони:
    • ЦЦЦЦББ - якщо закінчується на BP (номери Верховної Ради), на АП (номери Апарату Президента) або на КМ (номери Кабінету Міністрів);
    • БББЦЦЦ – якщо починається на CDP (дипломатичні номери);
    • ББЦЦЦЦЦЦ - якщо починається на DP (дипломатичні номери);
    • ББЦЦЦЦЦ - якщо починається на DP (дипломатичні номери);
    • ББЦЦЦЦ - якщо починається на DP (дипломатичні номери);
    • БЦЦЦЦЦЦ - якщо починається на SFCDTMKHP (дипломатичні номери);
    • БЦЦЦЦЦ - якщо починається на S (дипломатичні номери);
    • БББЦЦЦЦ - якщо починається на CDPCMD (дипломатичні номери);
    • ЦЦЦБЦЦЦЦЦ - якщо Б дорівнює FSBCD (дипломатичні номери);
    • ЦЦЦББЦЦЦЦ - якщо ББ дорівнює DPCC (дипломатичні номери);
    • ЦЦЦБББЦЦЦЦ - якщо БББ дорівнює CDP (дипломатичні номери);
    • БЦББЦЦЦЦБЦЦЦЦЦББ якщо починається на T (тимчасові номери);
  • допустимі шаблони:
    • ЦЦЦЦЦЦ (номери МВС);
    • ЦЦББЦЦЦЦЦЦЦЦЦЦББББЦЦЦЦБББЦЦЦЦББЦЦЦЦБББЦЦЦЦЦББЦЦЦЦБЦББББЦЦЦЦЦЦЦЦББББЦЦЦЦББЦЦЦЦЦБББЦЦЦЦ.

Перелік валідацій

  • Restrict2Chars RegEx: ^[a-zA-Zа-яА-ЯїЇіІ]{2}$ 2 літери
  • Restrict7Digits RegEx: ^[0-9]{7}$ До 7 цифр
  • Restrict17CharDigit RegEx: ^(?=.*\d+)[0-9,a-z,A-Z,у,У,к,К,е,Е,н,Н,х,Х,в,В,а,А,р,Р,о,О,с,С,м,М,т,Т,і,І,з,З]{5,17}$ Літери та цифри, до 17 символів
  • Restrict10CharDigit RegEx: ^[a-zA-Zа-яА-ЯїЇіІ0-9./]{0,10}$ Літери та цифри, до 10 символів
  • IdentCodeOrPasNumAndSeriese RegEx: ^[0-9]{8}$|^[0-9]{10}$|^[A-ZА-Я]{2}[0-9]{6}$ 0 цифр, або 2 літери та 5 цифр (серія та номер паспорту для осіб, які не мають ідентифікаційного коду)
  • Restrict6CharDigitDPCode RegEx: ^[a-zA-Zа-яА-ЯїЇіІ0-9./]{6}$ Літери та цифри, 6 символів (включаючи контрольний символ по спец. алгоритму)
  • Max50CharsAndSymbolsName RegEx: ^[а-я,А-Я,ї,і,є,ё,ґ,Ї,І,Є,Ё,Ґ,a-z,A-Z,\-,',’,0-9,\.,№,',",(,),_,»,«,“,”,;, ]{0,50}$ До 50 символів, допускаються літери та спеціальні символи
  • Restrict10Or8Digits RegEx: ^[0-9]{8}$|^[0-9]{10}$ Тільки цифри, 8 або 10 символів

Приклади помилок

Запит:

GET https://policy.kitsoft.kiev.ua/GetHistory.svc/ByCodeAndPlateNum HTTP/1.1
Host: policy.kitsoft.kiev.ua
Authentication: RXhhbXBsZVVzZXI6VGVzdDExMVRlc3QK

Відповідь:

{
  "ErrorID": 11100,
  "ErrorMessage": "Надані параметри пошуку не задовольняють встановлених правил перевірки",  
  "InputMessageID": null,
  "OutputRequestId": "108b6b3f-ccb5-4044-a5f3-8a4d224dfa18",
  "ValidationFaults": [
    {
      "Annotation": null,
      "Description": "Усі поля мають бути заповненими",
      "ErrorID": 23100,
      "FieldID": "AllFieldsFilled"
    }
  ]
}
Сгенерировано с помощью apidoc 0.13.1 - 2016-05-19T08:40:26.167Z
Comments