Позволяет создать запись на прием к врачу. Запись на прием можно создать 2 способами:
- По Гуиду конкретной ячейки расписания (рекомендуется).
- По Гуиду врача и времени записи на прием.
Запрос
Адрес запроса
POST: {{api}}/visit/{{lpuGuid}} |
Параметры запроса
Параметр | Описание | По умолчанию | Обязательный | Комментарий |
---|---|---|---|---|
lpuGuid | Гуид ЛПУ, в которой создается запись на прием | - | + | |
timeTable | Гуид ячейки расписания на которую выполняется запись на прием | - | + (если не указан Гуид врача и время приема | |
dateTime | Дата и время записи на прием | - | + (если не указан Гуид ячейки расписания) | |
docGuid | Гуид врача, к которому создается запись на прием | - | + (если не указан Гуид ячейки расписания) | |
directionId | Идентификатор направления(Гуид) | - | - | Для записи по направлению |
directionType | Тип направления | - | - | Ограниченный набор значений:
|
E-mail пациента | - | - | При указании обновляется в МКАБе пациента. | |
email_confirm_agree | Согласие на получение рассылки | - | Принимает значения 0/1, учитывается, только если указан email | |
phone | Телефон пациента | - | - | При указании обновляется в МКАБе пациента. |
fullResponse | Признак полного ответа | true | - |
|
examGuid | Гуид мероприятия диспансеризации | - | - | Запись на прием по мероприятию диспансеризации Используется для связи записи на прием с мероприятием диспансеризации |
ExternalID | Внешний идентификатор пользователя | - | - | Используется для получения записей другого человека под своей учётной записью |
Заголовки запроса
Заголовок | Значение (тип/формат значения) | Описание | Обязательный |
---|---|---|---|
Authorization | Bearer {lpuToken} (без скобок и через пробел после Bearer) | LPU токен, полученный с помощью сервиса авторизации | + |
Ответ сервера
В случае успешного выполнения сервер вернет ответ в формате JSON со следующими данными:
Модель: Запись на прием с полной информацией об ЛПУ - TicketVisitWithLpu
Описание полей
Название | Тип данных | Описание | Комментарий |
---|---|---|---|
TicketGuid | string(Guid) | Идентификатор Записи на прием | |
TimeTableGuid | string(Guid) | Идентификатор Ячейки расписания | |
DocFio | string | ФИО врача и не только | Расписать логику поля |
DocGuid | string(Guid) | Идентификатор ресурса(врача), к которому сделана запись | |
DoctorRole | string | Должность ресурса(врача), к которому сделана запись | |
Speciality | string | Специальность ресурса(врача), к которому сделана запись | |
BeginTime | string(DateTime) | Время начала приема | |
EndTime | string(DateTime) | Время окончания приема | |
DateOfAppointment | string(DateTime) | Дата и время создания записи | Может быть нулевым, если запись получена из локальной ЛПУ |
PlanCount | int | Запланированная вместимость ячейки расписания | API-801 - Получение подробных данных проблемы... СТАТУС |
UsedCount | int | Использованная вместимость ячейки расписания | API-801 - Получение подробных данных проблемы... СТАТУС |
Source | int | Источник записи | |
Login | string | Логин записавшего | |
SourceName | string | Название источника | |
DispExamGuid | string(Guid) | Гуид мероприятия диспансеризации | |
History | Array of DocumentHistory | История документа | |
Num | string | Номер записи на прием | |
UchastokNum | string | Номер участка | |
Room | string | Кабинет | |
Flat | int | Этаж | |
BusyType | Тип занятости - DocBusyType | Тип приема |
Дополнительные поля
Название | Тип данных | Описание | Комментарий |
---|---|---|---|
Lpu | LpuWithStatus | Информация об ЛПУ |
Если параметр запроса fullResponse указан как false, то будут заполнены только следующие поля: lpu, num, ticketGuid.
Возможные ошибки
Код ответа сервера | Код сообщения | Сообщение | Тип ошибки |
---|---|---|---|
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 |
В случае возникновения ошибок будет возвращен стандартный ответ сервера.