Схема договора

Каждый запрос-ответ на предварительный и итоговый расчет состоит из объектов определенной структуры. В этом разделе описаны основные встречающиеся объекты.

Договор

Договор (Policy) - корневой объект, соответствующий договору страхования или его проекту.

Типовой договор страхования содержит следующие параметры:

Параметр	Тип	Описание	Пример
policyNumber	string	Номер договора	23000MIP9990006928
previousPolicyNumber	string	Номер предыдущего договора (используется при пролонгации)
product	Product	Страховой продукт	"code": "VSK_IPOTEKA"
status	PolicyStatus	Статус договора	"code": "WAITING_PAYMENT"
startDate	string	Дата начала действия договора	2023-08-08T00:00:00+03:00
endDate	string	Дата окончания действия договора	2024-08-07T23:59:59+03:00
issueDate	string	Дата продажи полиса. заполняется партнером
createDate	string	Дата создания полиса в системе страховщика.	2023-08-08T16:39:38+03:00
paymentDate	string	Дата оплаты. первый взнос	2023-08-08T16:40:03+03:00
cancellationDate	string	Дата расторжения договора по любой причине
premium	number	Размер премии по договору в рублях	72055.5
premiumCur	number	Премия в валюте договора, если не рубли
currencyCode	string	Код валюты, если страховая сумма в валюте	RUB
currencyRate	number	Курс валюты, на дату страхования
placeOfIssue	string	Место выдачи договора
draftId	string	Код проекта договора	104859d9-9014-40df-8859-d9901440df24
beneficiaries	array of Beneficiary	Список выгодопреобретателей по договору
additionalProperties	AdditionalProperties
infoList	Infolist
consentPersonalData	ConsentPersonalData
installmentType	string	Тип рассрочки. Периодичность оплаты	Единовременно
installments	array of Installment
files	array of PolicyFile
uw	PolicyUw
anotherPolicyNumber	string	Номер договора другой страховой компании

Типовой договор может быть расширен дополнительными параметрами в зависимости от страхового продукта.

Страхователь

Страхователи физические лица и индивидуальные предприниматели описываются объектом PolicyHolderPerson. Страхователи юридические лица описываются объектом PolicyHolderOrganization.

Объект PolicyHolderPerson содержит следующие параметры:

Параметр	Тип	Описание	Пример
person	Person	Физическое лицо
phone	Phone	Телефон	"phoneNumber": "79991234567"
email	Email	Email	test@test.ru
passport	Document	Документ, удостоверяющий личность
address	Address	Адрес
placeOfWork	PlaceOfWork	Место работы
inn	string	ИНН
snils	string	СНИЛС
otherAddresses	array of Address	Другие адреса
otherDocuments	array of Document	Другие документы
organization	Organization	Организация (используется только у ИП)

Объект PolicyHolderOrganization содержит следующие параметры:

Параметр	Тип	Описание	Пример
organization	Organization	Юридическое лицо
phone	Phone	Телефон	"phoneNumber": "79991234567"
email	Email	Email	test@test.ru
document	Document	Документ
address	Address	Адрес
representative	RepresentativePerson	Представитель организации

Физическое лицо

Физическое лицо (Person) содержит следующие параметры:

Параметр	Тип	Описание	Пример
firstName	string	Имя	Александр
lastName	string	Фамилия	Филин
middleName	string	Отчество	Иванович
birthDate	string	Дата рождения	1997-05-29
fullName	string	Полное ФИО	Филин Александр Иванович
fullNameEn	string	Полное ФИО по английски
birthPlace	string	Место рождения	Москва
citizenship	string	Гражданство. Код страны ISO2. Значение по умолчанию: RU	RU
gender	string	Пол. Допустимые значения: M, F (M - мужской, F - женский)	M
familyState	string	Семейное положение. Значение по умолчанию: SINGLE	SINGLE
isPublicOfficial	boolean	Признак публичного должностного лица	false
isResident	boolean	Резидент РФ. Значение по умолчанию: true	true
vsk_id	string	ID записи, присваивается ВСК	894aa578-5545-464f-a616-365adbb352cd
ext_id	string	ID записи, присваивается внешней ИТ системой

Юридическое лицо

Юридическое лицо (Organization) содержит следующие параметры:

