Перейти к содержанию

Управление идентификаторами пациентов

Управление идентификаторами пациентов - это регистрация или изменение данных пациента. Данные поступают из МИС в компонент «Интеграционный шлюз ИЭМК» подсистемы ИЭМК.

Перечень доступных методов сервиса

  • append - Извещение на добавление нового пациента. Код ответа для успешно выполненного запроса 201.
  • update - Извещение на изменение данных пациента. Код ответа для успешно выполненного запроса 200.
  • append_or_update - Извещение на изменение пациента или на добавление нового, если ИЭМК ранее не был уведомлен о пациенте. Код ответа для успешно выполненного запроса может меняться, в зависимости от того, какое действие было выполнено: 201 - пациент был добавлен, 200 - пациент был обновлен.

Эти методы имеют абсолютно одинаковую структуру тела запроса, отличаются только названием в адресной строке.

Пример запроса

Описание параметров приведено в таблице ниже.

POST: https://egisz-test.medflex.ru/api/iemk/v1/patients/append|update|append_or_update/

Authorization: Token <Токен>

{
  "organization": {
    "oid": "1.2.643.5.1.13.13.12.0.0.00000",
    "name": "ООО \"Моя клиника\"",
    "phone": "+79000000000",
    "email": "lpu@example.com"
  },
  "patient": {
    "local_id": "3e3bb21c-b3dd-11de-8172-001583078ee5",
    "surname": "Заболотный",
    "name": "Юрий",
    "patr_name": "Павлович",
    "birth_date": "1991-11-21",
    "gender": 1,
    "phone": "+79274536276",
    "email": "patient@example.com",
    "social_statuses": [
      6
    ],
    "preferential_categories": [
      3
    ],
    "snils": "12155474337",
    "policy_oms": {
      "number": "1234567890",
      "date_begin": "2025-01-01",
      "date_end": "2025-12-31",
      "smo_id": "02017"
    },
    "policy_dms": [
      {
        "number": "1234567890",
        "date_begin": "2025-05-07",
        "date_end": "2025-05-06",
        "smo_id": "02004"
      }
    ],
    "documents": [
      {
        "type": 14,
        "series": "9200",
        "number": "123456",
        "issued": "ОУФМС России, по Даниловскому району, г Москвы в ЮАО",
        "date_begin": "2020-05-06",
        "date_end": null
      }
    ],
    "address_registration": {
      "country": "Российская Федерация",
      "state": "Томская область",
      "city": "Томск",
      "street": "Пушкина ул.",
      "home": "6",
      "block": null,
      "building": null,
      "apartment": "12"
    },
    "address_residence": {
      "country": "Российская Федерация",
      "state": "Томская область",
      "city": "Томск",
      "street": "Ленина ул.",
      "home": "22",
      "block": null,
      "building": null,
      "apartment": null
    },
    "birth_place": {
      "country": "Российская Федерация",
      "city": "Красноярск"
    }
  }
}

Описание параметров

Жирным текстом выделены обязательные параметры.

Параметр
 Описание
organization Информация о МО
organization.oid OID МО по справочнику 1.2.643.5.1.13.13.11.1461
organization.name Наименование МО
organization.phone Номер телефона МО. Без разделителей и кода страны. Пример: 9242551020
organization.email Адрес электронной почты МО
patient Блок пациента
patient.local_id Идентификатор пациента в МИС
patient.surname Фамилия
patient.name Имя
patient.patr_name Отчество
patient.birth_date Дата рождения
patient.gender Пол по справочнику 1.2.643.5.1.13.13.11.1040
patient.phone Номер телефона пациента, без разделителей. Пример: 9242551020 или +79242551020
patient.email Номер телефона пациента, без разделителей. Пример: 9242551020 или +79242551020
patient.social_statuses Социальные статусы по справочнику 1.2.643.5.1.13.13.99.2.374
patient.preferential_categories Категории льгот пациента по справочнику 1.2.643.5.1.13.13.99.2.457
patient.snils СНИЛС
patient.policy_oms Полис ОМС
policy_oms.series Серия полиса ОМС
policy_oms.number Номер полиса ОМС
policy_oms.date_begin Дата выдачи
policy_oms.date_end Дата окончания срока действия
policy_oms.smo_id Идентификатор страховой компании по справочнику 1.2.643.5.1.13.13.99.2.183
patient.policy_dms Полис ДМС
policy_dms.series Серия полиса ДМС
policy_dms.number Номер полиса ДМС
policy_dms.date_begin Дата выдачи
policy_dms.date_end Дата окончания срока действия
policy_dms.smo_id Идентификатор страховой компании по справочнику 1.2.643.5.1.13.13.99.2.183
patient.documents Документы удостоверяющие личность
documents.type Идентификатор типа ДУЛ по справочнику 1.2.643.5.1.13.13.99.2.320
documents.series Серия документа. Обязательность заполнения определена в справочнике 1.2.643.5.1.13.13.99.2.320
documents.number Номер документа
documents.issued Организация, выдавшая документ
documents.date_begin Дата выдачи, начало срока действия
documents.date_end Дата окончания срока действия
patient. address_registration Адрес регистрации
address_registration. country Страна
address_registration.state Регион
address_registration.city Населенный пункт
address_registration.street Улица
address_registration.home Дом
address_registration.block Корпус
address_registration. building Строение
address_registration. apartment Квартира
patient.address_residence Адрес регистрации
address_residence.country Страна
address_residence.state Регион
address_residence.city Населенный пункт
address_residence.street Улица
address_residence.home Дом
address_residence.block Корпус
address_residence.building Строение
address_residence.apartment Квартира
patient.birth_place Место рождения пациента
patient.country Страна
patient.city Населенный пункт

Примеры ответов

Пример успешного ответа

При успешном выполнении запроса, возвращается status: success с соответствующим сообщением.

{
    "request_id": "69fdf6b9-70a6-4fa8-a1bf-ea3f5f6febb0",
    "oid": "1.2.643.5.1.13.13.12.0.0.00000",
    "status": "success",
    "message": "Пациент [Patient(moId: [1.2.643.5.1.13.13.12.0.0.00000], patientId: [3e3bb21c-b3dd-11de-8172-001583078ee5])] обработан успешно"
}

Коды ответов, для успешно выполненных запросов:

  • 200 - Если пациент был изменен. Для методов update и append_or_update
  • 201 - Если пациент был добавлен. Для методов append и append_or_update

Пример запроса выполненного с ошибкой

{
    "request_id": "1f4ba58b-aa4e-4af8-884f-7267eadb1687",
    "oid": "1.2.643.5.1.13.13.12.0.0.00000",
    "status": "error",
    "error_code": "PAT-002",
    "message": "Пациент из [1.2.643.5.1.13.13.12.0.0.00000] с идентификатором [[3e3bb21c-b3dd-11de-8172-001583078ee5]] уже зарегистрирован"
}

Описание ошибок

Код ошибки
Параметр
 Описание
PAT-002 Пациент из [1.2.643.1.2.3] с идентификатором [0a8b64a4-017d-4781-8f5a-1b16b12580b4] уже зарегистрирован Пациент из МО уже зарегистрирован в ИЭМК (попытка повторной регистрации)
PAT-004 Пациент из [1.2.643.1.2.3] с идентификатором [0a8b64a4-017d-4781-8f5a-1b16b12580b4] не зарегистрирован Пациент из МО не зарегистрирован в ИЭМК (попытка операции с несуществующим пациентом)
PAT-031,
PIX-001,
PIX-002		 Внутренняя ошибка Внутренняя ошибка