Безшовний обмін 1С та Бітрікс: налаштування REST API під ключ
Уявіть: ваш інтернет-магазин на 1С-Бітрікс, а складський облік у 1С. Під час акції ви оновлюєте ціни, але CommerceML передає їх раз на 30 хвилин. Клієнт бачить стару вартість, замовлення йдуть з невірними залишками — склад у мінусі. Знайома ситуація? Ми спеціалізуємося на інтеграції 1С та Бітрікс через REST API. За 10+ років роботи впровадили безшовний обмін для 100+ проєктів. Наше рішення — синхронізація в реальному часі, без затримок і помилок.
CommerceML — синхронний пакетний обмін файлами. REST API — подієвий обмін у момент зміни даних. Різниця критична: другий підхід дає оновлення даних практично в реальному часі та дозволяє обмінюватися сутностями, які CommerceML не підтримує: довільні довідники, документи, завдання. Саме тому для сучасної торгівлі REST API стає стандартом де-факто.
Чому REST API швидше CommerceML?
| Параметр | CommerceML | REST API |
|---|---|---|
| Швидкість обміну | Раз на 15–30 хвилин | Миттєво (секунди) |
| Тип передачі | Пакетний файл | Подієвий запит |
| Підтримка нестандартних сутностей | Тільки каталог, замовлення | Будь-які дані (завдання, довідники) |
| Навантаження на сервер | Висока (обробка всіх даних) | Низька (точкові оновлення) |
| Помилки синхронізації | Часто через блокування | Мінімум при коректному налаштуванні |
Коли обирати REST API замість CommerceML?
REST-інтеграція виправдана при: необхідності оновлення даних швидше, ніж раз на 15 хвилин (ціни під час акції, критичні залишки); обміні нестандартними даними; інтеграції з самописною конфігурацією 1С без стандартної обробки обміну; наявності кількох сайтів або сервісів, підключених до однієї бази 1С. Перехід на REST API скорочує витрати на ручну синхронізацію та знижує ймовірність помилок.
Як налаштувати обмін залишків через REST?
Бітрікс надає REST API через модуль rest. Для зовнішніх систем створіть вхідний вебхук: Налаштування → Налаштування продуктів → REST API → Вхідні вебхуки → Додати. Права вебхука — тільки необхідні: catalog для каталогу, sale для замовлень. Не надавайте прав адміністратора.
З 1С (через HTTP-з'єднання в конфігураторі) відправляється запит до API Бітрікс:
POST https://myshop.ru/rest/1/WEBHOOK_KEY/catalog.storeproduct.update Content-Type: application/json { "productId": 12345, "storeId": 3, "amount": 47 } Це точкове оновлення — змінюється тільки конкретний товар на конкретному складі. На відміну від пакетного вивантаження, що обробляє всі 50 000 позицій, REST-виклик займає мілісекунди.
Як отримувати замовлення в 1С без затримок?
Альтернатива файловому обміну — 1С опитує REST API за розкладом:
GET https://myshop.ru/rest/1/WEBHOOK_KEY/sale.order.list ?filter[STATUS_ID]=N &filter[>=DATE_INSERT]=DATE_LAST_SYNC &select[]=ID &select[]=ACCOUNT_NUMBER &select[]=PRICE &select[]=CURRENCY Відповідь — JSON зі списком нових замовлень. 1С обробляє кожне, створює документи, після чого оновлює статус через sale.order.update.
Для негайної передачі подій (нове замовлення, зміна статусу) налаштуйте вихідний вебхук Бітрікс, який відправляє дані в HTTP-сервіс 1С: Налаштування → REST API → Вихідні вебхуки → Додати. Вкажіть URL HTTP-сервісу та тип події ONSALEORDERNEW. При появі нового замовлення Бітрікс негайно POST-запитом сповіщає 1С — без очікування наступного сеансу обміну.
Як уникнути типових помилок інтеграції?
Часті проблеми: невірний URL вебхука — немає відповіді, дублювання замовлень — неправильна обробка статусу, помилка аутентифікації — невірний ключ. Рішення: перевірте доступність HTTP-сервісу, використовуйте ідемпотентні ключі, перевірте права в налаштуваннях REST API. Докладніше про налаштування читайте в офіційній документації 1С-Бітрікс: REST API – офіційна документація.
Додаткові параметри налаштування
- Налаштування прав доступу для кожного вебхука окремо.
- Використання REST API для кастомних сутностей.
- Логування запитів для налагодження.
Що входить в налаштування обміну під ключ?
- Аудит поточної інтеграції та виявлення вузьких місць.
- Проєктування схеми обміну: вибір методів REST, налаштування вебхуків.
- Реалізація HTTP-сервісу в 1С для прийому запитів.
- Написання скриптів обміну для залишків, цін та замовлень.
- Тестування коректності синхронізації на тестових даних.
- Документація з експлуатації та навчання ваших спеціалістів.
- Гарантійна підтримка протягом місяця після впровадження.
Процес роботи
- Аналітика: вивчаємо вашу конфігурацію 1С та налаштування сайту.
- Проєктування: розробляємо архітектуру інтеграції.
- Реалізація: налаштовуємо REST API, пишемо HTTP-сервіс.
- Тестування: перевіряємо синхронізацію на всіх сценаріях.
- Деплой: запускаємо в промислову експлуатацію.
Терміни та вартість
Налаштування REST-інтеграції для обміну залишками та замовленнями — 1–2 дні. З вебхуками та push-сповіщеннями в обидві сторони — 3–5 днів. Повна заміна CommerceML на REST API для великого каталогу — 1–3 тижні. Вартість розраховується індивідуально після аудиту. Зв'яжіться з нами — оцінимо ваш проєкт і запропонуємо оптимальне рішення. Впровадження окупається за 2–3 місяці за рахунок зниження ручної праці.
Гарантуємо якість: всі роботи виконуються інженерами з досвідом роботи з Бітрікс та 1С понад 10 років. Надаємо сертифікати та рекомендації. Замовте налаштування інтеграції вже сьогодні — отримайте консультацію безкоштовно.