Онлайн-запись к врачу: синхронизация Битрикс и МИС
Сайт частной клиники принимает онлайн-записи к врачам. МИС — медицинская информационная система — операционная система клиники: расписание врачей, история болезни, электронная медкарта, учёт услуг, касса. МИС — медицинская информационная система. Задача: запись с сайта должна автоматически попадать в расписание МИС, а свободные слоты — отображаться на сайте в реальном времени. Каждый час простоя или ручного переноса данных стоит до 30% потерянных пациентов — мы это видели не раз.
Рынок МИС неоднороден: Инфоклиника, 1С:Медицина, qMS, Medesk, Ренессанс-М, ArchiMed+, Medods — у каждой свой API (или его отсутствие). Архитектура интеграции 1С-Битрикс с МИС зависит от конкретной системы. Мы гарантируем подбор оптимального сценария и реализацию под ключ с полным тестированием.
Типовые сценарии интеграции
Сценарий A: МИС предоставляет REST/SOAP API. Сайт напрямую обращается к API МИС для получения расписания и записи пациента. Самый чистый вариант, но не все МИС его поддерживают.
Сценарий B: Промежуточный брокер. МИС публикует расписание в промежуточной базе (PostgreSQL или MySQL), сайт читает оттуда. Запись на сайте создаёт заявку в промежуточной таблице, МИС забирает её по cron.
Сценарий C: Интеграционная шина. Для крупных клиник с несколькими МИС и множеством систем — отдельный интеграционный сервис (например, на базе RabbitMQ или Apache Kafka), который синхронизирует данные между системами.
Какой сценарий интеграции выбрать?
Выбор сценария определяется бюджетом, количеством систем и требованиями к задержкам. Ниже — сравнение ключевых параметров:
| Параметр | REST API | Промежуточная база | Интеграционная шина |
|---|---|---|---|
| Скорость внедрения | 5–8 недель | 8–14 недель | от 12 недель |
| Задержка данных | реальное время | 1–5 минут | реальное время |
| Нагрузка на МИС | высокая | низкая (вычитывается) | сбалансированная |
| Отказоустойчивость | зависит от МИС | высокая (кэш в БД) | высокая (очередь) |
REST API в 2–3 раза быстрее внедряется и даёт данные в реальном времени, но требует стабильного эндпоинта. Промежуточная база подходит для МИС без API или с жёсткими лимитами. Интеграционная шина — для сложных ландшафтов.
Почему интеграция через REST API — оптимальный выбор?
REST API — самый быстрый и прозрачный способ интеграции. В 90% случаев мы используем именно его: клиент получает данные в реальном времени, а кодовая база остается чистой. Ниже пример реализации для Medesk — одной из популярных МИС.
class MedeskApiClient { private string $apiKey; private string $baseUrl = 'https://api.medesk.net/api/v2'; public function getDoctorSchedule(int $doctorId, string $dateFrom, string $dateTo): array { return $this->request('GET', '/schedules', [ 'doctor_id' => $doctorId, 'from' => $dateFrom, 'to' => $dateTo, 'include' => 'free_slots', ]); } public function createAppointment(array $patientData, int $slotId): array { return $this->request('POST', '/appointments', [ 'slot_id' => $slotId, 'patient' => [ 'first_name' => $patientData['name'], 'last_name' => $patientData['surname'], 'phone' => $patientData['phone'], 'email' => $patientData['email'], 'birth_date' => $patientData['birth_date'], ], 'comment' => $patientData['comment'] ?? '', 'source' => 'website', ]); } public function cancelAppointment(int $appointmentId, string $reason = ''): array { return $this->request('DELETE', "/appointments/{$appointmentId}", [ 'reason' => $reason, ]); } private function request(string $method, string $path, array $data = []): array { $url = $this->baseUrl . $path; if ($method === 'GET' && $data) { $url .= '?' . http_build_query($data); } $ch = curl_init($url); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => $method, CURLOPT_HTTPHEADER => [ 'Content-Type: application/json', "Authorization: Bearer {$this->apiKey}", ], CURLOPT_POSTFIELDS => in_array($method, ['POST', 'PUT', 'PATCH']) ? json_encode($data) : null, ]); $response = json_decode(curl_exec($ch), true); $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); if ($httpCode >= 400) { \Bitrix\Main\Diag\Debug::writeToFile( "MIS API Error {$httpCode}: " . json_encode($response), 'MIS', '/local/logs/mis-integration.log' ); throw new \RuntimeException("MIS API error: {$httpCode}"); } return $response ?? []; } } Почему кеширование расписания критично?
Прямое обращение к API МИС при каждом посещении страницы врача — плохая идея: МИС может быть медленной или иметь ограничения на число запросов (например, 100 запросов в минуту). Кеширование снижает нагрузку на МИС в 10–20 раз и ускоряет загрузку страницы до 200 мс. Детали реализации:
class DoctorScheduleService { private MedeskApiClient $mis; public function getAvailableSlots(int $doctorId, string $date): array { $cacheKey = "doctor_slots_{$doctorId}_{$date}"; $cacheTtl = 180; // 3 минуты — баланс актуальности и нагрузки $cache = \Bitrix\Main\Data\Cache::createInstance(); if ($cache->initCache($cacheTtl, $cacheKey, '/mis/slots/')) { return $cache->getVars()['slots']; } $schedule = $this->mis->getDoctorSchedule($doctorId, $date, $date); $slots = $this->formatSlots($schedule); $cache->startDataCache(); $cache->endDataCache(['slots' => $slots]); return $slots; } public function bookSlot(int $slotId, array $patientData): array { $result = $this->mis->createAppointment($patientData, $slotId); // Инвалидируем кеш расписания для этого врача $date = date('Y-m-d'); $doctorId = $this->getSlotDoctorId($slotId); \Bitrix\Main\Data\Cache::clearByTag("doctor_slots_{$doctorId}_{$date}"); // Сохраняем запись в Битрикс $this->saveAppointmentInBitrix($result, $patientData); return $result; } } Хранение записей в Битрикс
Записи дублируем в Битрикс — для истории, уведомлений и работы без МИС при её недоступности:
class AppointmentTable extends \Bitrix\Main\ORM\Data\DataManager { public static function getTableName(): string { return 'local_mis_appointments'; } public static function getMap(): array { return [ new \Bitrix\Main\ORM\Fields\IntegerField('ID', ['primary' => true, 'autocomplete' => true]), new \Bitrix\Main\ORM\Fields\IntegerField('USER_ID'), new \Bitrix\Main\ORM\Fields\IntegerField('MIS_APPOINTMENT_ID'), new \Bitrix\Main\ORM\Fields\IntegerField('DOCTOR_ID'), new \Bitrix\Main\ORM\Fields\DatetimeField('APPOINTMENT_TIME'), new \Bitrix\Main\ORM\Fields\StringField('STATUS'), // booked|confirmed|cancelled|completed new \Bitrix\Main\ORM\Fields\StringField('SERVICE_NAME'), new \Bitrix\Main\ORM\Fields\StringField('PATIENT_PHONE'), new \Bitrix\Main\ORM\Fields\DatetimeField('CREATED_AT'), ]; } } Уведомления пациенту
После записи — SMS и email-подтверждение через Битрикс. За 24 часа и за 2 часа до приёма — напоминания. Напоминания реализуются через агент Битрикс, который каждый час проверяет записи:
function SendMisAppointmentReminders(): string { $now = new \Bitrix\Main\Type\DateTime(); $in24h = (new \DateTime())->modify('+24 hours'); $in2h = (new \DateTime())->modify('+2 hours'); $appointments = AppointmentTable::getList([ 'filter' => [ 'STATUS' => 'booked', '>=APPOINTMENT_TIME' => \Bitrix\Main\Type\DateTime::createFromTimestamp($in2h->getTimestamp()), '<=APPOINTMENT_TIME' => \Bitrix\Main\Type\DateTime::createFromTimestamp($in24h->getTimestamp()), 'REMINDER_24H_SENT' => 'N', ], ]); while ($row = $appointments->fetch()) { SmsService::send($row['PATIENT_PHONE'], "Напоминаем о записи к врачу " . date('d.m.Y H:i', strtotime($row['APPOINTMENT_TIME'])) ); AppointmentTable::update($row['ID'], ['REMINDER_24H_SENT' => 'Y']); } return __FUNCTION__ . '();'; } Обработка ошибок МИС
МИС может быть недоступна (технические работы, проблемы с сервером). Стратегия: если МИС недоступна — сохраняем заявку в таблицу local_mis_pending_appointments со статусом pending, отображаем пациенту «Запись принята, мы свяжемся с вами для подтверждения». Агент раз в 5 минут пробует отправить pending-записи в МИС. При повторных сбоях заявка переводится в статус manual — оператор связывается с пациентом. Мы внедряем такой механизм в каждом проекте и гарантируем нулевую потерю заявок.
Как гарантировать нулевую потерю заявок?
Если МИС недоступна, заявка сохраняется в таблице local_mis_pending_appointments со статусом pending. Агент каждые 5 минут повторно отправляет заявку. После 10 неудачных попыток статус меняется на manual, и оператор связывается с пациентом. Такая схема работает во всех проектах и исключает потерю заявок.
Что входит в работу
- Анализ документации API конкретной МИС и выбор сценария
- Разработка PHP-клиента API с обработкой ошибок и ретраями
- Кеширование расписания с инвалидацией при записи
- Компонент онлайн-записи на сайте (кастомный под дизайн клиники)
- Таблица записей в Битрикс с синхронизацией статусов
- Настройка SMS/email уведомлений (подтверждение + напоминания)
- Организация очереди pending-записей при недоступности МИС
- Тестирование на нагрузку и отказоустойчивость
- Документация по эксплуатации и обучение администраторов
Как мы интегрируем МИС за 5 шагов?
- Анализ API МИС и согласование сценария (1–2 недели).
- Разработка клиента API и резервного хранилища (3–6 недель).
- Интеграция компонента записи на сайте (1–2 недели).
- Настройка уведомлений и очереди ошибок (1 неделя).
- Нагрузочное тестирование и обучение персонала (1–2 недели).
Сроки: от 5 до 14 недель в зависимости от сложности. Закажите интеграцию с гарантией нулевой потери заявок — наши сертифицированные специалисты с 10-летним опытом подберут решение.
| Этап | Длительность |
|---|---|
| Анализ и проектирование | 1–2 недели |
| Разработка и тестирование | 3–6 недель |
| Внедрение и обучение | 1–2 недели |
| Гарантийная поддержка | 1 месяц после запуска |
Получите бесплатную консультацию и оценку вашего проекта — мы подберем оптимальный сценарий интеграции и предложим сроки.