Project Kaiser: 1.7. recording_in_the_planning/ запись пациента в Расписание

1.7. запись пациента в Расписание

EndPoint - recording_in_the_planning
Method - POST

Описание.

Данным способом можно записать только пациента у которого уже есть регистрация в МИС т.е. создана запись в таблице PATIENTS и имеется Patients_ID.

ID пациента, (при методе авторизации пользователя по умолчанию), это логин в basic авторизации.
Если используется другой логин пользователя или авторизация по x-api-key,
то нужно определить Patients_ID методами
0.2. get_patient / данные о пользователе
или
0.4. find_patient_by_fio / поиск пациента по ФИО+ДР+телефон

ID расписания - из метода 1.3. get_pl_subj / список расписаний
ID вида приема - из метода 1.2. get_pl_exam / виды приемов

Информация для сис.админа МИС Медиалог
запись на Событие возможна, если у этого типа события в справочнике установлена галка в логическое поле PL_LEG.mss_iswork=1

Request parameters / параметры запроса

Все параметры обязательны

Название параметра	Тип данных	Описание
patients_id	integer	ID ЭМК пациента (записаться может только пациент, имеющий ЭМК в базе)
pl_subj_id	integer	ID расписания
pl_exam_id	integer	ID вида приема
dt	string	ДатаВремя, на которое нужно записать, в формате ГГГГ-ММ-ДДtЧЧ:ММ
comment	string	комментарий, предназначен для регистратуры, использование Пациентом согласовывать
phone	string	обязательно в формате "+7(913)123-1234" т.к. записывается в поле с маской.

Response parameters / параметры ответа

Название параметра	Тип данных	Описание
msgcode	integer	код результата выполнения запроса
message	string	текст результата выполнения запроса
planning_id	integer	ID созданной записи
pl_subj_id	integer	ID расписания
pl_exam_id	integer	ID вида приема
dt_start	string	ДатаВремя, начала приема, в формате ГГГГ-ММ-ДДtЧЧ:ММ
duree	integer	Длительность приема, минуты

Request examples / пример запроса

url - http://127.0.0.1:45670/recording_in_the_planning
body -

{
	"patients_id": 1,
	"pl_subj_id": 1,
	"pl_exam_id": 1,
	"dt": "2021-10-30T13:30",
	"comment": "тест",
	"phone": "+7(913)123-1234"
}

Пример CURL

curl "http://127.0.0.1:45670/recording_in_the_planning \
-X POST \
-d "{\"patients_id\":1,\"pl_subj_id\":1,\"pl_exam_id\":1,\"dt\":\"2021-10-30T13:30\" ,\"comment\":\"тест\",\"phone\":\"+7(913)123-1234\"}"

Response examples / Пример ответа

{
  "msgcode": 0, 
  "message":"запись успешно создана", 
  "planning_id": 1234, 
  "pl_subj_id": 681, 
  "pl_exam_id": 110, 
  "dt_start": "2023-05-18T10:00", 
  "duree": 30 
}

Список Кодов и Сообщений Результат выполнения запроса. (Коды в разработке. пока возвращается код=1 означает любую из ошибок)

msgcode	message
0	Запись успешно создана
1	Дата приема выходит за границы допустимого периода
1	Нельзя создать более * записей в день для одного пациента к этому врачу
1	Превышено максимальное количество приемов в день
1	Превышено максимальное количество предварительных записей на прием
1	Запись пересекается по времени с другим приемом пациента
1	Запись выходит за границы рабочего времени врача
1	Запись пересекается по времени с другим приемом врача
1	Дата Запись на это время временно заблокирована. Выберите другое время приема либо повторите попытку

Пример Сообщения

{
 "msgcode":1, 
 "message":"Запись пересекается по времени с другим приемом врача"
}