Сервис "Запись на прием к врачу"

Настоящее описание раскрывает механизмы информационного взаимодействия между информационными системами в рамках оказания услуги «Прием заявок (запись) на прием к врачу" в электронном виде.

Описание решения

Общие положения

Сервис предназначен для предоставления электронной услуги «Запись на прием» и передачи данных в Федеральную электронную регистратуру, посредством информационного взаимодействия информационных систем через API Интеграционной платформы N3.Здравоохранение.

Клиентами Интеграционной платформы могут быть следующие информационные системы:

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


Сервисы Интеграционной платформы обеспечивают следующие возможности:

  1. Обмен данными о пациентах.
  2. Передачу данных о сотрудниках медицинских учреждений.
  3. Обмен данными о медицинских учреждениях и их ресурсах.
  4. Получение расписания работы специалистов медицинских учреждений, предварительной записи и отмены записи.
  5. Передачу информации о посещениях в медицинских учреждениях (реализуется со стороны МИС).
  6. Передачу информации в ФЭР федеральной ЕГИСЗ о расписании врачей и оказанных услугах.


В рамках оказания Услуги информационные системы взаимодействуют с Интеграционной платформой через стандартизированные интерфейсы для взаимодействия, реализованные в виде Web-сервисов, основанных на протоколе SOAP 1.1 и 1.2.

Краткое описание протокола взаимодействия приведено в разделе "Описание протокола взаимодействия и методов".

Описание методов, используемых в типовых решениях, приведено в разделе Описание протокола взаимодействия и методов.

ФЭР (в разделе Описание протокола взаимодействия и методов)

Для того, чтобы данные передавались в федеральную ЕГИСЗ необходимо выполнить следующие условия:

  1. Реализовать методы согласно API. Для работы МИС с модулем ФЭР требуются методы: CheckPatient, GetPositionList, GetDoctorList2, GetAvaibleAppointments, SetAppointment, CreateClaimForRefusal, SendNotificationAboutAppointment, SendNotificationAboutAppointmentStatus.
  2. ЛПУ должно быть внесено в единый регистр медицинских организаций;
  3. Врачи ЛПУ должны быть внесены в единый регистр медицинских работников).

Типовое решение для ЦТО

Отличия функциональности Типового решения для записи на прием через ЦТО от Типового решения для записи через Портал, Инфоматы и Мобильные приложения заключается в следующем:

  1. Используется нестрогая идентификация пациентов (для оператора предоставляется список пациентов, которые попадают под критерии поиска). Соответственно, для идентификации пациента используется другой метод – SearchTop10patient;
  2. В случае отсутствия пациента в базе данных целевой МИС при осуществлении записи на прием используется метод добавления пациента в МИС – AddNewPatient;
  3. Содержится возможность обновления номера телефона пациента (как мобильного, так и домашнего) – метод UpdatePhoneByIdPat;
  4. Присутствует возможность просмотра расписания врачей без оформления записи на прием, достигающаяся в Типовом решении для Порталов, Инфоматов и Мобильных приложений методом GetWorkingTime.


Аналогично Типовому решению для записи через Портал, Инфоматы и Мобильные приложения, целевым ЛПУ при получении запросов рекомендуется использовать метод «Определение пользователя по его GUID (GetHubUserByGuid)» для определения запрашивающей системы и получения сведений о ней (описание пользователя и его роль). С учетом полученных сведений целевая ЛПУ может управлять передаваемым результирующим списком, предоставляя запрашивающей системе только доступные для нее ресурсы (специальности, врачи, талоны и т.д.).

Схема Типового решения для ЦТО приведена на Рисунке 2.

Алгоритм тестирования системы передачи данных от ЛПУ

SoapUI это кроссплатформенное клиентское оконное приложение, написанное на языке Java. Использовать основной функционал приложения можно бесплатно. В платной версии программы, которая называется SoapUI Pro, вы сможете делать чуть больше, например, устанавливать плагины с помощью менеджера плагинов, проводить тесты драйверов данных, перехватывать трафик, оценивать покрытие ваших веб-сервисов тестами и создавать отчёты. Официальная страничка проекта находится по адресу https://www.soapui.org/, скачать дистрибутив бесплатной версии программы можно по адресу https://sourceforge.net/projects/soapui/files/. Если бесплатной версии вам не хватает, вы можете скачать пробную версию SoapUI Pro здесь https://www.soapui.org/downloads/download-soapui-pro-trial.html. Установка на компьютер под управлением Windows проходит быстро и обычно не вызывает вопросов.

