Интеграция 1С-Битрикс с 1С:Медицина: HTTP-сервисы и онлайн-запись

При запуске онлайн-записи в медицинском центре на 1С-Битрикс часто сталкиваются с одной проблемой: 1С:Медицина не отдаёт данные в реальном времени. Врачи ведут расписание в 1С, а на сайте оно не обновляется часами. Синхронизация через файловый обмен или прямые запросы к базе 1С приводит к ошибкам и задержкам. Мы решаем это через HTTP-сервисы — современный протокол, который обеспечивает бесшовное взаимодействие систем.

1С:Медицина — семейство конфигураций для медицинских организаций: «Больница», «Поликлиника», «Медицинская лаборатория». Конфигурации работают на платформе 1С:Предприятие 8 и, в отличие от большинства других МИС, хорошо знакомы разработчикам, работающим с экосистемой 1С. Наш опыт — более 10 лет интеграций 1С-Битрикс с МИС, реализовано свыше 50 проектов в медицинских учреждениях. Стоимость разработки зависит от сложности конфигурации и количества синхронизируемых справочников, но правильно спроектированная интеграция позволяет сократить операционные затраты клиники за счёт автоматизации записи.

Почему HTTP-сервисы лучше COM-объекта?

COM-объект — прямой вызов 1С из PHP через new COM(...). Работает только на Windows-сервере, плохо масштабируется. При параллельных запросах (5+ пациентов одновременно) возникают блокировки, падение производительности в 3–5 раз по сравнению с HTTP-сервисами. HTTP-сервисы не привязаны к ОС, поддерживают асинхронную обработку и кеширование на стороне Битрикс. Промежуточная база данных — альтернатива, если 1С уже умеет выгружать данные в PostgreSQL/MySQL, но она не даёт двустороннего онлайн-обмена. HTTP-сервисы — предпочтительный вариант.

HTTP-сервис в 1С:Медицина

В конфигураторе 1С создаётся HTTP-сервис (Общие → HTTP-сервисы):

Имя: МедицинскийAPI КорневойURL: /medapi Версия: 1.0.0 

Методы (шаблоны URL):

• GET /medapi/doctors — список врачей
• GET /medapi/schedule/{doctorId}/{date} — расписание врача
• POST /medapi/appointments — создание записи
• DELETE /medapi/appointments/{id} — отмена записи

Обработчик метода в 1С (встроенный язык):

Функция ПолучитьРасписание(Запрос)
    Ответ = Новый HTTPСервисОтвет(200);
    Ответ.Заголовки["Content-Type"] = "application/json; charset=utf-8";
    ИдВрача = Запрос.ПараметрыURL["doctorId"];
    ДатаСеанса = Дата(Запрос.ПараметрыURL["date"]);
    // Запрос к регистру расписания
    Запрос1С = Новый Запрос();
    Запрос1С.Текст = "
    |ВЫБРАТЬ
    | РасписаниеВрачей.ВремяНачала,
    | РасписаниеВрачей.ВремяОкончания,
    | РасписаниеВрачей.СтатусЯчейки,
    | РасписаниеВрачей.КабинетПоликлиники
    |ИЗ
    | РегистрСведений.РасписаниеВрачей КАК РасписаниеВрачей
    |ГДЕ
    | РасписаниеВрачей.Врач.УникальныйИдентификатор = &ИдВрача
    | И РасписаниеВрачей.Дата = &Дата
    | И РасписаниеВрачей.СтатусЯчейки = Перечисления.СтатусыЯчеекРасписания.Свободна";
    Запрос1С.УстановитьПараметр("ИдВрача", ИдВрача);
    Запрос1С.УстановитьПараметр("Дата", ДатаСеанса);
    Результат = Запрос1С.Выполнить().Выбрать();
    Слоты = Новый Массив();
    Пока Результат.Следующий() Цикл
        СлотДанные = Новый Структура("start,end,cabinet");
        СлотДанные.start = Формат(Результат.ВремяНачала, "ДФ=HH:mm");
        СлотДанные.end = Формат(Результат.ВремяОкончания, "ДФ=HH:mm");
        СлотДанные.cabinet = Результат.КабинетПоликлиники.Номер;
        Слоты.Добавить(СлотДанные);
    КонецЦикла;
    Ответ.УстановитьТелоИзСтроки(ЗаписатьJSON(Слоты));
    Возврат Ответ;
КонецФункции

PHP-клиент для HTTP-сервиса 1С:Медицина

