Получение расписания за промежуток дней

Метод, возвращающий расписание за промежуток дней.

Запрос

Адрес запроса

№1 . Получить расписание за промежуток дней по специальности

GET: {{url}}lpu/{{lpu}}/speciality/{specId}/schedule/{{dateFrom}}/{{dateTo}}

№2 . Получить расписание за промежуток дней по врачу

GET: {{url}}lpu/{{lpu}}/doctor/{{doctorGuid}}/schedule/{{dateFrom}}/{{dateTo}}

Заголовки запроса (определение прав по клиенту)

Заголовок	Значение (тип/формат значения)	Описание	Обязательный	Комментарий
Authorization	Bearer {codToken} (без скобок и через пробел после Bearer)	COD токен, полученный с помощью сервиса авторизации	-	Используется для фильтрации специальностей и ресурсов по полу/возрасту пациента и для получение прав доступа к ячейкам из клиентского приложения
Authorization	Bearer {lpuToken} (без скобок и через пробел после Bearer)	LPU токен, полученный с помощью сервиса авторизации

Параметры запроса

Параметр	Описание	По умолчанию	Обязательный
lpu	Гуид ЛПУ	-	+
specId	Id специальности	-	+
doctorGuid	Гуид врача	-	+
dateFrom	Дата начала поиска расписания	-	+
dateTo	Дата конца поиска расписания	-	+

Дополнительные параметры:

Наименование	Тип данных	Описание	Комментарий	Значение по умолчанию
lpuGuid	string	Гуид ЛПУ
mcod	string	МКОД ЛПУ
hostId	int	Идентификатор хоста	Будут возвращены все врачи, в рамках указанного хоста (одной бд или одной внешней МИС)
intime	bool	Признак приёма врачом по расписанию		true
restype	string	Тип ресурса	Возможные значения: doctor - врач room - кабинет equipment - оборудование all - все Может быть указано несколько значений: restype=doctor&restype=room
speciality	string	Код специальности	Может быть указано несколько значений
position	string	Код должности
dateFrom	string	Начало периода расписания (дата)		Текущая дата
dateTo	string	Конец периода расписания (дата)
timeFrom	string	Начало периода расписания (время)
timeTo	string	Конец периода расписания (время)
emulateDayOff	bool	Эмулировать неприемные дни в расписании		true
examGuid	string	Гуид мероприятия диспансеризации
serviceGuid	string	Гуид услуги диспансеризации
haveSchedule	bool	Только с расписанием	при включённом параметре в выборку не попадут талоны, недоступные клиенту по правам доступа Описание прав клиентов. Права записи. Права расписания	false
directionType	string	Тип направления		Должны передаваться только вместе
nomServiceCode	string	Код мероприятия по направлению		Должны передаваться только вместе
byDir	bool	Признак записи по направлению	Автоматически проставляется если переданы параметры directionType и nomServiceCode. При byDir = true в счётчике талонов учитываются ячейки с типом Диагностика.
flac	int	Права записи	Позволяет производить расчёт счётчиков расписания в завимисости от прав доступа. Может быть указан явно, может быть проставлен в соответствии с правами пользователя из токена	4 (Интернет)
dismissal	bool	Вывести уволенных врачей		false
special	bool	Фильтр по признаку "Узкий специалист"	По умолчанию выводятся все ресурсы по данному признаку. Фильтр позволяет показывать только узких или только общих специалистов.
busyType	string	Фильтр по типам занятости	По умолчанию выводятся все типы, кроме "Прием на дому. Вызов на дом". Может быть указано несколько значений
guid	string	Идентификатор конкретного ресурса

Ответ сервера метода №1

В случае успешного выполнения сервер вернет ответ в формате JSON со следующими данными:

Модель: Ресурс с расписанием за неделю(Краткий) - ShortResourceWeekly

Модель ресурса(врача) с расписанием сгруппированным по дням за неделю

Описание полей

