Позволяет создать запись на прием к врачу. Запись на прием можно создать как по GUID конкретной ячейки расписания, так и по GUID врача и времени записи на прием.
Запрос
Адрес запроса
POST: /api/v2/visit/{lpuGuid} |
Параметры запроса
Параметр | Тип | Описание | Обязательный |
---|---|---|---|
lpuGuid | path | ГУИД ЛПУ, в которой создается запись на прием | + |
timeTable | query | ГУИД ячейки расписания на которую выполняется запись на прием | + (если не указан GUID врача и время приема |
dateTime | query | Дата и время записи на прием | + (если не указан ГУИД ячейки расписания) |
docGuid | query | ГУИД врача, к которому создается запись на прием | + (если не указан ГУИД ячейки расписания) |
directionId | query | Идентификатор направления на прием | - |
directionType | query | Тип направления. Ограниченный набор значений: duvisit - диспансерное наблюдение diagnostic - лабораторное исследование consultation - консультация | - |
query | E-mail пациента (если указан и не совпадает с e-mail, указанным в МКАБ пациента, то будет выполнено обновление e-mail в МКАБ) | - | |
fullResponse | query | Признак полного ответа (true - вернется полная модель ответа/false - вернется модель с заполненными основными полями) | - (по умолчанию true) |
Заголовки запроса
Заголовок | Значение (тип/формат значения) | Описание | Обязательный |
---|---|---|---|
Authorization | Bearer {lpuToken} (без скобок и через пробел после Bearer) | LPU токен, полученный с помощью сервиса авторизации | + |
Ответ сервера
В случае успешного выполнения сервер вернет ответ в формате JSON со следующими данными:
Модель: TicketVisitWithLpu
Содержит следующие поля:
Поле | Тип данных | Описание |
---|---|---|
lpu | ЛПУ со статусом - LpuWithStatus | Характеристики ЛПУ |
num | string | Номер талона |
room | string | Кабинет |
flat | int | Этаж |
busyType | Тип занятости - DocBusyType | Тип приема |
ticketGuid | GUID (string) | Гуид записи на прием |
timeTableGuid | GUID (string) | Гуид ячейки расписания |
docFio | string | Фамилия и инициалы врача |
docGuid | GUID (string) | Гуид врача |
resType | Тип ресурса - ResTypeEnum | Тип ресурса |
doctorRole | string | Должность врача |
speciality | sring | Специальность врача |
beginTime | DateTime (string) | Дата и время начала приема |
endTime | DateTime (string) | Дата и время окончания приема |
dateOfAppointment | DateTime (string) | Дата и время создания записи на прием |
source | int | Код источника записи на прием |
login | string | Логин пользователя, создавшего запись |
sourceName | string | Наименование клиентского приложения |
history | Array of История изменений - DocumentHistory | История изменения документа |
Если параметр запроса fullResponse указан как false, то будут заполнены только следующие поля: Запись на прием к врачу, Запись на прием к врачу, Запись на прием к врачу.
Возможные ошибки
Код ответа сервера | Код сообщения | Сообщение | Тип ошибки |
---|---|---|---|
403 | 5010 | Запрос должен содержать 'Authorization: Bearer ...'" | Error |
403 | 5008 | Токен некорректен | Error |
403 | 5007 | Время действия токена истекло | Error |
403 | 5009 | Подпись запроса некорректна | Error |
400 | 4000 | Не найден МКАБ: {guid} в лпу: {lpu} | Error |
400 | 4033 | directionID и directionType не могут быть указаны отдельно | Error |
400 | 4031 | Направление с таким номером не существует, либо принаджлежит другому пациенту | Error |
400 | 4036 | Время и гуид врача или гуид ячейки расписания не должны быть пустыми | Error |
400 | 4005 | Вы пытаетесь записаться в детское учреждение. Запись пациентов старше 18 лет запрещена. | Validation |
400 | 4007 | Вам запрещена самостоятельная запись на прием через интернет или инфомат. Для записи на прием обратитесь в регистратуру медицинского учреждения лично или по телефону. | Validation |
400 | 4007 | Вы не состоите на диспансерном учете у данного специалиста. Запись невозможна. | Validation |
400 | 4008 | Вы уже записаны {ФИО} на {Время}. Запрещено иметь более одной активной записи на прием на одну специальность. | Validation |
400 | 4029 | Запись недоступна для данной возрастной группы. Сотрудниками МО было установлено ограничение по возрасту при записи на прием. | Validation |
400 | 4009 | Это время уже занято. Выберите другое свободное время приема. | Validation |
В случае возникновения ошибок будет возвращен стандартный ответ сервера;
В случае возникновения ошибок валидации сервер вернет стандартное сообщение валидации.