Для клиник и их разработчиков

Как передать данные клиники в geo-doc

Филиалы, специальности, услуги с ценами, врачи и их расписание. Прислать можно как удобно — таблицей, файлом или доступом к API МИС. Мы проверим данные, покажем, что увидели, и только потом загрузим их в кабинет клиники.

1. Способы передачи

Таблица по шаблонуExcel с листами «Филиалы», «Специальности», «Услуги», «Врачи», «Расписание». Самый быстрый путь: всё ляжет без вопросов.
Своя таблица или выгрузкаExcel или CSV в вашем виде, даже одна таблица «врач — специальность — филиал — цена — часы». Колонки мы распознаем сами и покажем, что увидели.
Файл JSONДля выгрузки из программы: формат и пример — ниже. Свой JSON тоже подойдёт: списки врачей, филиалов и услуг мы найдём.
API МИСДоступ к API вашей медицинской системы: справочники и свободное время мы заберём сами. Требования — в разделе 6.

Файл до 2 МБ. Старый формат Excel (.xls) сохраните как .xlsx или CSV. В CSV подойдут кодировки UTF-8 и Windows-1251, разделитель — точка с запятой, запятая или табуляция.

2. Единый стандарт

Данные всех клиник в geo-doc приводятся к одному виду. Что не совпадает, мастер подключения покажет, и мы уточним у вас.

  • Один врач — одна запись. Если врач принимает в нескольких филиалах или по нескольким специальностям, перечислите их через запятую, а не заводите врача дважды.
  • ФИО полностью: «Иванова Мария Петровна», а не «Иванова М.П.». Регистр и «ё» мы выровняем сами.
  • Специальность для поиска — из справочника: «терапевт», «врач УЗИ». На сайте клиники может называться иначе — укажите оба названия.
  • Цены — целыми рублями, без копеек. У каждого врача должен быть приём или исследование с ценой.
  • Время — ЧЧ:ММ, дни недели — «пн–пт», «пн, ср, пт» или числами 1–7 (1 — понедельник). Приём врача — в часы работы филиала, смены одного врача не пересекаются.
  • Категория — высшая, первая или вторая; степень — к.м.н. или д.м.н.; звание — профессор или доцент.
  • Ссылки — ключом, названием или ID в МИС: в таблице врачей можно писать «Клиника на Лефорта» и «Терапевт», а не коды.

3. Разделы и поля

В шаблоне Excel каждый раздел — отдельный лист, в JSON — отдельный список. Обязательные поля отмечены. Пустой ключ geo-doc соберёт сам из названия или ФИО.

Колонка в ExcelПоле JSONЧто писатьПример

Можно иначе, если так удобнее: ФИО одной колонкой вместо трёх, часы работы филиала одной строкой («пн–пт 08:00–20:00, сб 09:00–15:00»), график врача одной строкой или колонками «Пн»…«Вс» прямо в таблице врачей, цена приёма у врача, если отдельного прайса нет.

4. Расписание

Расписание бывает двух видов, можно оба сразу.

  • Недельное: филиал, дни недели, с какого и до какого часа принимает врач. По нему строится сетка приёма.
  • Из МИС: номер расписания врача в филиале по специальности — тот, по которому ваша МИС отдаёт свободное время. Тогда пациенты видят настоящее свободное время, а записи уходят в МИС.

У филиала и врача можно указать их ID в МИС — по ним мы сопоставим ответы API с вашими справочниками.

5. Формат JSON

Объект с четырьмя списками: filials, specialties, services, doctors. Расписание лежит внутри врача: schedule — недельное, mis_schedules — номера МИС. Кодировка UTF-8.










6. API МИС


Если у вашей медицинской системы есть API, мы заберём справочники и свободное время сами. Подойдёт почти любое API, которое отвечает в JSON; названия полей сопоставим при подключении.


    

  • Доступ: только HTTPS с действующим сертификатом, адрес доступен из интернета. Запросы приходят с сервера geo-doc.ru.
    • 

  • Авторизация: без неё, логин и пароль (Basic), токен (Bearer) или ключ в заголовке или параметре адреса. Ключ мы храним зашифрованным.
    • 

  • Ответ: JSON до 2 МБ, не дольше 15 секунд, без перенаправлений.
    • 



Нужны четыре запроса на чтение — например, такие:




ЧтоЗапросЧто в ответе



ФилиалыGET /filialsсписок: ID, название, адрес


СпециальностиGET /specialtiesсписок: ID, название


ВрачиGET /doctors?specialtyId=…ID, фамилия, имя, отчество, ID филиалов и специальностей


Свободное времяGET /slots?doctorId=…&filialId=…номерки: ID, начало и конец по местному времени





GET /slots?doctorId=6729&filialId=36

[
  { "id": 13666425, "begin": "2026-10-17T14:35:00", "end": "2026-10-17T15:00:00", "filialId": 36 },
  { "id": 13666281, "begin": "2026-10-17T15:00:00", "end": "2026-10-17T15:25:00", "filialId": 36 }
]


Для записи на сайте клиники дополнительно нужны запросы: занять номерок, записать пациента (ФИО, дата рождения, телефон) и отменить запись. Их состав согласуем при подключении записи.







7. Справочник специальностей


Специальность для поиска — строго из этого списка, в том же написании. Врачи со специальностью не из списка в поиск не попадут.




    









8. Как проходит подключение


    

  1. Вы присылаете файл или доступ к API на support@geo-doc.ru или вашему менеджеру geo-doc.
    2. 

  2. Мастер подключения разбирает данные и показывает, что увидел: сколько филиалов, врачей, услуг и расписаний, как пациенты увидят карточки врачей.
    3. 

  3. Дубли и несовпадения — один врач под двумя записями, специальность не из справочника, приём вне часов работы — уточняем с вами.
    4. 

  4. Проверенные данные загружаем в кабинет клиники. Дальше вы правите их там сами.
    5.