Раздел поясняет применение Правила 5 при обмене списками между страховыми компаниями (СК) и медицинскими
организациями (МО) через API medical-insured-person. Материал предназначен для команд, отвечающих
за
формирование сообщений POST /insured-persons и обработку ответов.
Правило 5 распространяется на списки Changement, Detachment и связку
Detachment + Attachment. Оно определяет, какие атрибуты передавать, как фиксировать пары
«старое / новое значение» и в каких сценариях нужна раздельная передача открепления и повторного прикрепления.
¶ Назначение и область применения
- Корректировка персональных данных (ФИО, документы, адреса, СНИЛС, контакты, пол).
- Управление договорными параметрами: серия/номер полиса, сроки действия, договоры и допсоглашения.
- Изменение программ страхования, рисков и лимитов, частичное открепление и продление полиса.
- Журналирование изменений и подтверждение обработки через пары
oldValue/newValue.
Рекомендации применяются во всех сценариях, где используется модель InsuredPersonInformation и
связанные уведомления об обработке списков.
¶ Соответствие кейсов элементам схемы
| Группа | case_id | Что меняется | Путь в схеме | Тип списка |
|---|---|---|---|---|
| Персональные данные | 1 | ФИО | InsuredPerson.InsuredPersonInformation.InsuredPersonDetails.FioContact |
Changement |
| 2 | Дата рождения | InsuredPerson.InsuredPersonInformation.InsuredPersonDetails.birthDate |
Changement | |
| 3 | Документ (паспорт) | InsuredPerson.InsuredPersonInformation.InsuredPersonDetails.IdentityDocumentInfo |
Changement | |
| 4 | Адрес | InsuredPerson.InsuredPersonInformation.InsuredPersonDetails.Address |
Changement | |
| 5 | СНИЛС | InsuredPerson.InsuredPersonInformation.InsuredPersonDetails.snils |
Changement | |
| 6 | Пол | InsuredPerson.InsuredPersonInformation.InsuredPersonDetails.gender |
Changement | |
| 7 | Полис ОМС | InsuredPerson.InsuredPersonInformation.InsuredPersonDetails.omsPolicyNumber |
Changement | |
| 8 | Должность | InsuredPerson.InsuredPersonInformation.InsuredPersonDetails.position |
Changement | |
| 9 | Категория | InsuredPerson.InsuredPersonInformation.InsuredPersonDetails.category |
Changement | |
| 10 | Работодатель | InsuredPerson.InsuredPersonInformation.InsuredPersonDetails.employerInfo |
Changement | |
| 11 | Категория работника | InsuredPerson.InsuredPersonInformation.InsuredPersonDetails.employerType |
Changement | |
| 12 | Телефон | InsuredPerson.InsuredPersonInformation.InsuredPersonDetails.ContactInfo.phoneNumberFax
|
Changement | |
| 13 | InsuredPerson.InsuredPersonInformation.InsuredPersonDetails.ContactInfo.emailAddress |
Changement | ||
| Договор и сроки | 14 | Серия и номер полиса | InsuredPerson.InsuredPersonInformation.seriesAndNumberDms |
Detachment + Attachment |
| 15 | Дата начала действия | InsuredPerson.InsuredPersonInformation.startDate |
Detachment + Attachment / Changement* | |
| 16 | Дата окончания | InsuredPerson.InsuredPersonInformation.endDate |
Detachment + Attachment / Changement* | |
| 17 | Договор между СК и МО | InsuredPerson.ContractDocumentInfo |
Detachment + Attachment | |
| 18 | Дополнительное соглашение | InsuredPerson.AnnexToTheContract |
Detachment + Attachment | |
| Программы и риски | 19 | Смена программы / рисков | InsuredPerson.InsuredPersonInformation.InsuredPrograms |
Detachment + Attachment / Changement |
| 20 | Частичное открепление программ | InsuredPerson.InsuredPersonInformation.InsuredPrograms |
Detachment / Changement | |
| 21 | Риски и объём помощи | InsuredPerson.InsuredPersonInformation.InsuredPrograms[].InsuranceRisks |
Detachment + Attachment / Changement | |
| 22 | Лимит ответственности | InsuredPerson.InsuredPersonInformation.InsuredPrograms[].agreedTreatmentLimit |
Detachment + Attachment / Changement | |
| Клиники | 23 | Клиника прикрепления | InsuredPerson.BranchInformation |
Detachment + Attachment |
-
* 15 дата начала действия меняется через
ChangementилиDetachmentот «старых дат» +Attachmentна «новые даты»Changement. -
* 15 дата окончания действия меняется через
ChangementилиDetachmentот «старых дат» +Attachmentна «новые даты»
При этом – если речь о досрочном расторжении – тогда список на Открепление.
-
Если даты сокращаются, программа меняется или происходит досрочное расторжение — применяйте
Detachmentлибо связкуDetachment + Attachment.
Любое новое значение, переданное вnewValue, считается актуальным. ЕслиoldValueне указано, МО всё равно трактует данные как обновлённые.
¶ Алгоритм подготовки списка на изменение
- Определите группу изменения и соответствующий
case_idпо таблице. - Выберите тип списка:
Changement,DetachmentилиDetachment + Attachment. Если в одном списке есть атрибут, требующий открепления, применяйте режим открепления ко всему списку. - Для каждого застрахованного заполните объект
InsuredPersonInformation:- Укажите идентификатор (например,
seriesAndNumberDms). - Передавайте
oldValueиnewValueдля изменяемых полей (по договорённости сторонoldValueможет быть обязательным). - Добавьте
changedAt, если нужно зафиксировать дату вступления изменений.
- Укажите идентификатор (например,
- Отправьте уведомление о готовности списка (
POST /notifications/insured-list), указавactionWithInsuredPerson. - Передайте сам список (JSON) по ссылке
link, полученной в уведомлении.
¶ Пример списка на изменение сроков действия
{
"documentName": "Изменение параметров полиса",
"documentNumber": "CHG-2024-016",
"dateOfDocument": "2024-10-25",
"actionWithInsuredPerson": "Changement",
"InsuredPersonInformation": [
{
"seriesAndNumberDms": "DMS-009988",
"changedAt": "2024-10-25",
"startDate": {
"oldValue": "2024-01-01",
"newValue": "2024-02-01"
},
"endDate": {
"oldValue": "2024-12-31",
"newValue": "2025-01-31"
}
}
]
}При продлении периода проверяйте, что новая дата начала не выходит за границы действующего прикрепления. В противном случае потребуется открепление и новое прикрепление.
¶ Пример частичного открепления программы
Частичный переход выполняется последовательностью из двух списков.
// Detachment
{
"actionWithInsuredPerson": "Detachment",
"InsuredPersonInformation": [
{
"seriesAndNumberDms": "DMS-998877",
"InsuredPrograms": [
{ "programCode": "DentalPlus" }
]
}
]
}
// Changement
{
"actionWithInsuredPerson": "Changement",
"InsuredPersonInformation": [
{
"seriesAndNumberDms": "DMS-998877",
"changedAt": "2024-10-25",
"InsuredPrograms": [
{ "programCode": "OutpatientStandard" }
]
}
]
}В списке на изменение указывайте полный актуальный набор программ. Отсутствующие значения трактуются как откреплённые.
¶ Приём уведомлений от МО
- Отслеживайте ответы на
POST /notifications/insured-person-list-status. - Разбирайте массив
InsuredPersonIssue, обращая внимание на коды ошибок. - При критических ошибках устраняйте значения и повторно отправляйте корректированный список.
¶ Контроль качества и журналирование
- Соблюдайте форматы и паттерны, определённые в
medical-insured-person-v2.yaml. - Для идентифицирующих полей (серия полиса, ФИО, дата рождения) указывайте
oldValueпри каждом изменении. - Ведите журнал изменений и ответов МИС для отслеживания истории откреплений, прикреплений и корректировок.
- Контролируйте непрерывность периодов обслуживания, особенно при использовании связки
Detachment + Attachment.