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

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

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

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

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

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

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

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

Для взаимодействия информационных систем в зависимости от их вида предусмотрены различные типовые решения:

  • решение для записи по направлению.
  • решение для работы с Журналом отложеной записи (ЖОЗ).
  • Описание методов, используемых в типовых решениях, приведено в разделе Описание протокола взаимодействия и методов.

    Типовое решение для Портала, Инфоматов и Мобильных приложений

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

    На диаграмме представлены функции (выделены зеленым), результат выполнения функций (выделены красным) и методы, которые реализуют соответствующие функции (указаны как комментарии к функциям). Например, метод, реализующий функцию «Валидация кода направления», называется InspectDoctorsReferal. Результатами выполнения этой функции могут быть следующие ответы:

    1. Код направления недействителен;
    2. Проверяемое направление является направлением на повторный прием;
    3. Проверяемое направление является направлением на консультацию.

    Рисунок 1. Схема Типового решения для Портала, Инфомата и Мобильного приложения

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

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

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

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

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

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

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

    Рисунок 2. Схема Типового процесса записи через ЦТО

    Типовое решение для записи по направлению

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

    Примечание: для получения данных по направлению или для дополнительной проверки статуса направления целевое ЛПУ может использовать метод СЗнП «Получение данных о направлении (CheckRefferal)». В случае, если МИС целевого ЛПУ поддержала сервис «Управление очередями на оказание медицинской помощи», вместо метода СЗнП «Получение данных о направлении (CheckRefferal)» ЛПУ может использовать метод УО «Поиск направления (SeachOne)».

    Сценарий «Запись по направлению в УО»

    1. Клиент СЗнП отправляет запрос метода «Валидация кода направления 2 (InspectDoctorsReferral2)» в СЗнП.
    2. СЗнП отправляет запрос метода SearchOne в сервис УО для получения данных о направлении, проверки статуса направления и определения целевого ЛПУ.
    3. УО передает ответ метода SearchOne в СЗнП с данными о направлении.
    4. В случае, если направление имеет статус 1, 2, 3, 4, 5 или 6 (по данным из шага 3), СЗнП отправляет запрос метода «Валидация кода направления 2 (InspectDoctorsReferral2)» в целевое ЛПУ, определенное на шаге 3, с указанием данных о направлении, полученных в УО.
    5. Целевое ЛПУ передает ответ метода «Валидация кода направления 2 (InspectDoctorsReferral2)» в СЗнП.
    6. СЗнП передает ответ метода «Валидация кода направления 2 (InspectDoctorsReferral2)» клиенту СЗнП.
    7. Клиент СЗнП отправляет запрос метода «Подтверждение записи (SetAppointment)» в СЗнП.
    8. СЗнП отправляет запрос метода SearchOne в сервис УО для получения данных о направлении, проверки статуса направления и определения целевого ЛПУ.
    9. УО передает ответ метода SearchOne в СЗнП с данными о направлении.
    10. В случае, если направление имеет статус 1, 2, 3, 4, 5 или 6 (по данным из шага 9), СЗнП отправляет запрос метода «Подтверждение записи (SetAppointment)» в целевое ЛПУ, определенное на шаге 9, с указанием данных о направлении, полученных в УО.
    11. Целевое ЛПУ передает ответ метода «Подтверждение записи (SetAppointment)» в СЗнП.
    12. СЗнП передает ответ метода «Подтверждение записи (SetAppointment)» клиенту СЗнП.
    13. СЗнП отправляет запрос метода AppointmentNotification в сервис УО для передачи в УО сведений о совершенной записи по направлению.
    14. УО передает ответ метода AppointmentNotification в СЗнП.

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

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

    Сценарий «Запрос актуальности записи»

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

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

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

    Сценарий «Отмена записи»

    1. Клиент СЗнП отправляет запрос метода «Подача заявки на отмену записи (CreateClaimForRefusal)» в СЗнП.
    2. СЗнП отправляет запрос метода «Подача заявки на отмену записи (CreateClaimForRefusal)» в целевое ЛПУ.
    3. Целевое ЛПУ передает ответ метода «Подача заявки на отмену записи (CreateClaimForRefusal)» в СЗнП.
    4. СЗнП передает ответ метода «Подача заявки на отмену записи (CreateClaimForRefusal)» клиенту СЗнП.

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

    Рисунок 5. Схема информационного взаимодействия в рамках сценария «Отмена записи»

    Типовое решение для работы с Журналом отложенной записи (ЖОЗ)

    Данное типовое решение предоставляет возможность регистрации заявки ЖОЗ, обработки ЖОЗ и записи на прием по заявке ЖОЗ

    Схема регистрации заявки ЖОЗ приведена на Рисунке 6.

    Рисунок 6. Схема процесса "Регистрация заявки ЖОЗ"

    Схема процесса обработки ЖОЗ приведена на Рисунке 7.

    Рисунок 7. Схема процесса "Обработка ЖОЗ"

    Схема процесса записи на прием по заявке ЖОЗ приведена на Рисунке 8.

    Рисунок 8. Схема процесса "Запись на прием по заявке ЖОЗ"

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

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

    Сервис «Запись на прием» содержит следующие методы:

    1. Валидация кода направления (InspectDoctorsReferal).
    2. Выбор района (GetDistrictList).
    3. Выбор ЛПУ (GetLPUList).
    4. Идентификация пациента (CheckPatient).
    5. Выбор специальности (GetSpesialityList).
    6. Выбор врача (GetDoctorList).
    7. Выбор даты приема (GetAvailableDates).
    8. Выбор времени приема (GetAvaibleAppointments).
    9. Подтверждение записи (SetAppointment).
    10. Поиск пациента (SearchTop10patient).
    11. Добавление пациента в стороннюю МИС (AddNewPatient).
    12. Уточнение телефона пациента (UpdatePhoneByIdPat).
    13. Просмотр предстоящих записей пациента (GetPatientHistory).
    14. Подача заявки на отмену записи (CreateClaimForRefusal).
    15. Просмотр расписаний (без записи) (GetWorkingTime).
    16. Постановка в лист ожидания (SetWaitingList).
    17. Получение списка врачей, сгруппированных по специальности (GetDocListFullTree).
    18. Определение пользователя по его GUID (GetHubUserByGuid).
    19. Уведомление о записи на прием (SendNotificationAboutAppointment).
    20. Уведомление о изменении статуса записи на прием (SendNotificationAboutAppointmentStatus).
    21. Получение врачебных участков по пациенту (GetPatientsAreas).
    22. Валидация кода направления 2 (InspectDoctorsReferral2).
    23. Получение данных о направлении (CheckRefferal).
    24. Получение доступных врачей для записи пациента на прием (GetAvailableDoctors).
    25. Запрос талонов по заявке ЖОЗ (GetAvailableAppointmentsByPARequest).
    26. Подтверждение записи по заявке ЖОЗ (SetAppointmentByPARequest).
    27. Регистрация заявки ЖОЗ (RegisterPARequest).
    28. Отмена заявки ЖОЗ (CancelPARequest).
    29. Поиск активных заявок ЖОЗ (SearchActivePARequest).
    30. Поиск заявок ЖОЗ пациента (SearchPARequests).
    31. Поиск заявок ЖОЗ пациента для АРМ ЦТО (SearchCtoPARequests).
    32. Получение списка должностей (GetPositionList).
    33. Получение списка врачей по должности (GetDoctorList2).
    34. Получение справочной информации по количеству доступных талонов для записи пациента по направлению (GetAvailableAppointmentsInfo).

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

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

    Валидация кода направления (InspectDoctorsReferal)

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

    Результатами выполнения данного метода могут быть следующие ответы:

    1. Код направления недействителен;
    2. Проверяемое направление является направлением на повторный прием;
    3. Проверяемое направление является направлением на консультацию.

    В случае, если код направления является кодом на консультацию, далее с помощью нижеописанных методов осуществляется выбор района (GetDistrictList), выбор ЛПУ (GetLPUList), проводится идентификация пациента (CheckPatient или SearchTop10Patient), после чего осуществляется выбор врача (GetDoctorList или GetDocListFullTree). В случае, если код направления является кодом на повторный прием, осуществляется проверка направления, в результате которой Район, ЛПУ и врач будут выбраны автоматически.

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

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

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

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

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

    Таблица 1 – Описание параметров запроса метода InspectDoctorsReferal
    Контейнер Параметры Обязательность Тип Описание
    Root      
    / doctorsReferal 1..1 String Номер направления
    / guid 1..1 GUID Авторизационный токен
    / idHistory 0..1 Int Идентификатор сессии (транзакции)

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

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

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

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

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

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

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

    Таблица 2 - Описание выходных данных метода InspectDoctorsReferal
    Контейнер Параметры Тип Описание Возможные значения
    /InspectDoctorsReferalResult      
    /InspectDoctorsReferalResult IdHistory Int Идентификатор сессии (транзакции)  
    /InspectDoctorsReferalResult Success Boolean Результат выполнения запроса True; False
    /InspectDoctorsReferalResult IdDoc String Идентификатор врача, к которому осуществляется запись Значение идентификатора врача из соответствующего справочника целевой МИС
    /InspectDoctorsReferalResult IdLpu Int Идентификатор ЛПУ Значение идентификатора из справочника «ЛПУ» Интеграционной платформы
    /InspectDoctorsReferalResult Id_Patient String Идентификатор пациента, получившего направление Значение идентификатора пациента из соответствующего справочника целевой МИС
    /InspectDoctorsReferalResult Type String Тип направления Значения типа направления см. Приложение 2
    /InspectDoctorsReferalResult/ErrorList/Error      
    /Error ErrorDescription String Текстовое описание ошибки Коды ошибок
    /Error IdError Int Идентификатор ошибки в справочнике Коды ошибок

    Запрос

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

    Ответ

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

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

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

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

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

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

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

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

    Таблица 3 - Описание параметров запроса метода GetDistrictList.
    Контейнер Параметры Обязательность Тип Описание
    Root      
    / guid 1..1 GUID Авторизационный токен
    / idHistory 0..1 Int Идентификатор сессии (транзакции)

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

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

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

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

    Таблица 4 - Описание выходных данных метода GetDistrictList
    Контейнер Параметры Тип Описание Возможные значения
    /GetDistrictListResult/District      
    /District DistrictName String Наименование района Значение наименования района из справочника «Районы» Интеграционной платформы
    /District IdDistrict Int Идентификатор района Значение идентификатора из справочника «Районы» Интеграционной платформы
    /District Okato Int Код ОКАТО района Значение кода ОКАТО района из справочника «Районы» Интеграционной платформы

    Запрос

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

    Ответ

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

    Выбор ЛПУ (GetLPUList)

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

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

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

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

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

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

    Таблица 5 - Описание параметров запроса метода GetLPUList.
    Контейнер Параметры Обязательность Тип Описание
    Root      
    / IdDistrict 0..1 Int Идентификатор района из справочника «Районы» Интеграционной платформы
    / guid 1..1 GUID Авторизационный токен
    / idHistory 0..1 Int Идентификатор сессии (транзакции)

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

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

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

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

    Таблица 6 - Описание выходных данных метода GetLPUList.
    Контейнер Параметры Тип Описание Возможные значения
    /GetLPUListResult      
    /GetLPUListResult IdHistory Int Идентификатор сессии (транзакции)  
    /GetLPUListResult Success Boolean Результат выполнения запроса True; False
    /GetLPUListResult/ErrorList/Error      
    /Error ErrorDescription String Текстовое описание ошибки Коды ошибок
    /Error IdError Int Идентификатор ошибки в справочнике Коды ошибок
    /GetLPUListResult/ListLPU/Clinic      
    /Clinic Description String Описание  
    /Clinic District Int Идентификатор района Значение идентификатора из справочника «Районы» Интеграционной платформы
    /Clinic IdLPU Int Идентификатор ЛПУ в справочнике Значение идентификатора ЛПУ в справочнике «ЛПУ» Интеграционной платформы
    /Clinic LPUFullName String Юридическое наименование ЛПУ  
    /Clinic LPUShortName String Аббревиатура (краткое наименование ЛПУ)  
    /Clinic LPUType Int Тип ЛПУ Значение идентификатора из справочника "Тип ЛПУ" Приложение 3
    /Clinic PartOf Int Идентификатор родительского ЛПУ Значение идентификатора родительского ЛПУ в справочнике «ЛПУ» Интеграционной платформы

    Запрос

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

    Ответ

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

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

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

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

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

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

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

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

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

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

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

    Таблица 7 – Описание параметров запроса метода CheckPatient
    Контейнер Параметры Обязательность Тип Описание
    Root      
    / idLpu 1..1 Int Идентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы
    / guid 1..1 GUID Авторизационный токен
    / idHistory 0..1 Int Идентификатор сессии (транзакции)
    /pat      
    /pat AriaNumber 0..1 String Номер врачебного участка
    /pat Birthday 0..1 datetime Дата рождения
    /pat CellPhone 0..1 String Номер мобильного телефона (формат передачи: «XXXXXXXXXX» – 10 знаков без разделителей)
    /pat Document_N 0..1 String Номер документа
    /pat Document_S 0..1 String Серия документа
    /pat HomePhone 0..1 String Номер домашнего телефона (формат передачи: «XXXXXXX» – 7 знаков без разделителей)
    /pat IdPat 0..1 String Идентификатор пациента из соответствующего справочника целевой МИС
    /pat Name 0..1 String Имя
    /pat Polis_N 0..1 String Номер полиса ОМС
    /pat Polis_S 0..1 String Серия полиса ОМС
    /pat SecondName 0..1 String Отчество
    /pat Snils 0..1 String СНИЛС пациента
    /pat Surname 0..1 String Фамилия

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

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

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

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

    Таблица 8 - Описание выходных данных метода CheckPatient
    Контейнер Параметры Тип Описание Возможные значения
    /CheckPatientResult      
    /CheckPatientResult IdHistory Int Идентификатор сессии (транзакции)  
    /CheckPatientResult Success Boolean Результат выполнения запроса True; False
    /CheckPatientResult IdPat String Идентификатор пациента Значение идентификатора пациента из соответствующего справочника целевой МИС
    /CheckPatientResult /ErrorList/Error      
    /Error ErrorDescription String Текстовое описание ошибки Коды ошибок
    /Error IdError Int Идентификатор ошибки в справочнике Коды ошибок

    Запрос

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

    Ответ

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

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

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

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

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

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

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

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

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

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

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

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

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

    Таблица 10 - Описание выходных данных метода GetSpesialityList
    Контейнер Параметры Тип Описание Возможные значения
    /GetSpesialityListResult      
    /GetSpesialityListResult IdHistory Int Идентификатор сессии (транзакции)  
    /GetSpesialityListResult Success Boolean Результат выполнения запроса True; False
    /GetSpesialityListResult LPUChanges String Информация об изменении в работе ЛПУ  
    /GetSpesialityListResult/ErrorList/Error      
    /Error ErrorDescription String Текстовое описание ошибки Коды ошибок
    /Error IdError Int Идентификатор ошибки в справочнике Коды ошибок
    /GetSpesialityListResult/ListSpesiality/Spesiality      
    /Spesiality CountFreeParticipantIE Int Количество доступных участнику информационного обмена для записи талонов по врачебной специальности  
    /Spesiality CountFreeTicket Int Общее количество свободных талонов по врачебной специальности  
    /Spesiality FerIdSpesiality String Идентификатор врачебной специальности в федеральном справочнике специальностей Номенклатура специальностей специалистов с высшим и послевузовским медицинским и фармацевтическим образованием в сфере здравоохранения (OID 1.2.643.5.1.13.2.1.1.181)
    /Spesiality IdSpesiality String Идентификатор врачебной специальности Значение идентификатора врачебной специальности из соответствующего справочника целевой МИС
    /Spesiality LastDate Datetime Дата приема по последнему свободному талону врачебной специальности  
    /Spesiality NameSpesiality String Наименование врачебной специальности Наименование врачебной специальности из соответствующего справочника целевой МИС
    /Spesiality NearestDate Datetime Дата приема по ближайшему свободному талону врачебной специальности  

    Запрос

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

    Ответ

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

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

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

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

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

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

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

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

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

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

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

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

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

    Таблица 12 - Описание выходных данных метода GetDoctorList
    Контейнер Параметры Тип Описание Возможные значения
    /GetDoctorListResult      
    /GetDoctorListResult IdHistory Int Идентификатор сессии (транзакции)  
    /GetDoctorListResult Success Boolean Результат выполнения запроса True; False
    /GetDoctorListResult/ErrorList/Error      
    /Error ErrorDescription String Текстовое описание ошибки Коды ошибок
    /Error IdError Int Идентификатор ошибки в справочнике Коды ошибок
    /GetDoctorListResult/Docs/Doctor      
    /Doctor AriaNumber String Номер врачебного участка Значение идентификатора врачебного участка из соответствующего справочника целевой МИС
    /Doctor Comment String Комментарий Дополнительная информация о враче (например, информация о причинах и сроках отсутствия приема врача)
    /Doctor CountFreeParticipantIE Int Количество доступных участнику информационного обмена талонов для записи к врачу  
    /Doctor CountFreeTicket Int Общее количество свободных талонов к врачу  
    /Doctor IdDoc String Идентификатор врача в справочнике Значение идентификатора врача из соответствующего справочника целевой МИС
    /Doctor LastDate Datetime Дата приема по последнему свободному талону к врачу  
    /Doctor Name String ФИО врача (полностью) ФИО врача из соответствующего справочника целевой МИС
    /Doctor NearestDate Datetime Дата приема по ближайшему свободному талону к врачу  
    /Doctor Snils String СНИЛС врача СНИЛС врача из соответствующего справочника целевой МИС

    Запрос

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

    Ответ

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

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

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

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

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

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

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

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

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

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

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

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

    Таблица 14 - Описание выходных данных метода GetAvailableDates
    Контейнер Параметры Тип Описание Возможные значения
    /GetAvailableDatesResult      
    /GetAvailableDatesResult IdHistory Int Идентификатор сессии (транзакции)  
    /GetAvailableDatesResult Success Boolean Результат выполнения запроса True; False
    /GetAvailableDatesResult/ErrorList/Error      
    /Error ErrorDescription String Текстовое описание ошибки Коды ошибок
    /Error IdError Int Идентификатор ошибки в справочнике Коды ошибок
    /GetAvailableDatesResult/AvailableDateList      
    /AvailableDateList dateTime Datetime Даты, на которые есть свободные талоны для записи Значение в формате: YYYY-MM-DDHH:MM:SS.MsMsMs

    Запрос

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

    Ответ

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

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

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

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

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

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

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

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

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

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

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

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

    Таблица 16 - Описание выходных данных метода GetAvaibleAppointments
    Контейнер Параметры Тип Описание Возможные значения
    /GetAvailableAppointmentsResult      
    /GetAvailableAppointmentsResult IdHistory Int Идентификатор сессии (транзакции)  
    /GetAvailableAppointmentsResult Success Boolean Результат выполнения запроса True; False
    /GetAvailableAppointmentsResult/ErrorList/Error      
    /Error ErrorDescription String Текстовое описание ошибки Коды ошибок
    /Error IdError Int Идентификатор ошибки в справочнике Коды ошибок
    /GetAvailableAppointmentsResult/ListAppointments/Appointment      
    /Appointment Address String Адрес приема врача Указывается адрес приема врача (место оказания услуги) в случае, если данный адрес отличается от адреса МО/подразделения МО
    /Appointment IdAppointment String Идентификатор талона для записи Значение идентификатора талона на прием из соответствующего справочника целевой МИС
    /Appointment Num Int Номер талона в очереди  
    /Appointment Room String Номер кабинета Номер кабинета, где будет производиться врачебный прием
    /Appointment VisitStart Datetime Дата и время начала приема Значение в формате: YYYY-MM-DDHH:MM:SS.MsMsMs
    /Appointment VisitEnd Datetime Дата и время окончания приема Значение в формате: YYYY-MM-DDHH:MM:SS.MsMsMs

    Запрос

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

    Ответ

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

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

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

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

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

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

    Рисунок 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.

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

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

    Таблица 17 – Описание параметров запроса метода SetAppointment
    Контейнер Параметры Обязательность Тип Описание
    Root      
    / idAppointment 1..1 String Идентификатор талона для записи из соответствующего справочника целевой МИС
    / idLpu 1..1 Int Идентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы
    / idPat 1..1 String Идентификатор пациента из соответствующего справочника целевой МИС
    / doctorsReferal 0..1 String Номер направления
    / attachedReferral 0..1 XML-объект Объект SearchOneResponse сервиса УО ([base] /MqService.svc?wsdl). Наполняется при передаче запроса от СЗнП к поставщику данных
    / idAppointmentPrev 0..1 String Идентификатор талона записи на прием, по которой необходимо произвести перенос даты и времени (указывается идентификатор талона по существующей записи на прием)
    / guid 1..1 GUID Авторизационный токен
    / idHistory 0..1 Int Идентификатор сессии (транзакции)

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

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

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

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

    Таблица 18 - Описание выходных данных метода SetAppointment
    Контейнер Параметры Тип Описание Возможные значения
    /SetAppointmentsResult      
    /SetAppointmentsResult IdHistory Int Идентификатор сессии (транзакции)  
    /SetAppointmentsResult Success Boolean Результат выполнения запроса True; False
    /SetAppointmentsResult Type String Тип специалиста, к которому записался пациент Значение справочника «Тип специалиста (врача)» Приложение 4
    /SetAppointmentsResult/ErrorList/Error      
    /Error ErrorDescription String Текстовое описание ошибки Коды ошибок
    /Error IdError Int Идентификатор ошибки в справочнике Коды ошибок

    Запрос

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

    Ответ

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

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

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

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

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

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

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

    Таблица 19 – Описание параметров запроса метода SearchTop10Patient
    Контейнер Параметры Обязательность Тип Описание
    Root      
    / idLpu 1..1 Int Идентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы
    / guid 1..1 GUID Авторизационный токен
    / idHistory 0..1 Int Идентификатор сессии (транзакции)
    /pat      
    /pat AriaNumber 0..1 String Номер врачебного участка
    /pat Birthday 0..1 datetime Дата рождения
    /pat CellPhone 0..1 String Номер мобильного телефона (формат передачи: «XXXXXXXXXX» – 10 знаков без разделителей)
    /pat Document_N 0..1 String Номер документа
    /pat Document_S 0..1 String Серия документа
    /pat HomePhone 0..1 String Номер домашнего телефона (формат передачи: «XXXXXXX» – 7 знаков без разделителей)
    /pat IdPat 0..1 String Идентификатор пациента из соответствующего справочника целевой МИС
    /pat Name 1..1 String Имя пациента
    /pat Polis_N 0..1 String Номер полиса ОМС
    /pat Polis_S 0..1 String Серия полиса ОМС
    /pat SecondName 0..1 String Отчество пациента
    /pat Snils 0..1 String СНИЛС пациента
    /pat Surname 1..1 String Фамилия пациента

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

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

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

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

    Таблица 20 - Описание выходных данных метода SearchTop10Patient
    Контейнер Параметры Тип Описание Возможные значения
    /SearchTop10PatientResult      
    /SearchTop10PatientResult IdHistory Int Идентификатор сессии (транзакции)  
    /SearchTop10PatientResult Success Boolean Результат выполнения запроса True; False
    /SearchTop10PatientResult/ErrorList/Error      
    /Error ErrorDescription String Текстовое описание ошибки Коды ошибок
    /Error IdError Int Идентификатор ошибки в справочнике Коды ошибок
    /SearchTop10PatientResult/ListPatient/Patient      
    /Patient AriaNumber String Номер врачебного участка Значение идентификатора врачебного участка из соответствующего справочника целевой МИС
    /Patient Birthday datetime Дата рождения  
    /Patient CellPhone String Номер мобильного телефона (формат передачи: «XXXXXXXXXX» – 10 знаков без разделителей)  
    /Patient Document_N String Номер документа  
    /Patient Document_S String Серия документа  
    /Patient HomePhone String Номер домашнего телефона (формат передачи: «XXXXXXX» – 7 знаков без разделителей)  
    /Patient IdPat String Идентификатор пациента Значение идентификатора пациента из соответствующего справочника целевой МИС
    /Patient Name String Имя пациента  
    /Patient Polis_N String Номер полиса ОМС  
    /Patient Polis_S String Серия полиса ОМС  
    /Patient SecondName String Отчество пациента  
    /Patient Snils String СНИЛС пациента  
    /Patient Surname String Фамилия пациента  

    Запрос

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

    Ответ

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

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

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

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

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

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

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

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

    Таблица 21 – Описание параметров запроса метода AddNewPatient
    Контейнер Параметры Обязательность/ кратность Тип Описание
    Root      
    / idLpu 1..1 Int Идентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы
    / approvedByTfoms 0..1 boolean Прикреплен ли пациент к МО согласно сведениям ТФОМС
    / guid 1..1 GUID Авторизационный токен
    / idHistory 0..1 Int Идентификатор сессии (транзакции)
    /patient 1..1   Информация о пациенте
    /patient AriaNumber 0..1 String Номер врачебного участка в запрашивающей МИС
    /patient Birthday 1..1 datatime Дата рождения
    /patient CellPhone 0..1 String Номер мобильного телефона (формат передачи: «XXXXXXXXXX» – 10 знаков без разделителей)
    /patient Document_N 0..1 String Номер документа
    /patient Document_S 0..1 String Серия документа
    /patient HomePhone 0..1 String Номер домашнего телефона (формат передачи: «XXXXXXX» – 7 знаков без разделителей)
    /patient IdPat 0..1 String Идентификатор пациента
    /patient Name 1..1 String Имя пациента
    /patient Polis_N 0..1 String Номер полиса
    /patient Polis_S 0..1 String Серия полиса
    /patient SecondName 0..1 String Отчество пациента
    /patient Snils 0..1 String СНИЛС пациента
    /patient Surname 1..1 String Фамилия пациента

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

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

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

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

    Таблица 22 - Описание выходных данных метода AddNewPatient
    Контейнер Выходные данные Тип Описание Возможные значения
    /AddNewPatientResult      
    /AddNewPatientResult IdHistory Int Идентификатор сессии (транзакции)  
    /AddNewPatientResult Success Boolean Результат выполнения запроса True; False
    /AddNewPatientResult IdPat String Идентификатор пациента Значение идентификатора пациента из соответствующего справочника целевой МИС
    /AddNewPatientResult/ErrorList/Error      
    /Error ErrorDescription String Текстовое описание ошибки Коды ошибок
    /Error IdError Int Идентификатор ошибки в справочнике Коды ошибок

    Запрос

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

    Ответ

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

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

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

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

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

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

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

    Таблица 23 – Описание параметров запроса метода UpdatePhoneByIdPat
    Контейнер Параметры Обязательность Тип Описание
    Root      
    / idLpu 1..1 Int Идентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы
    / idPat 1..1 String Идентификатор пациента из соответствующего справочника МИС
    / homePhone 0..1 String Номер домашнего телефона (формат передачи: «XXXXXXX» – 7 знаков без разделителей)
    / cellPhone 0..1 String Номер мобильного телефона (формат передачи: «XXXXXXXXXX» – 10 знаков без разделителей)
    / guid 1..1 GUID Авторизационный токен
    / idHistory 0..1 Int Идентификатор сессии (транзакции)

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

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

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

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

    Таблица 24 - Описание выходных данных метода UpdatePhoneByIdPat
    Контейнер Параметры Тип Описание Возможные значения
    /UpdatePhoneByIdPatResult      
    /UpdatePhoneByIdPatResult IdHistory Int Идентификатор сессии (транзакции)  
    /UpdatePhoneByIdPatResult Success Boolean Результат выполнения запроса True; False
    /UpdatePhoneByIdPatResult/ErrorList/Error      
    /Error ErrorDescription String Текстовое описание ошибки Коды ошибок
    /Error IdError Int Идентификатор ошибки в справочнике Коды ошибок

    Запрос

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

    Ответ

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

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

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

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

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

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

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

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

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

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

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

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

    Таблица 26 - Описание выходных данных метода GetPatientHistory
    Контейнер Параметры Тип Описание Возможные значения
    /GetPatientHistoryResult      
    /GetPatientHistoryResult IdHistory Int Идентификатор сессии (транзакции)  
    /GetPatientHistoryResult Success Boolean Результат выполнения запроса True; False
    /GetPatientHistoryResult/ErrorList/Error      
    /Error ErrorDescription String Текстовое описание ошибки Коды ошибок
    /Error IdError Int Идентификатор ошибки в справочнике Коды ошибок
    /GetPatientHistoryResult
    /ListHistoryRefusal/HistoryRefusal
      Информация о записях на прием к врачу, по которым произведен отказ  
    /HistoryRefusal DateCreatedAppointment datatime Дата создания записи на прием  
    /HistoryRefusal IdAppointment String Идентификатор талона на запись Идентификатор талона для записи из соответствующего справочника МИС
    /HistoryRefusal VisitStart datatime Дата начала приема  
    /GetPatientHistoryResult/ListHistoryRefusal
    /HistoryRefusal/DoctorBringReferal
      Информация о враче, направившем на прием  
    /DoctorBringReferal AriaNumber String Номер врачебного участка  
    /DoctorBringReferal IdDoc String Идентификатор врача Значение идентификатора врача из соответствующего справочника МИС
    /DoctorBringReferal Name String ФИО врача (полностью)  
    /GetPatientHistoryResult/ListHistoryRefusal
    /HistoryRefusal/DoctorRendingConsultation
      Информация о враче, к которому произведена запись на прием  
    /DoctorRendingConsultation AriaNumber String Номер врачебного участка  
    /DoctorRendingConsultation IdDoc String Идентификатор врача Значение идентификатора врача из соответствующего справочника МИС
    /DoctorRendingConsultation Name String ФИО врача (полностью)  
    /GetPatientHistoryResult/ListHistoryRefusal
    /HistoryRefusal/SpecialityBringReferal
      Информация о специальности врача, направившего на прием  
    /SpecialityBringReferal FerIdSpesiality String Идентификатор врачебной специальности в федеральном справочнике Номенклатура специальностей специалистов с высшим и послевузовским медицинским и фармацевтическим образованием в сфере здравоохранения (OID 1.2.643.5.1.13.2.1.1.181)
    /SpecialityBringReferal IdSpesiality String Идентификатор врачебной специальности в справочнике Идентификатор врачебной специальности в справочнике МИС
    /SpecialityBringReferal NameSpesiality String Наименование врачебной специальности Наименование врачебной специальности в справочнике МИС
    /GetPatientHistoryResult/ListHistoryRefusal
    /HistoryRefusal/SpecialityRendingConsultation
      Информация о специальности врача, к которому произведена запись на прием  
    /SpecialityRendingConsultation FerIdSpesiality String Идентификатор врачебной специальности в федеральном справочнике Номенклатура специальностей специалистов с высшим и послевузовским медицинским и фармацевтическим образованием в сфере здравоохранения (OID 1.2.643.5.1.13.2.1.1.181)
    /SpecialityRendingConsultation IdSpesiality String Идентификатор врачебной специальности в справочнике Идентификатор врачебной специальности в справочнике МИС
    /SpecialityRendingConsultation NameSpesiality String Наименование врачебной специальности Наименование врачебной специальности в справочнике МИС
    /GetPatientHistoryResult/ListHistoryRefusal
    /HistoryRefusal/UserCreatedAppointment
      Информация о пользователе, записавшем на прием  
    /UserCreatedAppointment UserName String Пользователь, записавший на прием  
    /UserCreatedAppointment UserPosition String Роль пользователя, записавшего на прием Значение справочника «Роль пользователя» Приложение 5
    /GetPatientHistoryResult
    /ListHistoryVisit/HistoryVisit
      Информация об актуальных предстоящих записях пациента на прием  
    /HistoryVisit DateCreatedAppointment datatime Дата создания записи на прием  
    /HistoryVisit IdAppointment String Идентификатор талона на запись Идентификатор талона для записи из соответствующего справочника МИС
    /HistoryVisit VisitStart datatime Дата начала приема  
    /GetPatientHistoryResult/ListHistoryVisit
    /HistoryVisit/DoctorBringReferal
      Информация о враче, направившем на прием  
    /DoctorBringReferal AriaNumber String Номер врачебного участка  
    /DoctorBringReferal IdDoc String Идентификатор врача Значение идентификатора врача из соответствующего справочника МИС
    /DoctorBringReferal Name String ФИО врача (полностью)  
    /GetPatientHistoryResult/ListHistoryVisit
    /HistoryVisit/DoctorRendingConsultation
      Информация о враче, к которому произведена запись на прием  
    /DoctorRendingConsultation AriaNumber String Номер врачебного участка  
    /DoctorRendingConsultation IdDoc String Идентификатор врача Значение идентификатора врача из соответствующего справочника МИС
    /DoctorRendingConsultation Name String ФИО врача (полностью)  
    /GetPatientHistoryResult/ListHistoryVisit
    /HistoryVisit/SpecialityBringReferal
      Информация о специальности врача, направившего на прием  
    /SpecialityBringReferal FerIdSpesiality String Идентификатор врачебной специальности в федеральном справочнике Номенклатура специальностей специалистов с высшим и послевузовским медицинским и фармацевтическим образованием в сфере здравоохранения (OID 1.2.643.5.1.13.2.1.1.181)
    /SpecialityBringReferal IdSpesiality String Идентификатор врачебной специальности в справочнике Идентификатор врачебной специальности в справочнике МИС
    /SpecialityBringReferal NameSpesiality String Наименование врачебной специальности Наименование врачебной специальности в справочнике МИС
    /GetPatientHistoryResult/ListHistoryVisit
    /HistoryVisit/SpecialityRendingConsultation
      Информация о специальности врача, к которому произведена запись на прием  
    /SpecialityRendingConsultation FerIdSpesiality String Идентификатор врачебной специальности в федеральном справочнике Номенклатура специальностей специалистов с высшим и послевузовским медицинским и фармацевтическим образованием в сфере здравоохранения (OID 1.2.643.5.1.13.2.1.1.181)
    /SpecialityRendingConsultation IdSpesiality String Идентификатор врачебной специальности в справочнике Идентификатор врачебной специальности в справочнике МИС
    /SpecialityRendingConsultation NameSpesiality String Наименование врачебной специальности Наименование врачебной специальности в справочнике МИС
    /GetPatientHistoryResult/ListHistoryVisit
    /HistoryVisit/UserCreatedAppointment
      Информация о пользователе, записавшем на прием  
    /UserCreatedAppointment UserName String Пользователь, записавший на прием  
    /UserCreatedAppointment UserPosition String Роль пользователя, записавшего на прием Значение справочника «Роль пользователя» Приложение 5

    Запрос

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

    Ответ

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

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

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

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

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

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

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

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

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

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

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

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

    Таблица 28 - Описание выходных данных метода GetPatientHistory
    Контейнер Параметры Тип Описание Возможные значения
    /CreateClaimForRefusalResult      
    /CreateClaimForRefusalResult IdHistory Int Идентификатор сессии (транзакции)  
    /CreateClaimForRefusalResult Success Boolean Результат выполнения запроса True; False
    /CreateClaimForRefusalResult/ErrorList/Error      
    /Error ErrorDescription String Текстовое описание ошибки Коды ошибок
    /Error IdError Int Идентификатор ошибки в справочнике Коды ошибок

    Запрос

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

    Ответ

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

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

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

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

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

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

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

    Таблица 29 – Описание параметров запроса метода GetWorkingTime
    Контейнер Параметры Обязательность Тип Описание
    Root      
    / idDoc 1..1 String Идентификатор врача в справочнике целевой МИС
    / idLpu 1..1 Int Идентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы
    / visitStart 1..1 Datetime Дата начала диапазона поиска для получения информации о расписании
    / visitEnd 1..1 Datetime Дата окончания диапазона поиска для получения информации о расписании
    / guid 1..1 GUID Авторизационный токен
    / idHistory 0..1 Int Идентификатор сессии (транзакции)

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

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

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

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

    Таблица 30 - Описание выходных данных метода GetWorkingTime
    Контейнер Параметры Тип Описание Возможные значения
    /GetWorkingTimeResult      
    /GetWorkingTimeResult IdHistory Int Идентификатор сессии (транзакции)  
    /GetWorkingTimeResult Success Boolean Результат выполнения запроса True; False
    /GetWorkingTimeResult/ErrorList/Error      
    /Error ErrorDescription String Текстовое описание ошибки Коды ошибок
    /Error IdError Int Идентификатор ошибки в справочнике Коды ошибок
    /GetWorkingTimeResult/WorkingTimeList/WorkingTime      
    /WorkingTime DenyCause String Описание причины отсутствия записи Обычный текст. Наполнение определяется на стороне МИС. Максимальное количество символов- 50.
    /WorkingTime RecordableDay Boolean Возможна ли запись на прием True; False
    /WorkingTime VisitStart Datetime Дата и время начала приема Значение в формате: YYYY-MM-DDHH:MM:SS.MsMsMs
    /WorkingTime VisitEnd Datetime Дата и время окончания приема Значение в формате: YYYY-MM-DDHH:MM:SS.MsMsMs

    Запрос

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

    Ответ

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

    Постановка в лист ожидания (SetWaitingList)

    Данный метод предназначен для фиксирования отказа пациента от записи на прием и добавления пациента в Лист ожидания.

    Листом ожидания является список пациентов, ожидающих появление свободных талонов на прием к определенному врачу или врачебной специальности в указанный временной интервал. Пациент может быть добавлен в Лист ожидания при отсутствии свободного/удобного для пациента времени приема врача в соответствии с установленным графиком приема врачей.

    Если при обращении к методу передается объект rule, то метод осуществляет постановку в Лист ожидания, иначе осуществляется отказ от записи.

    При осуществлении добавления пациента в Лист ожидания соответствующая информация направляется посредством Интеграционной платформы в целевую МИС.

    Процесс «Постановка пациента в Лист ожидания посредством ЦТО» представлен на Рисунке 39.

    Рисунок 39. Схема процесса «Постановка пациента в Лист ожидания посредством ЦТО»

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

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

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

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

    Таблица 31 - Описание параметров запроса метода SetWaitingList
    Контейнер Параметры Обязательность/ кратность Тип Описание
    Root      
    / idDoc 0..1 String Идентификатор врача в справочнике целевой МИС
    / nameDoc 0..1 String ФИО врача (полностью)
    / idSpesiality 1..1 String Идентификатор врачебной специальности в справочнике целевой МИС
    / nameSpesiality 1..1 String Наименование врачебной специальности в справочнике целевой МИС
    / idLpu 1..1 Int Идентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы
    / claim 0..1 String Причина постановки в лист ожидания Приложение 6
    / idPat 1..1 String Идентификатор пациента из соответствующего справочника целевой МИС
    / namePat 0..1 String ФИО пациента (полностью)
    / birthday 0..1 dataTime Дата рождения пациента
    / phone 0..1 String Номер телефона пациента
    / guid 1..1 GUID Авторизационный токен
    / idHistory 0..1 Int Идентификатор сессии (транзакции)
    /rule 0..1   Заполняется при постановке в лист ожидания
    /rule Start 1..1 Datetime Начало диапазона ожидания (желаемого времени приема)
    /rule End 1..1 Datetime Окончание диапазона ожидания (желаемого времени приема)

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

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

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

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

    Таблица 32 - Описание выходных данных метода SetWaitingList
    Контейнер Параметры Тип Описание Возможные значения
    /SetWaitingListResult      
    /SetWaitingListResult IdHistory Int Идентификатор сессии (транзакции)  
    /SetWaitingListResult Success Boolean Результат выполнения запроса True; False
    /SetWaitingListResult GuidClaim Int Идентификатор заявки на ожидание  
    /SetWaitingListResult/ErrorList/Error      
    /Error ErrorDescription String Текстовое описание ошибки Коды ошибок
    /Error IdError Int Идентификатор ошибки в справочнике Коды ошибок

    Запрос

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

    Ответ

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

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

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

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

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

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

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

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

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

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

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

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

    Таблица 34 - Описание выходных данных метода GetDocListFullTree
    Контейнер Параметры Тип Описание Возможные значения
    /GetDocListFullTreeResult      
    /GetDocListFullTreeResult IdHistory Int Идентификатор сессии (транзакции)  
    /GetDocListFullTreeResult Success Boolean Результат выполнения запроса True; False
    /GetDocListFullTreeResult/ErrorList/Error      
    /Error ErrorDescription String Текстовое описание ошибки Коды ошибок
    /Error IdError Int Идентификатор ошибки в справочнике Коды ошибок
    /GetDocListFullTreeResult/ListDoctor/Essence      
    /Essence Description String Комментарий Указывается важная информация для осуществления записи на прием к врачам данной специальности
    /Essence IdEssence String Идентификатор врачебной специальности в МИС Значение идентификатора врачебной специальности в справочнике целевой МИС
    /Essence NameEssence String Наименование врачебной специальности Значение наименования врачебной специальности в справочнике целевой МИС
    /GetDocListFullTreeResult/ListDoctor/Essence
    /ListEssence/Essence
         
    /Essence Description String Комментарий Указывается важная информация для осуществления записи на прием к данному врачу. Для участковых врачей обязательно указывать врачебные участки, по которым осуществляется прием
    /Essence IdEssence String Идентификатор врача в МИС Значение идентификатора врача в справочнике целевой МИС
    /Essence NameEssence String ФИО врача  

    Запрос

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

    Ответ

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

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

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

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

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

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

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

    Таблица 35 – Описание параметров запроса метода GetHubUserByGuid
    Контейнер Параметры Обязательность Тип Описание
    Root      
    / usersGuid 0..1 GUID GUID пользователя
    / guid 1..1 GUID Авторизационный токен
    / idHistory 0..1 Int Идентификатор сессии (транзакции)

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

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

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

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

    Таблица 36 - Описание выходных данных метода GetHubUserByGuid
    Контейнер Параметры Тип Описание Возможные значения
    /GetHubUserByGuidResult      
    /GetHubUserByGuidResult IdHistory Int Идентификатор сессии (транзакции)  
    /GetHubUserByGuidResult Success Boolean Результат выполнения запроса True; False
    /GetHubUserByGuidResult/ErrorList/Error      
    /Error ErrorDescription String Текстовое описание ошибки Коды ошибок
    /Error IdError Int Идентификатор ошибки в справочнике Коды ошибок
    /GetDocListFullTreeResult/HubUserList/HubUser      
    /HubUser UserName String ФИО пользователя  
    /HubUser UserPosition String Роль пользователя Значение справочника «Роль пользователя» Приложение 5
    /HubUser IdDistrict Int Идентификатор района Значение идентификатора из справочника «Районы» Интеграционной платформы
    /HubUser PublicGuid GUID GUID пользователя  

    Запрос

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

    Ответ

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

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

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

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

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

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

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

    Рисунок 46. Структура запроса SendNotificationAboutAppointment

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

    Таблица 37 - Описание параметров запроса метода SendNotificationAboutAppointment.
    Контейнер Параметры Условие Обязательность/ кратность Тип Описание
    Root        
    / idLpu   1..1 Int Идентификатор ЛПУ из справочника "ЛПУ" Интеграционной платформы
    / guid   1..1 GUID Авторизационный токен
    / idHistory   0..1 Int Идентификатор сессии (транзакции)
    / doctorsReferal   0..1 String Номер направления или номер заявки ЖОЗ
    / appointmentSource   1..1 String Источник записи. Значения Приложение 7
    / member Для значения "Прочее" об источнике записи 1..1 GUID Участник информационного взаимодействия, осуществивший запись
    Для остальных значений об источнике записи 0..1
    / fedIdPosition 1..1 String Идентификатор врачебной должности в федеральном справочнике должностей (ФРМР. Должности медицинского персонала (OID 1.2.643.5.1.13.13.11.1102))
    Должно соответствовать коду должности, расположенной в папках:
  • «Должности работников медицинских организаций» -> «Должности медицинских работников» -> «Должности специалистов с высшим профессиональным (медицинским) образованием (врачи) » -> «врачи-специалисты»

  • «Должности работников медицинских организаций» -> «Должности медицинских работников» -> «Должности специалистов со средним профессиональным (медицинским) образованием (средний медицинский персонал)»

  • Пример: 13
    /doctor        
    /doctor AriaNumber   0..1 String Номер врачебного участка
    /doctor Comment   0..1 String Дополнительная информация о враче (например, информация о причинах и сроках отсутствия приема врача)
    /doctor CountFreeParticipantIE   0..1 Int Количество доступных участнику информационного обмена талонов для записи к врачу
    /doctor CountFreeTicket   0..1 Int Общее количество свободных талонов к врачу
    /doctor IdDoc   1..1 String Идентификатор врача в соответствующем справочнике МИС
    /doctor LastDate   0..1 Datetime Дата приема по последнему свободному талону к врачу
    /doctor Name   1..1 String ФИО врача
    /doctor NearestDate   0..1 Datetime Дата приема по ближайшему свободному талону к врачу
    /doctor Snils   1..1 String СНИЛС врача
    /spesiality        
    /spesiality CountFreeParticipantIE   0..1 Int Количество доступных участнику информационного обмена для записи талонов по врачебной специальности
    /spesiality CountFreeTicket   0..1 Int Общее количество свободных талонов по врачебной специальности
    /spesiality FerIdSpesiality   1..1 String Идентификатор специальности в справочнике ФЭР
    /spesiality IdSpesiality   1..1 String Идентификатор врачебной специальности в справочнике МИС
    /spesiality LastDate   0..1 Datetime Дата приема по последнему свободному талону врачебной специальности
    /spesiality NameSpesiality   1..1 String Наименование врачебной специальности в справочнике МИС
    /spesiality NearestDate   0..1 Datetime Дата приема по ближайшему свободному талону врачебной специальности
    /patient        
    /patient AriaNumber   0..1 String Номер врачебного участка
    /patient Birthday   1..1 dateTime Дата рождения пациента
    /patient CellPhone   0..1 String Номер мобильного телефона (формат передачи: «XXXXXXXXXX» – 10 знаков без разделителей)
    /patient HomePhone   0..1 String Номер домашнего телефона (формат передачи: «XXXXXXX» – 7 знаков без разделителей)
    /patient Document_S   0..1 String Серия паспорта
    /patient Document_N   0..1 String Номер паспорта
    /patient IdPat   1..1 String Идентификатор пациента из соответствующего справочника МИС
    /patient Name   1..1 String Имя пациента
    /patient Surname   1..1 String Фамилия пациента
    /patient SecondName   0..1 String Отчество пациента
    /patient Polis_S   0..1 String Серия полиса
    /patient Polis_N   0..1 String Номер полиса
    /patient Snils   0..1 String СНИЛС полиса
    /Аppointment При передаче уведомлений «онлайн» 1..1
    При передаче уведомлений «постфактум» 0..0
    /Аppointment Address   0..1 String Указывается адрес приема врача (место оказания услуги) в случае, если данный адрес отличается от адреса МО/подразделения МО
    /Аppointment IdAppointment   1..1 String Идентификатор талона для записи из соответствующего справочника МИС.
    Значение идентификатора талона должно быть уникальным в рамках МИС МО
    /Аppointment Num   0..1 Int Номер талона в очереди
    /Аppointment Room   0..1 String Номер кабинета, где будет производиться врачебный прием
    /Аppointment VisitStart   1..1 dateTime Начало приема.
    Дата начала приема должна быть больше
    или равна дате отправки запроса. Дата и время начала приема должна быть меньше
    или равна дате и времени окончания приема
    /Аppointment VisitEnd   1..1 dateTime Окончание приема
    /NoticeAppointment При передаче уведомлений «онлайн» 0..0
      При передаче уведомлений «постфактум» 1..1
    /NoticeAppointment Address   0..1 String Указывается адрес приема врача (место оказания услуги) в случае, если данный адрес отличается от адреса МО/подразделения МО
    /NoticeAppointment IdAppointment   1..1 String Идентификатор талона для записи из соответствующего справочника МИС
    /NoticeAppointment Num   0..1 Int Номер талона в очереди
    /NoticeAppointment Room   0..1 String Номер кабинета, где будет производиться врачебный прием
    /NoticeAppointment VisitStart   1..1 dateTime Начало приема
    /NoticeAppointment VisitEnd   1..1 dateTime Окончание приема
    /NoticeAppointment EventDateTime   1..1 dateTime Дата осуществления записи на прием.
    Дата осуществления записи на прием должна быть меньше или равна Дате начала приема.
    Дата осуществления записи на прием должна быть меньше или равна дате отправки запроса.

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

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

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

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

    Таблица 38 - Описание выходных данных метода SendNotificationAboutAppointment
    Контейнер Параметры Тип Описание Возможные значения
    /SendNotificationAboutAppointmentResult      
    /SendNotificationAboutAppointmentResult IdHistory Int Идентификатор сессии (транзакции)  
    /SendNotificationAboutAppointmentResult Success Boolean Результат выполнения запроса True; False
    /SendNotificationAboutAppointmentResult IdNotification Long Идентификатор уведомления о записи  
    /SendNotificationAboutAppointmentResult/ErrorList/Error      
    /Error ErrorDescription String Текстовое описание ошибки Коды ошибок
    /Error IdError Int Идентификатор ошибки в справочнике Коды ошибок

    Запрос

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

    Ответ

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

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

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

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

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

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

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

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

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

    Таблица 39 - Описание параметров запроса метода SendNotificationAboutAppointmentStatus.
    Контейнер Параметры Условие Обязательность/ кратность Тип Описание
    Root        
    / idNotification Параметр заполняется, если в запросе не переданы параметры idLpu, IdPat, IdAppointment и doctorsReferral 0..1 Long Идентификатор уведомления о записи
    / idLpu Параметр заполняется, если в запросе не передан параметр idNotification 0..1 Int Идентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы
    / idPat Параметр заполняется, если в запросе не передан параметр idNotification 0..1 String Идентификатор пациента из соответствующего справочника целевой МИС
    / idAppointment Параметр заполняется, если в запросе не передан параметр idNotification 0..1 String Идентификатор талона из соответствующего справочника целевой МИС
    / doctorsReferral Параметр заполняется, если в запросе не передан параметр idNotification и данная запись на прием была произведена по направлению/заявке ЖОЗ 0..1 String Номер направления или номер заявки ЖОЗ
    / status   1..1 String Итоговое состояние записи Приложение 8
    / EventDateTime   1..1 dateTime Дата изменения статуса записи на прием. Дата и время изменения статуса записи на прием должна быть больше или равна дате и времени осуществления записи на прием. Дата и время изменения статуса записи на прием должна быть меньше или равна дате и времени отправки запроса.
    / guid   1..1 GUID Авторизационный токен
    / idHistory   0..1 Int Идентификатор сессии (транзакции)

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

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

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

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

    Таблица 40 - Описание выходных данных метода SendNotificationAboutAppointmentStatus
    Контейнер Параметры Тип Описание Возможные значения
    /SendNotificationAboutAppointmentStatusResult      
    /SendNotificationAboutAppointmentStatusResult IdHistory Int Идентификатор сессии (транзакции)  
    /SendNotificationAboutAppointmentStatusResult Success Boolean Результат выполнения запроса True; False
    /SendNotificationAboutAppointmentStatusResult/ErrorList/Error      
    /Error ErrorDescription String Текстовое описание ошибки Коды ошибок
    /Error IdError Int Идентификатор ошибки в справочнике Коды ошибок

    Запрос

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

    Ответ

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

    Получение врачебных участков по пациенту (GetPatientsAreas)

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

    Выходной параметр «AreaType» является перечислением (возможные значения параметра указаны в Таблице 42).

    Правила формирования ответа метода «Получение врачебных участков по пациенту (GetPatientsAreas)» при отсутствии данных в МИС о прикреплении пациента к врачебным участкам:

    • В случае, если МИС целевой ЛПУ производит учёт прикрепления к участкам и по запрашиваемому пациенту отсутствуют данные по участкам, МИС необходимо возвращать в ответе ошибку "Отсутствует информация о врачебных участках по пациенту" (код 41);
    • В случае, если МИС целевой ЛПУ не производит учёт прикрепления к участкам, МИС необходимо возвращать в ответе пустой список PatientsArea.

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

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

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

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

    Таблица 41 - Описание параметров запроса метода GetPatientsAreas
    Контейнер Параметры Условие Обязательность/кратность Тип Описание
    Root        
    / idLpu 1..1   String Идентификатор ЛПУ из справочника "ЛПУ" Интеграционной платформы
    / idPat 1..1   String Идентификатор пациента из соответствующего справочника целевой МИС
    / guid 1..1   GUID Авторизационный токен
    / idHistory 0..1   Int Идентификатор сессии (транзакции)

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

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

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

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

    Таблица 42 - Описание выходных данных метода GetPatientsAreas
    Контейнер Выходные данные Тип Описание Возможные значения
    /GetPatientsAreasResult      
    /GetPatientsAreasResultResult IdHistory Int Идентификатор сессии (транзакции)  
    /GetPatientsAreasResultResult Success Boolean Результат выполнения запроса True; False
    /GetPatientsAreasResult/ErrorList/Error      
    /Error ErrorDescription String Текстовое описание ошибки Коды ошибок
    /Error IdError Int Идентификатор ошибки в справочнике Коды ошибок
    /GetPatientsAreasResult/PatientsAreaList/PatientsArea   Указывается информация о врачебных участках, к которым относится пациент в рамках ЛПУ, указанного в запросе метода  
    /PatientsArea Area String Наименование врачебного участка  
    /PatientsArea AreaType String Вид врачебного участка Указывается одно значение из следующих возможных:
    • Фельдшерский
    • Терапевтический
    • ВрачОбщейПрактики
    • Комплексный
    • Акушерский
    • Приписной
    • Педиатрический
    • Фтизиатрический

    Запрос

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

    Ответ

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

    Валидация кода направления 2 (InspectDoctorsReferral2)

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

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

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

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

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

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

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

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

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

    Таблица 43 – Описание параметров запроса метода InspectDoctorsReferral2
    Контейнер Параметры Условие Обязательность/ кратность Тип Описание
    Root        
    / idLpu   0..1 Int Идентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы. Наполняется при передаче запроса от СЗнП к поставщику данных
    / doctorsReferal   1..1 String Номер направления
    / surname   0..1 String Фамилия пациента (заполняется как в выданном направлении)
    / attachedReferral   0..1 XML-объект Объект SearchOneResponse сервиса УО ([base] /MqService.svc?wsdl). Наполняется при передаче запроса от СЗнП к поставщику данных
    / guid   1..1 GUID Авторизационный токен
    / idHistory   0..1 Int Идентификатор сессии (транзакции)

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

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

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

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

    Таблица 44 - Описание выходных данных метода InspectDoctorsReferral2
    Контейнер Выходные данные Обязательность/ кратность Тип Описание Возможные значения
    /InspectDoctorsReferral2Result        
    /InspectDoctorsReferral2Result IdHistory 0..1 Int Идентификатор сессии (транзакции)  
    /InspectDoctorsReferral2Result Success 1..1 Boolean Результат выполнения запроса True; False
    /InspectDoctorsReferral2Result IdLpu 1..1 Int Идентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы  
    /InspectDoctorsReferral2Result IdPat 1..1 String Идентификатор пациента в МИС ЛПУ Значение идентификатора пациента из соответствующего справочника целевой МИС
    /InspectDoctorsReferral2Result
    /ErrorList/Error
    0..*      
    /Error ErrorDescription 1..1 String Текстовое описание ошибки Коды ошибок
    /Error IdError 1..1 Int Идентификатор ошибки в справочнике Коды ошибок
    /InspectDoctorsReferral2Result
    /ListSpeсiality/Speсiality
    0..*   Указывается информация о специальности  
    /Speсiality FerIdSpeciality 1..1 String Идентификатор врачебной специальности в федеральном справочнике специальностей Номенклатура специальностей специалистов с высшим и послевузовским медицинским и фармацевтическим образованием в сфере здравоохранения (OID 1.2.643.5.1.13.2.1.1.181)
    /Speсiality IdSpeciality 1..1 String Идентификатор врачебной специальности Значение идентификатора врачебной специальности из соответствующего справочника целевой МИС
    /Speсiality NameSpeciality 1..1 String Наименование врачебной специальности Наименование врачебной специальности из соответствующего справочника целевой МИС
    /Speсiality Description 0..1 String Комментарий Указывается важная информация для осуществления записи на прием к врачам данной специальности
    /InspectDoctorsReferral2Result
    /ListSpeсiality/Speсiality/ListDoctor/Doctor2
    0..*   Указывается информация о враче  
    /Doctor2 IdDoc 1..1 String Идентификатор врача в справочнике Значение идентификатора врача из соответствующего справочника целевой МИС
    /Doctor2 Name 1..1 String ФИО врача (полностью) ФИО врача из соответствующего справочника целевой МИС
    /Doctor2 Description 1..1 String Комментарий Указывается важная информация для осуществления записи на прием к данному врачу
    /Doctor2 Snils 1..1 String СНИЛС врача СНИЛС врача из соответствующего справочника целевой МИС
    /InspectDoctorsReferral2Result
    /ListSpeсiality/Speсiality/ListDoctor/Doctor2
    /ListAppointment/Appointment
    0..*   Указывается информация о талоне (свободном временном интервале)  
    /Appointment Adress 0..1 String Адрес приема врача Указывается адрес приема врача (место оказания услуги) в случае, если данный адрес отличается от адреса МО/подразделения МО
    /Appointment IdAppointment 1..1 String Идентификатор талона для записи Значение идентификатора талона на прием из соответствующего справочника целевой МИС
    /Appointment Num 0..1 Int Номер талона в очереди  
    /Appointment Room 0..1 String Номер кабинета Номер кабинета, где будет производиться врачебный прием
    /Appointment VisitStart 1..1 Datetime Дата и время начала приема Значение в формате: YYYY-MM-DDHH:MM:SS.MsMsMs
    /Appointment VisitEnd 1..1 Datetime Дата и время окончания приема Значение в формате: YYYY-MM-DDHH:MM:SS.MsMsMs

    Запрос

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

    Ответ

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

    Получение данных о направлении (CheckRefferal)

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

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

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

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

    1. Целевое ЛПУ (клиент СЗнП) отправляет запрос метода «Получение данных о направлении (CheckRefferal)» в СЗнП. Состав параметров запроса представлен в Таблице 45.
    2. СЗнП отправляет запрос метода SearchOne в сервис УО для получения данных о направлении.
    3. УО передает ответ метода SearchOne в СЗнП с данными о направлении.
    4. СЗнП передает ответ метода «Получение данных о направлении (CheckRefferal)» в целевое ЛПУ (клиент СЗнП). Состав выходных данных ответа метода «Получение данных о направлении (CheckRefferal)» аналогичен составу выходных данных ответа метода SearchOne в сервисе УО (представлен по ссылке: http://api.netrika.ru/docs.php?article=Queues#SearchOne).

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

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

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

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

    Таблица 45 – Описание параметров запроса метода CheckRefferal
    Контейнер Параметры Условие Обязательность/ кратность Тип Описание
    Root        
    / doctorsReferal   1..1 String Номер направления
    / guid   1..1 GUID Авторизационный токен
    / idHistory   0..1 Int Идентификатор сессии (транзакции)

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

    Состав выходных данных ответа метода «Получение данных о направлении (CheckRefferal)» должен быть аналогичен составу выходных данных ответа метода «Поиск направления (SearchOne)» в сервисе УО.

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

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

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

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

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

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

    Таблица 46 - Описание параметров запроса метода GetAvailableDoctors
    Контейнер Параметры Условие Обязательность/кратность Тип Описание
    Root        
    / idLpu   1..1 String Идентификатор ЛПУ из справочника "ЛПУ" Интеграционной платформы
    / idPat   1..1 String Идентификатор пациента из соответствующего справочника целевой МИС
    / idSpeciality Если в запросе указывается параметр idSpeciality, параметр ferIdSpeciality в запросе передаваться не должен 0..1 String Идентификатор врачебной специальности в справочнике целевой МИС
    / ferIdSpeciality Если в запросе указывается параметр ferIdSpeciality, параметр idSpeciality в запросе передаваться не должен 0..1 String Идентификатор врачебной специальности в федеральном справочнике специальностей (Номенклатура специальностей специалистов с высшим и послевузовским медицинским и фармацевтическим образованием в сфере здравоохранения (OID 1.2.643.5.1.13.2.1.1.181))
    / guid   1..1 GUID Авторизационный токен
    / idHistory   0..1 Int Идентификатор сессии (транзакции)

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

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

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

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

    Таблица 47 - Описание выходных данных метода GetAvailableDoctors
    Контейнер Выходные данные Обязательность/кратность Тип Описание Возможные значения
    /GetAvailableDoctorsResult      
    /GetAvailableDoctorsResult IdHistory 0..1 Int Идентификатор сессии (транзакции)  
    /GetAvailableDoctorsResult Success 1..1 Boolean Результат выполнения запроса True; False
    /GetAvailableDoctorsResult Comment 0..1 String Комментарий Дополнительная информация для пациента по оформлению записи; до 50 символов
    /GetAvailableDoctorsResult/ErrorList/Error   0..*    
    /Error ErrorDescription 1..1 String Текстовое описание ошибки Коды ошибок
    /Error IdError 1..1 Int Идентификатор ошибки в справочнике Коды ошибок
    /GetAvailableDoctorsResult/ListSpeciality/Speciality3   0..*    
    /Speciality3 Comment 0..1 String Комментарий Дополнительная информация о специальности (до 50 символов)
    /Speciality3 CountFreeParticipantIE 1..1 Int Количество доступных участнику информационного обмена для записи талонов по врачебной специальности  
    /Speciality3 FerIdSpeciality 1..1 String Идентификатор врачебной специальности в федеральном справочнике специальностей Номенклатура специальностей специалистов с высшим и послевузовским медицинским и фармацевтическим образованием в сфере здравоохранения (OID 1.2.643.5.1.13.2.1.1.181)
    /Speciality3 IdSpeciality 1..1 String Идентификатор врачебной специальности Значение идентификатора врачебной специальности из соответствующего справочника целевой МИС
    /Speciality3 LastDate 1..1 Datetime Дата приема по последнему свободному талону врачебной специальности  
    /Speciality3 NameSpeciality 1..1 String Наименование врачебной специальности Наименование врачебной специальности из соответствующего справочника целевой МИС
    /Speciality3 NearestDate 1..1 Datetime Дата приема по ближайшему свободному талону врачебной специальности  
    /GetAvailableDoctorsResult/ListSpeciality/Speciality3/Docs/Doctor3   0..*    
    /Doctor3 Area 0..1 String Полное наименование врачебного участка (включая номер врачебного участка и необходимые дополнительные указания и комментарии)  
    /Doctor3 AreaType 0..1 String Вид врачебного участка Указывается одно значение из следующих возможных:
  • Фельдшерский
  • Терапевтический
  • Врача общей практики (семейного врача)
  • Комплексный
  • Акушерский
  • Приписной
  • Педиатрический
  • Фтизиатрический
  • /Doctor3 Comment 0..1 String Комментарий Дополнительная информация о враче (например, информация о причинах и сроках отсутствия приема врача); до 50 символов
    /Doctor3 CountFreeParticipantIE 1..1 Int Количество доступных участнику информационного обмена талонов для записи к врачу  
    /Doctor3 CountFreeTicket 1..1 Int Общее количество свободных талонов к врачу  
    /Doctor3 IdDoc 1..1 Int Идентификатор врача в справочнике Значение идентификатора врача из соответствующего справочника целевой МИС
    /Doctor3 LastDate 1..1 Datetime Дата приема по последнему свободному талону к врачу  
    /Doctor3 Name 1..1 String ФИО врача (полностью) ФИО врача из соответствующего справочника целевой МИС
    /Doctor3 NearestDate 1..1 Datetime Дата приема по ближайшему свободному талону к врачу  
    /Doctor3 Snils 1..1 String СНИЛС врача СНИЛС врача из соответствующего справочника целевой МИС (формат передачи: «XXXXXXXXXXX»)

    Запрос

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

    Ответ

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

    Запрос талонов по заявке ЖОЗ (GetAvailableAppointmentsByPARequest)

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

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

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

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

    1. Клиент СЗнП отправляет запрос метода «Запрос талонов по заявке ЖОЗ (GetAvailableAppointmentsByPARequest)» в СЗнП. Состав параметров запроса представлен в Таблице 48.
    2. СЗнП отправляет запрос метода SearchActivePARequests в сервис УО для получения данных о заявке ЖОЗ.
    3. УО передает ответ метода SearchActivePARequests в СЗнП с данными о заявке ЖОЗ.
    4. В случае, если заявка ЖОЗ найдена методом SearchActivePARequests (т.е. заявка активна), СЗнП отправляет запрос метода «Запрос талонов по заявке ЖОЗ (GetAvailableAppointmentsByPARequest)» в целевое ЛПУ, определенное на шаге 3, с указанием данных о заявке ЖОЗ, полученных в УО. Состав параметров запроса представлен в Таблице 48.
    5. Целевое ЛПУ передает ответ метода «Запрос талонов по заявке ЖОЗ (GetAvailableAppointmentsByPARequest)» в СЗнП. Состав выходных данных ответа метода представлен в Таблице 49.
    6. СЗнП передает ответ метода «Запрос талонов по заявке ЖОЗ (GetAvailableAppointmentsByPARequest)» клиенту СЗнП. Состав выходных данных ответа метода представлен в Таблице 49.

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

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

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

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

    Таблица 48 – Описание параметров запроса метода GetAvailableAppointmentsByPARequest
    Контейнер Параметры Обязательность/ кратность Тип Описание
    Root    
    / idLpu 0..1 Int Идентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы. Наполняется при передаче запроса от СЗнП к поставщику данных
    / guid 1..1 GUID Авторизационный токен
    / idHistory 0..1 Int Идентификатор сессии (транзакции)
    /attachedPARequest   1..1 XML-объект Объект типа ActivePARequestInfo. Данные, кроме IdPar, наполняются при передаче запроса от СЗнП к поставщику данных
    /attachedPARequest IdPar 1..1 String Идентификатор заявки ЖОЗ
    /attachedPARequest CreatedDate 1..1 DateTime Дата создания заявки ЖОЗ
    /attachedPARequest PASourceCreated 1..1 Int Идентификатор заявки ЖОЗ
    /attachedPARequest IdPar 1..1 String Источник создания заявки ЖОЗ (код из справочника «Источники заявки ЖОЗ» Интеграционной платформы) Приложение 10  
    /attachedPARequest/PARequest   1..1   Контейнер параметров заявки
    /PARequest FerIdSpeciality 1..1 String Номенклатура специальностей специалистов с высшим и послевузовским медицинским и фармацевтическим образованием в сфере здравоохранения (OID 1.2.643.5.1.13.2.1.1.181)
    /PARequest IdDoc 0..1 String Идентификатор врача в соответствующем справочнике МИС
    /PARequest IdLpu 1..1 String Идентификатор ЛПУ (из справочника "ЛПУ" Интеграционной платформы), в которое должна быть осуществлена запись
    /PARequest IdNsiLpu 1..1 String Идентификатор ЛПУ (Значение поля «Code» из справочника с OID 1.2.643.2.69.1.1.1.64) куда должна быть осуществлена запись
    /PARequest IdSpeciality 1..1 String Идентификатор врачебной специальности в справочнике МИС
    /PARequest NameDoc 0..1 String ФИО врача в соответствующем справочнике МИС, ожидается в паре с идентификатором врача в соответствующем справочнике МИС
    /PARequest NameSpeciality 1..1 String Наименование врачебной специальности в справочнике МИС
    /attachedPARequest/PARequestInfo   1..1   Контейнер причин
    /PARequestInfo Claim 1..1 String Причина постановки в лист ожидания (код из справочника "Причина постановки в лист ожидания (ЖОЗ)" Интеграционной платформы Приложение 6
    /PARequestInfo Info 1..1 String Причина посещения врача, краткое описание симптомов и диагноза если известны
    /attachedPARequest/PARequestPatient   1..1   Контейнер сведений о пациенте
    /PARequestPatient BirthDate 1..1 DateTime Дата рождения пациента
    /PARequestPatient FirstName 1..1 String Имя пациента
    /PARequestPatient IdPatient 1..1 String Идентификатор пациента из соответствующего справочника МИС
    /PARequestPatient LastName 1..1 String Фамилия пациента
    /PARequestPatient MiddleName 1..1 String Отчество пациента
    /PARequestPatient/PARequestPatientContacts   1..1   Контейнер контактной информации пациента
    /PARequestPatientContacts AdditionalInformation 0..1 String Дополнительная информация о контактах
    /PARequestPatientContacts Email 0..1 String Адрес электронной почты (для автоматизации уведомлений пациента)
    /PARequestPatientContacts Phone 1..1 String Номер телефона (для уведомления о назначенном времени приема)
    /attachedPARequest/PreferredIntervals/PARequestInterval   1..*   Контейнер интервалов удобного пациенту времени посещения
    /PARequestInterval StartDate 1..1 dateTime Начало интервала
    /PARequestInterval EndDate 1..1 dateTime Окончание интервала

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

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

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

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

    Таблица 49 - Описание выходных данных метода GetAvailableAppointmentsByPARequest
    Контейнер Выходные данные Обязательность/кратность Тип Описание Возможные значения
    /GetAvailableAppointmentsByPARequestResult    
    /GetAvailableAppointmentsByPARequestResultIdHistory0..1IntИдентификатор сессии (транзакции) 
    /GetAvailableAppointmentsByPARequestResultSuccess1..1BooleanРезультат выполнения запросаTrue; False
    /GetAvailableAppointmentsByPARequestResultIdLpu1..1IntИдентификатор ЛПУ из справочника «ЛПУ» Интеграцион
    ной платформы
     
    /GetAvailableAppointmentsByPARequestResultIdPat1..1StringИдентификатор пациента в МИС ЛПУЗначение идентификатора пациента из соответствующе
    го справочника целевой МИС
    /GetAvailableAppointmentsByPARequestResult/
    ErrorList/Error
    0..*   
    /ErrorErrorDescription1..1StringТекстовое описание ошибкиКоды ошибок
    /ErrorIdError1..1IntИдентификатор ошибки в справочникеКоды ошибок
    /GetAvailableAppointmentsByPARequestResult/
    ListSpeсiality/Speсiality2
    0..* Указывается информация о специальности 
    /Speсiality2FerIdSpeciality1..1StringИдентификатор врачебной специальности в
    федеральном справочнике специальностей
    Номенклатура специальностей специалистов с высшим
    и послевузовским медицинским и фармацевтическим
    образованием в сфере здравоохранения (OID 1.2.643.5.
    1.13.2.1.1.181)
    /Speсiality2IdSpeciality1..1StringИдентификатор врачебной специальностиЗначение идентификатора врачебной специальности из
    соответствующего справочника целевой МИС
    /Speсiality2NameSpeciality1..1StringНаименование врачебной специальностиНаименование врачебной специальности из соответств
    ующего справочника целевой МИС
    /Speсiality2Description0..1StringКомментарийУказывается важная информация для осуществления за
    писи на прием к врачам данной специальности
    /GetAvailableAppointmentsByPARequestResult/ListSpeсiality/
    Speсiality2/ListDoctor/Doctor2
    0..* Указывается информация о враче 
    /Doctor2IdDoc1..1StringИдентификатор врача в справочникеЗначение идентификатора врача из соответствующего
    справочника целевой МИС
    /Doctor2Name1..1StringФИО врача (полностью)ФИО врача из соответствующего справочника целевой
    МИС
    /Doctor2Description0..1StringКомментарийУказывается важная информация для осуществления за
    писи на прием к данному врачу
    /Doctor2Snils1..1StringСНИЛС врачаСНИЛС врача из соответствующего справочника
    целевой МИС (формат передачи: «XXX-XXX-XXX YY»)
    /GetAvailableAppointmentsByPARequestResult/ListSpeсiality/
    Speсiality2/ListDoctor/Doctor2/
    ListAppointment/Appointment
    0..* Указывается информация о талоне (свободном временн
    ом интервале)
     
    /AppointmentAddress0..1StringАдрес приема врачаУказывается адрес приема врача (место оказания услуги)
    в случае, если данный адрес отличается
    от адреса МО/подразделения МО
    /AppointmentIdAppointment1..1StringИдентификатор талона для записиЗначение идентификатора талона на прием из
    соответствующего справочника целевой МИС
    /AppointmentNum0..1IntНомер талона в очереди 
    /AppointmentRoom0..1StringНомер кабинетаНомер кабинета, где будет производиться врачебный
    прием
    /AppointmentVisitStart1..1DatetimeДата и время начала приемаЗначение в формате: YYYY-MM-DDHH:MM:SS.MsMsMs
    /AppointmentVisitEnd1..1DatetimeДата и время окончания приемаЗначение в формате: YYYY-MM-DDHH:MM:SS.MsMsMs

    Запрос

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

    Ответ

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

    Подтверждение записи по заявке ЖОЗ (SetAppointmentByPARequest)

    Данный метод используется для записи по заявке ЖОЗ на прием в выбранный временной интервал рабочего времени врача, в запросе к целевой ЛПУ дополнительно передаются данные по заявке ЖОЗ, полученные в сервисе УО. Если в запросе метода заполнен параметр idAppointmentPrev, то осуществляется перенос даты и времени приема по ранее оформленной записи.

    На Рисунке 62 представлена схема информационного взаимодействия в случае оформления записи по заявке ЖОЗ в рамках метода «Подтверждение записи по заявке ЖОЗ (SetAppointmentByPARequest)».

    Рисунок 62. Схема информационного взаимодействия в случае оформления записи по заявке ЖОЗ в рамках метода «Подтверждение записи по заявке ЖОЗ (SetAppointmentByPARequest)»

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

    1. Клиент СЗнП отправляет запрос метода «Подтверждение записи по заявке ЖОЗ (SetAppointmentByPARequest)» в СЗнП. Состав параметров запроса представлен в Таблице
    2. СЗнП отправляет запрос метода SearchActivePARequests в сервис УО для получения данных о заявке ЖОЗ.
    3. УО передает ответ метода SearchActivePARequests в СЗнП с данными о заявке ЖОЗ.
    4. В случае, если заявка ЖОЗ найдена методом SearchActivePARequests (т.е. заявка активна), СЗнП отправляет запрос метода «Подтверждение записи по заявке ЖОЗ (SetAppointmentByPARequest)» в целевое ЛПУ, определенное на шаге 3, с указанием данных о заявке ЖОЗ, полученных в УО. Состав параметров запроса представлен в Таблице 50.
    5. Целевое ЛПУ передает ответ метода «Подтверждение записи по заявке ЖОЗ (SetAppointmentByPARequest)» в СЗнП. Состав выходных данных ответа метода представлен в Таблице 51.
    6. СЗнП передает ответ метода «Подтверждение записи по заявке ЖОЗ (SetAppointmentByPARequest)» клиенту СЗнП. Состав выходных данных ответа метода представлен в Таблице 51.

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

    Структура запроса SetAppointmentByPARequest представлена на Рисунке 63

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

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

    Таблица 50 – Описание параметров запроса метода SetAppointmentByPARequest
    Контейнер Параметры Обязательность/кратность Тип Описание
    Root   
    /idAppointment1..1StringИдентификатор талона для записи из соответствующего справочника целевой МИС
    /idAppointmentPrev0..1StringИдентификатор талона записи на прием, по которой необходимо произвести перенос даты и времени (указывается идентификатор талона по существующей записи на прием)
    /idLpu1..1IntИдентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы
    /guid1..1GUIDАвторизационный токен
    /idHistory0..1IntИдентификатор сессии (транзакции)
    /attachedPARequest1..1XML-объектОбъект типа ActivePARequestInfo. Данные, кроме IdPar, наполняются при передаче запроса от СЗнП к поставщику данных
    /attachedPARequestIdPar1..1StringИдентификатор заявки ЖОЗ
    /attachedPARequestCreatedDate1..1DateTimeДата создания заявки ЖОЗ
    /attachedPARequestPASourceCreated1..1Int Источник создания заявки ЖОЗ (код из справочника «Источники заявки ЖОЗ» Интеграционной платформы) Приложение 10
    /attachedPARequest/PARequest1..1 Контейнер параметров заявки
    /PARequestFerIdSpeciality1..1StringНоменклатура специальностей специалистов с высшим и послевузовским медицинским и фармацевтическим образованием в сфере здравоохранения (OID 1.2.643.5.1.13.2.1.1.181)
    /PARequestIdDoc0..1StringИдентификатор врача в соответствующем справочнике МИС
    /PARequestIdLpu1..1StringИдентификатор ЛПУ (из справочника "ЛПУ" Интеграционной платформы), в которое должна быть осуществлена запись
    /PARequestIdNsiLpu1..1StringИдентификатор ЛПУ (Значение поля «Code» из справочника с OID 1.2.643.2.69.1.1.1.64) куда должна быть осуществлена запись
    /PARequestIdSpeciality1..1StringИдентификатор врачебной специальности в справочнике МИС
    /PARequestNameDoc0..1StringФИО врача в соответствующем справочнике МИС, ожидается в паре с идентификатором врача в соответствующем справочнике МИС
    /PARequestNameSpeciality1..1StringНаименование врачебной специальности в справочнике МИС
    /attachedPARequest/PARequestInfo1..1 Контейнер причин
    /PARequestInfoClaim1..1String Причина постановки в лист ожидания (код из справочника "Причина постановки в лист ожидания (ЖОЗ)" Интеграционной платформы Приложение 6
    /PARequestInfoInfo1..1StringПричина посещения врача, краткое описание симптомов и диагноза если известны
    /attachedPARequest/PARequestPatient1..1 Контейнер сведений о пациенте
    /PARequestPatientBirthDate1..1DateTimeДата рождения пациента
    /PARequestPatientFirstName1..1StringИмя пациента
    /PARequestPatientIdPatient1..1StringИдентификатор пациента из соответствующего справочника МИС
    /PARequestPatientLastName1..1StringФамилия пациента
    /PARequestPatientMiddleName1..1StringОтчество пациента
    /PARequestPatient/PARequestPatientContacts1..1 Контейнер контактной информации пациента
    /PARequestPatientContactsAdditionalInformation0..1StringДополнительная информация о контактах
    /PARequestPatientContactsEmail0..1StringАдрес электронной почты (для автоматизации уведомлений пациента)
    /PARequestPatientContactsPhone1..1StringНомер телефона (для уведомления о назначенном времени приема)
    /attachedPARequest/PreferredIntervals/PARequestInterval1..* Контейнер интервалов удобного пациенту времени посещения
    /PARequestIntervalStartDate1..1DateTimeНачало интервала
    /PARequestIntervalEndDate1..1DateTimeОкончание интервала

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

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

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

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

    Таблица 51 - Описание выходных данных метода SetAppointmentByPARequest
    Контейнер Выходные данные Тип Описание Выходные данные
    /SetAppointmentByPARequestResult   
    /SetAppointmentByPARequestResultIdHistoryIntИдентификатор сессии (транзакции) 
    /SetAppointmentByPARequestResultSuccessBooleanРезультат выполнения запросаTrue; False
    /SetAppointmentByPARequestResultTypeStringТип специалиста, к которому записался пациентЗначения из справочника «Тип специалиста (врача) Приложение 4
    /ErrorErrorDescriptionStringТекстовое описание ошибкиКоды ошибок
    /ErrorIdErrorIntИдентификатор ошибки в справочникеКоды ошибок

    Запрос

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

    Ответ

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

    Регистрация заявки ЖОЗ (RegisterPARequest)

    Данный метод предназначен для регистрации заявки на прием к врачу в журнале отложенной записи (ЖОЗ). При положительном результате проверок входных данных и обработки метода будет сформирован и передан в составе выходных параметров уникальный идентификатор заявки ЖОЗ.

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

    Рисунок 65. Схема информационного взаимодействия в рамках метода «Регистрация заявки ЖОЗ (RegisterPARequest)»

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

    Таблица 52 – Описание параметров запроса метода RegisterPARequest
    Контейнер Параметры Обязательность/ кратность Тип Описание
    Root   
    /guid1..1GUIDАвторизационный токен
    /idHistory0..1IntИдентификатор сессии (транзакции)
    /request   
    /request/PARequest1..1 Контейнер параметров заявки
    /PARequestIdLpu1..1StringИдентификатор ЛПУ (из справочника "ЛПУ" Интеграционной платформы), в которое должна быть осуществлена запись
    /PARequestIdNsiLpu0..1StringИдентификатор ЛПУ (Значение поля «Code» из справочника с OID 1.2.643.2.69.1.1.1.64)
    куда должна быть осуществлена запись,
    наполняется при передаче запроса от СЗнП к УО
    /PARequestIdSpesiality1..1StringИдентификатор врачебной специальности в справочнике МИС
    /PARequestNameSpeciality1..1StringНаименование врачебной специальности в справочнике МИС
    /PARequestFerIdSpeciality1..1StringНоменклатура специальностей специалистов
    с высшим и послевузовским медицинским и фармацевтическим образованием
    в сфере здравоохранения (OID 1.2.643.5.1.13.2.1.1.181)
    /PARequestIdDoc0..1StringИдентификатор врача в соответствующем справочнике МИС
    /PARequestNameDoc0..1StringФИО врача в соответствующем справочнике МИС,
    ожидается в паре с идентификатором врача в соответствующем справочнике МИС
    /request/PARequestPatient1..1 Контейнер сведений о пациенте
    /PARequestPatientIdPatient1..1StringИдентификатор пациента из соответствующего справочника МИС
    /PARequestPatientLastName1..1StringФамилия пациента
    /PARequestPatientFirstName1..1StringИмя пациента
    /PARequestPatientMiddleName0..1StringОтчество пациента
    /PARequestPatientBirthDate1..1DatetimeДата рождения пациента
    /PARequestPatient/PARequestPatientContacts1..1 Контейнер контактной информации пациента
    /PARequestPatientContactsAdditionalInformation0..1StringДополнительная информация о контактах
    /PARequestPatientContactsEmail0..1StringАдрес электронной почты (для автоматизации уведомлений пациента)
    /PARequestPatientContactsPhone1..1StringНомер телефона (для уведомления о назначенном времени приема) (в формате +7(xxx)xxx-xx-xx или 8(xxx)xxxxxxx)
    /request/PARequestInfo1..1 Контейнер причин
    /PARequestInfoClaim1..1StringПричина постановки в лист ожидания (код из справочника "Причина постановки в лист ожидания (ЖОЗ)" Интеграционной платформы Приложение 6
    /PARequestInfoInfo0..1StringПричина посещения врача, краткое описание симптомов и диагноза если известны
    /requestPASource1..1Int Источник создания заявки ЖОЗ (код из справочника «Источники заявки ЖОЗ» Интеграционной платформы) Приложение 10  
    /request/PreferredIntervals0..1 Контейнер интервалов удобного пациенту времени приема врача
    /request/PreferredIntervals/PARequestInterval1..* Интервал времени
    /PARequestIntervalStartDate1..1DatetimeНачало интервала
    /PARequestIntervalEndDate1..1DatetimeОкончание интервала

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

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

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

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

    Таблица 53 - Описание выходных данных метода RegisterPARequest
    Результат выполнения запроса
    Контейнер Выходные данные Тип Описание Возможные значения
    /RegisterPARequestResult   
    /RegisterPARequestResultIdParStringИдентификатор заявки ЖОЗ 
    /RegisterPARequestResultIdHistoryIntИдентификатор сессии (транзакции) 
    /RegisterPARequestResultSuccessBooleanTrue; False
    /RegisterPARequestResult/ErrorList/Error   
    /ErrorErrorDescriptionStringТекстовое описание ошибки 
    /ErrorIdErrorIntИдентификатор ошибки в справочникеКоды ошибок

    Запрос

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

    Ответ

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

    Отмена заявки ЖОЗ (CancelPARequest)

    Данный метод предназначен для отмены существующей заявки на прием к врачу в журнале отложенной записи (ЖОЗ). При положительном результате проверок входных данных и обработки метода заявка ЖОЗ будет деактивирована.

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

    Структура запроса CancelPARequest представлена на Рисунке 67

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

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

    Таблица 54 – Описание параметров запроса метода CancelPARequest
    Контейнер Параметры Обязательность/ кратность Тип Описание
    Root   
    /guid1..1GUIDАвторизационный токен
    /idHistory0..1IntИдентификатор сессии (транзакции)
    /request   
    /requestIdPar1..1StringИдентификатор отменяемой заявки на запись к врачу
    /requestLinkedIdPar0..1StringИдентификатор новой заявки на запись к врачу, для случая когда запись на прием будет оформлена на другой код площадки или другую МО
    /requestDeactivationReason1..1Int Повод отмены записи (код из справочника "Поводы отмены заявки в ЖОЗ" Интеграционной платформы) Приложение 9
    /requestDeactivationComment0..1StringКомментарий отмены заявки
    /requestPASource1..1Int Источник отмены заявки ЖОЗ (код из справочника «Источники заявки ЖОЗ» Интеграционной платформы) Приложение 10

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

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

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

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

    Таблица 55 - Описание выходных данных метода CancelPARequest
    Контейнер Выходные данные Тип Описание Возможные значения
    /CancelPARequestResult   
    /CancelPARequestResultIdHistoryIntИдентификатор сессии (транзакции) 
    /CancelPARequestResultSuccessBooleanРезультат выполнения запросаTrue; False
    /CancelPARequestResultCancellationResultBooleanРезультат выполнения запросаTrue; False
    /CancelPARequestResultIdParStringИдентификатор заявки ЖОЗ 
    /CancelPARequestResult/ErrorList/Error   
    /ErrorErrorDescriptionStringТекстовое описание ошибкиКоды ошибок
    /ErrorIdErrorIntИдентификатор ошибки в справочникеКоды ошибок

    Запрос

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

    Ответ

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

    Поиск активных заявок ЖОЗ (SearchActivePARequest)

    Данный метод предназначен для поиска активных заявок на прием к врачу в журнале отложенной записи (ЖОЗ). При обработке метода заполненные параметры рассматриваются как совокупность условий поиска соединенных функцией «Логическое И».

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

    Структура запроса SearchActivePARequest представлена на Рисунке 69

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

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

    Таблица 56 – Описание параметров запроса метода SearchActivePARequest
    Контейнер Параметры Обязательность/ кратность Тип Описание
    Root   
    /guid1..1GUIDАвторизационный токен
    /idHistory0..1IntИдентификатор сессии (транзакции)
    /filter1..1 Контейнер условий поиска.
    Хотя бы один параметр для поиска должен быть заполнен
    /filterIdLpu0..1StringИдентификатор ЛПУ (из справочника "ЛПУ" Интеграционной платформы),
    в которое должна быть осуществлена запись
    /filterIdNsiLpu0..1StringИдентификатор ЛПУ (Значение поля «Code» из справочника с OID 1.2.643.2.69.1.1.1.64)
    куда должна быть осуществлена запись
    /filterFerIdSpeciality0..1StringНоменклатура специальностей специалистов
    с высшим и послевузовским медицинским и фармацевтическим
    образованием в сфере здравоохранения
    (OID 1.2.643.5.1.13.2.1.1.181)
    /filterIdSpeciality0..1StringИдентификатор врачебной специальности в справочнике МИС
    /filterIdDoc0..1StringИдентификатор врача в соответствующем справочнике МИС
    /filterClaim0..1StringПричина постановки в лист ожидания (код из справочника "Причина постановки в лист ожидания (ЖОЗ)" Интеграционной платформы Приложение 6
    /filterIdPar0..1StringИдентификатор заявки на запись к врачу
    /filter/IdPatients0..*StringМассив идентификаторов пациентов в ЛПУ
    из соответствующего справочника МИС
    /IdPatientsstring1..1StringЗначение идентификатора

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

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

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

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

    Таблица 57 - Описание выходных данных метода SearchActivePARequest
    Контейнер Выходные данные Тип Описание Возможные значения
    /SearchActivePARequestsResult   
    /SearchActivePARequestsResultIdHistoryIntИдентификатор сессии (транзакции) 
    /SearchActivePARequestsResultSuccessBooleanРезультат выполнения запросаTrue; False
    /SearchActivePARequestsResultCountInt  
    /SearchActivePARequestsResult/ActivePARequests/
    ActivePARequestInfo
    XML-объектОбъект типа ActivePARequestInfo 
    /ActivePARequestInfoCreatedDateDateTimeДата создания заявки ЖОЗ 
    /ActivePARequestInfoIdParStringИдентификатор заявки ЖОЗ 
    /ActivePARequestInfo/PARequest Контейнер параметров заявки 
    /PARequestFerIdSpecialityStringНоменклатура специальностей специалистов
    с высшим и послевузовским медицинским и фармацевтическим
    образованием в сфере здравоохранения (OID 1.2.643.5.1.13.2.1.1.181)
     
    /PARequestIdDocStringИдентификатор врача в соответствующем справочнике МИС 
    /PARequestIdLpuStringИдентификатор ЛПУ (из справочника "ЛПУ" Интеграционной платформы),
    в которое должна быть осуществлена запись
     
    /PARequestIdNsiLpuStringИдентификатор ЛПУ (Значение поля «Code» из справочника с OID 1.2.643.2.69.1.1.1.64)
    куда должна быть осуществлена запись
     
    /PARequestIdSpecialityStringИдентификатор врачебной специальности в справочнике МИС 
    /PARequestNameDocStringФИО врача в соответствующем справочнике МИС,
    ожидается в паре с идентификатором врача
    в соответствующем справочнике МИС
      
    /PARequestNameSpecialityStringНаименование врачебной специальности в справочнике МИС 
    /ActivePARequestInfo/PARequestInfo Контейнер причин 
    /PARequestInfoClaimStringПричина постановки в лист ожидания (код из справочника "Причина постановки в лист ожидания (ЖОЗ)" Интеграционной платформы Приложение 6
    /PARequestInfoInfoStringПричина посещения врача, краткое описание симптомов и диагноза если известны 
    /ActivePARequestInfo/PARequestPatient Контейнер сведений о пациенте 
    /PARequestPatientBirthDateDateTimeДата рождения пациента 
    /PARequestPatientFirstNameStringИмя пациента 
    /PARequestPatientIdPatientStringИдентификатор пациента из соответствующего справочника МИС 
    /PARequestPatientLastNameStringФамилия пациента 
    /PARequestPatientMiddleNameStringОтчество пациента 
    /PARequestPatient/PARequestPatientContacts Контейнер контактной информации пациента 
    /PARequestPatientContactsAdditionalInformationStringДополнительная информация о контактах 
    /PARequestPatientContactsEmailStringАдрес электронной почты 
    /PARequestPatientContactsPhoneStringНомер телефона (для уведомления о назначенном времени приема)
    (в формате +7(xxx)xxx-xx-xx или 8(xxx)xxxxxxx)
     
    /ActivePARequestInfoPASourceCreatedInt Источник создания заявки ЖОЗ (код из справочника «Источники заявки ЖОЗ» Интеграционной платформы) Приложение 10  
    /ActivePARequestInfo/PreferredIntervals/PARequestInterval Контейнер интервалов удобного пациенту времени посещения 
    /PARequestIntervalStartDateDateTimeНачало интервала 
    /PARequestIntervalEndDateDateTimeОкончание интервала 
    /SearchActivePARequestsResult/ErrorList/Error   
    /ErrorErrorDescriptionStringТекстовое описание ошибкиКоды ошибок
    /ErrorIdErrorIntИдентификатор ошибки в справочникеКоды ошибок

    Запрос

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

    Ответ

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

    Поиск заявок ЖОЗ пациента (SearchPARequests)

    Данный метод предназначен для поиска заявок на прием к врачу в журнале отложенной записи (ЖОЗ) для пациента.

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

    Структура запроса SearchPARequests представлена на Рисунке 71

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

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

    Таблица 58 – Описание параметров запроса метода SearchPARequests
    Контейнер Параметры Обязательность/ кратность Тип Описание
    Root   
    guid1..1GUIDАвторизационный токен 
    idHistory0..1IntИдентификатор сессии (транзакции) 
    /filter1..* Контейнер условий поиска
    /filterIdPar StringИдентификатор заявки ЖОЗ
    /filter/IdInfos/IdInfo0..* Массив идентификаторов пациентов из соответствующего справочника МИС
    /IdInfo IdLpu 1..1StringИдентификатор ЛПУ (из справочника "ЛПУ" Интеграционной платформы),
    в которое должна быть осуществлена запись
    /IdInfo IdPatient1..1StringИдентификатор пациента в ЛПУ из соответствующего справочника МИС

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

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

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

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

    Таблица 59 - Описание выходных данных метода SearchPARequests
    Контейнер Выходные данные Тип Описание Возможные значения
    /SearchPARequestsResult   
    /SearchPARequestsResultIdHistoryIntИдентификатор сессии (транзакции) 
    /SearchPARequestsResultSuccessBooleanРезультат выполнения запросаTrue; False
    /SearchPARequestsResultCountIntКоличество найденных по параметрам поиска заявок ЖОЗ 
    /SearchPARequestsResult/PARequests/SearchPARequestInfo Контейнер заявок ЖОЗ 
    /SearchPARequestInfoCreatedDateDateTimeДата создания заявки 
    /SearchPARequestInfoIdParStringИдентификатор заявки ЖОЗ 
    /SearchPARequestInfo/PARequest Контейнер параметров заявки 
    /PARequestFerIdSpecialityStringНоменклатура специальностей специалистов
    с высшим и послевузовским медицинским и фармацевтическим
    образованием в сфере здравоохранения (OID 1.2.643.5.1.13.2.1.1.181)
     
    /PARequestIdDocStringИдентификатор врача в соответствующем справочнике МИС 
    /PARequestIdLpuStringИдентификатор ЛПУ (из справочника "ЛПУ" Интеграционной платформы),
    в которое должна быть осуществлена запись
     
    /PARequestIdNsiLpuStringИдентификатор ЛПУ (Значение поля «Code» из справочника с OID 1.2.643.2.69.1.1.1.64)
    куда должна быть осуществлена запись
     
    /PARequestIdSpecialityStringИдентификатор врачебной специальности в справочнике МИС 
    /PARequestNameDocStringФИО врача в соответствующем справочнике МИС,
    ожидается в паре с идентификатором врача
    соответствующем справочнике МИС
     
    /PARequestNameSpecialityStringНаименование врачебной специальности в справочнике МИС 
    /SearchPARequestInfo/PARequestInfo Контейнер причин 
    /PARequestInfoClaimStringПричина постановки в лист ожидания (код из справочника "Причина постановки в лист ожидания (ЖОЗ)" Интеграционной платформы Приложение 6
    /PARequestInfoInfoStringПричина посещения врача, краткое описание
    симптомов и диагноза если известны
     
    /SearchPARequestInfo/PARequestPatient Контейнер сведений о пациенте 
    /PARequestPatientBirthDateDateTimeДата рождения пациента 
    /PARequestPatientFirstNameStringИмя пациента 
    /PARequestPatientIdPatientStringИдентификатор пациента из соответствующего справочника МИС 
    /PARequestPatientLastNameStringФамилия пациента 
    /PARequestPatientMiddleNameStringОтчество пациента 
    /PARequestPatient/PARequestPatientContacts Контейнер контактной информации пациента 
    /PARequestPatientContactsAdditionalInformationStringДополнительная информация о контактах 
    /PARequestPatientContactsEmailStringАдрес электронной почты (для автоматизации уведомлений пациента) 
    /PARequestPatientContactsPhoneStringНомер телефона (для уведомления о назначенном времени приема)
    (в формате +7(xxx)xxx-xx-xx или 8(xxx)xxxxxxx)
     
    /SearchPARequestInfoPASourceCreatedInt Источник создания заявки ЖОЗ (код из справочника «Источники заявки ЖОЗ» Интеграционной платформы) Приложение 10  
    /SearchPARequestInfo/PreferredIntervals/PARequestInterval Контейнер интервалов удобного пациенту времени посещения 
    /PARequestIntervalStartDateStringНачало интервала 
    /PARequestIntervalEndDateStringОкончание интервала 
    /SearchPARequestInfo/PARequestDeactivationInfo Контейнер сведений о деактивации заявки 
    /PARequestDeactivationInfoDeactivationCommentStringКомментарий отмены заявки 
    /PARequestDeactivationInfoDeactivationDateDateTimeДата деактивации заявки 
    /PARequestDeactivationInfoDeactivationReasonInt Повод отмены записи
    (из справочника "Поводы отмены заявки в ЖОЗ" Интеграционной платформы) Приложение 9
    /PARequestDeactivationInfoLinkedIdParStringИдентификатор связанной заявки
    (для случая, когда запись на прием была оформлена на другой код площадки или другую МО)
     
    /PARequestDeactivationInfoPASourceDeactivatedInt Источник деактивации заявки ЖОЗ
    (код из справочника «Источники заявки ЖОЗ» Интеграционной платформы Приложение 10
    /SearchPARequestInfoPARequestStatusIntСтатус заявкиЗначение «1»
    заявка активна;
    Значение «2»
    по заявке совершена запись на прием;
    Значение «3»
    заявка отменена
    /SearchPARequestsResult/ErrorList/Error   
    /ErrorErrorDescriptionStringТекстовое описание ошибкиКоды ошибок
    /ErrorIdErrorIntИдентификатор ошибки в справочникеКоды ошибок

    Запрос

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

    Ответ

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

    Поиск заявок ЖОЗ пациента для АРМ ЦТО (SearchCtoPARequests)

    Данный метод предназначен для поиска заявок на прием к врачу в журнале отложенной записи (ЖОЗ) по параметрам для целей АРМ ЦТО и не предназначен для вызова иными клиентами СЗнП. При обработке метода заполненные параметры рассматриваются как совокупность условий поиска соединенных функцией «Логическое И». Исключением является работа с заданным параметром IdPatient - при заданном параметре данные указанные в параметрах: PatientLastName, PatientFirstName, PatientMiddleName и PatientBirthday – игнорируются. Выполнение поиска параметров по принципу «подстроки в строке» производится при указании знака %, в игнорируемой части (частях).

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

    Структура запроса SearchCtoPARequests представлена на Рисунке 73

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

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

    Таблица 60 – Описание параметров запроса метода SearchCtoPARequests
    Контейнер Параметры Обязательность/ кратность Тип Описание
    Root   
    /guid1..1GUIDАвторизационный токен 
    /idHistory0..1IntИдентификатор сессии (транзакции)
    /filter1..* Контейнер условий поиска
    /filterFerIdSpeciality0..1StringНоменклатура специальностей специалистов
    с высшим и послевузовским медицинским и фармацевтическим образованием
    в сфере здравоохранения (OID 1.2.643.5.1.13.2.1.1.181)
    /filterIdDoctor0..1StringИдентификатор врача в соответствующем справочнике МИС
    /filterIdLpu0..1StringИдентификатор ЛПУ (из справочника "ЛПУ" Интеграционной платформы),
    в которое осуществляется запись
    /filterIdPatient0..1StringИдентификатор пациента из соответствующего справочника МИС
    /filterIdSpeciality0..1StringИдентификатор врачебной специальности в справочнике МИС
    /filterIntervalStart0..1DateTimeНачало интервала
    /filterIntervalEnd0..1DateTimeОкончание интервала
    /filterPatientBirthday0..1DateTimeДата рождения пациента
    /filterPatientFirstName0..1StringИмя пациента
    /filterPatientLastName0..1StringФамилия пациента
    /filterPatientMiddleName0..1StringОтчество пациента

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

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

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

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

    Таблица 60 - Описание выходных данных метода SearchCtoPARequests
    Контейнер Выходные данные Тип Описание Возможные значения
    /SearchCtoPARequestsResult   
    /SearchCtoPARequestResultIdHistoryIntИдентификатор сессии (транзакции) 
    /SearchCtoPARequestResultSuccessBooleanРезультат выполнения запросаTrue; False
    /SearchCtoPARequestResultCountInt  
    /SearchCtoPARequestsResult/PARequests/SearchPARequestInfo Контейнер активных заявок ЖОЗ 
    /SearchPARequestInfoCreatedDateDateTime  
    /SearchPARequestInfoIdParStringИдентификатор заявки ЖОЗ 
    /SearchPARequestInfo/PARequest Контейнер параметров заявки 
    /PARequestFerIdSpecialityStringНоменклатура специальностей специалистов
    с высшим и послевузовским медицинским и фармацевтическим
    образованием в сфере здравоохранения (OID 1.2.643.5.1.13.2.1.1.181)
     
    /PARequestIdDocStringИдентификатор врача в соответствующем справочнике МИС 
    /PARequestIdLpuStringИдентификатор ЛПУ (из справочника "ЛПУ" Интеграционной платформы),
    в которое должна быть осуществлена запись
     
    /PARequestIdNsiLpuStringИдентификатор ЛПУ (Значение поля «Code» из справочника с OID 1.2.643.2.69.1.1.1.64)
    куда должна быть осуществлена запись
     
    /PARequestIdSpecialityStringИдентификатор врачебной специальности в справочнике МИС 
    /PARequestNameDocStringФИО врача в соответствующем справочнике МИС,
    ожидается в паре с идентификатором врача в соответствующем справочнике МИС
     
    /PARequestNameSpecialityStringНаименование врачебной специальности в справочнике МИС 
    /SearchPARequestInfo/PARequestInfo Контейнер причин 
    /PARequestInfoClaimStringПричина постановки в лист ожидания (код из справочника "Причина постановки в лист ожидания (ЖОЗ)" Интеграционной платформы Приложение 6
    /PARequestInfoInfoStringПричина посещения врача, краткое описание
    симптомов и диагноза если известны
     
    /SearchPARequestInfo/PARequestPatient Контейнер сведений о пациенте 
    /PARequestPatientBirthDateDateTimeДата рождения пациента 
    /PARequestPatientFirstNameStringИмя пациента 
    /PARequestPatientIdPatientStringИдентификатор пациента из соответствующего справочника МИС 
    /PARequestPatientLastNameStringФамилия пациента 
    /PARequestPatientMiddleNameStringОтчество пациента 
    /PARequestPatient/PARequestPatientContacts Контейнер контактной информации пациента 
    /PARequestPatientContactsAdditionalInformationString  
    /PARequestPatientContactsEmailStringАдрес электронной почты 
    /PARequestPatientContactsPhoneStringНомер телефона (для уведомления о назначенном времени приема)
    (в формате +7(xxx)xxx-xx-xx или 8(xxx)xxxxxxx)
     
    /SearchPARequestInfoPASourceCreatedInt Источник создания заявки ЖОЗ (код из справочника «Источники заявки ЖОЗ» Интеграционной платформы) Приложение 10  
    /SearchPARequestInfo/PreferredIntervals/PARequestInterval   
    /PARequestIntervalStartDateStringНачало интервала 
    /PARequestIntervalEndDateStringОкончание интервала 
    /SearchPARequestInfo/PARequestDeactivationInfo   
    /PARequestDeactivationInfoDeactivationCommentStringКомментарий отмены заявки 
    /PARequestDeactivationInfoDeactivationDateDateTime  
    /PARequestDeactivationInfoDeactivationReasonInt Повод отмены записи (код из справочника "Поводы отмены заявки в ЖОЗ" Интеграционной платформы) Приложение 9
    /PARequestDeactivationInfoLinkedIdParString  
    /PARequestDeactivationInfoPASourceDeactivatedInt Источник деактивации заявки ЖОЗ
    (код из справочника «Источники заявки ЖОЗ» Интеграционной платформы Приложение 10
    /SearchPARequestInfoPARequestStatusInt  
    /SearchCtoPARequestsResult/ErrorList/Error   
    /ErrorErrorDescriptionStringТекстовое описание ошибкиКоды ошибок
    /ErrorIdErrorIntИдентификатор ошибки в справочникеКоды ошибок

    Запрос

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

    Ответ

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



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

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

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

    Структура запроса GetPositionList представлена на Рисунке 75

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

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

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

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

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

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

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

    Таблица 62 - Описание выходных данных метода GetPositionList
    Контейнер Выходные данные Обязательность/Кратность Тип Описание Возможные значения
    /GetPositionListResult
    /GetPositionListResult IdHistory 0..1 Int Идентификатор сессии (транзакции)
    /GetPositionListResult Success 1..1 Boolean Результат выполнения запроса True; False
    /GetPositionListResult Comment 0..1 String Комментарий Дополнительная информация для пациента по оформлению записи; до 50 символов
    /GetPositionListResult/ErrorList/Error 0..*
    /Error ErrorDescription 1..1 String Текстовое описание ошибки Описание ошибок – см. Коды ошибок
    /Error IdError 1..1 Int Идентификатор ошибки в справочнике> Описание ошибок – см. Коды ошибок
    /GetPositionListResult/ListPosition/Position 0..*
    /Position Comment 0..1 String Комментарий Дополнительная информация о врачебной должности (до 50 символов)
    /Position CountFreeParticipantIE 0..1 Int Количество доступных участнику информационного обмена для записи талонов по врачебной должности
    /Position CountFreeTicket 0..1 Int Общее количество свободных талонов по врачебной должности
    /Position FedIdPosition 1..1 String Идентификатор врачебной должности в федеральном справочнике должностей Должно соответствовать коду должности из справочника
    ФНСИ 1.2.643.5.1.13.13.11.1102 «ФРМР. Должности медицинского персонала»,
    расположенной в папках:
  • «Должности работников медицинских организаций» ->
    «Должности медицинских работников» ->
    «Должности специалистов с высшим профессиональным (медицинским) образованием (врачи)»
    -> «врачи-специалисты»
  • «Должности работников медицинских организаций» ->
    «Должности медицинских работников» ->
    «Должности специалистов со средним профессиональным (медицинским)
    образованием (средний медицинский персонал)»

  • Пример: 13
    /Position IdPosition 1..1 String Идентификатор врачебной должности Значение идентификатора врачебной должности из соответствующего справочника целевой МИС
    /Position LastDate 0..1 Datetime Дата приема по последнему свободному талону врачебной должности
    /Position NamePosition 1..1 String Наименование врачебной должности Наименование врачебной должности из соответствующего справочника целевой МИС
    /Position NearestDate 0..1 Datetime Дата приема по ближайшему свободному талону врачебной должности

    Запрос

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

    Ответ

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



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

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

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

    Структура запроса GetDoctorList2 представлена на Рисунке 78

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

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

    Таблица 63 - Описание параметров запроса метода GetDoctorList2
    Контейнер Параметры Условие Обязательность/Кратность Тип Описание
    Root
    / idLpu 1..1 String Идентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы
    / idPat 1..1> String Идентификатор пациента из соответствующего справочника целевой МИС
    / idPosition 0..1 Если в запросе указывается параметр idPosition,
    параметр fedIdPosition в запросе передаваться не должен
    String Идентификатор врачебной должности в справочнике целевой МИС
    / fedIdPosition 0..1 Если в запросе указывается параметр fedIdPosition,
    параметр idPosition в запросе передаваться не должен
    String Идентификатор врачебной должности в федеральном
    справочнике должностей (ФРМР. Должности медицинского персонала (OID 1.2.643.5.1.13.13.11.1102))
    Должно соответствовать коду должности,
    расположенной в папках:
  • «Должности работников медицинских организаций» -> «Должности медицинских работников» -> «Должности специалистов с высшим профессиональным (медицинским) образованием (врачи) » ->
    «врачи-специалисты»
  • «Должности работников медицинских организаций» -> «Должности медицинских работников» -> «Должности специалистов со средним профессиональным (медицинским) образованием (средний медицинский персонал)»

  • Пример: 13
    / guid 1..1 GUID Авторизационный токен
    / idHistory 0..1 Int Идентификатор сессии (транзакции)

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

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

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

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

    Таблица 64 - Описание выходных данных метода GetDoctorList2
    Контейнер Выходные данные Обязательность/Кратность Тип Описание Возможные значения
    /GetDoctorList2Result
    /GetDoctorList2Result IdHistory 0..1 Int Идентификатор сессии (транзакции)
    /GetDoctorList2Result Success 1..1 Boolean Результат выполнения запроса True; False
    /GetDoctorList2Result Comment 0..1 String Комментарий Дополнительная информация для пациента по оформлению записи; до 50 символов
    /GetDoctorList2Result/ErrorList/Error 0..*
    /Error ErrorDescription 1..1 String Текстовое описание ошибки Описание ошибок – см. Коды ошибок
    /Error IdError 1..1 Int Идентификатор ошибки в справочнике Описание ошибок – см. Коды ошибок
    /GetDoctorList2Result/Docs/ Doctor3 0..*
    /Doctor3 Area 0..1 String Полное наименование врачебного участка
    (включая номер врачебного участка и
    необходимые дополнительные указания и комментарии)
    /Doctor3 AreaType 0..1 String Вид врачебного участка Указывается одно значение из следующих возможных:
  • Фельдшерский
  • Терапевтический
  • Врача общей практики (семейного врача)
  • Комплексный
  • Акушерский
  • Приписной
  • Педиатрический
  • Фтизиатрический
  • /Doctor3 Comment 0..1 String Комментарий Дополнительная информация о враче
    (например, информация о причинах
    и сроках отсутствия приема врача);
    до 50 символов
    /Doctor3 CountFreeParticipantIE 0..1 Int Количество доступных участнику информационного обмена талонов для записи к врачу
    /Doctor3 CountFreeTicket 0..1 Int Общее количество свободных талонов к врачу
    /Doctor3 IdDoc 1..1 String Идентификатор врача в справочнике Значение идентификатора врача из соответствующего справочника целевой МИС
    /Doctor3 LastDate 0..1 Datetime Дата приема по последнему свободному талону к врачу
    /Doctor3 Name 1..1 String ФИО врача (полностью) ФИО врача из соответствующего справочника целевой МИС
    /Doctor3 NearestDate 0..1 Datetime Дата приема по ближайшему свободному талону к врачу
    /Doctor3 Snils 0..1 String СНИЛС врача СНИЛС врача из соответствующего справочника целевой МИС (формат передачи: «XXXXXXXXXXX»)

    Запрос

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

    Ответ

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



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

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

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

    Структура запроса GetAvailableAppointmentsInfo представлена на Рисунке 80

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

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

    Таблица 64 - Описание параметров запроса метода ValidateMedicalExamination
    Контейнер Параметры Условие Обязательность/Кратность Тип Описание
    Root
    / idLpu 1..1 String При обращении клиента сервиса к СЗнП необходимо
    передавать идентификатор МО из справочника с OID 1.2.643.2.69.1.1.1.64.
    При передаче запроса от СЗнП к поставщику данных (владельцу талонов)
    значение заменяется на идентификатор ЛПУ из
    справочника «ЛПУ» Интеграционной платформы
    / guid 1..1 GUID Авторизационный токен
    / idHistory 0..1 Int Идентификатор сессии (транзакции)
    /patient 0..1 Данные пациента
    /patient AriaNumber 0..1 String Номер врачебного участка
    /patient Birthday 0..1 datetime Дата рождения
    /patient CellPhone 0..1 String Номер мобильного телефона (формат передачи: «XXXXXXXXXX» – 10 знаков без разделителей)
    /patient Document_N 0..1 String Номер документа
    /patient Document_S 0..1 String Серия документа
    /patient HomePhone 0..1 String Номер домашнего телефона (формат передачи: «XXXXXXX» – 7 знаков без разделителей)
    /patient IdPat 0..1 String Идентификатор пациента из соответствующего справочника целевой МИС
    /patient Name 0..1 String Имя пациента
    /patient Polis_N 0..1 String Номер полиса ОМС
    /patient Polis_S 0..1 String Серия полиса ОМС
    /patient SecondName 0..1 String Отчество пациента
    /patient Snils 0..1 String СНИЛС пациента (формат передачи: «XXX-XXX-XXX YY»)
    /patient Surname 0..1 String Фамилия пациента
    /info 0..1 Данные направления
    /info MkbCode 0..1 String Код заболевания. Значение в соответствии с МКБ-10. OID справочника: 1.2.643.2.69.1.1.1.2
    /info Priority 0..1 String Комментарий о приоритете и состоянии пациента
    /info PrivilegeType 0..1 String Код льготы пациента. OID справочника: 1.2.643.2.69.1.1.1.7
    /info ProfileMedService 1..1 String Идентификатор составного профиля помощи. OID справочника: 1.2.643.2.69.1.1.1.56
    /info Reason 0..1 String Основание направления, цель направления пациента
    /info SourceLPU 1..1 String Идентификатор МО, направляющей пациента. OID справочника: 1.2.643.2.69.1.1.1.64
    /info SurveyOrgan 0..1 String Идентификатор области исследования. OID справочника: 1.2.643.2.69.1.1.1.58
    /info SurveyType 0..1 String Идентификатор вида исследования. OID справочника: 1.2.643.2.69.1.1.1.57

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

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

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

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

    Таблица 65 - Описание выходных данных метода GetAvailableAppointmentsInfo
    Контейнер Выходные данные Обязательность/Кратность Тип Описание Возможные значения
    /GetAvailableAppointmentsInfoResult
    /GetAvailableAppointmentsInfoResult IdHistory 0..1 Int Идентификатор сессии (транзакции)
    /GetAvailableAppointmentsInfoResult Success 1..1 Boolean Результат выполнения запроса True; False
    /GetAvailableAppointmentsInfoResult IdLpu 1..1 Int Идентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы
    /GetAvailableAppointmentsInfoResult IdPat 1..1 String Идентификатор пациента в МИС ЛПУ Значение идентификатора пациента из соответствующего справочника целевой МИС
    /GetAvailableAppointmentsInfoResult/ErrorList/Error 0..*
    /Error ErrorDescription 1..1 String Текстовое описание ошибки Описание ошибок – см. Коды ошибок
    /Error IdError 1..1 Int Идентификатор ошибки в справочнике Описание ошибок – см. Коды ошибок
    /GetAvailableAppointmentsInfoResult/
    ListSpeсiality/Speсiality2
    0..* Указывается информация о специальности
    /Speсiality2 FerIdSpeciality 1..1 String Идентификатор врачебной специальности в федеральном справочнике специальностей Номенклатура специальностей специалистов с высшим и послевузовским медицинским и фармацевтическим образованием в сфере здравоохранения (OID 1.2.643.5.1.13.2.1.1.181)
    /Speсiality2 IdSpeciality 1..1 String Идентификатор врачебной специальности Значение идентификатора врачебной специальности из соответствующего справочника целевой МИС
    /Speсiality2 NameSpeciality 1..1 String Наименование врачебной специальности Наименование врачебной специальности из соответствующего справочника целевой МИС
    /Speсiality2 Description 0..1 String Комментарий Указывается важная информация для осуществления записи на прием к врачам данной специальности
    /GetAvailableAppointmentsInfoResult/ListSpeсiality
    /Speсiality2/ListDoctor/Doctor2
    0..* Указывается информация о враче
    /Doctor2 IdDoc 1..1 String Идентификатор врача в справочнике Значение идентификатора врача из соответствующего справочника целевой МИС
    /Doctor2 Name 1..1 String ФИО врача (полностью) ФИО врача из соответствующего справочника целевой МИС
    /Doctor2 Description 0..1 String Комментарий Указывается важная информация для осуществления записи на прием к данному врачу
    /Doctor2 Snils 1..1 String СНИЛС врача СНИЛС врача из соответствующего справочника целевой МИС (формат передачи: «XXX-XXX-XXX YY»)
    /GetAvailableAppointmentsInfoResult/ListSpeсiality
    /Speсiality2/ListDoctor/Doctor2/ListAppointment
    /Appointment
    0..* Указывается информация о талоне (свободном временном интервале)
    /Appointment Address 0..1 String Адрес приема врача Указывается адрес приема врача (место оказания услуги) в случае, если данный адрес отличается от адреса МО/подразделения МО
    /Appointment IdAppointment 1..1 String Идентификатор талона для записи Значение идентификатора талона на прием из соответствующего справочника целевой МИС
    /Appointment Num 0..1 Int Номер талона в очереди
    /Appointment Room 0..1 String Номер кабинета Номер кабинета, где будет производиться врачебный прием
    /Appointment VisitStart 1..1 Datetime Дата и время начала приема Значение в формате: YYYY-MM-DDHH:MM:SS.MsMsMs
    /Appointment VisitEnd 1..1 Datetime Дата и время окончания приема Значение в формате: YYYY-MM-DDHH:MM:SS.MsMsMs

    Запрос

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

    Ответ

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



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

    Идентификатор ошибки Текст ошибки
    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} не найдена среди активных заявок
    99 Текст ответа МИС – в случае необходимости передачи определенной информации клиенту сервиса, инициирующему запрос метода
    Type
    консультация
    повторный
    LpuType TypeName
    1 амбулатория
    2 стоматология
    3 онкология
    4 травматология
    5 КВД
    6 женская консультация
    7 ПНД
    8 ПТД
    9 роддом
    10 стационар
    Type
    отсутстствует_неопределенно
    широкого_профиля
    узкий
    UserPosition
    отсутстствует_неопределенно
    медрегистратор
    оператор
    врач
    портал
    инфомат
    система
    ЛПУ
    ЕПГУ
    Код ClaimToWaitingListType
    1 отсутствуют_свободные_талоны
    2 нет_удобного_времени
    3 отсутствует_специалист
    № п/п Значение справочника Описание (трактовка использования значений в методе
    «Уведомление о произведенной записи на прием
    (SendNotificationAboutAppointment)»)
    1 ЦТО Запись на прием оформлена через ЦТО (без использования методов Сервиса «Запись на прием»)
    2 Инфомат Запись на прием оформлена через Информационные терминалы (без использования методов
    Сервиса «Запись на прием»)
    3 Регистратура Запись на прием оформлена через Регистратуру МИС (без использования методов Сервиса «Запись на прием»)
    4 Врач_АПУ Запись на прием оформлена через АРМ Врача (без использования методов Сервиса «Запись на прием»)
    5 Интернет Запись на прием оформлена через Интернет-порталы, мобильные приложения и т.п. (без использования методов Сервиса «Запись на прием»)
    6 Прочее Запись на прием оформлена через источники записи, использующие методы Сервиса «Запись на прием»

    ! В случае использования данного значения в запросе SendNotificationAboutAppointment, обязателен для передачи параметр member в запросе SendNotificationAboutAppointment

    № п/п Значение справочника Описание
    1 запись_отменена_по_инициативе_ЛПУ Запись отменена по инициативе ЛПУ
    2 запись_отменена_по_инициативе_пациента Запись отменена по инициативе пациента
    3 запись_перенесена Запись перенесена
    4 посещение_состоялось Посещение состоялось
    5 пациент_не_явился Пациент не явился
    Код Наименование
    1 По инициативе пациента
    2 Не удалось связаться с пациентом по предоставленным контактам
    3 Нет специалиста в МО
    4 Реализована запись в другую МО
    5 Услуга оказана до обработки заявки
    Код Описание
    1 ЦТО
    2 Инфомат
    3 Регистратура
    4 АРМ врача
    5 Интернет
    6 Прочее