class OneCMedicinaClient {
    private string $baseUrl; // http://1c-server:8080/медицина/hs/medapi
    private string $username;
    private string $password;

    public function getSchedule(string $doctorGuid, string $date): array {
        return $this->request('GET', "/schedule/{$doctorGuid}/{$date}");
    }

    public function createAppointment(array $data): array {
        return $this->request('POST', '/appointments', [
            'slotDate' => $data['date'],
            'slotTime' => $data['time'],
            'doctorGuid' => $data['doctor_guid'],
            'patient' => [
                'lastName' => $data['last_name'],
                'firstName' => $data['first_name'],
                'middleName' => $data['middle_name'] ?? '',
                'birthDate' => $data['birth_date'],
                'phone' => $data['phone'],
                'email' => $data['email'],
                'snils' => $data['snils'] ?? '',
            ],
            'serviceCode' => $data['service_code'] ?? '',
        ]);
    }

    private function request(string $method, string $path, array $body = []): array {
        $ch = curl_init($this->baseUrl . $path);
        curl_setopt_array($ch, [
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_CUSTOMREQUEST => $method,
            CURLOPT_USERPWD => "{$this->username}:{$this->password}", // Basic Auth в 1С
            CURLOPT_HTTPHEADER => ['Content-Type: application/json; charset=utf-8'],
            CURLOPT_POSTFIELDS => $body ? json_encode($body, JSON_UNESCAPED_UNICODE) : null,
            CURLOPT_TIMEOUT => 10,
        ]);
        $json = curl_exec($ch);
        $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        curl_close($ch);
        if ($httpCode !== 200) {
            throw new \RuntimeException("1C:Медицина API error {$httpCode}");
        }
        return json_decode($json, true) ?? [];
    }
}

Важно: 1С:Предприятие по умолчанию не поддерживает параллельные запросы в одну информационную базу без лицензий клиентских подключений. При высокой нагрузке нужен пул соединений или кеширование на стороне Битрикс.

Как синхронизировать справочники без дублей?

Список врачей, их специализации, кабинеты — синхронизируем из 1С в инфоблок Битрикс. Ключевой параметр — уникальный идентификатор врача (GUID) из 1С. Он сохраняется в свойстве инфоблока, и при повторной синхронизации мы не создаём дубли, а обновляем существующие элементы. Типичная ошибка — потеря связи между записями, когда в 1С меняется идентификатор. Мы используем служебное свойство DOCTYPE_GUID и логику поиска по нему.

class OneCMedicDoctorSync
{
    public function syncDoctors(): void
    {
        $doctors = $this->onecClient->request('GET', '/doctors');
        foreach ($doctors as $doctor) {
            $existingId = $this->findDoctorByGuid($doctor['guid']);
            $fields = [
                'NAME' => $doctor['fullName'],
                'ACTIVE' => $doctor['active'] ? 'Y' : 'N',
                'IBLOCK_ID' => DOCTORS_IBLOCK_ID,
                'IBLOCK_SECTION_ID' => $this->getSpecializationSectionId($doctor['specialization']),
            ];
            $props = [
                'DOCTOR_GUID' => $doctor['guid'],
                'SPECIALIZATION' => $doctor['specialization'],
                'CABINET_NUMBER' => $doctor['cabinet'],
                'EXPERIENCE_YEARS' => $doctor['experienceYears'],
                'ACADEMIC_DEGREE' => $doctor['academicDegree'],
            ];
            if ($existingId) {
                $el = new \CIBlockElement();
                $el->Update($existingId, $fields);
                \CIBlockElement::SetPropertyValuesEx($existingId, DOCTORS_IBLOCK_ID, $props);
            } else {
                $el = new \CIBlockElement();
                $newId = $el->Add(array_merge($fields, ['PROPERTY_VALUES' => $props]));
            }
        }
    }
}

Какие данные синхронизируются между 1С:Медицина и Битрикс?

Что входит в работу

• Анализ конкретной конфигурации 1С:Медицина и доступных регистров
• Разработка HTTP-сервиса на стороне 1С (совместно с 1С-разработчиком)
• PHP-клиент для HTTP-сервиса с кешированием (тегированное кэширование)
• Синхронизация справочника врачей в инфоблок Битрикс
• Компонент онлайн-записи с формой (валидация, выбор слота)
• Уведомления пациенту по SMS/email после записи
• Документация по интеграции и обучение
• Гарантийная поддержка 3 месяца