Руководство по тестированию МИС для сервисов записи пациента и автоматизированного рабочего места оператора центра телефонного обслуживания

Для того, чтобы скачать тестовый файл необходимо кликнуть левой клавишей мыши на ссылку "Файл для проведения тестирования"

Файл для проведения тестирования

Инструкция по подключению ВОЗ

SoapUI это кроссплатформенное клиентское оконное приложение, написанное на языке Java. Использовать основной функционал приложения можно бесплатно. В платной версии программы, которая называется SoapUI Pro, вы сможете делать чуть больше, например, устанавливать плагины с помощью менеджера плагинов, проводить тесты драйверов данных, перехватывать трафик, оценивать покрытие ваших веб-сервисов тестами и создавать отчёты. Официальная страничка проекта находится по адресу https://www.soapui.org/, скачать дистрибутив бесплатной версии программы можно по адресу https://sourceforge.net/projects/soapui/files/. Если бесплатной версии вам не хватает, вы можете скачать пробную версию SoapUI Pro здесь https://www.soapui.org/downloads/download-soapui-pro-trial.html. Установка на компьютер под управлением Windows проходит быстро и обычно не вызывает вопросов.

Руководство по тестированию МИС для сервисов записи пациента и автоматизированного рабочего места оператора центра телефонного обслуживания

Для того, чтобы скачать тестовый файл необходимо кликнуть левой клавишей мыши на ссылку "Файл для проведения тестирования"

Файл для проведения тестирования

Описание протокола взаимодействия и методов

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

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

Сервис «Запись на прием» содержит следующие методы:
  1. Выбор района (GetDistrictList).
  2. Выбор ЛПУ (GetLPUList).
  3. Идентификация пациента (CheckPatient).
  4. Выбор специальности (GetSpesialityList).
  5. Выбор врача (GetDoctorList).
  6. Выбор даты приема (GetAvailableDates).
  7. Выбор времени приема (GetAvaibleAppointments).
  8. Подтверждение записи (SetAppointment).
  9. Поиск пациента (SearchTop10patient).
  10. Добавление пациента в стороннюю МИС (AddNewPatient).
  11. Уточнение телефона пациента (UpdatePhoneByIdPat).
  12. Просмотр предстоящих записей пациента (GetPatientHistory).
  13. Подача заявки на отмену записи (CreateClaimForRefusal).
  14. Просмотр расписаний (без записи) (GetWorkingTime).
  15. Получение списка врачей, сгруппированных по специальности (GetDocListFullTree).
  16. Определение пользователя по его GUID (GetHubUserByGuid).
  17. Уведомление о записи на прием (SendNotificationAboutAppointment).
  18. Уведомление о изменении статуса записи на прием (SendNotificationAboutAppointmentStatus).
  19. Получение доступных врачей для записи пациента на прием (GetAvailableDoctors).
  20. Получение списка должностей (GetPositionList).
  21. Получение списка врачей по должности (GetDoctorList2).
  22. Получение списка услуг (GetServiceList).


В методах GetSpesialityList, GetDoctorList, GetAvailableDates и GetAvailableAppointments в рамках параметра IdPat возможно использование служебного идентификатора ( -2147483647 ) для получения неотфильтрованных наборов данных (для определенных сценариев, таких как "получение справочной информации" или "синхронизация данных с ФЭР"). Значение этого параметра в указанных методах можно игнорировать, если МИС не ограничивает доступ к возвращаемым методами данным, например, в зависимости от прикрепления пациента к определенному врачебному участку и т.п.. Если МИС при прочих равных для разных пациентов может возвращать различные ответы в указанных методах - значение параметра необходимо обрабатывать, как "снятие фильтра по пациенту".

Обязательность параметров, используемых в запросах, указана в соответствующих таблицах. При этом используются следующие обозначения:

Параметр «Кратность» означает количество возможных значений реквизита:0..1 - параметр необязательный, максимальное количество экземпляров один;
0..* – параметр необязательный, максимальное количество экземпляров не ограничено;
1..1 – параметр обязательный, экземпляр один;
1..2 – параметр обязательный, экземпляр один или два;
1..* – параметр обязательный, максимальное количество экземпляров не ограничено




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