Название	Тип данных	Описание	Комментарий
DocFio	string	Название ресурса	В зависимости от тип ресурса принимает разные значения: Врач - ФИО полностью Кабинет - "Кабинет {{Номер}} (Этаж {{Этаж}})" Оборудование - "Оборудование {{Название оборудования}}
Description	string	Описание ресурса	API-829 - Получение подробных данных проблемы... СТАТУС
DocGuid	string(Guid)	Гуид ресурса
LastModified	string(DateTime)	Время последнего обновления данных в оперативном хранилище
Snils	string	СНИЛС сотрудника	Отсутствует, если не заполнен и если у ресурса не привязан сотрудник
DoctorRole	string	Название должности
Department	string	Название отделения
Type	int	Код типа ресурса (1 - Врач, 2 - Кабинет, 3 - Оборудование)	API-885 - Получение подробных данных проблемы... СТАТУС
TypeName	string	Наименование типа ресурса	API-885 - Получение подробных данных проблемы... СТАТУС
Room	string	Номер кабинета
RoomComment	string	Комментарий к кабинету
Uchastok	string	Название участка	Если есть. Берется название первого незакрытого участка, в котором указан ресурс.
UchastokCode	string	Номер(код) участка	API-825 - Получение подробных данных проблемы... СТАТУС
Rating	string	Значение рейтинга
VoteCount	int	Количество оценок
ClosestEntry	ClosestEntry	Ближайшая ячейка доступная для записи
Schedule	Array of WeeklySchedule	Список расписания	Расписание за неделю
isWaitingList	bool	Признак возможности записи в лист ожидания
UchastokList	Array of UchastokShort	Массив участков ресурса(врача)

ClosestEntry

Название	Тип данных	Описание	Комментарий
TimeTableGuid	string(Guid)	Гуид ячейки
BeginTime	string(DateTime)	Время начала приема

Пример модели в формате JSON

{
  "docFio": "Диспансеризатов Диспар Диспартович",
  "description": "Описание",
  "docGuid": "f05d7650-a2a0-49dc-99f1-bb57829bc46a",
  "lastModified": "2019-06-26T09:51:41+03:00",
  "snils": "982-984-860 02",
  "doctorRole": "Терапевты",
  "department": "Кабинет врача-терапевта",
  "type": 1,
  "typeName": "Врач",
  "room": "202",
  "roomComment": "Какая то строка",
  "uchastok": null,
  "rating": null,
  "voteCount": 0,
  "isWaitingList": true,
  "closestEntry": {
    "timeTableGuid": "02690298-a3e5-4f58-b488-a64e419d5c41",
    "beginTime": "2019-04-10T11:15:00+03:00"
  },
  "schedule": [
    {
      "date": "2019-04-10T00:00:00+03:00",
      "beginTime": "07:00",
      "endTime": "18:00",
      "ticketCount": 44,
      "ticketsCanWrite": 27,
      "busyType": {
        "name": "Диспансеризация",
        "type": 1,
        "code": "206"
      }
    },
    {
      "date": "2019-04-11T00:00:00+03:00",
      "beginTime": "07:00",
      "endTime": "18:00",
      "ticketCount": 44,
      "ticketsCanWrite": 44,
      "busyType": {
        "name": "Диспансеризация",
        "type": 1,
        "code": "206"
      }
    },
    {
      "date": "2019-04-12T00:00:00+03:00",
      "beginTime": "07:00",
      "endTime": "18:00",
      "ticketCount": 44,
      "ticketsCanWrite": 44,
      "busyType": {
        "name": "Диспансеризация",
        "type": 1,
        "code": "206"
      }
    },
    {
      "date": "2019-04-13T00:00:00+03:00",
      "beginTime": "07:00",
      "endTime": "18:00",
      "ticketCount": 43,
      "ticketsCanWrite": 43,
      "busyType": {
        "name": "Диспансеризация",
        "type": 1,
        "code": "206"
      }
    },
    {
      "date": "2019-04-14T00:00:00+03:00",
      "beginTime": "07:00",
      "endTime": "18:00",
      "ticketCount": 44,
      "ticketsCanWrite": 44,
      "busyType": {
        "name": "Диспансеризация",
        "type": 1,
        "code": "206"
      }
    },
    {
      "date": "2019-04-15T00:00:00+03:00",
      "beginTime": "07:00",
      "endTime": "18:00",
      "ticketCount": 44,
      "ticketsCanWrite": 44,
      "busyType": {
        "name": "Диспансеризация",
        "type": 1,
        "code": "206"
      }
    },
    {
      "date": "2019-04-16T00:00:00+03:00",
      "beginTime": "07:00",
      "endTime": "18:00",
      "ticketCount": 44,
      "ticketsCanWrite": 44,
      "busyType": {
        "name": "Диспансеризация",
        "type": 1,
        "code": "206"
      }
    }
  ]
}

Ответ сервера метода №2

В случае успешного выполнения сервер вернет ответ в формате JSON со следующими данными:

Модель: Ячейка расписания(Слот) - ExtendedSlot

Используется в Получить расписание за промежуток дней по врачу и Получение расписания за день

Описание полей

