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