Пример времени по Москве: 2021-01-18T12:20:12.2508719+03:00

Выбор района (GetDistrictList)

Данный метод используется для получения значений справочника «Районы» Интеграционной платформы.

Метод должен поддерживаться МИС в рамках типового решения «Запись на прием из одной МИС в другую».

Описание параметров запроса Структура запроса GetDistrictList представлена на Рисунке 10.
В Таблице 3 представлено описание параметров запроса метода GetDistrictList.
Описание выходных данных
Структура ответа GetDistrictList представлена на Рисунке 11.
В Таблице 4 представлено описание выходных данных метода GetDistrictList.
Запрос
Вариант запроса сервиса приведен в разделе "Примеры запросов".

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

Выбор ЛПУ (GetLPUList)

Данный метод используется для получения списка ЛПУ в районе, указанном в запросе. В запросе необходимо указать идентификатор района из справочника «Районы». Если идентификатор района не указан, то метод в выходных данных вернет полный список ЛПУ.

Метод должен поддерживаться МИС в рамках типового решения «Запись на прием из одной МИС в другую».

Описание параметров
Структура запроса GetLPUList представлена на Рисунке 12.
В Таблице 5 представлено описание параметров запроса метода GetLPUList.
Описание выходных данных
Структура ответа GetLPUList представлена на Рисунке 13.
В Таблице 6 представлено описание выходных данных метода GetLPUList.
Запрос
Вариант запроса сервиса приведен в разделе "Примеры запросов".
Ответ
Вариант ответа сервиса приведен в разделе "Примеры запросов".

Идентификация пациента (CheckPatient)

Данный метод используется для идентификации пациента в МИС ЛПУ.

Результаты выполнения запроса:

  • Если пациентов с заданными параметрами не найдено, то возвращается ошибка;
  • Если найдено более 1 пациента, то необходимо уточнить параметры запроса (например, если в запросе не было указано отчество пациента, то необходимо указать его);
  • Если найден 1 пациент, то метод возвращает идентификатор этого пациента из справочника МИС.


Идентификация пациента может производиться по следующим наборам параметров:

  • Фамилия, Имя, Дата рождения;
  • СНИЛС пациента, Дата рождения;
  • Номер полиса пациента, Дата рождения;
  • Номер полиса пациента;
  • Идентификатор пациента.


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

Структура запроса CheckPatient представлена на Рисунке 14.
В Таблице 7 представлено описание параметров запроса метода CheckPatient.
Описание выходных данных

Структура ответа CheckPatient представлена на Рисунке 15.
В Таблице 8 представлено описание выходных данных метода CheckPatient.
Запрос
Вариант запроса сервиса приведен в разделе "Примеры запросов".

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

Выбор специальности (GetSpesialityList)

Данный метод используется для получения списка врачебных специальностей в ЛПУ, запись к врачам которых доступна для пациента, идентификатор которого вводится в запрос метода. Список специальностей, к врачам которой для пациента доступна запись, определяется на стороне МИС ЛПУ.

Параметры CountFreeTicket и CountFreeParticipantIE ответа метода обнуляемые. При этом NULL означает отсутствие приема у врача (отпуск, больничный и т.д.). В противном случае, при отсутствии доступных талончиков, соответствующих параметру, должен передаваться "0".

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

Структура запроса GetSpesialityList представлена на Рисунке 16.
В Таблице 9 представлено описание параметров запроса метода GetSpesialityList.
Описание выходных данных

Структура ответа GetSpesialityList представлена на Рисунке 17.
В Таблице 10 представлено описание выходных данных метода GetSpesialityList.
Запрос
Вариант запроса сервиса приведен в разделе "Примеры запросов".

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

Выбор врача (GetDoctorList)

Данный метод используется для получения списка врачей указанной специальности, запись к которым доступна для пациента, идентификатор которого вводится в запрос метода. Список врачей, запись к которым доступна для пациента, определяется на стороне МИС ЛПУ.

Параметры CountFreeTicket и CountFreeParticipantIE ответа метода обнуляемые. При этом NULL означает отсутствие приема у врача (отпуск, больничный и т.д.). В противном случае, при отсутствии доступных талончиков, соответствующих параметру, должен передаваться "0".

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

Структура запроса GetDoctorList представлена на Рисунке 18.
В Таблице 11 представлено описание параметров запроса метода GetDoctorList.
Описание выходных данных