Параметр	Тип	Описание	Пример
country	string	Код страны регистрации (ISO2)
inn	string	ИНН	7327060811
fullName	string	Полное наименование	ООО «Союз-Логистик»
fullNameEn	string	Полное наименование по английски
shortName	string	Краткое наименование
legalForm	string	Организацинно-правовая форма	OOO
kpp	string	КПП	732701001
ogrn	string	ОГРН
okpo	string	ОКПО
bic	string	БИК (для банков)
isResident	boolean	Резидент РФ. Значение по умолчанию: true
group	string	b2b Группа страхователя ЮЛ
vsk_id	string	ID записи, присваивается ВСК
ext_id	string	ID записи, присваивается внешней ИТ системой

Адрес

Адрес (Address) содержит следующие параметры:

Параметр	Тип	Описание	Пример
typeCode	string	Тип адреса (справочник)	REGISTRATION
countryCode	string	Код страны (ISO2). Значение по умолчанию: RU	RU
region	string	Наименование региона	Ульяновская
city	string	Город	Ульяновск
street	string	Улица	Московское шоссе
house	string	Номер дома	3
building	string	Строение
flat	string	Квартира	216
room	string	Комната
zipCode	string	Индекс	432045
kladrId	string	КЛАДР
fiasId	string	ФИАС	835c8c9d-325b-48fe-9a73-bd0505fef706
addressStr	string	Адрес строкой	432045, г. Ульяновск ул. Московское шоссе, д.3, офис 216
addressStrEn	string	Адрес строкой по английски
vsk_id	string	ID записи, присваивается ВСК
ext_id	string	ID записи, присваивается внешней ИТ системой

Документ

Документ (Document) содержит следующие параметры:

Параметр	Тип	Описание	Пример
typeCode	string	Код типа документа (справочник)	PASSPORT_RF
serial	string	Серия документа	1234
number	string	Номер документа	223355
dateIssue	string	Дата выдачи	2018-06-29
validUntil	string	Действительно до	ОУФМС по г. Москва
whom	string	Кем выдан	958-364
divisionCode	string	Код подразделения	958-364
vsk_id	string	ID записи, присваивается ВСК
ext_id	string	ID записи, присваивается внешней ИТ системой
countryCode	string	Страна, в которой выдан документ. Код страны (ISO2). Значение по умолчанию: RU	RU
documentOwner	Person	Кому выдан документ

Объект страхованиия

Объект страхованияя (InsuredObject) может быть нескольких типов:

• объект страхования Физическое лицо (InsObjectPerson, InsObjectPersonal) используется в ипотечном и медицинском страховании
• объект страхования Имущество (InsObjectProperty) используется в ипотечном страховании и страховании имущества
• объект страхования Груз (InsObjectCargo) используется в страховании грузов
• объект страхования ОСАГО (InsObjectVehicleOsago) используется в ОСАГО
• объект страхования КАСКО (InsObjectIndCasco и InsObjectCorpCasco) используется в КАСКО
• объект страхования ГЭП (InsObjectGAP) используется в продукте "Финансовый ГЭП"
• объект страхования Домашнее животное (InsObjectPet) используется в страховании домашних животных

Общие параметры объекта страхования (InsuredObject):

Параметр	Тип	Описание	Пример
packageCode	string	Код страхового пакета
covers	array of Risks	Набор покрытий по объекту страхования

Дополнительные параметры объекта страхования Физическое лицо (InsObjectPerson):

Параметр	Тип	Описание	Пример
person	Person	Физическое лицо
phone	Phone	Телефон
email	Email	Email
passport	Document	Документ, удостоверяющий личность
address	Address	Адрес
placeOfWork	PlaceOfWork	Место работы
otherAddresses	array of Address	Другие адреса
otherDocuments	array of Document	Другие документы
inn	string	ИНН
snils	string	СНИЛС

Дополнительные параметры объекта страхования Физическое лицо (InsObjectPersonal):

Параметр	Тип	Описание	Пример
insureds	array of InsuredPerson	Застрахованные лица

Застрахованное лицо (InsuredPerson) содержит следующие параметры:

Параметр	Тип	Описание	Пример
person	Person	Физическое лицо
phone	Phone	Телефон
email	Email	Email
passport	Document	Документ, удостоверяющий личность
address	Address	Адрес
placeOfWork	PlaceOfWork	Место работы
plaсeOfStudy	PlaceOfStudy	Место учебы
additionalFactors	InsPersonAdditionalFactors	Дополнительные параметры
certificate	string	Номер сертификата

Дополнительные параметры объекта страхования Имущество (InsObjectProperty):

Параметр	Тип	Описание	Пример
property	Property	Имущество
owner	array of Owner	Собственник
seller	Seller	Продавец
otherPerson	OtherPerson	Другое лицо
ownershipTransferInfo	OwnershipTransferInfo	Информация о переходе права собственности
documents	array of Document	Документы