Название	Тип данных	Описание	Комментарий
status	string	Статус доступности	Имеет ограниченный набор значений: Unavailable - Недоступен UnavailableWithMessage - Недоступно с сообщением API-763 - Получение подробных данных проблемы... СТАТУС Available - Доступен Unauthorized - Не хватает прав - Желтые ячейки Expired - Время прошло Booked - Занято
message API-763 - Получение подробных данных проблемы... СТАТУС	string	Сообщение для отображения	Отображается при статусе UnavailableWithMessage
flagAccess	string	Доступ к ячейке	Перечисление способов записи(прав) через запятую. Возможные значения: None - Пусто. Передается в случае отсутствия каких либо прав Registry - регистратура Doctor - Доктор Internet - Интернет/Самозапись DoctorOtherLpu - Врачи других ЛПУ/Сервис Врач-врач
opened	bool	Признак открытия расписания	Ячейка была открыта через механизм Открытия ячеек расписания.
bookingSource	string	Источник с которыми была произведена запись на ячейку	Будет заполнен только в статусе Booked - Занято и будет принимать одно из значений: Internet - Интернет Infomat - Инфомат CallCenter - Колл-центр Doctor - Доктор DoctorOtherLpu - Врачи других ЛПУ/Сервис Врач-врач Registry - Регистратура
bookingDate	string(DateTime)	Дата и время последней записи на ячейку
connectionType	string	Источник полученных записей	Возможные значения: Sql - расписание получено через запрос от сервиса к бд ЛПУ по Sql Http - расписание получено через взаимодействие с удаленным сервисом по http
count	int	Свободные записи	Сколько записей на прием одновременно возможно создать
planCount	int	Запланированная вместимость ячейки	API-801 - Получение подробных данных проблемы... СТАТУС
usedCount	int	Использованные записи ячейки	API-801 - Получение подробных данных проблемы... СТАТУС
guid	string(Guid)	Идентификатор(Гуид) ячейки
beginTime	string	Время начала приема	Формат HH:mm
endTime	string	Время окончания приема	Формат HH:mm
canWrite	bool	Признак доступности записи	Устарел. Оставлен для обратной совместимости. Рекомендуется использовать status
busyType	BusyType	Тип приема
doctorTimeTableID	int	Идентификатор ячейки расписания	hlt_DoctorTimeTable.DoctorTimeTableID

BusyType

Название	Тип данных	Описание
name	string	Название типа приема
type	int	Приемный/не приемный
code	string	Код типа приема
group	BusyTypeGroup	Группа занятости

Пример модели в формате JSON

{
  "status": "Expired",
  "flagAccess": "Registry, Doctor, Internet, DoctorOtherLpu, Infomat, CallCenter",
  "opened": false,
  "bookingSource": null,
  "bookingDate": null,
  "connectionType": "Sql",
  "count": 0,
  "planCount": 1,
  "usedCount": 0,
  "guid": "977c1ed9-cf0d-4f44-9b21-42e1a49269c8",
  "date": "2021-11-15T00:00:00+03:00",
  "beginTime": "05:00",
  "endTime": "05:15",
  "canWrite": false,
  "busyType": {
      "name": "Прием по очереди",
      "type": 1,
      "code": "4",
      "group": null
  }
}
//В задаче https://jira.softrust.ru/browse/API-3082 добавлено новое поле: "doctorTimeTableID":
{
        "status": "Expired",
        "flagAccess": "Registry, Doctor, Internet, DoctorOtherLpu, Infomat, CallCenter",
        "opened": false,
        "bookingSource": null,
        "bookingDate": null,
        "connectionType": "Sql",
        "count": 0,
        "planCount": 1,
        "usedCount": 0,
        "guid": "a94dc9f7-6f68-4ff2-be12-df4955e78ba6",
        "date": "2023-12-21T00:00:00+03:00",
        "beginTime": "21:45",
        "endTime": "22:00",
        "canWrite": false,
        "busyType": {
            "name": "Прием беременных",
            "type": 1,
            "code": "201",
            "group": null
        },
        "doctorTimeTableID": 6822373
    }

Возможные ошибки

В случае возникновения ошибок будет возвращен стандартный ответ сервера;

Дерево страниц

Получение расписания за промежуток дней

Запрос

Адрес запроса

№1 . Получить расписание за промежуток дней по специальности

№2 . Получить расписание за промежуток дней по врачу

Заголовки запроса (определение прав по клиенту)

Параметры запроса

Ответ сервера метода №1

Описание полей

ClosestEntry

Ответ сервера метода №2

Описание полей

BusyType

Возможные ошибки