Структура ответа GetDoctorList представлена на Рисунке 19.
В Таблице 12 представлено описание выходных данных метода GetDoctorList.
Запрос
Вариант запроса сервиса приведен в разделе "Примеры запросов".

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

Выбор даты (GetAvailableDates)

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

Описание параметров
Структура запроса GetAvailableDates представлена на Рисунке 20.
В Таблице 13 представлено описание параметров запроса метода GetAvailableDates.
Описание выходных данных
Структура ответа GetAvailableDates представлена на Рисунке 21.
В Таблице 14 представлено описание выходных данных метода GetAvailableDates.
Запрос
Вариант запроса сервиса приведен в разделе "Примеры запросов".

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

Выбор времени приема (GetAvaibleAppointments)

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

Описание параметров
Структура запроса GetAvaibleAppointments представлена на Рисунке 22.
В Таблице 15 представлено описание параметров запроса метода GetAvaibleAppointments.
Описание выходных данных
Структура ответа GetAvaibleAppointments представлена на Рисунке 23.
В Таблице 16 представлено описание выходных данных запроса метода GetAvaibleAppointments.
Запрос
Вариант запроса сервиса приведен в разделе "Примеры запросов".

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

Подтверждение записи (SetAppointment)

Данный метод используется для записи пациента на прием в выбранный пациентом временной интервал рабочего времени врача.

Если в запросе метода заполнен параметр idAppointmentPrev, то осуществляется перенос даты и времени приема по ранее оформленной записи.

В случае, если запись осуществляется по направлению (заполнен параметр doctorsReferal), в запросе к целевой ЛПУ дополнительно передаются данные по направлению, полученные в сервисе УО.

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

  1. Клиент СЗнП отправляет запрос метода «Подтверждение записи (SetAppointment)» в СЗнП. Состав параметров запроса представлен в Таблице 17.
  2. СЗнП отправляет запрос метода SearchOne в сервис УО для получения данных о направлении.
  3. УО передает ответ метода SearchOne в СЗнП с данными о направлении.
  4. В случае, если направление имеет статус 1, 2, 3, 4, 5 или 6 (по данным из шага 3), СЗнП отправляет запрос метода «Подтверждение записи (SetAppointment)» в целевое ЛПУ, определенное на шаге 3, с указанием данных о направлении, полученных в УО. Состав параметров запроса представлен в Таблице 17.
  5. Целевое ЛПУ передает ответ метода «Подтверждение записи (SetAppointment)» в СЗнП. Состав выходных данных ответа метода представлен в Таблица 18.
  6. СЗнП передает ответ метода «Подтверждение записи (SetAppointment)» клиенту СЗнП. Состав выходных данных ответа метода представлен в Таблица 18.
Описание параметров
Структура запроса SetAppointment представлена Рисунке 25
В Таблице 17 представлено описание параметров запроса метода SetAppointment.
Описание выходных данных
Структура ответа SetAppointment представлена на Рисунке 26.
В Таблице 18 представлено описание выходных данных запроса метода SetAppointment.
Запрос
Вариант запроса сервиса приведен в разделе "Примеры запросов".

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

Поиск пациента (SearchTop10patient)

Данный метод используется для поиска первых 10-ти пациентов, подходящих по введенным параметрам поиска.

Описание параметров
Структура запроса SearchTop10Patient представлена на Рисунке 27.
В Таблице 19 представлено описание параметров запроса метода SearchTop10Patient.
Описание выходных данных
Структура ответа SearchTop10Patient представлена на Рисунке 28.
В Таблице 20 представлено описание выходных данных метода SearchTop10Patient.
Запрос
Вариант запроса сервиса приведен в разделе "Примеры запросов".

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

Добавление пациента в стороннюю МИС (AddNewPatient)

Данный метод используется для добавления пациента в стороннюю МИС (в случае, если пациент отсутствует в базе данных МИС) при осуществлении записи на прием к врачу.

В случае, если переданный пациент уже имеется в базе данных МИС, в ответе метода необходимо передавать идентификатор пациента в МИС ЛПУ.

Описание параметров
Структура запроса AddNewPatient представлена на Рисунке 29.
В Таблице 21 представлено описание параметров запроса метода AddNewPatient.
В Таблице 26 представлено описание выходных данных метода GetPatientHistory.
Описание выходных данных
Структура ответа AddNewPatient представлена на Рисунке 30.
В Таблице 22 представлено описание выходных данных метода AddNewPatient.
Запрос
Вариант запроса сервиса приведен в разделе "Примеры запросов".

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

