Бесшовный обмен 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 лет. Предоставляем сертификаты и рекомендации. Закажите настройку интеграции уже сегодня — получите консультацию бесплатно.