Позволяет создать запись на прием к врачу. Запись на прием можно создать как по GUID 2 способами:
- По Гуиду конкретной ячейки расписания
...
- (рекомендуется).
- По Гуиду врача и времени записи на прием.
...
Запрос
Адрес запроса
POST: {{url}}/api/v2/visit/{{lpuGuid}} |
Параметры запроса
Параметр | Описание | По умолчанию | Обязательный | Комментарий |
---|
lpuGuid |
ГУИД Гуид ЛПУ, в которой создается запись на прием | - | + |
|
|
ГУИД Гуид ячейки расписания на которую выполняется запись на прием | - | + (если не указан |
GUID Гуид врача и время приема |
|
| Дата и время записи на прием формата ГГГГ-мм-ДД ЧЧ:ММ:СС.МММ | - | + (если не указан |
ГУИД Гуид ячейки расписания) | Например: 2023-04-05 14:00:00.000 |
|
ГУИД Гуид врача, к которому создается запись на прием | - | + (если не указан |
ГУИД Гуид ячейки расписания) |
|
directionId |
идентификатор направления на приемИдентификатор направления (устар.) | - | - | Для записи по направлению необходимо использовать этот метод |
directionType |
тип ограниченный набор значений)устар.) | - | - | Ограниченный набор значений: - duvisit - диспансерное наблюдение
- diagnostic - лабораторное исследование
- consultation - консультация
|
-e- | fullResponse | признак полного ответа ( (если указан и не совпадает с e-mail, указанным в МКАБ пациента, то будет выполнено обновление e-mail в МКАБ) | - | - | При указании обновляется в МКАБе пациента. |
email_confirm_agree | Согласие на получение рассылки | - |
| Принимает значения 0/1, учитывается, только если указан email |
phone | Телефон пациента | - | - | При указании обновляется в МКАБе пациента. |
| Признак полного ответа | true | - |
- true - вернется полная модель ответа
|
/- false - вернется модель с заполненными основными полями(TicketGuid, Num, LpuGuid)
|
examGuid | Гуид мероприятия диспансеризации | - | - | Запись на прием по мероприятию диспансеризации Используется для связи записи на прием с мероприятием диспансеризации |
externalUserID | Внешний идентификатор пользователя | - | - | Используется для создания записи на другого человека под своей учётной записью. Позднее записи созданные таким способом можно получить через Получение записей на прием другого человека |
Заголовки запроса
Заголовок | Значение (тип/формат значения) | Описание | Обязательный |
---|
Authorization | Bearer {lpuToken} (без скобок и через пробел после Bearer) | LPU ЛПУ токен, полученный в сервисе с помощью сервиса авторизации | + |
Ответ сервера
В случае успешного выполнения сервер вернет ответ в формате JSON со следующими данными:
...
Пример ответа
...
Модель: Запись на прием с полной информацией об ЛПУ - TicketVisitWithLpu
Включить страницу |
---|
| Запись на прием с полной информацией об ЛПУ - TicketVisitWithLpu |
---|
| Запись на прием с полной информацией об ЛПУ - TicketVisitWithLpu |
---|
|
Если параметр запроса fullResponse указан как false, то будут заполнены только следующие поля: lpu, num, ticketGuid.
Возможные ошибки
Код ответа сервера | Код сообщения* | Сообщение |
---|
Тип ошибки | Комментарий |
---|
400 | 5000 | Запись на прием доступна не ранее, чем за {ScheduleDays} дней. |
|
400 | 4848 | У вас уже есть активная запись на данную ячейку расписания. Совершить повторную запись невозможно |
|
403 | 5010 | Запрос должен содержать 'Authorization: Bearer ...'" |
|
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 |
|
400 | 4011 | Вы записаны в это время {Время}. Запрещено иметь более одной активной записи на прием в одно время. |
|
400 | 5066 | Недопустимый период расписания. Максимальный период N дней |
|
* - Для части сообщений не выделен числовой код ошибки. По умолчанию пишем 5000
В случае возникновения ошибок будет возвращен стандартный ответ сервера;В случае возникновения ошибок валидации сервер вернет стандартное сообщение валидации.