¶ Правило 1
Досрочное открепление
- Режим «открепление», обязательное поле
earlyTerminationDate. - Полис — основной идентификатор; акт или протокол фиксирует причину и дату.
- Для нескольких программ применяйте процедуру из Правила 17.
Материал подготовлен для страховых компаний (СК) и медицинских организаций (МО), использующих API
medical-insured-person. Этот раздел устанавливает единые требования и порядок действий при обмене данными между страховыми компаниями и медицинскими организациями. Он описывает процедуры прикрепления, открепления, обновления информации о застрахованных лицах.
Списки на прикрепление, открепление и изменение формируются в соответствии с набором из 18 правил. Они охватывают SLA, последовательность обработки, работу со справочниками и специальные сценарии (ретро-даты, франшизы, продление полиса).
¶ Ключевые правила обмена
¶ Правило 2
SLA отправки
- Фиксируйте сроки направления списков на прикрепление, открепление и замену.
- Базовая рекомендация — не более двух рабочих дней на передачу данных.
- Несоблюдение SLA влечёт риски некорректного обслуживания и санкции.
¶ Правило 3
Техническая экспертиза
- Проверяйте формат, структуру и взаимосвязи полей JSON, особенно с ретро-датами.
- Результаты экспертизы фиксируйте протоколом, подписанным обеими сторонами.
¶ Правило 4
Последовательность обработки
- МО обрабатывает списки по метке
datetime(с учётом часового пояса). - При критических ошибках повторная обработка выполняется в следующих списках.
- Для прозрачности ведите журнал поступления и исполнения списков.
¶ Правило 5
Выбор типа списка
- Changement — изменения ПДн, дат, программ, рисков, лимитов.
- Detachment/Attachment — смена полиса, клиники, договора, а также программ с изменением допсоглашений.
- При будущих периодах дата начала может обновляться без открепления.
- За подробными кейсами и примерами JSON переходите в Руководство по Правилу 5.
¶ Качество данных и справочники
¶ Правило 6
Ошибки по рискам обслуживания
- Критическая ошибка фиксируется, если обслуживание невозможно по всем рискам.
- Поддерживайте актуальный справочник рисков и доступность услуг в каждой клинике.
¶ Правило 7
Разделение взрослых и детей
- Отдельные списки для взрослых и детей при разных программах.
- Автоматизируйте определение категории по возрастным критериям.
¶ Правило 8
Головная организация
- Фиксируйте модель взаимодействия: прямая МО, головная компания или смешанный сценарий.
- В смешанном варианте для отдельных клиник возможны собственные договоры и списки.
¶ Правило 9
Обязательность полей
- Статус «обязательный» исключает значения
nullи «н/д». - МО может вернуть некритическую ошибку (данные приняты с замечаниями) или критическую (запрос отклонён).
- Отсутствие обязательного поля всегда критическая ошибка.
¶ Правило 10
Атрибуты клиник и договоров
- Для клиник сети указывайте
organizationId, название, ИНН и КПП; название однозначно идентифицирует клинику. - При прикреплении ко всей сети перечисление клиник не требуется.
- Поле
ContractDocumentInfoобязательно, при допсоглашениях —AnnexToTheContract.
¶ Правило 11
Коды программ
- Каждая программа имеет уникальные код и наименование из договора.
- Планируется единый справочник программ — готовьтесь к централизованной идентификации.
¶ Правило 12
Риски и расширения
- Передавайте риск и расширение риска отдельно; применяйте общие справочники.
- Элементы вне справочника помечайте признаком «не из справочника» для корректной обработки.
¶ Правило 13
Обработка ошибок
- При критической ошибке направляйте новый список; исходный считается неисполненным.
- Некритические ошибки допускают уточняющий список, исходный остаётся исполненным.
- Ведите журнал ошибок с датой, временем и кодом сообщения.
¶ Специальные сценарии
¶ Правило 14
Программы «Факт/Аванс»
- Каждый тип оформляется отдельным допсоглашением.
- Поле «факт/аванс» обязательно, если тип нельзя определить из договора.
¶ Правило 15
Ретро-даты
- При прикреплении прошедшая дата начала принимается, прошедшая дата окончания — критическая ошибка.
- В списках на изменение и открепление даты корректируются с учётом SLA и ближайших доступных периодов.
- Оплата услуг производится с учётом расхождений дат, выявленных технической экспертизой.
¶ Правило 16
Франшизы
- Франшиза оформляется отдельной программой договора.
- Передавайте условия, проценты оплаты и название программы, чтобы МО корректно рассчитывала услуги.
¶ Правило 17
Несколько программ
- Одно допсоглашение — один список на прикрепление.
- Полное открепление всех программ — один список без перечисления программ (с номером договора).
- Частичное открепление и изменения наборов программ выполняйте через детализированные списки.
¶ Правило 18
Продление полиса
- Продление — увеличение периода при сохранении номера полиса.
- При сохранении программы допускается один список (Changement или Attachment) без пересечения периодов.
- При изменении программы фиксируйте дату внесения изменений и избегайте пересечения периодов обслуживания.
¶ Продление полиса: пример обработки
Пример изменения: «было» 01.01.2025–31.12.2025, «стало» 01.01.2025–31.12.2026.
-
Программа сохраняется.
- Список на прикрепление с периодом 01.01.2025–31.12.2026: если даты не пересекаются, ответ МИС — ОК; при пересечении — критическая ошибка.
- Список на изменение с тем же периодом: если новая дата начала внутри действующего периода, прикрепление продлевается; при выходе за пределы периода МИС возвращает критическую ошибку.
-
Программа изменяется.
- Список на изменение: период 01.01.2025–31.12.2026, «дата внесения изменений» 01.01.2026; ранняя дата закрывает старое прикрепление.
- Список на прикрепление: период 01.01.2026–31.12.2026; при непересекающихся датах создаётся новое прикрепление для второго года.
Ретро-даты и перенос окончания периода обрабатываются по Правилу 15: разрешено расширять период вперёд, при сокращении периодов требуется открепление и повторное прикрепление.