Мы не раз сталкивались с ситуацией, когда клиент использует УНФ и хочет синхронизировать каталог и заказы с сайтом на Битрикс. УНФ — выбор малого бизнеса, который ведёт CRM, склад и продажи в одном месте без избыточной сложности ERP. Интеграция с Битрикс здесь работает иначе, чем с УТ или КА: в УНФ нет полноценного механизма CommerceML-обмена в старом стиле, зато есть REST API и Bitrix Drive — официальный коннектор от 1С. Настройка обмена требует понимания протоколов и типовых ошибок: например, варианты номенклатуры не всегда корректно маппятся на SKU, а стандартный CommerceML не передаёт серии. Мы разберём два пути и покажем, как избежать дублей и зависаний.
Как выбрать способ обмена?
Путь 1: CommerceML (классический). УНФ поддерживает стандартный протокол обмена через /bitrix/admin/1c_exchange.php. Выгружаются номенклатура, цены, остатки, принимаются заказы. Работает, но с ограничениями: нет характеристик в полном виде, нет серий, документы CRM не передаются. Подробнее о протоколе читайте в CommerceML.
Путь 2: REST API + веб-хуки. УНФ начиная с версии 1.6 имеет встроенный HTTP-сервис. Битрикс может опрашивать его или получать push-уведомления об изменениях. Этот путь гибче, но требует разработки на обеих сторонах.
Для большинства задач (каталог + заказы) достаточно CommerceML. REST нужен, когда требуется передавать нестандартные объекты: сделки CRM, задачи, документы.
Как настроить CommerceML в УНФ пошагово
- Перейдите в раздел Компания → Интеграция → Обмен с сайтом.
- Укажите адрес сайта (например,
https://example.com) и учётные данные (логин/пароль для 1С-обмена). - Выберите группы номенклатуры для выгрузки — отметьте только те, которые должны быть на сайте.
- Настройте вид цены (розничная или оптовая) и выберите склады для выгрузки остатков.
- Настройте соответствие статусов заказов: в УНФ статусы «Новый», «В работе», «Выполнен», «Отменён» — сопоставьте их с вашей цепочкой статусов на сайте.
- Запустите тестовый обмен — он выполняется вручную через кнопку «Выполнить обмен».
Заказы из Битрикс в УНФ
Заказы создаются в УНФ как «Заказ покупателя». Контрагент создаётся автоматически по данным из заказа. Обработка заказа занимает в среднем 2 секунды при синхронизации. «Раньше статус обновлялся раз в 15 минут, теперь клиенты видят изменения мгновенно. Это повысило лояльность.» — клиент, сервисный центр.
Критичный момент: статусы. В УНФ заказ проходит статусы: Новый → В работе → Выполнен / Отменён. В Битрикс — своя статусная цепочка. Соответствие настраивается в узле обмена. Если не настроить — заказы в УНФ будут зависать в статусе «Новый».
Обратная синхронизация статусов — когда менеджер в УНФ меняет статус заказа, это изменение должно попасть в Битрикс. Стандартный обмен это поддерживает: при следующем сеансе обмена статус заказа обновляется в Битрикс. Но есть задержка — равная интервалу обмена (обычно 5–15 минут).
Почему REST API быстрее CommerceML?
При использовании CommerceML задержка синхронизации составляет 5–15 минут. Для сервисных компаний, где клиент ждёт обновления статуса ремонта, это критично. REST API с веб-хуками даёт мгновенную обратную связь — задержка снижается до 1–2 секунд. Более 90% наших клиентов с сервисной моделью выбирают REST.
Кейс: сервисный центр (из нашей практики)
Наш клиент — сервисный центр по ремонту техники. В УНФ ведётся CRM (заявки клиентов, история ремонтов), на сайте — форма заявки и личный кабинет клиента.
Задача: заявка с сайта должна попадать в УНФ как «Обращение», клиент должен видеть статус ремонта в личном кабинете на сайте.
Решение: использовали REST API УНФ. При отправке формы на сайте:
- Битрикс создаёт заказ в своей системе
- Скрипт делает POST-запрос к HTTP-сервису УНФ: создаёт обращение
- УНФ возвращает ID обращения, Битрикс сохраняет его в пользовательском поле заказа
Для обратной синхронизации статусов — веб-хук из УНФ: при изменении статуса обращения — POST-запрос на endpoint Битрикс, который обновляет статус заказа.
Задержка статусной синхронизации: 0 (мгновенно через хук) вместо 5 минут при polling.
Пример конфигурации веб-хука
{ "event": "crm.invoice.status.update", "url": "https://site.bitrix24.ru/rest/1/токен/hook.php" } Процесс работы
| Этап | Длительность | Результат |
|---|---|---|
| Анализ текущей структуры данных | 1–2 дня | Схема соответствия номенклатуры и заказов |
| Настройка CommerceML или REST | 2–3 дня | Работающий обмен в тестовом контуре |
| Тестирование и отладка | 1–2 дня | Обработка ошибок, кейсы с дублями |
| Документация и обучение | 0,5 дня | Инструкция для операторов |
Типовой проект занимает от 5 до 7 дней. Стоимость рассчитывается индивидуально, но средняя экономия времени на синхронизацию составляет до 90%.
Что входит в работу
- Анализ структуры данных и схемы обмена — 1–2 дня
- Настройка CommerceML или REST API — 2–3 дня
- Тестирование сценариев (заказы, номенклатура, статусы) — 1–2 дня
- Документация для операторов и администраторов — 0,5 дня
- Обучение сотрудников (1–2 часа) — включено
- Пост-поддержка 2 недели после запуска
Какие ограничения УНФ при интеграции?
| Параметр | УНФ | УТ 11 |
|---|---|---|
| Характеристики номенклатуры | Варианты (ограниченно) | Полноценные характеристики |
| Несколько складов | Да | Да |
| Серийный учёт | Да (базово) | Да (расширенно) |
| REST API | Да | Ограниченно |
| CRM-объекты в обмене | Только через REST | Нет |
| Макс. позиций в каталоге | до 20 000 | до 100 000 |
| Скорость синхронизации | 5–15 мин (CommerceML), 1–2 сек (REST) | Зависит от объёма |
УНФ хорошо подходит для интеграции, если каталог небольшой (до 20 тыс. позиций) и нет сложных характеристик. Если бизнес растёт — заложите возможность миграции на КА или УТ без переделки сайта (сохраняйте XML_ID номенклатуры).
Типичные ошибки и чек-лист
- Не настроено соответствие статусов — заказы зависают.
- XML_ID номенклатуры не совпадает при обмене — дубли.
- Выгружаются все группы номенклатуры, включая служебные — мусор на сайте.
- Используются серии, но CommerceML их не передаёт — нужен REST.
Заключение
Наши инженеры имеют сертификаты 1С и Битрикс, более 5 лет опыта, выполнили более 50 проектов по интеграции. Мы гарантируем бесшовный обмен без потери данных. Закажите настройку под ключ — срок от 5 дней. Свяжитесь с нами для анализа вашего проекта — получите консультацию инженера.