Передача в МИС номера телефона пациента (UpdatePhoneByIdPat)

Данный метод используется для обновления номера телефона пациента на основании его идентификатора. Этот метод использует ЦТО, когда операторы обновляют телефонный номер (домашний или мобильный) пациента в базе на основе того, с которого пациент позвонил (предварительно спросив его, со своего ли номера звонит пациент).

Описание параметров
Структура запроса UpdatePhoneByIdPat представлена Рисунке 31.
В Таблице 23 представлено описание параметров запроса метода UpdatePhoneByIdPat.
Описание выходных данных
Структура ответа UpdatePhoneByIdPat представлена на Рисунке 32.
В Таблице 24 представлено описание выходных данных метода UpdatePhoneByIdPat.
Запрос
Вариант запроса сервиса приведен в разделе "Примеры запросов".

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

Просмотр предстоящих записей пациента (GetPatientHistory)

Данный метод используется для получения списка записей пациента на прием и отказов от записи на прием в указанном в запросе ЛПУ, даты по которым еще не наступили.

Описание параметров
Структура запроса GetPatientHistory представлена Рисунке 33.
В Таблице 25 представлено описание параметров запроса метода GetPatientHistory.
Описание выходных данных
Структура ответа GetPatientHistory представлена на Рисунке 34.
В Таблице 26 представлено описание выходных данных метода GetPatientHistory.
Запрос
Вариант запроса сервиса приведен в разделе "Примеры запросов".

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

Подача заявки на отмену записи (CreateClaimForRefusal)

Данный метод позволяет создавать заявки на отмену записи на прием. Используется в типовом решении для записи на прием через ЦТО.

Описание параметров
Структура запроса CreateClaimForRefusal представлена на Рисунке 35.
В Таблице 27 представлено описание параметров запроса метода CreateClaimForRefusal.
Описание выходных данных
Структура ответа CreateClaimForRefusal представлена на Рисунке 36.
В Таблице 28 представлено описание выходных данных метода CreateClaimForRefusal.
Запрос
Вариант запроса сервиса приведен в разделе "Примеры запросов".

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

Просмотр расписаний (без записи) (GetWorkingTime)

Данный метод используется для получения информации о времени работы врача (возвращает часы приема врача), идентификатор которого указан в запросе.

Описание параметров
Структура запроса GetWorkingTime представлена на Рисунке 37.
В Таблице 29 представлено описание параметров запроса метода GetWorkingTime.
Описание выходных данных
Структура ответа GetWorkingTime представлена на Рисунке 38.
В Таблице 30 представлено описание выходных данных метода GetWorkingTime.
Запрос
Вариант запроса сервиса приведен в разделе "Примеры запросов".

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

Получение списка врачей, сгруппированных по специальности (GetDocListFullTree)

Данный метод используется для получения списков врачей по каждой специальности запрашиваемого ЛПУ и возвращает двухуровневый объект. Первый уровень – список врачебных специальностей ЛПУ, второй уровень – список врачей по каждой специальности ЛПУ.

Описание параметров
Структура запроса GetDocListFullTree представлена Рисунке 42.
В Таблице 33 представлено описание параметров запроса метода GetDocListFullTree.
Описание выходных данных
Структура ответа GetDocListFullTree представлена на Рисунке 41.
В Таблице 34 представлено описание выходных данных метода GetDocListFullTree.
Запрос
Вариант запроса сервиса приведен в разделе "Примеры запросов".

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

Определение пользователя по его GUID (GetHubUserByGuid)

Данный метод используется для получения информации о пользователе по его GUID. Если в запросе GUID пользователя не указан, то выводится весь список пользователей.

Описание
параметров Структура запроса GetHubUserByGuid представлена на Рисунке 44.
В Таблице 35 представлено описание параметров запроса метода GetHubUserByGuid.
Описание выходных данных
Структура ответа GetHubUserByGuid представлена на Рисунке 45.
В Таблице 36 представлено описание выходных данных метода GetHubUserByGuid.
Запрос
Вариант запроса сервиса приведен в разделе "Примеры запросов".

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

Уведомление о записи на прием (SendNotificationAboutAppointment)

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

