При запуску онлайн-запису в медичному центрі на 1С-Бітрікс часто стикаються з однією проблемою: 1С:Медицина не віддає дані в реальному часі. Лікарі ведуть розклад у 1С, а на сайті він не оновлюється годинами. Синхронізація через файловий обмін або прямі запити до бази 1С призводить до помилок та затримок. Ми вирішуємо це через HTTP-сервіси — сучасний протокол, який забезпечує безшовну взаємодію систем.
1С:Медицина — сімейство конфігурацій для медичних організацій: «Лікарня», «Поліклініка», «Медична лабораторія». Конфігурації працюють на платформі 1С:Підприємство 8 і, на відміну від більшості інших МІС, добре знайомі розробникам, що працюють з екосистемою 1С. Наш досвід — понад 10 років на ринку інтеграцій, реалізовано понад 50 проєктів у медичних закладах. Вартість розробки залежить від складності конфігурації та кількості синхронізованих довідників, але правильно спроєктована інтеграція дозволяє скоротити операційні витрати клініки на 20–30% за рахунок автоматизації запису. Пропонуємо рішення під ключ — оцінимо ваш проєкт безкоштовно.
Чому HTTP-сервіси краще COM-об'єкта?
COM-об'єкт — прямий виклик 1С з PHP через new COM(...). Працює лише на Windows-сервері, погано масштабується. При паралельних запитах (5+ пацієнтів одночасно) виникають блокування, падіння продуктивності в 3–5 разів порівняно з HTTP-сервісами. HTTP-сервіси не прив'язані до ОС, підтримують асинхронну обробку та кешування на стороні Бітрікс. Проміжна база даних — альтернатива, якщо 1С вже вміє вивантажувати дані в PostgreSQL/MySQL, але вона не дає двостороннього онлайн-обміну. HTTP-сервіси — кращий варіант.
| Метод | Швидкість | Надійність | Складність |
|---|---|---|---|
| HTTP-сервіси 1С | Висока | Висока | Середня |
| COM-об'єкт | Середня (падає при навантаженні) | Низька (блокування) | Низька |
| Проміжна БД | Низька (асинхронно) | Висока | Висока |
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С (вбудована мова):
Функція ОтриматиРозклад(Запит)
Відповідь = Новий HTTPServisВідповідь(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С → Бітрікс | По події (зміна в 1С) |
| Розклад (слоти часу) | 1С → Бітрікс | Рідше: кожні 5-15 хвилин |
| Новий запис пацієнта | Бітрікс → 1С | Миттєво (онлайн) |
| Скасування запису | Бітрікс → 1С | Миттєво |
| Послуги та ціни | 1С → Бітрікс | За розкладом (раз на добу) |
Що входить в роботу
- Аналіз конкретної конфігурації 1С:Медицина та доступних регістрів
- Розробка HTTP-сервісу на стороні 1С (спільно з 1С-розробником)
- PHP-клієнт для HTTP-сервісу з кешуванням (теговане кешування)
- Синхронізація довідника лікарів в інфоблок Бітрікс
- Компонент онлайн-запису з формою (валідація, вибір слоту)
- Сповіщення пацієнту по SMS/email після запису
- Документація по інтеграції та навчання
- Гарантійна підтримка 3 місяці
Чек-лист типових етапів проєкту:
- Аудит конфігурації 1С:Медицина та схеми даних
- Проєктування REST API (HTTP-сервіс)
- Розробка та тестування HTTP-сервісу в 1С
- Створення PHP-клієнта та компонентів Бітрікс
- Інтеграційне тестування (до 2 тижнів)
- Запуск та супровід (3 місяці гарантії)
Терміни: 6–10 тижнів за наявності 1С-розробника в команді. Розробка HTTP-сервісу на стороні 1С — 2–4 тижні, PHP-частина — 3–6 тижнів. Правильно спроєктована інтеграція дає економію бюджету на підтримці та знижує витрати на адміністрування. Пишіть нам для консультації — ми проаналізуємо конфігурацію та запропонуємо рішення. Зв'яжіться з нами.