Позволяет создать запись на прием к врачу. Запись на прием можно создать как по GUID 2 способами:
- По Гуиду конкретной ячейки расписания
...
- (рекомендуется).
- По Гуиду врача и времени записи на прием.
...
Запрос
Адрес запроса
POST: {{url}}/api/v2/visit/{{lpuGuid}} |
Параметры запроса
Параметр | ТипОписаниеОписание | По умолчанию | Обязательный | Комментарий | |||
---|---|---|---|---|---|---|---|
lpuGuid | path | ГУИД Гуид ЛПУ, в которой создается запись на прием | - | + | |||
timeTable | query | ГУИД Гуид ячейки расписания на которую выполняется запись на прием | - | + (если не указан GUID Гуид врача и время приема | |||
dateTime | Дата и время записи на прием формата ГГГГ-мм-ДД ЧЧ:ММ:СС.МММ | - | + (если не указан ГУИД Гуид ячейки расписания) | Например: 2023-04-05 14:00:00.000 | |||
docGuid | query | ГУИД Гуид врача, к которому создается запись на прием | - | + (если не указан ГУИД Гуид ячейки расписания) | |||
directionIdquery | Идентификатор направления на прием | -(устар.) | - | - | Для записи по направлению необходимо использовать этот метод | ||
directionType | query | Тип направления (устар.) | - | - | Ограниченный набор значений:
| -||
query | E-mail пациента (если указан и не совпадает с e-mail, указанным в МКАБ пациента, то будет выполнено обновление e-mail в МКАБ) | - | - | - | При указании обновляется в МКАБе пациента. | ||
email_confirm_agree | Согласие на получение рассылки | - | Принимает значения 0/1, учитывается, только если указан email | ||||
phone | Телефон пациента | - | - | При указании обновляется в МКАБе пациента. | |||
fullResponse | Признак полного ответа | true | - | fullResponse | query | Признак полного ответа (
| /
|
examGuid | Гуид мероприятия диспансеризации | - | -(по умолчанию true) | Запись на прием по мероприятию диспансеризации Используется для связи записи на прием с мероприятием диспансеризации | |||
externalUserID | Внешний идентификатор пользователя | - | - | Используется для создания записи на другого человека под своей учётной записью. Позднее записи созданные таким способом можно получить через Получение записей на прием другого человека |
Заголовки запроса
Заголовок | Значение (тип/формат значения) | Описание | Обязательный |
---|---|---|---|
Authorization | Bearer {lpuToken} (без скобок и через пробел после Bearer) | LPU токен, полученный с помощью сервиса авторизации | + |
Ответ сервера
В случае успешного выполнения сервер вернет ответ в формате JSON со следующими данными:
Модель: Запись на прием с полной информацией об ЛПУ - TicketVisitWithLpu
Включить страницу | ||||
---|---|---|---|---|
|
Если параметр запроса fullResponse указан как false, то будут заполнены только следующие поля: Запись на прием к врачу, Запись на прием к врачу, Запись на прием к врачу lpu, num, ticketGuid.
Возможные ошибки
Код ответа сервера | Код сообщения* | Сообщение |
---|
Комментарий | |||
---|---|---|---|
400 | 5000 | Запись на прием доступна не ранее, чем за {ScheduleDays} дней. | |
400 | 4848 | У вас уже есть активная запись на данную ячейку расписания. Совершить повторную запись невозможно | |
403 | 5010 | Запрос должен содержать 'Authorization: Bearer ...'" |
403 | 5008 | Токен некорректен |
403 | 5007 | Время действия токена истекло |
403 | 5009 | Подпись запроса некорректна |
400 | 4000 | Не найден МКАБ: {guid} в лпу: {lpu} |
400 | 4033 | directionID и directionType не могут быть указаны отдельно |
400 | 4031 | Направление с таким номером не существует, либо |
принадлежит другому пациенту |
400 | 4036 | Время и гуид врача или гуид ячейки расписания не должны быть пустыми |
400 | 4005 | Вы пытаетесь записаться в детское учреждение. Запись пациентов старше 18 лет запрещена. |
400 | 4007 | Вам запрещена самостоятельная запись на прием через интернет или инфомат. Для записи на прием обратитесь в регистратуру медицинского учреждения лично или по телефону. |
400 | 4007 | Вы не состоите на диспансерном учете у данного специалиста. Запись невозможна. |
400 | 4008 | Вы уже записаны {ФИО} на {Время}. Запрещено иметь более одной активной записи на прием на одну специальность. |
400 | 4029 | Запись недоступна для данной возрастной группы. Сотрудниками МО было установлено ограничение по возрасту при записи на прием. |
400 | 4009 | Это время уже занято. Выберите другое свободное время приема. |
400 | 4011 | Вы записаны в это время {Время}. Запрещено иметь более одной активной записи на прием в одно время. | |
400 | 5066 | Недопустимый период расписания. Максимальный период N дней |
* - Для части сообщений не выделен числовой код ошибки. По умолчанию пишем 5000
В случае возникновения ошибок будет возвращен стандартный ответ сервера;В случае возникновения ошибок валидации сервер вернет стандартное сообщение валидации.