Предполагаются 2 сценария использования метода:

  1. Передача уведомлений «онлайн» (единовременно по наступлении события) о произведенной записи на прием. В этом случае данные передаются в контейнере Appointment.
  2. Передача уведомлений о произведенных записях на прием «постфактум». Данные передаются в контейнере NoticeAppointment

Описание параметров
Структура запроса SendNotificationAboutAppointment представлена на Рисунке 46.
В Таблице 37 представлено описание параметров запроса метода SendNotificationAboutAppointment.
Описание выходных данных
Структура ответа SendNotificationAboutAppointment представлена на Рисунке 47.
В Таблице 38 представлено описание выходных данных метода SendNotificationAboutAppointment.
Запрос
Вариант запроса сервиса приведен в разделе "Примеры запросов".

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

Уведомление об изменении статуса записи на прием (SendNotificationAboutAppointmentStatus)

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

Предполагается следующий сценарий использования метода:

  1. МИС передает сведения в Интеграционную платформу, обо всех записях на прием, путем вызова метода SendNotificationAboutAppointment для каждой записи.
  2. Интеграционная платформа присваивает идентификатор уведомлению и возвращает его в ответе метода SendNotificationAboutAppointment.
  3. МИС сохраняет полученный идентификатор уведомления для последующего использования.
  4. После изменения статуса для записи на прием, МИС передает сведения о статусе записи, по уже известному идентификатору уведомления, путем вызова метода SendNotificationAboutAppoinmentStatus для каждой записи.
  5. В случае, если у МИС нет возможности сохранения идентификатора уведомления, после изменения статуса для записи на прием МИС передает сведения о статусе записи путем вызова метода SendNotificationAboutAppoinmentStatus для каждой записи с указанием параметров idLpu, idPat, idAppointment и doctorsReferral (игнорируя idNotification).
  6. Вариант с передачей в запросе параметра idNotification (идентификатор уведомления) является предпочтительным.


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

Структура запроса SendNotificationAboutAppointmentStatus представлена на Рисунке 48.
В Таблице 39 представлено описание параметров запроса метода SendNotificationAboutAppointmentStatus.
Описание выходных данных
Структура ответа SendNotificationAboutAppointmentStatus представлена на Рисунке 49.
В Таблице 40 представлено описание выходных данных метода SendNotificationAboutAppointmentStatus.
Запрос
Вариант запроса сервиса приведен в разделе "Примеры запросов".

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

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

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

Описание параметров
Структура запроса GetAvailableDoctors представлена на Рисунке 57.
В Таблице 46 представлено описание параметров запроса метода GetAvailableDoctors.
Описание выходных данных
Структура ответа GetAvailableDoctors представлена на Рисунке 58.
В Таблице 47 представлено описание выходных данных метода GetAvailableDoctors.
Запрос
Вариант запроса сервиса приведен в разделе "Примеры запросов".

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

Получение списка должностей (GetPositionList)

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

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

Структура запроса GetPositionList представлена на Рисунке 75
В Таблице 61 представлено описание параметров запроса метода GetPositionList.
Описание выходных данных
Структура ответа GetPositionList представлена на Рисунке 76.
В Таблице 62 представлено описание выходных данных метода GetPositionList.
Запрос
Вариант запроса сервиса приведен в разделе "Примеры запросов".

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

Получение списка врачей по должности (GetDoctorList2)

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

Описание параметров
Структура запроса GetDoctorList2 представлена на Рисунке 78
В Таблице 63 представлено описание параметров запроса метода GetDoctorList2.
Описание выходных данных
Структура ответа GetDoctorList2 представлена на Рисунке 79.
В Таблице 64 представлено описание выходных данных метода GetDoctorList2.
Запрос
Вариант запроса сервиса приведен в разделе "Примеры запросов".

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

Получение списка услуг по врачу (GetServiceList)

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

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

Структура запроса GetServiceList представлена на Рисунке 80.
В Таблице 65 представлено описание параметров запроса метода GetServiceList.
Описание выходных данных
Структура ответа GetServiceList представлена на Рисунке 81.
В Таблице 66 представлено описание выходных данных метода GetServiceList.
Запрос
Вариант запроса сервиса приведен в разделе "Примеры запросов".

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

Коды ошибок

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

Тип направления

Тип ЛПУ

Тип специалиста (врача)

Роль пользователя

Источники записи

Статус записи на прием