Дополнительные параметры объекта страхования Груз (InsObjectCargo):

Параметр	Тип	Описание	Пример
cargo	Cargo	Груз
delivery	CargoDelivery	Параметры доставки

Груз (Cargo) содержит следующие параметры:

Параметр	Тип	Описание	Пример
cargoType	string	Наименование груза
cargoTypeEn	string	Наименование груза по английски
cargoCategory	string	Категория груза
cargoСondition	string	NEW-новый, USED-б/у
weight	string	Масса груза
quantity	string	Количество мест
packaging	string	Упаковка
packagingEn	string	Упаковка по английски
containerNumbers	array of string	Номера контейнеров через ;
containerAmount	string	Количество контейнеров
containerType	string	Тип контейнера
containerTypeEn	string	Тип контейнера по английски

Дополнительные параметры объекта страхования ОСАГО (InsObjectVehicleOsago):

Параметр	Тип	Описание	Пример
vehicle	Vehicle	Транспортное средство
vehicleDocument	Document	Документ на ТС
owner	VehicleOwner	Собственник
typeLDU	string	Тип лиц, допущенных к управлению (LIM или UNLIM)
drivers	array of Driver	Водители
kbm	string	КБМ
trailer	boolean	Наличие прицепа
transit	boolean	Признак транзита
lease	boolean	Авто в кредите
purpose	string	Цель использования ТС	PERSONAL
usingType	string	Режим использования ТС
primaryDrivingArea	string	Территория преимущественного использования ТС (ФИАС)
coefficients	CoefficientsOsago	Коэффициенты
isReinsurance	boolean	Признак перестрахования

Дополнительные параметры объекта страхования КАСКО (InsObjectIndCasco и InsObjectCorpCasco):

Параметр	Тип	Описание	Пример
casco	InsObjectVehicleCasco	Объект страхования автомобиль
extraEquipment	InsObjectExtraEquipment	Объект страхования доп оборудование автомобиля
autoAccident	InsObjectAutoAccident	Объект страхования АвтоНС
autoResponsibility	InsObjectAutoResponsibility	Объект страхования АвтоОтветственность
autoFinancialRisks	InsObjectAutoFinancialRisks	Объект страхования АвтоФинансовые Риски

Дополнительные параметры объекта страхования ГЭП (InsObjectGAP):

Параметр	Тип	Описание	Пример
vehicle	Vehicle	Транспортное средство
vehicleDocument	Document	Документ на ТС
cascoPolicy	Document	Полис КАСКО
loanAgreement	LoanAgreement	Договор лизинга

Дополнительные параметры объекта страхования Домашнее животное (InsObjectPet):

Параметр	Тип	Описание	Пример
species	string	Вид животного	Собака
breed	string	Порода	Алабай
namePet	string	Кличка	Рекс
genderPet	string	Пол	Самец
age	string	Возраст	2
distinguishingMark	string	Дополнительно (окрас,чип,особые приметы)	длинношёрстная собака, номер чипа: 643094100156084

Выгодоприобретатель

Выгодоприобретатель (Beneficiary) содержит следующие параметры:

Параметр	Тип	Описание	Пример
beneficiaryPerson	BeneficiaryPerson	Выгодоприобретатель ФЛ или ИП
beneficiaryOrganization	BeneficiaryOrganization	Выгодоприобретатель ЮЛ
insObjects	array of string	Список объектов страхования
percents	array of BeneficiaryRisk	Доля выгодоприобретателя в риске

Выгодоприобретатель ФЛ или ИП (BeneficiaryPerson) содержит следующие параметры:

Параметр	Тип	Описание	Пример
person	Person	Физическое лицо
address	Address	Адрес
phone	Phone	Телефон
email	Email	Email
document	Document	Документ
inn	string	ИНН
snils	string	СНИЛС
organization	Organization	Организация (используется только у ИП)

Выгодоприобретатель ЮЛ (BeneficiaryOrganization) содержит следующие параметры:

Параметр	Тип	Описание	Пример
organization	Organization	Организация
address	Address	Адрес
phone	Phone	Телефон
email	Email	Email

Доля выгодоприобретателя в риске (BeneficiaryRisk) содержит следующие параметры:

Параметр	Тип	Описание	Пример
risk	string	Код риска
percent	number	Процент выгодопреобретателя по риску: от 0 до 100. Значение по умолчанию: 100