К другим статьям
1С1С-БитриксCommerceMLИнтеграцииОбмен данными
Для бизнеса

Интеграция 1С и 1С-Битрикс: как настроить обмен с сайтом по шагам

Автор: Александр Драченин, разработчик 1С-Битрикс с 2018 года
Интеграция 1С и 1С-Битрикс: как настроить обмен с сайтом по шагам

Обмен 1С с сайтом на 1С-Битрикс настраивается штатными средствами. На сайте включают интеграцию с 1С и заводят пользователя для обмена, в 1С создают узел обмена с сайтом. Дальше 1С сама по расписанию отправляет на сайт товары, цены и остатки и забирает заказы. Ниже порядок настройки и то, что стоит проверить после первой выгрузки.

Если правила у вас сложнее типовых (несколько видов цен, склады, резервы, свои статусы заказов), сначала пройдите чек-лист обмена до запуска. Эта статья про сам процесс настройки.

Как устроен обмен

Обмен всегда начинает 1С. Она обращается к сайту по адресу https://ваш-сайт/bitrix/admin/1c_exchange.php, передаёт файлы в формате CommerceML и забирает заказы. Сайт сам в 1С не ходит, поэтому расписание задаётся на стороне 1С.

В одну сторону идут каталог, цены и остатки: в стандартном обмене это файлы import.xml (товары и разделы) и offers.xml (цены и остатки). В обратную сторону уходят заказы, покупатели и статусы. Синхронизация бывает по расписанию или почти в реальном времени; если связь пропала, изменения копятся и уходят, когда она вернётся.

Что нужно до начала

  • Редакция Битрикса. Обмен с 1С поддерживается в редакциях «Малый бизнес» и «Бизнес».
  • Модуль обмена в 1С. Для «Управления торговлей», «Комплексной автоматизации», ERP, УНФ и «Розницы» его выпускает 1С-Битрикс, он бесплатный. Какой нужен вашей конфигурации и как его обновить, разобрано в статье про модуль обмена.
  • Резервные копии. Копия сайта и копия базы 1С до первой выгрузки. Первая выгрузка меняет каталог целиком, откатить её без бэкапа сложно.
  • Решение, кто главный. Для каждого типа данных заранее решите, где он живёт: цены и остатки обычно ведутся в 1С, описания и картинки часто правят на сайте. Если это не решить, обмен будет перетирать правки.

Шаг 1. Пользователь для обмена на сайте

Заведите на сайте отдельного пользователя для обмена и отдельную группу с правом на интеграцию с 1С. Администраторскую учётную запись для постоянного обмена не используйте: её пароль меняют, и обмен ломается, а права у неё шире, чем нужно.

Логин и пароль этого пользователя потом укажете в узле обмена в 1С.

Шаг 2. Настройки интеграции на сайте

В административной части Битрикса откройте раздел «Интеграция с 1С» в настройках магазина. Названия полей зависят от версии модулей, но смысл один:

  • Группы пользователей, которым разрешён обмен. Сюда добавьте группу из шага 1.
  • Куда загружать каталог: тип и инфоблок. Если каталог на сайте уже есть, выберите именно его.
  • Что делать с товарами, которых нет в выгрузке. Безопаснее деактивировать, а не удалять: удалённый товар вместе с историей заказов уже не вернуть.
  • Интервал одного шага. Обмен идёт порциями. Если на больших каталогах обмен падает с ошибкой 502 или нехваткой памяти, уменьшите шаг до 1–5 секунд. Если не помогло, попробуйте выгрузку без картинок.
  • Выгрузка заказов: с какой даты и в каких статусах заказы уходят в 1С.

Шаг 3. Узел обмена в 1С

В 1С создайте узел обмена с сайтом. Где он находится в меню, зависит от конфигурации и релиза; инструкция по установке и настройке лежит внутри дистрибутива модуля. В узле указывают:

  • Адрес сайта и логин с паролем пользователя из шага 1.
  • Что выгружать: группы номенклатуры, виды цен, склады, характеристики и свойства.
  • Заказы: какие статусы и как сопоставлять покупателей с контрагентами.
  • Расписание полной выгрузки и выгрузки изменений.

Сразу проверьте, что выбраны нужные виды цен и склады. Пустая цена на сайте после первой выгрузки чаще всего значит, что вид цены не выбран в узле или не сопоставлен на сайте.

Шаг 4. Первая выгрузка

По возможности проведите её на копии сайта. Если каталог на сайте уже заполнен вручную или из другого источника, не удаляйте его перед выгрузкой. 1С сопоставляет товары по внешнему коду (XML_ID). Когда коды на сайте и в 1С не совпадают, после выгрузки появятся дубли: старый товар и новый с тем же названием.

После выгрузки сверьте:

  • число товаров и разделов на сайте и в 1С;
  • цены по нескольким товарам из разных видов цен;
  • остатки по нескольким товарам с разных складов;
  • что ручные правки, которые должны остаться (описания, картинки), остались.

Шаг 5. Заказы

Оформите на сайте тестовый заказ и проверьте, что он появился в 1С с правильным покупателем, товарами и суммой. Потом смените статус в 1С и убедитесь, что он вернулся на сайт. Если заказ не доходит, порядок проверки разобран в статье «Заказы с сайта не уходят в 1С».

Шаг 6. Расписание

Полную выгрузку каталога ставят редко, например раз в сутки ночью. Выгрузку изменений цен и остатков чаще, по нагрузке на сайт и на 1С. После включения расписания несколько дней смотрите журналы обмена на обеих сторонах: единичная ошибка видна сразу, а не через неделю, когда покупатель увидит неверную цену.

Частые ошибки после настройки

  • На сайте нет цены. Вид цены не выбран в узле обмена или не сопоставлен на сайте. Подробнее в статье «Цены и остатки не совпадают с 1С».
  • Дубли товаров. Каталог удалили перед выгрузкой или внешние коды на сайте и в 1С разные.
  • Обмен падает на середине. Большой каталог, мало памяти или времени на шаг: уменьшите интервал шага, выгрузите без картинок.
  • Ошибка авторизации или прав. Пользователь обмена не в той группе, у группы нет права на интеграцию. Начните с проверки системы в админке Битрикса: часть проблем она показывает сразу.
  • Ошибка проверки источника запроса. Встречается при обмене через сторонние сервисы и со старым модулем обмена. Сначала обновите модуль; отключать проверку стоит только осознанно, это снижает защиту обмена.

Когда нужен разработчик

Штатный обмен закрывает типовой магазин. Разработчик нужен, если конфигурация 1С доработана, у товаров нестандартные свойства, нужно выгружать несколько сайтов из одной базы, есть оптовые цены для B2B или обмен с Битрикс24. И когда обмен уже настроен, но регулярно ломается, а причина не видна.

На такие задачи есть услуга по интеграции с 1С: диагностика обмена стоит 10 000 ₽, после неё понятно, что сломано и сколько стоит ремонт.

Похожая задача?

Разберём вашу ситуацию с 1С-Битрикс

Опишите, что сейчас не работает или что нужно сделать — отвечу с планом и ориентиром по срокам.