Регламентний обмін 1С та 1С-Бітрікс: налаштування автоматичного розкладу
Менеджер забув запустити обмін у п'ятницю ввечері — і весь понеділок клієнти бачать невірні залишки. Знайома ситуація? Але навіть якщо пам'ятає, ручний запуск відволікає від основних завдань. Ми стикаємося з цим регулярно: ручний обмін — головна причина розбіжностей. Автоматичний обмін за розкладом вирішує проблему цілком, але потребує коректного налаштування в обох системах. Наш досвід показує, що після правильного налаштування кількість інцидентів знижується на 80% і економиться до 10 годин на тиждень.
Чому обмін за розкладом важливий?
Без розкладу дані в живому каталозі застарівають: ціни не оновлюються, замовлення не надходять до 1С, залишки розходяться з реальними. Особливо критично для компаній, що працюють за 54-ФЗ, де фіскальні дані мають синхронізуватися строго вчасно. За даними документації 1С-Бітрікс, регламентні завдання через крон — єдиний надійний спосіб гарантувати виконання обміну в заданий час.
Як налаштувати регламентне завдання в 1С?
У конфігурації УТ 10/11 обмін запускається з регламентного завдання:
Адміністрування → Регламентні та фонові завдання → Обмін з сайтом
Параметри завдання:
-
Розклад: задайте інтервал (кожні N хвилин, щогодини, щодня). Для залишків та цін — кожні 15–30 хвилин, повний каталог — вночі.
-
Користувач: вкажіть обліковий запис з правами на обмін з сайтом.
-
Повтор при помилці: увімкніть з паузою 5–10 хвилин, щоб завдання не зависало.
Це мінімальна конфігурація. Додатково можна налаштувати кілька регламентних завдань для різних типів даних — так ви уникнете блокувань та перевантаження.
Як уникнути помилок при налаштуванні крона?
Якщо архітектура передбачає, що сайт періодично запитує оновлення у 1С (REST API), запуск через агент Бітрікс:
Налаштування → Інструменти → Агенти → Додати агент:
\MyProject\OneC\ExchangeAgent::run();
Інтервал: 900 секунд (15 хвилин) для цін та залишків. Агент має виконуватися через реальний крон (/bitrix/modules/main/tools/cron_events.php), а не через хіти — інакше обмін не запуститься в нічний час. Типова помилка — забувають налаштувати крон, і агент спрацьовує лише при відвідуванні сайту, що вночі не відбувається.
Що робити, якщо обмін не запускається вночі?
Перевірте, чи налаштований системний планувальник на виконання cron_events.php. Якщо ні — налаштуйте задачу cron на сервері. Команда:
* * * * * php -f /path/to/site/bitrix/modules/main/tools/cron_events.php
Це гарантує виконання агента щохвилини. Після налаштування переконайтеся, що в логах агента немає помилок доступу до файлів або бази даних.
Моніторинг виконання
Без моніторингу налаштований розклад непотрібний — обмін може зламатися тихо. Мінімальний моніторинг:
- Лог останнього обміну з часовою міткою в окремій таблиці
- Алерт при відсутності успішного обміну більше X годин
- Повідомлення по email/Telegram при помилках
// Записати результат обміну
\Bitrix\Main\Application::getConnection()->query(
"INSERT INTO b_exchange_log (CREATED_AT, STATUS, DETAILS)
VALUES (NOW(), '" . ($success ? 'OK' : 'ERROR') . "', '" . $details . "')"
);
Що потрібно пам'ятати при налаштуванні крона?
Крон має виконуватися від користувача з правами на запис у файлову систему та доступ до бази. Переконайтеся, що шлях до php вказаний вірно. Для налагодження використовуйте логування виводу команди у файл.
Ручний обмін vs автоматичний: порівняння
| Критерій |
Ручний обмін |
Автоматичний за розкладом |
| Частота збоїв |
Висока (людський фактор) |
Низька (залежить від налаштувань) |
| Час запізнення даних |
Години, іноді дні |
Хвилини (15–30) |
| Навантаження на співробітників |
Високе (регулярний запуск) |
Мінімальне |
| Моніторинг |
Відсутній або ручний |
Автоматичний зі сповіщеннями |
Ручний обмін у 10 разів збільшує ризик запізнення даних порівняно з автоматичним — і це без урахування людських помилок.
Розподіл розкладів за типом даних
| Тип даних |
Рекомендована періодичність |
| Залишки та ціни |
Кожні 15–30 хвилин |
| Статуси замовлень |
Кожні 30–60 хвилин |
| Повний каталог |
1 раз на ніч |
| Нові замовлення в 1С |
Кожні 15–30 хвилин |
Що входить до роботи
- Аналіз поточної конфігурації 1С та Бітрікс
- Налаштування регламентних завдань в 1С з урахуванням 54-ФЗ
- Налаштування агентів та крона на стороні сайту
- Розподіл розкладів за типами даних
- Налаштування моніторингу з логами та сповіщеннями
- Документація по новій конфігурації
- Навчання співробітників роботі з системою
- Тестовий прогін протягом 48 годин
Типові помилки при налаштуванні
- Агент не виконується вночі — забули налаштувати реальний крон, агент спрацьовує лише по хіту.
- Розклад занадто частий — кожні 5 хвилин для повного каталогу призводить до перевантаження сервера та блокувань.
- Відсутній моніторинг — помилка обміну може залишатися непоміченою днями.
- Різні типи даних в одному завданні — краще рознести на окремі регламентні завдання.
Налаштування автоматичного обміну за розкладом з моніторингом — від 4 до 8 годин. Зв'яжіться з нами для аудиту вашої поточної інтеграції — ми запропонуємо оптимальне рішення під ключ. Отримайте консультацію безкоштовно.
CommerceML: чому стандартний обмін — і порятунок, і пастка
Стандартний обмін через CommerceML 2.0 на типовому «Управлінні торгівлею» або «Комплексній автоматизації» заводиться за день-два. Товари, ціни, залишки, замовлення — все через XML-файли за розкладом. Для магазину на 3 000 позицій з парою оновлень на добу цього вистачає з запасом. Але як тільки каталог переростає 30 000 SKU, починаються проблеми: інтеграція 1С з Бітрікс на великих обсягах потребує нестандартних рішень.
Чому CommerceML гальмує на каталогах понад 100 000 товарів?
bitrix_1c_exchange.php генерує XML на стороні Бітрікса, 1С забирає та парсить. На великих каталогах парсер активно пише в тимчасову таблицю b_xml_tree — MySQL може стати колом. Ми бачили проект, де стандартний обмін 180 000 товарів займав 6 годин і повністю блокував сервер: ні адмінка, ні фронт не відкривалися. Рішення — інкрементальний обмін. В налаштуваннях вузла обміну на стороні 1С ставимо «Вивантажувати тільки змінені» та розбиваємо вивантаження на пакети по 500–1000 елементів. На стороні Бітрікса — кастомний обробник, який не перестворює b_xml_tree кожного разу, а працює через CIBlockXMLFile::ReadXMLToDatabase() з контролем порцій. Каталог у 200 000 SKU оновлюється за 8–12 хвилин.
Ще один підводний камінь — EXTERNAL_ID. При повторному імпорті Бітрікс зіставляє елементи інфоблоків за зовнішнім кодом. Якщо в 1С товар видалено та створено заново з новим GUID, на сайті з'являється дубль — зі старими відгуками на одній картці та нульовими на іншій. Лікується жорсткою прив'язкою за артикулом через кастомний обробник події OnBeforeIBlockElementAdd.
Як уникнути дублів при повторному імпорті?
Прив'язуємо товари не за GUID, а за артикулом. Перевірка на унікальність виконується до запису в інфоблок — дублікати виключаються навіть після перестворення номенклатури в 1С. На одному проекті з 50 000 товарів така схема запобігла появі 300 дублів на місяць і заощадила контент-менеджерам близько 20 годин ручного чищення.
Кастомні конфігурації 1С: коли CommerceML пасує
«У нас типова конфігурація» — каже кожен другий клієнт, а потім ми відкриваємо базу і бачимо 200 кастомних обробок, перейменовані реквізити та самописні документи реалізації. CommerceML працює з фіксованою структурою XML. Якщо в 1С змінили склад реквізитів номенклатури або додали нестандартний документ — обмін мовчки пропускає ці дані. Або падає з незрозумілою помилкою в журналі реєстрації 1С, а в Бітрікс нічого не пишеться.
У таких випадках робимо кастомне вивантаження. На стороні 1С пишемо обробку, яка формує JSON (парсити швидше, налагоджувати простіше) і відправляє через REST API Бітрікса. Повний контроль: які поля беремо, як трансформуємо, що робимо при конфлікті. Для важких випадків — D7 API з прямою роботою через \Bitrix\Catalog\ProductTable та \Bitrix\Sale\Order.
| Критерій |
CommerceML (стандарт) |
Кастомний REST (JSON) |
| Швидкість на 100 000+ SKU |
Низька (повний XML) |
Висока (інкрементальний JSON) |
| Гнучкість схеми |
Фіксована |
Довільна |
| Можливість розширення |
Обмежена |
Без обмежень |
| Простота налагодження |
Журнал реєстрації 1С |
Логи HTTP-запитів, Postman |
Коли потрібен кастомний REST замість CommerceML?
Кастомний REST виправданий при:
- нестандартних реквізитах номенклатури;
- множинних типах цін (роздріб, опт, дилерська, акційна, регіональна, валютна) — стандартний обмін передає лише один тип;
- мультискладі з різними залишками та необхідністю вибору складу на сайті.
Ціни, залишки та мультисклад
Стандартний обмін вміє передавати один тип ціни. В реальності їх може бути 15: кожна зі своєю групою покупців та пріоритетом. Мапінг між ціновими групами 1С та групами користувачів Бітрікса — окрема інженерна задача. Особливо коли знижки перетинаються і потрібно визначити, яка ціна перемагає.
Мультисклад додає ще один шар: товар є на складі в Москві, немає в Пітері, і «під замовлення» в Новосибірську. На сайті потрібно показати наявність по кожній точці, підключити вибір пункту самовивозу та розрахувати доставку від найближчого складу, де товар фізично є. Стандартний модуль складського обліку Бітрікс (catalog.store) справляється з відображенням, але логіку «звідки відвантажувати» пишемо окремо. Для одного виробничого холдингу ми реалізували кастомний агрегатор залишків, який за 2 секунди розраховував баланс по 8 складах — це скоротило кількість помилок відвантаження на 80%.
Замовлення та документообіг
Замовлення з сайту відлітає в 1С, формується реалізація, товар резервується. Статуси повертаються назад. Головний нюанс — часткове відвантаження: клієнт замовив 5 позицій, 3 є на складі, 2 прийдуть через тиждень. 1С формує два документи реалізації. Бітрікс з коробки не вміє розбивати одне замовлення на кілька відвантажень — доопрацьовуємо обробник OnSaleOrderSaved, який створює дочірні замовлення та синхронізує статуси по кожному.
Документи в особистому кабінеті — рахунки, акти, накладні з 1С — віддаємо через REST, PDF генерується на стороні 1С і кешується на CDN. Покупець завантажує не з 1С напряму (це вбило б сервер), а з кешу.
Рекомендація CommerceML: пакетний імпорт з контролем порцій знижує навантаження на MySQL та виключає блокування (джерело: Wikipedia).
Моніторинг: не «налаштував і забув»
Обмін може зламатися тихо: скрипт відпрацював, помилок в лозі немає, але 200 товарів не оновилися через невалідний UTF-8 в назві. Або 1С змінила формат дати в черговому оновленні — всі ціни прийшли нульовими.
Мінімальний набір, який ставимо на кожному проекті:
- Алерт в Telegram, якщо час обміну виріс у 3+ рази від середнього.
- Перевірка розбіжності залишків: скрипт порівнює
b_catalog_product.QUANTITY з тим, що віддає 1С, і сповіщає при дельті більше 5 %.
- Дашборд: остання синхронізація, кількість оброблених позицій, черга, помилки.
Для проектів з високим навантаженням додаємо асинхронні черги на Redis або RabbitMQ. Обмін не блокує веб-сервер, дані не втрачаються при короткочасному падінні 1С. На одному інтернет-магазині з оборотами 2 млн замовлень на рік ми впровадили таку схему — час відновлення після збоїв скоротився з 3 годин до 10 хвилин.
Зв'язка з Бітрікс24 для автоматизації документообігу
Якщо крім сайту є корпоративний портал на Бітрікс24 — зв'язуємо і його. Контрагенти з CRM летять в 1С, рахунки з 1С з'являються в картці угоди. Менеджер бачить дебіторку та взаєморозрахунки, не перемикаючись між вікнами. Закрили угоду — документи сформувалися самі.
Оплата надійшла в 1С → логіст отримує задачу на відвантаження в Бітрікс24. Товар відвантажений → менеджер бачить повідомлення. Автоматичні задачі за подіями з 1С — через вебхуки Бітрікс24 REST API. Така зв'язка скорочує ручне введення на 70% та виключає забуті відвантаження.
Як ми налаштовуємо інтеграцію: покроковий процес
-
Аудит конфігурації 1С. Дивимось структуру довідників, документів, реквізитів. Виявляємо кастомні доопрацювання. Оцінюємо обсяг даних (кількість SKU, замовлень, складів).
-
Проектування схеми обміну. Узгоджуємо набір даних: товари, ціни, залишки, замовлення, документи. Визначаємо інтервал синхронізації та механізм — CommerceML або кастомний REST.
-
Налаштування стандартного обміну. Налаштовуємо CommerceML, пакетний режим, прив'язку за артикулом. Перевіряємо коректність передачі даних на тестовому каталозі.
-
Розширена інтеграція. Для складних конфігурацій пишемо кастомні обробники на стороні 1С та Бітрікса. Підключаємо мультисклад, множинні ціни, часткове відвантаження.
-
Моніторинг та гарантія. Встановлюємо алерти, дашборд, документацію. Навчаємо операторів. Після запуску — гарантійна підтримка.
Типові налаштування обміну для каталогу 50 000 SKU
Пакетний режим: 500 елементів за крок. Прив'язка за артикулом. Період синхронізації: кожні 15 хвилин. Використовуємо агенти Бітрікса з тегованим кешуванням. На стороні 1С — обробка формування JSON замість XML для прискорення.
Строки та що входить в роботу
| Етап |
Опис |
Орієнтовний строк |
| Аналітика |
Аудит конфігурації 1С, структури обміну, поточних проблем |
1–2 дні |
| Проектування схеми |
Узгодження набору даних (товари, ціни, замовлення) та архітектури |
2–5 днів |
| Реалізація стандартного обміну |
Налаштування CommerceML, пакетного режиму, прив'язки за артикулом |
1–2 тижні |
| Розширена інтеграція |
Кастомний REST, мультисклад, множинні ціни, часткове відвантаження |
2–4 тижні |
| Повна кастомна зв'язка |
1С + сайт + Бітрікс24, асинхронні черги, моніторинг |
1–2 місяці |
Результат роботи включає: документовану схему обміну, налаштовані сценарії синхронізації, дашборд моніторингу, навчання операторів та гарантійну підтримку після запуску. Вартість розраховується індивідуально — вона залежить від складності конфігурації 1С, обсягу каталогу та необхідного ступеня автоматизації. Оцінимо ваш проект за 1 день — пишіть, обговоримо. Замовте інтеграцію — отримайте стабільний обмін за 1–2 тижні.
Ми провели понад 50 інтеграцій 1С для інтернет-магазинів та виробничих компаній. Середній досвід команди — 7 років, у нас є сертифіковані спеціалісти 1С-Бітрікс. Наш досвід гарантує, що обмін не зламається в перший же місяць і буде стабільно працювати роками. Наприклад, на проекті з каталогом 50 000 товарів автоматизація обміну заощадила клієнту близько 200 000 рублів на рік на операційних витратах.
Зв'яжіться з нами для безкоштовного аудиту вашої конфігурації 1С — знайдемо вузькі місця та запропонуємо оптимальне рішення.