поиск по сайту
например: Педиатр, Динамо

Подбор клиники

Подробнее о методе передачи расписания приемов специалистов

Мы разработали механизм бронирования посещения к принимающим специалистам пользователями нашего сайта. Для подключения к системе бронирования необходимо заполнить анкету и подписать соглашение о взаимной работе. Добавление и изменение расписания приемов специалистов происходит в ручном и автоматическом режиме.

Для автоматического режима мы предлагаем воспользоваться форматом XML для размещения актуальной информации на конкретные дни, время и стоимость приема. Для защиты передаваемых данных в формате XML мы создали уникальный ХЕШ-код для доступа к информации косающихся ваших клиник. Код вы можете получить на странице "Редактирование учреждения", закладка "Расписание приемов". Там же вы найдете ссылку на загрузку XML файла с расписанием и бронями.

Описание формата XML.

Cтандарт XML (XML DTD). Единый формат представления данных позволяет быстро и качественно обрабатывать предоставляемую клиниками информацию.
Настройте экспорт требуемой информации из вашей базы, CRM, и т.п. данных в XML-файл. Отправляйте на регулярной основе XML файл по протоколу POST, и не забудьте передавать ХЕШ-код доступа.

После отправки файла, в течении короткого промежутка времени, происходит обновление расписания специалистов вашей клиники на сайте Medmaximum.ru.

Общие требования к XML-файлу

1. Стандарт XML учитывает порядок следования элементов, поэтому важно соблюдать его в соответствии с шаблонами. Это требование продиктовано стандартом XML.
2. Стандарт XML не допускает использования в текстовых данных непечатаемых символов с ASCII-кодами в диапазоне значений от 0 до 31 (за исключением символов с кодами 9, 10, 13 — табуляция, перевод строки, возврат каретки). Это требует обязательной замены некоторых символов на эквивалентные им символьные коды:

Символ в текстеКод для XML-файла
" "
& &
> >
< <
' '

Пример файла

<clinic id="1071960">
<specialist name="иванов иван иванович" type="терапевт" price="800.00" currencyId="RUR" email="doctor@clinika.ru">
<dates>
<date start="2011-07-07 09:30" end="2011-07-07 20:30" status="free" />
<date start="2011-07-08 10:30" end="2011-07-08 14:30" status="busy" />
<date start="2011-07-08 10:30" end="2011-07-08 14:30" status="free" />
</dates>
<bookings>
<booking id="3" timefrom="2011-07-07 12:30" timeto="2011-07-07 13:30" clientname="Иванов Иван" clientphone="+79261234567" clientemail="mail@mail.ru" status="confirmed" />
<booking id="4" timefrom="2011-07-07 13:30" timeto="2011-07-07 14:30" clientname="Николаев Николай" clientphone="89161234567" clientemail="mail@mail.ru" status="clinic_cenceled" />
<booking id="5" timefrom="2011-07-07 14:30" timeto="2011-07-07 15:30" clientname="Семенов Семен" clientphone="89161234567" clientemail="mail@mail.ru" status="user_cenceled" />
</bookings>
</specialist>
</clinic>

Описание тегов

<?xml version="1.0" encoding="UTF-8"?> Это стандартный XML-заголовок со ссылкой на файл описания формата. Заголовок должен начинаться с первой строки, с нулевого символа.
<medmaximum date="2011-07-07 12:30"> Это корневой элемент XML-файла. Файл должен содержать только один корневой элемент. Атрибут date элемента должен соответствовать дате и времени генерации XML файла на стороне клиники.
clinic Элемент <clinic> содержит атрибут id - индификатор клиники на сайте.
specialist

Элемент <specialist> содержит информацию конкретном специалисте, его даты и времени приема и стоимость.

Атрибут:
name - Фамилия, Имя, Отчество принимающего специалиста.
type - Специализация – обязательный атрибут. Указывается из списка "Информация о ваших специалистах" у конкретной клиники.
price - Стоимость приема (услуги) специалиста.
currencyId - Идентификатор валюты стоимости (RUR, USD, EUR). Для корректного отображения цены в нужной валюте необходимо использовать идентификатор (например, RUR) с соответствующим значением цены. Если передается атрибут price, то данный атрибут является обязательным.
email - E-mail специалиста. Указывается в том случае если этот человек зарегистрирован на сайте medmaximum.ru

dates В элементе < dates > содержится список дат приемов специалистом. Каждый диапазон дат приема располагается в элементе <date>.
date

Элемент содержит информацию о свободных датах для записи на прием.

Атрибут:
start - Дата и время начала приема специалистом.
end - Дата и время окончания приема специалистом.
status - Статусы даты: free - прием есть, busy - приема нет.

bookings В элементе < bookings > содержится список забронированных дат приемов специалистом. Каждый диапазон дат приема располагается в элементе <date>.
booking

Элемент booking содержит информацию об уже имещихся записях на прием к специалисту.

Атрибут:
id - Уникальный идентификационный номер записи.
timefrom - Дата и время начала приема забронированного посещения.
timeto - Дата и время окончания приема забронированного посещения.
clientname - Имя клиента
clientphone - Номер мобильного телефона клиента.
clientemail - E-mail клиента.
status - Статусы брони: Не подтверждена клиникой => 'clinic_not_confirmed', Подтверждено (клиникой)=>'confirmed', Отменена пользователем=>'user_cenceled', Состоялся прием (пользователь)=>'user_success', Состоялся прием (клиника)=>'clinic_success', Не состоялся прием (пользователь)=>'clinic_not_success', Отменена клиникой=>'clinic_cenceled'.

Мы просим вас не передавать личную информацию о клиентах (имя, фамилия, номер телефона и e-mail), которые делали запись не через наш сайт.