Для взаимодействия с сервисом Интеграционной платформы используется протокол SOAP 1.1. и 1.2. См. http://www.w3.org/TR/soap/.

Клиентами Интеграционной платформы (клиентами СЗнП) могут выступать следующие информационные системы:

  • Медицинская информационная система;
  • Портал записи на прием;
  • Инфомат;
  • Рабочее место оператора Центра телефонного обслуживания (ЦТО);
  • Мобильное приложение.

    При информационном взаимодействии используется обязательный служебный параметр GUID (авторизационный токен), выдаваемый разработчику МИС администратором Интеграционной платформы.


    Сервис «Запись на прием» в части обеспечения возможности оказания услуги «Запись на медицинские осмотры» содержит следующие методы:

    1. Валидация возможности записи на медицинский осмотр (ValidateMedicalExamination)
    2. Анкетирование пациента в рамках медицинского осмотра (MedicalExaminationQuestioning)
    3. Получение плана медицинского осмотра (GetMedicalExaminationPlan)
    4. Получение доступных слотов для записи на услугу в рамках медицинского осмотра (GetMedicalServiceAvailableSlots)
    5. Запись на медицинскую услугу в рамках медицинского осмотра (BookMedicalService)
    6. Отмена записи на медицинскую услугу в рамках медицинского осмотра (CancelMedicalServiceBooking)
    7. Уведомление об изменении статуса записи на медицинскую услугу в рамках медицинского осмотра (UpdateMedicalServiceBooking)

    Значения параметров методов, имеющих тип Datetime, необходимо передавать в формате UTC с указанием таймзоны. Если таймзона не указана, то в рамках сервиса считается, что передано локальное время (региональное), и сервис работает с переданным значением как с "датой, для которой не указана таймзона".



    Типовое решение для портала

    Данное типовое решение предоставляет возможность оформления записи на медицинскую услугу в рамках медицинского осмотра через порталы записи на прием.

    Рисунок 1. Схема информационного взаимодействия в рамках типового решения для портала


    Типовое решение для взаимодействия с Концентратором услуг ФЭР

    Данное типовое решение предоставляет возможность оформления записи на медицинскую услугу в рамках медицинского осмотра, отмены записи пользователем и передачи на федеральный уровень данных об изменении статуса записи на медицинскую услугу медицинского осмотра в рамках взаимодействия с сервисом «Концентратор услуг ФЭР» в части услуги «Запись для прохождения профилактических медицинских осмотров, диспансеризации» (согласно требованиям, описанным в документе «КУ ФЭР услуга ЛКП Профосмотры, диспансеризация v1.1.1.docx» от 03 сентября 2018, доступном по адресу http://portal.egisz.rosminzdrav.ru/materials/615).

    Рисунок 2. Схема информационного взаимодействия в рамках типового решения для для взаимодействия с Концентратором услуг ФЭР



    Валидация возможности записи на медицинский осмотр (ValidateMedicalExamination)

    Метод «Валидация возможности записи на медицинский осмотр (ValidateMedicalExamination)» используется для получения от целевого ЛПУ информации о возможности записи конкретного пациента на медицинский осмотр и получения информации о текущем статусе прохождения медицинского осмотра.

    На Рисунке 3 представлена схема информационного взаимодействия в рамках метода «Валидация возможности записи на медицинский осмотр (ValidateMedicalExamination)».

    Рисунок 3. Схема информационного взаимодействия в рамках метода «Валидация возможности записи на медицинский осмотр (ValidateMedicalExamination)»

    Описание схемы:

    1. Клиент СЗнП отправляет запрос метода «Валидация возможности записи на медицинский осмотр (ValidateMedicalExamination)» в СЗнП. Состав параметров запроса представлен в Таблице 1.
    2. СЗнП отправляет запрос метода «Валидация возможности записи на медицинский осмотр (ValidateMedicalExamination)» в целевое ЛПУ. Состав параметров запроса представлен в Таблице 1.
    3. Целевое ЛПУ передает ответ метода «Валидация возможности записи на медицинский осмотр (ValidateMedicalExamination)» в СЗнП. Состав выходных данных ответа метода представлен в Таблице 2.
    4. СЗнП передает ответ метода «Валидация возможности записи на медицинский осмотр (ValidateMedicalExamination)» клиенту СЗнП. Состав выходных данных ответа метода представлен в Таблице 2.

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

    Структура запроса ValidateMedicalExamination представлена на Рисунке 4.

    Рисунок 4. Структура запроса метода ValidateMedicalExamination»

    В Таблице 1 представлено описание параметров запроса метода ValidateMedicalExamination.

    Таблица 1 - Описание параметров запроса метода ValidateMedicalExamination
    Контейнер Параметры Обязательность/Кратность Условие Тип Описание
    Root        
    / idLpu 1..1   String Идентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы
    / comment 0..1   String Комментарий
    / medicalExaminationType 0..1   String Тип медицинского осмотра (OID 1.2.643.2.69.1.1.1.106)
    Может принимать следующие значения:
    «1» – 1 этап диспансеризации.
    Возможные значения данного элемента будут расширены при развитии услуги «Запись на медицинские осмотры»
    / guid 1..1   GUID Авторизационный токен
    /ExaminationPatient 1..1     Данные пациента
    /ExaminationPatient Surname 1..1   String Фамилия пациента
    /ExaminationPatient Name 1..1   String Имя пациента
    /ExaminationPatient Patronymic 0..1   String Отчество пациента
    /ExaminationPatient BirthDate 1..1   Date Дата рождения пациента
    /ExaminationPatient PolicySeries 0..1   String Серия полиса ОМС пациента
    /ExaminationPatient PolicyNumber 0..1   String Номер полиса ОМС пациента
    /ExaminationPatient Snils 0..1   String СНИЛС пациента (формат передачи: «XXXXXXXXXXX»)
    /ExaminationPatient Gender 1..1   String Пол пациента (в соответствии с Классификатором половой принадлежности, OID 1.2.643.5.1.13.2.1.1.156)
    /ExaminationPatient Email 0..1   String Адрес электронной почты пациента
    /ExaminationPatient Phone 0..1   String Номер телефона пациента

    Параметр "Обязательность" определяет количество возможных экземпляров параметра

    Возможны следующие значения:

    • 0..1 - параметр необязательный, максимальное количество экземпляров один;
    • 0..* – параметр необязательный, максимальное количество экземпляров не ограничено;
    • 1..1 – параметр обязательный, экземпляр один;
    • 1..* – параметр обязательный, максимальное количество экземпляров не ограничено.


    Описание выходных данных

    Структура ответа ValidateMedicalExamination представлена на Рисунке 5.

    Рисунок 5. Структура ответа метода ValidateMedicalExamination

    В Таблице 2 представлено описание выходных данных метода ValidateMedicalExamination.

    Таблица 2 - Описание выходных данных метода ValidateMedicalExamination
    Контейнер Выходные данные Обязательность/Кратность Тип Описание Возможные значения
    /ValidateMedicalExaminationResult        
    /ValidateMedicalExaminationResult Success 1..1 Boolean Результат выполнения запроса True; False
    /ValidateMedicalExaminationResult IdPat 1..1 String Идентификатор пациента Значение идентификатора пациента из соответствующего справочника целевой МИС
    /ValidateMedicalExaminationResult/ErrorList/Error 0..*      
    /Error ErrorDescription 0..1 String Текстовое описание ошибки Передача текстового описания ошибки обязательна для ошибки с кодом 99
    /Error IdError 1..1 Int Идентификатор ошибки в справочнике
    /ValidateMedicalExaminationResult/ListMedicalExamination 0..1   Медицинские осмотры пациента  
    /ValidateMedicalExaminationResult/ListMedicalExamination/MedicalExamination 1..*   Медицинский осмотр пациента  
    /MedicalExamination IdMedicalExamination 1..1 GUID Идентификатор медицинского осмотра Значение идентификатора медицинского осмотра из соответствующего справочника целевой МИС
    /MedicalExamination MedicalExaminationType 1..1 String Тип медицинского осмотра (OID 1.2.643.2.69.1.1.1.106) Может принимать следующие значения:
    «1» – 1 этап диспансеризации.
    Возможные значения данного элемента будут расширены при развитии услуги «Запись на медицинские осмотры»
    /MedicalExamination ExaminationStatus 1..1 String Статус медицинского осмотра (OID 1.2.643.2.69.1.1.1.108) Может принимать следующие значения:
    «1» - Проведен;
    «2» - Недоступен;
    «3» - Доступен для проведения.
    /MedicalExamination ExaminationStatusNotes 0..1 String Примечания к статусу медицинского осмотра Может принимать следующее значение:
    «В рамках программы ОМС следующее прохождение Вами медицинского осмотра возможно в XXXX году»
    Где XXXX – числовое значение года.
    Элемент обязателен при значениях элемента «ExaminationStatus»:
    «1» - Проведен;
    «2» - Недоступен/
    /MedicalExamination IsQuestionnaireFilled 0..1 Boolean Признак наличия заполненной анкеты Признак наличия в МИС заполненной пациентом анкеты в текущем году (например, по диспансеризации).
    Признак присутствует и заполняется только в случае, если медицинский осмотр (услуга диспансеризации) доступен для прохождения в текущем году
    /ValidateMedicalExaminationResult/ListMedicalExamination
    /MedicalExamination/ListMedicalService
    0..0 Медицинские услуги в рамках медицинского осмотра В рамках текущего метода требуется не передавать данный контейнер

    Запрос

    Вариант запроса сервиса приведен в разделе "Примеры запросов".

    Ответ

    Вариант ответа сервиса приведен в разделе "Примеры запросов".

    Анкетирование пациента в рамках медицинского осмотра (MedicalExaminationQuestioning)

    Метод «Анкетирование пациента в рамках медицинского осмотра (MedicalExaminationQuestioning)» используется для передачи в целевое ЛПУ данных заполненной пациентом анкеты в рамках медицинского осмотра.

    На Рисунке 6 представлена схема информационного взаимодействия в рамках метода «Анкетирование пациента в рамках медицинского осмотра (MedicalExaminationQuestioning)».

    Рисунок 6. Схема информационного взаимодействия в рамках метода «Анкетирование пациента в рамках медицинского осмотра (MedicalExaminationQuestioning)»

    Описание схемы:

    1. Клиент СЗнП отправляет запрос метода «Анкетирование пациента в рамках медицинского осмотра (MedicalExaminationQuestioning)» в СЗнП. Состав параметров запроса представлен в Таблице 3.
    2. СЗнП отправляет запрос метода «Анкетирование пациента в рамках медицинского осмотра (MedicalExaminationQuestioning)» в целевое ЛПУ. Состав параметров запроса представлен в Таблице 3.
    3. Целевое ЛПУ передает ответ метода «Анкетирование пациента в рамках медицинского осмотра (MedicalExaminationQuestioning)» в СЗнП. Состав выходных данных ответа метода представлен в Таблице 4.
    4. СЗнП передает ответ метода «Анкетирование пациента в рамках медицинского осмотра (MedicalExaminationQuestioning)» клиенту СЗнП. Состав выходных данных ответа метода представлен в Таблице 4.

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

    Структура запроса MedicalExaminationQuestioning представлена на Рисунке 7.

    Рисунок 7. Структура запроса метода MedicalExaminationQuestioning

    В Таблице 3 представлено описание параметров запроса метода MedicalExaminationQuestioning.

    Таблица 3 - Описание параметров запроса метода MedicalExaminationQuestioning
    Контейнер Параметры Обязательность/Кратность Условие Тип Описание
    Root
    / idLpu 1..1 String Идентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы
    / idPat 1..1 String Идентификатор пациента из соответствующего справочника целевой МИС
    / idMedicalExamination 1..1 GUID Идентификатор медицинского осмотра из соответствующего справочника целевой МИС
    / comment 0..1 String Комментарий
    / guid 1..1 GUID Авторизационный токен
    /ListQuestionnaire 1..1 Заполненные анкеты
    /ListQuestionnaire/Questionnaire 1..* Заполненная анкета
    /Questionnaire QuestionnaireType 1..1 String <Тип анкеты (OID 1.2.643.2.69.1.1.1.107)
    Может принимать следующие значения:
    «1» - Анкета по диспансеризации для граждан в возрасте до 75 лет;
    «2» - Анкета по диспансеризации для граждан в возрасте после 75 лет.
    Возможные значения данного элемента будут расширены при развитии услуги «Запись на медицинские осмотры»
    /Questionnaire Comment 0..1 String Комментарий к анкете
    /ListQuestionnaire/Questionnaire/ListQuestionnaireAnswer 0..1 Ответы на вопросы анкеты
    /ListQuestionnaire/Questionnaire/ListQuestionnaireAnswer/QuestionnaireAnswer 1..* Ответ на вопрос анкеты
    /QuestionnaireAnswer QuestionCode 1..1 String Код вопроса (кодировка вопросов анкет приведены в Приложении 3 и Приложении 5)
    /QuestionnaireAnswer AnswerValue 0..1 String Значение ответа
    /QuestionnaireAnswer Comment 0..1 String Комментарий к вопросу/ответу

    Описание выходных данных

    Структура ответа MedicalExaminationQuestioning представлена на Рисунке 8.

    Рисунок 8. Структура ответа метода MedicalExaminationQuestioning

    В Таблице 4 представлено описание выходных данных метода MedicalExaminationQuestioning.

    Таблица 4 - Описание выходных данных метода MedicalExaminationQuestioning
    Контейнер Выходные данные Обязательность/Кратность Тип Описание Возможные значения
    /MedicalExaminationQuestioningResult
    /ValidateMedicalExaminationResult Success 1..1 Boolean Результат выполнения запроса True; False
    /MedicalExaminationQuestioningResult/ErrorList/Error 0..*
    /Error ErrorDescription 0..1 String Текстовое описание ошибки Передача текстового описания ошибки обязательна для ошибки с кодом 99
    /Error IdError 1..1 Int Идентификатор ошибки в справочнике

    Запрос

    Вариант запроса сервиса приведен в разделе "Примеры запросов".

    Ответ

    Вариант ответа сервиса приведен в разделе "Примеры запросов".

    Получение плана медицинского осмотра (GetMedicalExaminationPlan)

    Метод «Получение плана медицинского осмотра (GetMedicalExaminationPlan)» используется для получения из целевого ЛПУ плана прохождения медицинского осмотра, в том числе перечня медицинских услуг, доступных пациенту в рамках медицинского осмотра, и их текущего статуса.

    На Рисунке 9 представлена схема информационного взаимодействия в рамках метода «Получение плана медицинского осмотра (GetMedicalExaminationPlan)».

    Рисунок 9. Схема информационного взаимодействия в рамках метода «Получение плана медицинского осмотра (GetMedicalExaminationPlan)»

    Описание схемы:

    1. Клиент СЗнП отправляет запрос метода «Получение плана медицинского осмотра (GetMedicalExaminationPlan)» в СЗнП. Состав параметров запроса представлен в Таблице 5.
    2. СЗнП отправляет запрос метода «Получение плана медицинского осмотра (GetMedicalExaminationPlan)» в целевое ЛПУ. Состав параметров запроса представлен в Таблице 5.
    3. Целевое ЛПУ передает ответ метода «Получение плана медицинского осмотра (GetMedicalExaminationPlan)» в СЗнП. Состав выходных данных ответа метода представлен в Таблице 6.
    4. СЗнП передает ответ метода «Получение плана медицинского осмотра (GetMedicalExaminationPlan)» клиенту СЗнП. Состав выходных данных ответа метода представлен в Таблице 6.

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

    Структура запроса GetMedicalExaminationPlan представлена на Рисунке 10.

    Рисунок 10. Структура запроса метода GetMedicalExaminationPlan

    В Таблице 5 представлено описание параметров запроса метода GetMedicalExaminationPlan.

    Таблица 5 – Описание параметров запроса метода GetMedicalExaminationPlan
    Контейнер Параметры Обязательность/Кратность Условие Тип Описание
    Root
    / idLpu 1..1 String Идентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы
    / idPat 1..1 String Идентификатор пациента из соответствующего справочника целевой МИС
    / idMedicalExamination 1..1 GUID Идентификатор медицинского осмотра из соответствующего справочника целевой МИС
    / guid 1..1 GUID Авторизационный токен

    Описание выходных данных

    Структура ответа GetMedicalExaminationPlan представлена на Рисунке 11.

    Рисунок 11. Структура ответа метода GetMedicalExaminationPlan

    В Таблице 6 представлено описание выходных данных метода GetMedicalExaminationPlan.

    Таблица 6 - Описание выходных данных метода GetMedicalExaminationPlan
    Контейнер Выходные данные Обязательность/Кратность Тип Описание Возможные значения
    /GetMedicalExaminationPlanResult
    /GetMedicalExaminationPlanResult Success 1..1 Boolean Результат выполнения запроса True; False
    /GetMedicalExaminationPlanResult/ErrorList/Error 0..*
    /Error ErrorDescription 0..1 String Текстовое описание ошибки Передача текстового описания ошибки обязательна для ошибки с кодом 99
    /Error IdError Int Идентификатор ошибки в справочнике
    /GetMedicalExaminationPlanResult/MedicalExamination 1..1 Медицинский осмотр пациента
    /MedicalExamination IdMedicalExamination 1..1 GUID Идентификатор медицинского осмотра Значение идентификатора медицинского
    осмотра из соответствующего справочника целевой МИС
    /MedicalExamination MedicalExaminationType 1..1 String Тип медицинского осмотра (OID 1.2.643.2.69.1.1.1.106) Может принимать следующие значения:
    «1» – 1 этап диспансеризации.
    Возможные значения данного элемента будут расширены при развитии услуги «Запись на медицинские осмотры»
    /MedicalExamination ExaminationStatus 1..1 String Статус медицинского осмотра (OID 1.2.643.2.69.1.1.1.108) Может принимать следующие значения:
    «1» - Проведен;
    «2» - Недоступен;
    «3» - Доступен для проведения.
    /MedicalExamination ExaminationStatusNotes 0..1 String Примечания к статусу медицинского осмотра Может принимать следующее значение:
    «В рамках программы ОМС следующее прохождение
    Вами медицинского осмотра возможно в XXXX году»
    Где XXXX – числовое значение года.
    Элемент обязателен при значениях элемента «ExaminationStatus»:
    «1» - Проведен;
    «2» - Недоступен.
    /MedicalExamination IsQuestionnaireFilled 0..1 Boolean Признак наличия заполненной анкеты Признак наличия в МИС заполненной пациентом анкеты
    в текущем году (например, по диспансеризации).
    Признак присутствует и заполняется только в случае,
    если медицинский осмотр (услуга диспансеризации) доступен для прохождения в текущем году
    /GetMedicalExaminationPlanResult/ListMedicalService 0..1 Медицинские услуги в рамках медицинского осмотра Элемент обязателен при значениях элемента «ExaminationStatus»:
    «1» - Проведен;
    «3» - Доступен для проведения.
    /GetMedicalExaminationPlanResult/
    ListMedicalService/MedicalService
    1..* Медицинская услуга
    /MedicalService IdMedicalService 1..1 GUID Идентификатор медицинской услуги Значение идентификатора медицинской услуги из соответствующего справочника целевой МИС
    /MedicalService MedicalServiceName 1..1 String Наименование медицинской услуги Наименование медицинской услуги из соответствующего справочника целевой МИС
    /MedicalService MedicalServiceCode 1..1 String Код медицинской услуги в соответствии с федеральным справочником Код медицинской услуги по классификатору ОКМУ (OID 1.2.643.5.1.13.13.11.1070). Пример: B04.047.001
    /MedicalService MedicalServiceConditions 0..1 String Условия оказания медицинской услуги Текстовое описание условий оказания медицинской услуги.
    Пример: Кровь для лабораторного исследования рекомендуется сдавать утром, натощак
    (не менее 8 часов и не более 14 часов голода, питье – вода, в обычном режиме),
    накануне избегать пищевых перегрузок, приёма алкоголя;
    не курить минимально в течение 1 часа до исследования.
    /MedicalService MedicalServiceStatus 1..1 String Статус оказания услуги (OID 1.2.643.2.69.1.1.1.109) Может принимать следующие значения:
    «1» - Запланирована;
    «2» - Оказана;
    «3» - Доступна;
    «4» - Недоступна.
    /MedicalService MedicalServiceRequired 1..1 Boolean Признак обязательности оказания медицинской услуги в рамках медицинского осмотра Может принимать следующие значения:
    true – обязательно;
    false – необязательно.
    /MedicalService MedicalServiceUnavailableReason 0..1 String Причина недоступности записи на медицинскую услугу Элемент обязателен для услуг со значением поля MedicalServiceStatus = «4» (Недоступна).
    Элемент должен отсутствовать для услуг со значениями поля MedicalServiceStatus = «1», «2» и «3».
    Пример: Услуга недоступна для предварительной записи и оказывается по направлению врача-терапевта
    /MedicalService MedicalServiceComment 0..1 String Комментарий к медицинской услуге
    /GetMedicalExaminationPlanResult/ListMedicalService
    /MedicalService/ MedicalServiceBooking
    0..1 Данные по записи на медицинскую услугу Элемент обязателен для услуг со значениями поля MedicalServiceStatus = «1» и «2».
    Элемент обязателен для услуг со значениями поля MedicalServiceStatus = «3» и «4», если по данной услуге ранее была оформлена запись
    /MedicalServiceBooking IdMedicalServiceBooking 1..1 GUID Идентификатор записи на медицинскую услугу Значение идентификатора записи на медицинскую услугу
    /MedicalServiceBooking MedicalServiceBookingDateTime 1..1 Datetime Дата и время, на которые записан пациент на оказание медицинской услуги
    /MedicalServiceBooking MedicalServiceBookingStatus 1..1 String Статус записи на медицинскую услугу (OID 1.2.643.2.69.1.1.1.114) Может принимать следующие значения: «1» - Запись оформлена;
    «2» - Посещение состоялось (услуга оказана);
    «3» - Запись отменена по инициативе МО;
    «4» - Запись отменена по инициативе пациента;
    «5» - Пациент не явился.
    /MedicalServiceBooking BookingSource 1..1 String Источник оформления записи на медицинскую услугу (OID 1.2.643.2.69.1.1.1.115)
    /MedicalServiceBooking BookingMember 1..1
    Для значения "6" об источнике оформления записи
    0..1
    Для остальных значений об источнике оформления записи
    GUID Участник информационного взаимодействия, осуществивший запись на медицинскую услугу
    /MedicalServiceBooking ChangeBookingSource 0..1
    Элемент должен обязательно присутствовать
    при значении поля MedicalServiceBookingStatus
    не равном «1» (Запись оформлена)
    String Источник изменения статуса записи на медицинскую услугу (OID 1.2.643.2.69.1.1.1.115)
    /MedicalServiceBooking ChangeBookingMember 1..1
    Для значения "6" об источнике изменения статуса записи
    0..1
    Для остальных значений об источнике изменения статуса записи
    GUID Участник информационного взаимодействия, изменивший статус записи на медицинскую услугу
    /MedicalServiceBooking IdLpu 1..1 String Идентификатор медицинской организации, в которой производится медицинская услуга Идентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы
    /MedicalServiceBooking Room 0..1 String Наименование кабинета, в котором оказывается услуга Пример: Кабинет №45
    /MedicalServiceBooking MedicalServiceBoookingComment 0..1 String Комментарий к записи на медицинскую услугу
    /GetMedicalExaminationPlanResult/ListMedicalService
    /MedicalService/MedicalServiceBooking/ListMedicalResource
    0..1 Данные медицинских ресурсов, оказывающих медицинскую услугу Элемент обязателен для услуг со значением поля MedicalServiceStatus = «1» и «2»
    /GetMedicalExaminationPlanResult/ListMedicalService
    /MedicalService/MedicalServiceBooking/ListMedicalResource/MedicalResource
    1..1 Данные медицинского ресурса, оказывающего медицинскую услугу
    /MedicalResource IdMedicalResource 1..1 GUID Идентификатор медицинского ресурса Значение идентификатора медицинского ресурса из соответствующего справочника целевой МИС
    /MedicalResource MedicalResourceName 1..1 String Наименование медицинского ресурса Наименование медицинского ресурса из соответствующего справочника целевой МИС
    /MedicalResource MedicalResourceComment 0..1 String Комментарий к медицинскому ресурсу
    /GetMedicalExaminationPlanResult/ListMedicalService
    /MedicalService/ MedicalServiceBooking/ListMedicalResource
    /MedicalResource/MedicalEmployee
    0..1 Данные медицинского работника, оказывающего медицинскую услугу Элемент обязателен, если медицинский ресурс, оказывающий медицинскую услугу, является медицинским работником
    /MedicalEmployee MedicalEmployeeSnils 1..1 String СНИЛС медицинского работника СНИЛС медицинского работника из соответствующего справочника целевой МИС (формат передачи: «XXXXXXXXXXX»)
    /MedicalEmployee MedicalEmployeePositionCode 1..1 String Код должности медицинского работника Должно соответствовать коду должности медицинского работника
    согласно классификатору НСИ 1.2.643.5.1.13.13.11.1002
    «Должности работников организаций медицинского и фармацевтического профиля». Пример: 109
    /MedicalEmployee MedicalEmployeeFedIdSpeciality 1..1 String Идентификатор врачебной специальности медицинского работника в федеральном справочнике специальностей Номенклатура специальностей специалистов с высшим и послевузовским медицинским и фармацевтическим образованием в сфере здравоохранения (OID 1.2.643.5.1.13.2.1.1.181)
    /MedicalEmployee MedicalEmployeeIdSpeciality 1..1 String Идентификатор врачебной специальности медицинского работника Значение идентификатора врачебной специальности медицинского работника из соответствующего справочника целевой МИС
    /MedicalEmployee MedicalEmployeeNameSpeciality 1..1 String Наименование врачебной специальности медицинского работника Наименование врачебной специальности медицинского работника из соответствующего справочника целевой МИС
    /MedicalEmployee MedicalEmployeeComment 0..1 String Комментарий к медицинскому работнику
    /GetMedicalExaminationPlanResult/ListMedicalService/
    MedicalService/MedicalServiceAvailableResource
    0..1 Данные для осуществления записи на медицинскую услугу Элемент обязателен для услуг со значением поля MedicalServiceStatus = «3».
    Элемент должен отсутствовать для услуг со значениями
    поля MedicalServiceStatus = «2» и «4».
    /MedicalServiceAvailableResource IdLpu 1..1 String Идентификатор медицинской организации, в которой производится медицинская услуга Идентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы
    /GetMedicalExaminationPlanResult/ListMedicalService/MedicalService
    /MedicalServiceAvailableResource/ListMedicalResource
    1..1 Данные медицинского ресурса, оказывающего медицинскую услугу
    /GetMedicalExaminationPlanResult/ListMedicalService/MedicalService
    /MedicalServiceAvailableResource/ListMedicalResource
    /MedicalResource
    1..* Данные медицинского ресурса, оказывающего медицинскую услугу
    /MedicalResource IdMedicalResource 1..1 GUID Идентификатор медицинского ресурса Значение идентификатора медицинского ресурса из соответствующего справочника целевой МИС
    /MedicalResource MedicalResourceName 1..1 String Наименование медицинского ресурса Наименование медицинского ресурса из соответствующего справочника целевой МИС
    /MedicalResource MedicalResourceComment 0..1 String Комментарий к медицинскому ресурсу
    /GetMedicalExaminationPlanResult/ListMedicalService
    /MedicalService/MedicalServiceAvailableResource
    /ListMedicalResource/MedicalResource
    /MedicalEmployee
    0..1 Данные медицинского работника, оказывающего медицинскую услугу Элемент обязателен, если медицинский ресурс, оказывающий медицинскую услугу, является медицинским работником
    /MedicalEmployee MedicalEmployeeSnils 1..1 String СНИЛС медицинского работника СНИЛС медицинского работника из соответствующего справочника целевой МИС (формат передачи: «XXXXXXXXXXX»)
    /MedicalEmployee MedicalEmployeePositionCode 1..1 String Код должности медицинского работника Должно соответствовать коду должности медицинского работника
    согласно классификатору НСИ 1.2.643.5.1.13.13.11.1002
    «Должности работников организаций медицинского и фармацевтического профиля».
    Пример: 109
    /MedicalEmployee MedicalEmployeeFedIdSpeciality 1..1 String Идентификатор врачебной специальности медицинского работника в федеральном справочнике специальностей Номенклатура специальностей специалистов с высшим и послевузовским медицинским и фармацевтическим образованием в сфере здравоохранения (OID 1.2.643.5.1.13.2.1.1.181)
    /MedicalEmployee MedicalEmployeeIdSpeciality 1..1 String Идентификатор врачебной специальности медицинского работника Значение идентификатора врачебной специальности медицинского работника из соответствующего справочника целевой МИС
    /MedicalEmployee MedicalEmployeeNameSpeciality 1..1 String Наименование врачебной специальности медицинского работника Наименование врачебной специальности медицинского работника из соответствующего справочника целевой МИС
    /MedicalEmployee MedicalEmployeeComment 0..1 String Комментарий к медицинскому работнику
    /GetMedicalExaminationPlanResult/ListMedicalService
    /MedicalService/MedicalServiceAvailableResource
    /ListMedicalResource/MedicalResource
    /ListSlot
    0..1 Указывается информация о талонах (свободных временных интервалах), рекомендуемых для записи на медицинскую услугу
    /GetMedicalExaminationPlanResult/ListMedicalService/
    MedicalService/MedicalServiceAvailableResource
    /ListMedicalResource/MedicalResource/ListSlot/Slot
    1..1 Указывается информация о талоне (свободном временном интервале), рекоммедуемом для записи на медицинскую услугу
    /Slot IdSlot 1..1 GUID Идентификатор слота (талона) Значение идентификатора талона на прием из соответствующего справочника целевой МИС
    /Slot VisitStart 1..1 Datetime Дата и время начала приема
    /Slot VisitEnd 1..1 Datetime Дата и время окончания приема
    /Slot Room 0..1 String Наименование кабинета, в котором оказывается услуга Пример: Кабинет №45
    /Slot Address 0..1 String Адрес оказания медицинской услуги Указывается адрес места оказания услуги в случае, если данный адрес отличается от адреса МО/подразделения МО

    Запрос

    Вариант запроса сервиса приведен в разделе "Примеры запросов".

    Ответ

    Вариант ответа сервиса приведен в разделе "Примеры запросов".

    Получение доступных слотов для записи на услугу в рамках медицинского осмотра (GetMedicalServiceAvailableSlots)

    Метод «Получение доступных слотов для записи на услугу в рамках медицинского осмотра (GetMedicalServiceAvailableSlots)» используется для получения из целевого ЛПУ списка талонов (слотов), доступных пациенту для записи на конкретную медицинскую услугу в рамках медицинского осмотра.

    На Рисунке 12 представлена схема информационного взаимодействия в рамках метода «Получение доступных слотов для записи на услугу в рамках медицинского осмотра (GetMedicalServiceAvailableSlots)».

    Рисунок 12. Схема информационного взаимодействия в рамках метода «Получение доступных слотов для записи на услугу в рамках медицинского осмотра (GetMedicalServiceAvailableSlots)»

    Описание схемы:

    1. Клиент СЗнП отправляет запрос метода «Получение доступных слотов для записи на услугу в рамках медицинского осмотра (GetMedicalServiceAvailableSlots)» в СЗнП. Состав параметров запроса представлен в Таблице 7.
    2. СЗнП отправляет запрос метода «Получение доступных слотов для записи на услугу в рамках медицинского осмотра (GetMedicalServiceAvailableSlots)» в целевое ЛПУ. Состав параметров запроса представлен в Таблице 7.
    3. Целевое ЛПУ передает ответ метода «Получение доступных слотов для записи на услугу в рамках медицинского осмотра (GetMedicalServiceAvailableSlots)» в СЗнП. Состав выходных данных ответа метода представлен в Таблице 8.
    4. СЗнП передает ответ метода «Получение доступных слотов для записи на услугу в рамках медицинского осмотра (GetMedicalServiceAvailableSlots)» клиенту СЗнП. Состав выходных данных ответа метода представлен в Таблице 8.

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

    Структура запроса GetMedicalServiceAvailableSlots представлена на Рисунке 13.

    Рисунок 13. Структура запроса метода GetMedicalServiceAvailableSlots

    В Таблице 7 представлено описание параметров запроса метода GetMedicalServiceAvailableSlots.

    Таблица 7 – Описание параметров запроса метода GetMedicalServiceAvailableSlots
    Контейнер Параметры Обязательность/Кратность Условие Тип Описание
    Root
    / idLpu 1..1 StringИдентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы
    / idPat 1..1 String Идентификатор пациента из соответствующего справочника целевой МИС
    / idMedicalExamination 1..1 GUID Идентификатор медицинского осмотра из соответствующего справочника целевой МИС
    / IdMedicalService 1..1 GUID Идентификатор медицинской услуги из соответствующего справочника целевой МИС
    / IdMedicalResource 1..1 GUID Идентификатор медицинского ресурса из соответствующего справочника целевой МИС
    / slotSearchStartDate 1..1 Datetime Начальная дата отбора слотов (включительно)
    / slotSearchEndDate 1..1 Datetime Конечная дата отбора слотов (включительно)
    / guid 1..1 GUID Авторизационный токен

    Описание выходных данных

    Структура ответа GetMedicalServiceAvailableSlots представлена на Рисунке 14.

    Рисунок 14. Структура ответа метода GetMedicalServiceAvailableSlots

    В Таблице 8 представлено описание выходных данных метода GetMedicalServiceAvailableSlots.

    Таблица 8 - Описание выходных данных метода GetMedicalServiceAvailableSlots
    Контейнер Выходные данные Обязательность/Кратность Тип Описание Возможные значения
    /GetMedicalServiceAvailableSlotsResult
    /GetMedicalServiceAvailableSlotsResult Success 1..1 Boolean Результат выполнения запроса True; False
    /GetMedicalServiceAvailableSlotsResult/ErrorList/Error 0..*
    /Error ErrorDescription 0..1 String Текстовое описание ошибки Передача текстового описания ошибки обязательна для ошибки с кодом 99
    /Error IdError 1..1 Int Идентификатор ошибки в справочнике
    /GetMedicalServiceAvailableSlotsResult/ListSlot 0..1 Указывается информация о талонах (свободных временных интервалах)
    /GetMedicalServiceAvailableSlotsResult/ListSlot/Slot 1..* Указывается информация о талоне (свободном временном интервале)
    /Slot IdSlot 1..1 GUID Идентификатор слота (талона) Значение идентификатора талона на прием из соответствующего справочника целевой МИС
    /Slot VisitStart 1..1 Datetime Дата и время начала приема
    /Slot VisitEnd 1..1 Datetime Дата и время окончания приема
    /Slot Room 0..1 String Наименование кабинета, в котором оказывается услуга Пример: Кабинет №45
    /Slot Address 0..1 String Адрес оказания медицинской услуги Указывается адрес места оказания услуги в случае, если данный адрес отличается от адреса МО/подразделения МО

    Запрос

    Вариант запроса сервиса приведен в разделе "Примеры запросов".

    Ответ

    Вариант ответа сервиса приведен в разделе "Примеры запросов".

    Запись на медицинскую услугу в рамках медицинского осмотра (BookMedicalService)

    Метод «Запись на медицинскую услугу в рамках медицинского осмотра (BookMedicalService)» используется для записи пациента на медицинскую услугу в рамках медицинского осмотра в выбранный временной интервал.

    На Рисунке 15 представлена схема информационного взаимодействия в рамках метода «Запись на медицинскую услугу в рамках медицинского осмотра (BookMedicalService)».

    Рисунок 15. Схема информационного взаимодействия в рамках метода «Запись на медицинскую услугу в рамках медицинского осмотра (BookMedicalService)»

    Описание схемы:

    1. Клиент СЗнП отправляет запрос метода «Запись на медицинскую услугу в рамках медицинского осмотра (BookMedicalService)» в СЗнП. Состав параметров запроса представлен в Таблице 9.
    2. СЗнП отправляет запрос метода «Запись на медицинскую услугу в рамках медицинского осмотра (BookMedicalService)» в целевое ЛПУ. Состав параметров запроса представлен в Таблице 9.
    3. Целевое ЛПУ передает ответ метода «Запись на медицинскую услугу в рамках медицинского осмотра (BookMedicalService)» в СЗнП. Состав выходных данных ответа метода представлен в Таблице 10.
    4. СЗнП передает ответ метода «Запись на медицинскую услугу в рамках медицинского осмотра (BookMedicalService)» клиенту СЗнП. Состав выходных данных ответа метода представлен в Таблице 10.

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

    Структура запроса BookMedicalService представлена на Рисунке 16.

    Рисунок 16. Структура запроса метода BookMedicalService

    В Таблице 9 представлено описание параметров запроса метода BookMedicalService.

    Таблица 9 – Описание параметров запроса метода BookMedicalService
    Контейнер Параметры Обязательность/Кратность Условие Тип Описание
    Root
    / idLpu 1..1 String Идентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы
    / idPat 1..1 String Идентификатор пациента из соответствующего справочника целевой МИС
    / idMedicalExamination 1..1 GUID Идентификатор медицинского осмотра из соответствующего справочника целевой МИС
    / idMedicalService 1..1 GUID Идентификатор медицинской услуги из соответствующего справочника целевой МИС
    / idMedicalResource 1..1 GUID Идентификатор медицинского ресурса из соответствующего справочника целевой МИС
    / idSlot 1..1 GUID Идентификатор слота (талона) из соответствующего справочника целевой МИС
    / visitStart 0..1 Datetime Дата и время начала приема
    / guid 1..1 GUID Авторизационный токен

    Описание выходных данных

    Структура ответа BookMedicalService представлена на Рисунке 17.

    Рисунок 17. Структура ответа метода BookMedicalService

    В Таблице 10 представлено описание выходных данных метода BookMedicalService.

    Таблица 10 - Описание выходных данных метода BookMedicalService
    Контейнер Выходные данные Обязательность/Кратность Тип Описание Возможные значения
    /BookMedicalServiceResult
    /MedicalServiceBookingResult Success 1..1 Boolean Результат выполнения запроса True; False
    /BookMedicalServiceResult/ErrorList/Error 0..*
    /Error ErrorDescription 0..1 String Текстовое описание ошибки Передача текстового описания ошибки обязательна для ошибки с кодом 99
    /Error IdError 1..1 Int Идентификатор ошибки в справочнике
    /BookMedicalServiceResult/MedicalService 0..1 Данные по медицинской услуге Заполняется, если запись на медицинскую услугу успешно произведена
    /MedicalService IdMedicalService 1..1 GUID Идентификатор медицинской услуги Значение идентификатора медицинской услуги из соответствующего справочника целевой МИС
    /MedicalService/td> MedicalServiceName 1..1 String Наименование медицинской услуги Наименование медицинской услуги из соответствующего справочника целевой МИС
    /MedicalService MedicalServiceCode 1..1 String Код медицинской услуги в соответствии с федеральным справочником Код медицинской услуги по классификатору ОКМУ (OID 1.2.643.5.1.13.13.11.1070).
    Пример: B04.047.001
    /MedicalService MedicalServiceConditions 0..1 String Условия оказания медицинской услуги Текстовое описание условий оказания медицинской услуги.
    Пример: Кровь для лабораторного исследования рекомендуется сдавать утром, натощак (не менее 8 часов и не более 14 часов голода,
    питье – вода, в обычном режиме), накануне избегать пищевых перегрузок, приёма алкоголя;
    не курить минимально в течение 1 часа до исследования.
    /MedicalService MedicalServiceStatus 1..1 String Статус оказания услуги (OID 1.2.643.2.69.1.1.1.109) Может принимать следующие значения:
    «1» - Запланирована.
    /MedicalService MedicalServiceRequired 1..1 Boolean Признак обязательности оказания медицинской услуги в рамках медицинского осмотра Может принимать следующие значения:
    true – обязательно;
    false – необязательно.
    /MedicalService MedicalServiceUnavailableReason 0..0 String Причина недоступности записи на медицинскую услугу
    /MedicalService MedicalServiceComment 0..1 String Комментарий к медицинской услуге
    /BookMedicalServiceResult/MedicalService/ MedicalServiceBooking 1..1 Данные по записи на медицинскую услугу
    /MedicalServiceBooking IdMedicalServiceBooking 1..1 GUID Идентификатор записи на медицинскую услугу Значение идентификатора записи на медицинскую услугу
    /MedicalServiceBooking MedicalServiceBookingDateTime 1..1 Datetime Дата и время, на которые записан пациент на оказание медицинской услуги
    /MedicalServiceBooking MedicalServiceBookingStatus 1..1 String Статус записи на медицинскую услугу (OID 1.2.643.2.69.1.1.1.114) Может принимать следующие значения:
    «1» - Запись оформлена.
    /MedicalServiceBooking BookingSource 1..1 String Источник оформления записи на медицинскую услугу (OID 1.2.643.2.69.1.1.1.115)
    /MedicalServiceBooking BookingMember 1..1
    Для значения "6" об источнике
    оформления записи
    0..1
    Для остальных значений об источнике оформления записи
    GUID Участник информационного взаимодействия, осуществивший запись на медицинскую услугу
    /MedicalServiceBooking ChangeBookingSource 0..0 String Источник изменения статуса записи на медицинскую услугу (OID 1.2.643.2.69.1.1.1.115)
    /MedicalServiceBooking ChangeBookingMember 0..0 GUID Участник информационного взаимодействия, изменивший статус записи на медицинскую услугу
    /MedicalServiceBooking IdLpu 1..1 String Идентификатор медицинской организации, в которой производится медицинская услуга Идентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы
    /MedicalServiceBooking Room 0..1 String Наименование кабинета, в котором оказывается услуга Пример: Кабинет №45
    /MedicalServiceBooking MedicalServiceBoookingComment 0..1 String Комментарий к записи на медицинскую услугу
    /BookMedicalServiceResult/MedicalService/ MedicalServiceBooking/ListMedicalResource 1..1 Данные медицинских ресурсов, оказывающих медицинскую услугу
    /BookMedicalServiceResult/MedicalService/ MedicalServiceBooking/ListMedicalResource/MedicalResource 1..1 Данные медицинского ресурса, оказывающего медицинскую услугу
    /MedicalResource IdMedicalResource 1..1 GUID Идентификатор медицинского ресурса Значение идентификатора медицинского ресурса из соответствующего справочника целевой МИС
    /MedicalResource MedicalResourceName 1..1 String Наименование медицинского ресурса Наименование медицинского ресурса из соответствующего справочника целевой МИС
    /MedicalResource MedicalResourceComment 0..1 String Комментарий к медицинскому ресурсу
    /BookMedicalServiceResult/MedicalService/ MedicalServiceBooking/ListMedicalResource/MedicalResource/MedicalEmployee 0..1 Данные медицинского работника, оказывающего медицинскую услугу Элемент обязателен, если медицинский ресурс, оказывающий медицинскую услугу, является медицинским работником
    /MedicalEmployee MedicalEmployeeSnils 1..1 String СНИЛС медицинского работника СНИЛС медицинского работника из соответствующего справочника целевой МИС (формат передачи: «XXXXXXXXXXX»)
    /MedicalEmployee MedicalEmployeePositionCode 1..1 String Код должности медицинского работника Должно соответствовать коду должности медицинского работника
    согласно классификатору НСИ 1.2.643.5.1.13.13.11.1002
    «Должности работников организаций медицинского и фармацевтического профиля».
    Пример: 109
    /MedicalEmployee MedicalEmployeeFedIdSpeciality 1..1 String Идентификатор врачебной специальности медицинского работника в федеральном справочнике специальностей Номенклатура специальностей специалистов с высшим и послевузовским медицинским и фармацевтическим образованием в сфере здравоохранения (OID 1.2.643.5.1.13.2.1.1.181)
    /MedicalEmployee MedicalEmployeeIdSpeciality 1..1 String Идентификатор врачебной специальности медицинского работника Значение идентификатора врачебной специальности медицинского работника из соответствующего справочника целевой МИС
    /MedicalEmployee MedicalEmployeeNameSpeciality 1..1 String Наименование врачебной специальности медицинского работника Наименование врачебной специальности медицинского работника из соответствующего справочника целевой МИС
    /MedicalEmployee MedicalEmployeeComment 0..1 String Комментарий к медицинскому работнику
    /BookMedicalServiceResult/MedicalService
    /MedicalServiceAvailableResource
    0..0 Данные для осуществления записи на медицинскую услугу В рамках текущего метода требуется не передавать данный контейнер

    Запрос

    Вариант запроса сервиса приведен в разделе "Примеры запросов".

    Ответ

    Вариант ответа сервиса приведен в разделе "Примеры запросов".

    Отмена записи на медицинскую услугу в рамках медицинского осмотра (CancelMedicalServiceBooking)

    Метод «Отмена записи на медицинскую услугу в рамках медицинского осмотра (CancelMedicalServiceBooking)» используется для отмены записи пациента на медицинскую услугу в рамках медицинского осмотра.

    На Рисунке 18 представлена схема информационного взаимодействия в рамках метода «Отмена записи на медицинскую услугу в рамках медицинского осмотра (CancelMedicalServiceBooking)».

    Рисунок 18. Схема информационного взаимодействия в рамках метода «Отмена записи на медицинскую услугу в рамках медицинского осмотра (CancelMedicalServiceBooking)»

    Описание схемы:

    1. Клиент СЗнП отправляет запрос метода «Отмена записи на медицинскую услугу в рамках медицинского осмотра (CancelMedicalServiceBooking)» в СЗнП. Состав параметров запроса представлен в Таблице 11.
    2. СЗнП отправляет запрос метода «Отмена записи на медицинскую услугу в рамках медицинского осмотра (CancelMedicalServiceBooking)» в целевое ЛПУ. Состав параметров запроса представлен в Таблице 11.
    3. Целевое ЛПУ передает ответ метода «Отмена записи на медицинскую услугу в рамках медицинского осмотра (CancelMedicalServiceBooking)» в СЗнП. Состав выходных данных ответа метода представлен в Таблице 12.
    4. СЗнП передает ответ метода «Отмена записи на медицинскую услугу в рамках медицинского осмотра (CancelMedicalServiceBooking)» клиенту СЗнП. Состав выходных данных ответа метода представлен в Таблице 12.

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

    Структура запроса CancelMedicalServiceBooking представлена на Рисунке 19.

    Рисунок 19. Структура запроса метода CancelMedicalServiceBooking

    В Таблице 11 представлено описание параметров запроса метода CancelMedicalServiceBooking.

    Таблица 11 – Описание параметров запроса метода CancelMedicalServiceBooking
    Контейнер Параметры Обязательность/Кратность Условие Тип Описание
    Root
    / idLpu 1..1 String Идентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы
    / idPat 1..1 String Идентификатор пациента из соответствующего справочника целевой МИС
    / idMedicalServiceBooking 1..1 GUID Идентификатор записи на медицинскую услугу
    / guid 1..1 GUID Авторизационный токен

    Описание выходных данных

    Структура ответа CancelMedicalServiceBooking представлена на Рисунке 20.

    Рисунок 20. Структура ответа метода CancelMedicalServiceBooking

    В Таблице 12 представлено описание выходных данных метода CancelMedicalServiceBooking.

    Таблица 12 - Описание выходных данных метода CancelMedicalServiceBooking
    Контейнер Выходные данные Обязательность/Кратность Тип Описание Возможные значения
    /CancelMedicalServiceBookingResult
    /MedicalServiceBookingResult Success 1..1 Boolean Результат выполнения запроса True; False
    /CancelMedicalServiceBookingResult/ErrorList/Error 0..*
    /Error ErrorDescription 0..1 String Текстовое описание ошибки Передача текстового описания ошибки обязательна для ошибки с кодом 99
    /Error IdError 1..1 Int Идентификатор ошибки в справочнике

    Запрос

    Вариант запроса сервиса приведен в разделе "Примеры запросов".

    Ответ

    Вариант ответа сервиса приведен в разделе "Примеры запросов".

    Уведомление об изменении статуса записи на медицинскую услугу в рамках медицинского осмотра (UpdateMedicalServiceBooking)

    Метод «Уведомление об изменении статуса записи на медицинскую услугу в рамках медицинского осмотра (UpdateMedicalServiceBooking)» используется для отмены записи пациента на медицинскую услугу в рамках медицинского осмотра.

    На Рисунке 21 представлена схема информационного взаимодействия в рамках метода «Уведомление об изменении статуса записи на медицинскую услугу в рамках медицинского осмотра (UpdateMedicalServiceBooking)».

    Рисунок 21. Схема информационного взаимодействия в рамках метода «Уведомление об изменении статуса записи на медицинскую услугу в рамках медицинского осмотра (UpdateMedicalServiceBooking)»

    Описание схемы:

    1. Целевое ЛПУ отправляет запрос метода «Уведомление об изменении статуса записи на медицинскую услугу в рамках медицинского осмотра (UpdateMedicalServiceBooking)» в СЗнП. Состав параметров запроса представлен в Таблице 13.
    2. СЗнП передает ответ метода «Уведомление об изменении статуса записи на медицинскую услугу в рамках медицинского осмотра (UpdateMedicalServiceBooking)» целевому ЛПУ. Состав выходных данных ответа метода представлен в Таблице 14.

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

    Структура запроса UpdateMedicalServiceBooking представлена на Рисунке 22.

    Рисунок 22. Структура запроса метода UpdateMedicalServiceBooking

    В Таблице 13 представлено описание параметров запроса метода UpdateMedicalServiceBooking.

    Таблица 13 – Описание параметров запроса метода
    Контейнер Параметры Обязательность/Кратность Условие Тип Описание
    Root
    / idLpu 1..1 String Идентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы
    / idPat 1..1 String Идентификатор пациента из соответствующего справочника целевой МИС
    / guid 1..1 GUID Авторизационный токен
    /MedicalExamination 1..1 Медицинский осмотр пациента
    /MedicalExamination IdMedicalExamination 1..1 GUID Идентификатор медицинского осмотра из соответствующего справочника целевой МИС
    /MedicalExamination MedicalExaminationType 1..1 String Тип медицинского осмотра (OID 1.2.643.2.69.1.1.1.106) Может принимать следующие значения: «1» – 1 этап диспансеризации. Возможные значения данного элемента будут расширены при развитии услуги «Запись на медицинские осмотры»
    /MedicalExamination ExaminationStatus 1..1 String Статус медицинского осмотра (OID 1.2.643.2.69.1.1.1.107)
    Может принимать следующие значения:
    «1» - Проведен;
    «2» - Недоступен;
    «3» - Доступен для проведения.
    /MedicalExamination ExaminationStatusNotes 0..1 String Примечания к статусу медицинского осмотра
    Может принимать следующее значение:
    «В рамках программы ОМС следующее прохождение Вами медицинского осмотра возможно в XXXX году»
    Где XXXX – числовое значение года.
    Элемент обязателен при значениях элемента «ExaminationStatus»:
    «1» - Проведен;
    «2» - Недоступен.
    /MedicalExamination IsQuestionnaireFilled 0..1 Boolean Признак наличия заполненной анкеты
    Признак наличия в МИС заполненной пациентом анкеты в текущем году (например, по диспансеризации).
    Признак присутствует и заполняется только в случае, если медицинский осмотр
    (услуга диспансеризации) доступен для прохождения в текущем году
    /MedicalExamination/ListMedicalService 1..1 Медицинские услуги в рамках медицинского осмотра
    /MedicalExamination/ListMedicalService/MedicalService 1..1 Медицинская услуга
    /MedicalService IdMedicalService 1..1 GUID Идентификатор медицинской услуги из соответствующего справочника целевой МИС
    /MedicalService MedicalServiceName 1..1 String Наименование медицинской услуги из соответствующего справочника целевой МИС
    /MedicalService MedicalServiceCode 1..1 String Код медицинской услуги в соответствии с классификатором ОКМУ (OID 1.2.643.5.1.13.13.11.1070).
    Пример: B04.047.001
    /MedicalService MedicalServiceConditions 0..1 String Текстовое описание условий оказания медицинской услуги.
    Пример: Кровь для лабораторного исследования рекомендуется сдавать утром, натощак (не менее 8 часов и не более 14 часов голода, питье – вода, в обычном режиме), накануне избегать пищевых перегрузок, приёма алкоголя; не курить минимально в течение 1 часа до исследования.
    /MedicalService MedicalServiceStatus 1..1 String Статус оказания услуги (OID 1.2.643.2.69.1.1.1.109)
    Может принимать следующие значения:
    «1» - Запланирована;
    «2» - Оказана;
    «3» - Доступна;
    «4» - Недоступна.
    /MedicalService MedicalServiceRequired 1..1 Boolean Признак обязательности оказания медицинской услуги в рамках медицинского осмотра. Может принимать следующие значения:
    true – обязательно;
    false – необязательно.
    /MedicalService MedicalServiceUnavailableReason 0..1 String Причина недоступности записи на медицинскую услугу
    Элемент обязателен для услуг со значением поля MedicalServiceStatus = «4» (Недоступна).
    Элемент должен отсутствовать для услуг со значениями поля MedicalServiceStatus = «1», «2» и «3».
    Пример: Услуга недоступна для предварительной записи и оказывается по направлению врача-терапевта
    /MedicalService MedicalServiceComment 0..1 String Комментарий к медицинской услуге
    /MedicalExamination/ListMedicalService/
    MedicalService/MedicalServiceBooking
    1..1 Данные по записи на медицинскую услугу
    /MedicalServiceBooking IdMedicalServiceBooking 1..1 GUID Идентификатор записи на медицинскую услугу
    /MedicalServiceBooking MedicalServiceBookingDateTime 1..1 Datetime Дата и время, на которые записан пациент на оказание медицинской услуги
    /MedicalServiceBooking MedicalServiceBookingStatus 1..1 String Статус записи на медицинскую услугу (OID 1.2.643.2.69.1.1.1.114).
    Может принимать следующие значения:
    «2» - Посещение состоялось (услуга оказана);
    «3» - Запись отменена по инициативе МО;
    «4» - Запись отменена по инициативе пациента;
    «5» - Пациент не явился.
    /MedicalServiceBooking BookingSource 1..1 String Источник оформления записи на медицинскую услугу (OID 1.2.643.2.69.1.1.1.115)
    /MedicalServiceBooking BookingMember 1..1
    0..1
    Для значения "6" об источнике оформления записи
    Для остальных значений об источнике оформления записи
    GUID Участник информационного взаимодействия, осуществивший запись на медицинскую услугу
    /MedicalServiceBooking ChangeBookingSource 1..1 String Источник изменения статуса записи на медицинскую услугу (OID 1.2.643.2.69.1.1.1.115)
    /MedicalServiceBooking ChangeBookingMember 1..1
    0..1
    Для значения "6" об источнике изменения статуса записи
    Для остальных значений об источнике изменения статуса записи
    GUID Участник информационного взаимодействия, изменивший статус записи на медицинскую услугу
    /MedicalServiceBooking IdLpu 1..1 String Идентификатор медицинской организации из справочника «ЛПУ» Интеграционной платформы, в которой производится медицинская услуга
    /MedicalServiceBooking Room 0..1 String Наименование кабинета, в котором оказывается услуга.
    Пример: Кабинет №45
    /MedicalServiceBooking MedicalServiceBoookingComment 0..1 String Комментарий к записи на медицинскую услугу
    /MedicalExamination/ListMedicalService/MedicalService
    /MedicalServiceBooking/ListMedicalResource
    1..1 Данные медицинских ресурсов, оказывающих медицинскую услугу
    /MedicalExamination/ListMedicalService/MedicalService
    /MedicalServiceBooking/ListMedicalResource/MedicalResource
    1..1 Данные медицинского ресурса, оказывающего медицинскую услугу
    /MedicalResource IdMedicalResource 1..1 GUID Идентификатор медицинского ресурса из соответствующего справочника целевой МИС
    /MedicalResource MedicalResourceName 1..1 String Наименование медицинского ресурса из соответствующего справочника целевой МИС
    /MedicalResource MedicalResourceComment 0..1 String Комментарий к медицинскому ресурсу
    /MedicalExamination/ListMedicalService/MedicalService
    /MedicalServiceBooking/ListMedicalResource/MedicalResource/MedicalEmployee
    0..1 Данные медицинского работника, оказывающего медицинскую услугу.
    Элемент обязателен, если медицинский ресурс, оказывающий медицинскую услугу, является медицинским работником
    /MedicalEmployee MedicalEmployeeSnils 1..1 String СНИЛС медицинского работника из соответствующего справочника целевой МИС (формат передачи: «XXXXXXXXXXX»)
    /MedicalEmployee MedicalEmployeePositionCode 1..1 String Код должности медицинского работника в соответствии с классификатором НСИ 1.2.643.5.1.13.13.11.1002 «Должности работников организаций медицинского и фармацевтического профиля».
    Пример: 109
    /MedicalEmployee MedicalEmployeeFedIdSpeciality 1..1 String Идентификатор врачебной специальности медицинского работника в соответствии с номенклатурой специальностей специалистов с высшим и послевузовским медицинским и фармацевтическим образованием в сфере здравоохранения (OID 1.2.643.5.1.13.2.1.1.181)
    /MedicalEmployee MedicalEmployeeIdSpeciality 1..1 String Идентификатор врачебной специальности медицинского работника из соответствующего справочника целевой МИС
    /MedicalEmployee MedicalEmployeeNameSpeciality 1..1 String Наименование врачебной специальности медицинского работника из соответствующего справочника целевой МИС
    /MedicalEmployee MedicalEmployeeComment 0..1 String Комментарий к медицинскому работнику
    /MedicalExamination/ListMedicalService
    /MedicalService/MedicalServiceAvailableResource
    0..0 Данные для осуществления записи на медицинскую услугу. В рамках текущего метода требуется не передавать данный контейнер

    Описание выходных данных

    Структура ответа UpdateMedicalServiceBooking представлена на Рисунке 23.

    Рисунок 23. Структура ответа метода UpdateMedicalServiceBooking

    В Таблице 14 представлено описание выходных данных метода UpdateMedicalServiceBooking.

    Таблица 14 - Описание выходных данных метода UpdateMedicalServiceBooking
    Контейнер Выходные данные Обязательность/Кратность Тип Описание Возможные значения
    /UpdateMedicalServiceBookingResult
    /UpdateMedicalServiceBookingResult Success 1..1 Boolean Результат выполнения запроса True; False
    /UpdateMedicalServiceBookingResult/ErrorList/Error 0..*
    /Error ErrorDescription 0..1 String Текстовое описание ошибки Передача текстового описания ошибки обязательна для ошибки с кодом 99
    /Error IdError 1..1 Int Идентификатор ошибки в справочнике

    Запрос

    Вариант запроса сервиса приведен в разделе "Примеры запросов".

    Ответ

    Вариант ответа сервиса приведен в разделе "Примеры запросов".



    Ниже приведены коды ошибок, возращаемые сервисом, и соответствующее им описание.

    Идентификатор ошибки Текст ошибки
    1 Не был указан/указан неверно guid при вызове метода
    2 Отсутствует доступ или не найдена конечная точка
    3 Время ожидания истекло
    4 Получен не полный набор данных для выполнения метода
    5 На стороне сервиса МИС метод не поддержан
    6 Техническая ошибка на стороне МИС
    7 Техническая ошибка. Медицинская система учреждения не поддержала данную функциональность.
    8 Нет связи с сервисом "Управление очередями"
    9 Не удалось определить ЛПУ для обращения за талонами
    10 Учреждение с данным идентификатором отсутствует в справочнике
    11 Отсутствуют данные целевой МО
    12 Ошибка в сервисе УО
    13 Недействительное значение параметра
    14 Неверный формат входящего параметра
    15 Внутренняя ошибка сервиса
    16 МИС медицинской организации передала некорректные данные
    20 Пациент с заданными параметрами не найден
    21 Данные пациента не являются уникальными
    22 Несоответствие записи акта гражданского состояния
    23 МИС не вернула идентификатор пациента
    30 Запись запрещена
    31 Расхождения в данных прикрепления пациента
    32 Несоответствие сроков действия полиса ОМС
    33 Специальность врача не соответствует профилю пациента
    34 Нарушение порядка и периодичности записи
    35 Пациент имеет предстоящую запись к данному врачу/врачу этой специальности
    36 Пациент не имеет прикрепления к данному учреждению или участку
    37 Указан недопустимый идентификатор пациента
    38 Указан недопустимый идентификатор талона на запись
    39 Талон к врачу занят/заблокирован
    40 Пациент уже имеет запись на это время к другому врачу
    41 Отсутствует информация о врачебных участках по пациенту
    42 Указан некорректный идентификатор медицинского осмотра
    43 Указан некорректный идентификатор медицинской услуги
    44 Указан некорректный идентификатор медицинского ресурса
    45 Не найдено расписание медицинского ресурса
    46 Отмена записи невозможна, медицинская услуга уже оказана
    47 Отмена записи невозможна, медицинская услуга обязательна
    48 Указан некорректный идентификатор сессии
    49 Статус заявки не изменен. Статус заявки может быть изменен согласно правилам статусной модели
    50 Значение PARequestPatientContacts.Phone не может быть пустым
    51 Значение PARequestPatientContacts.Phone имеет неверный формат
    52 Значение PARequestPatientContacts.Email имеет неверный формат
    53 Значение PASource должно соответствовать одному из значений справочника "Источник записи"
    60 Указан недопустимый идентификатор врача
    61 Указаны недопустимые интервалы времени
    62 Дата осуществления записи на прием должна быть меньше или равна дате начала приема (NoticeAppointment)
    63 Дата начала приема должна быть больше или равна дате отправки запроса (Appointment)
    64 Дата и время начала приема должна быть меньше или равна дате и времени окончания приема
    65 Дата осуществления записи на прием должна быть меньше или равна дате отправки запроса (NoticeAppointment)
    66 Дата и время изменения статуса записи на прием должна быть больше или равна дате и времени осуществления записи на прием
    67 Дата и время изменения статуса записи на прием должна быть меньше или равна дате и времени отправки запроса
    70 Указан недопустимый идентификатор специальности
    71 В запросе запрещено одновременное заполнение параметров: идентификатора специальности и федерального идентификатора специальности
    72 Нет доступного врача для вызова врача на дом
    73 Нет доступных слотов для вызова врача на дом
    75 Талон с указанным номером не существует или уже отменен
    76 Направление не найдено по параметрам поиска
    77 Направление найдено, но не прошло проверку на актуальность
    80 Нет прикрепления к ЛПУ
    90 Сведения о записи не найдены
    91 Неизвестный источник записи
    92 Заявка {idPar} не найдена среди активных заявок
    94 Неизвестный статус записи
    99 Текст ответа МИС – в случае необходимости передачи определенной информации клиенту сервиса, инициирующему запрос метода

    Ниже приведены формы и кодировки анкет (во вложении)

    Название документа Форма (файл)
    Форма анкеты для граждан в возрасте до 75 лет на выявление хронических неинфекционных заболеваний, факторов риска их развития, потребления наркотических средств и психотропных веществе без назначения врача Форму документа – см. Форма 1
    Кодировка вопросов анкеты для граждан до 75 лет Форму документа – см. Кодировка 1
    Форма анкеты для граждан в возрасте 75 лет и старше на выявление хронических неинфекционных заболеваний, факторов риска, старческой астении Форму документа – см. Форма 2
    Кодировка вопросов анкеты для граждан 75 лет и старше Форму документа – см. Кодировка 2

    © Нетрика 2019