Интеграция сайта на CMS Bitrix с 1С. Обмен товарами

Интеграция сайта на CMS Bitrix с 1С. Обмен товарами

Обмен товарами (1С -> Битрикс).

Данный тип обмена (type=catalog) используется для создания и обновления на сайте следующих сущностей:

  • инфоблок товаров
  • UF-поля разделов в этом инфоблоке
  • свойства элементов в этом инфоблоке
  • инфоблок SKU
  • типы цен
  • склады
  • разделы в инфоблоке товаров
  • элементы в инфоблоке товаров (товары)
  • цены товаров
  • наличие товаров по складам

При обмене товарами 1С формирует XML-файлы, передает их на сайт и контролирует их обработку сайтом. 1С может передать 4 вида файлов:

  • В файлах с префиксом import_ — разделы каталога, товары, свойства товаров
  • В файлах с префиксом offers_ — SKU
  • В файлах с префиксом prices_ — цены товаров и предложений
  • В файлах с префиксом rests_ — остатки товаров и предложений по складам

На шаге авторизации в случае успеха сервер вернет дополнительный параметр timestamp (текущее время). 1С сохранит timestamp и передаст на сайт на последнем шаге обмена товарами.

schema1.jpg

Шаг 1. Передача файла (повторяющийся).

Запрос
GET-параметры type=catalog
mode=file
sessid=<ID сессии>
filename=<имя файла>
POST Содержимое файла в виде строки
Cookie <имя Cookie>=<значение Cookie>
Ответ
Если успех success
Если ошибка failure
<текст ошибки>

Шаг может выполняется несколько раз. Каждый файл выгружается частями не более file_limit байт (см. предыдущий шаг) в бинарном виде через сырой POST-запрос. Сайт создает файл, если его нет. Имя файла берет из GET-параметра filename и дописывает в него переданный контент. Так продолжается до тех пор, пока 1С не передаст все части этого файла.
Возможные ошибки

Текст ошибки Что делать
Ошибка чтения HTTP данных Проверить сетевое соединение между сайтом и 1С.
Ошибка открытия файла <имя файла> для записи Проверить права на файл и папку файла у пользователя Apache, под которым работает Битрикс.
Ошибка записи в файл <имя файла> Проверить права на файл и папку файла у пользователя Apache, под которым работает Битрикс.

Шаг 2. Основной.

Запрос
GET-параметры type=<тип обмена>
mode=import
sessid=<ID сессии>
filename=<имя файла>
Cookie <имя Cookie>=<значение Cookie>
Ответ
Если импорт завершен success
Если импорт продолжается progress
<текущий статус>
Если ошибка failure
<текст ошибки>

Этот шаг — особенный. Файл уже целиком загружен на сайт и Битрикс готов его обработать. Его обработка может состоять из 11 более мелких операций, о которых 1С ничего не знает. Поэтому в параметре GET приходит mode=import (один и тот же запрос!), но сайт выполняет совершенно разные операции. Текущий прогресс Битрикс сохраняет в сессии в переменной $_SESSION[BX_CML2_IMPORT][NS]. Например, узел STEP в этом массиве отвечает как раз за номер внутренней операции импорта.

Шаг 2.1 Распаковка архива (повторяющийся, необязательный).

Ответ
Если файл распакован progress
Идет распаковка архива
Если файл распаковывается progress
Распаковка архива завершена
Если ошибка failure
<текст ошибки>

Шаг исполняется, только если 1С передала файл в формате ZIP. Распаковка происходит в той же директории, где лежат все файлы обмена товарами (по умолчанию — /upload/1c_catalog/). Эта операция не нумеруется внутри Битрикса (значение STEP в сессии не изменяется).
Возможные ошибки

Текст ошибки Что делать
Ошибка распаковки архива Проверьте работоспособность функции PHP zip_open и расширение Zip . Если все корректно — скачайте архив с сайта и проверьте его корректность вручную.

Шаг 2.2 Удаление временных таблиц.

Ответ
Если успех progress
Временные таблицы удалены
Сессия ($_SESSION[BX_CML2_IMPORT][NS])
STEP 0

Работать напрямую с файлом XML (тем более, если он большой) неудобно и неэффективно. Поэтому все данные прочитываются во временную таблицу b_xml_tree. На этом подготовительном шаге таблица b_xml_tree, если она существует, удаляется.

Шаг 2.3 Создание временных таблиц.

Ответ
Если успех progress
Временные таблицы созданы
Сессия ($_SESSION[BX_CML2_IMPORT][NS])
STEP 1

Таблица b_xml_tree создается. Если объявлена PHP константа BX_XML_CREATE_INDEXES_IMMEDIATELY, таблица сразу же индексируется. В конце этого шага Битрикс испускает событие OnBeforeCatalogImport1C.
Возможные ошибки

Текст ошибки Что делать
Ошибка создания временных таблиц Проверить права и подключение СУБД.

Шаг 2.4 Загрузка файла во временную таблицу (повторяющийся).

Ответ
Если файл читается progress
Обработано <число>% файла
Если файл прочитан progress
Файл импорта прочитан
Если ошибка failure
<текст ошибки>
Сессия ($_SESSION[BX_CML2_IMPORT][NS])
STEP 2

Битрикс шаг за шагом начинает читать переданный из 1С файл, добавляя записи в таблицу b_xml_tree. Чтобы избежать проблем с временем исполнения, процесс происходит пошагово. Управление продолжительностью шага происходит на странице «Интеграция с 1С» в панели управления сайтом.
Возможные ошибки

Текст ошибки Что делать
Ошибка открытия файла импорта Проверить доступ к файлу

Шаг 2.5 Индексация временных таблиц.

Ответ
Если успех progress
Временные таблицы проиндексированы
Если ошибка failure
<текст ошибки>
Сессия ($_SESSION[BX_CML2_IMPORT][NS])
STEP 3

Для повышения скорости работы импорта таблица b_xml_tree индексируется после прочтения файла.
Возможные ошибки

Текст ошибки Что делать
Ошибка создания индекса для временных таблиц Возможная причина: проблемы с СУБД, правами в ней или подключением.

Шаг 2.6 Импорт метаданных.

Ответ
Если успех progress
Метаданные импортированы успешно
Если ошибка failure
Ошибка импорта метаданных
<текст ошибки>
Сессия ($_SESSION[BX_CML2_IMPORT][NS])
STEP 4

На этом шаге создаются или обновляются следующие данные:

  1. Инфоблоки товаров и SKU
  2. Служебные свойства каталога (с префиксом CML2_: CML2_BAR_CODE, CML2_ARTICLE, CML2_ATTRIBUTES…)
  3. Торговый каталог
  4. Свойства инфоблоков
  5. UF-поля разделов инфоблоков
  6. Типы цен
  7. Склады
  8. Единицы измерения
Никакие сущности при импорте метаданных не удаляются. Случайно выгруженный из 1С склад или тип цены остается на сайте, пока администратор не удалит его вручную.

Возможные ошибки

Текст ошибки Что делать
Отсутствует модуль «Торговый каталог». Импорт торговых предложений и цен невозможен Пояснения не требуются
Ошибка создания типа информационных блоков После этого сообщения следует текст ошибки API, который пояснит причину ошибки.
Ошибка добавления новой единицы измерения (код единицы: <код>) Текст ошибки Битрикс не выведет, необходимо разобрать XML файл самостоятельно и найти причину ошибки.
Количество импортированных складов превышает разрешенное для данной редакции Пояснения не требуются
Ошибка импорта пользовательского свойства (xml_id: <код>) Проверить параметры пользовательского свойства
Название справочника должно начинаться с буквы и состоять только из латинских букв и цифр. Пояснения не требуются
В выгрузке настроены цены с одинаковым названием. Продолжение обмена невозможно. Пояснения не требуются
В редакции Малый Бизнес нет возможности иметь более одного типа цены. Настройте выгрузку из 1С или перейдите на другую редакцию БУС. Пояснения не требуются
Текст ошибки Что делать
Ошибка создания индекса для временных таблиц Возможная причина: проблемы с СУБД, правами в ней или подключением.

Шаг 2.7 Импорт разделов каталога.

Ответ
Если успех progress
Группы импортированы
Если ошибка failure
Ошибка импорта метаданных
<текст ошибки>
Сессия ($_SESSION[BX_CML2_IMPORT][NS])
STEP 5

На этом шаге в инфоблоке создаются и обновляются все разделы каталога, которые были в XML файле. Сопоставление разделов из XML-файла и в БД происходит по XML_ID. Если на сайте нет раздела с XML_ID из файла, он создается. Если есть, то выполняется сравнение полей из XML файла с аналогичными полями в БД.

2. 2-8.jpg

Если изменения нет, то Битрикс только обновляет поле TIMESTAMP_X и пропускает раздел. Если изменения есть — происходит полноценное обновление. Это происходит независимо от настроек сайта. Для экономии ресурсов сервера добавление разделов происходит без пересчета дерева (речь о полях LEFT_MARGIN и RIGHT_MARGIN).
Возможные ошибки Так как импорт разделов не пошаговый, при обмене большом дереве разделов на сайте может возникать ошибка превышения времени исполнения. Решения три.

  1. Увеличить время исполнения на странице «Интеграция с 1С» и в настройках сервера (nginx).
  2. Доработать 1С, чтобы ошибки на этом этапе игнорировались пока не будет получен ответ «progress».
  3. Повторить всю выгрузку несколько раз.

Объясним, как поможет повтор шага или всей выгрузки. Допустим, в XML-файле и на сайте 20001 раздел. Пусть за один проход Битрикс успевает импортировать только 10000 разделов.

№ Обмена/шага Пропущено т.к. нет изменений Обработано Ответ
1 0 10000 Ошибка сервера
2 10000 10000 Ошибка сервера
3 20000 1 progress
Группы импортированы

Битрикс каждый раз обрабатывает столько разделов, сколько успевает. При повторении выгрузки первые 10000 разделов он пропустит (обновит только TIMESTAMP_X) и обновит еще 10000 разделов, пока не наступил тайм-аут. И только на 3-ей выгрузке из 1С шаг будет завершен корректно.

Шаг 2.8 Пересчет дерева разделов.

Ответ
Если успех progress
Деактивация/удаление групп завершено
Если ошибка failure
Ошибка импорта метаданных
<текст ошибки>
Сессия ($_SESSION[BX_CML2_IMPORT][NS])
STEP 6

На этом шаге Битрикс выполняет две задачи:

  1. Удаление/деактивация разделов (в старых версиях модуля обмена в 1С)
  2. Перестройка дерева разделов

В старых версиях 1С отличить полную выгрузку от частичной просто: при частичной в узле «Классификатор» был атрибут СодержитТолькоИзменения="true", при полной его не было. В 2019 году 1С всегда выгружает этот атрибут. Если этого атрибута нет, Битрикс мог (и до сих пор может, просто этот код не используется) удалить, деактивировать старые разделы (или пропустить их). На выбор влиял параметр на странице «Интеграция с 1С». Сейчас эта настройка уже ни на что не влияет и ни деактивации, ни удаления не происходит.
Также на этом шаге пересчитываются служебные поля LEFT_MARGIN и RIGHT_MARGIN всех разделов.

3. 2-9.jpg

Шаг 2.9 Импорт товаров (повторяющийся).

Ответ
Если идет процесс импорта progress
Обработано <число> из <число> элементов
Если импорт завершен progress
Загрузка элементов завершена
Если ошибка failure
<текст ошибки>
Сессия ($_SESSION[BX_CML2_IMPORT][NS])
STEP 7
DONE Ассоциативный массив, счетчик обработанных товаров и всех товаров в файле

На этом шаге в инфоблоке создаются и обновляются все товары, которые были в XML файле. Сопоставление товаров в файле товарам на сайте происходит по полю XML_ID.
Если на сайте нет товара с XML_ID из файла, он создается. Если есть, то выполняется сравнение полей из XML файла с аналогичными полями в БД.
Если изменения нет, и задан параметр «Использовать контрольные суммы элементов для оптимизации обновления каталога», Битрикс только обновляет поле TIMESTAMP_X и пропускает товар. Иначе происходит полноценное обновление.
При импорте товара заполняется поле TMP_ID. Значение для этого поля хранится в узле <НомерВерсии>. Если узла нет — Битрикс вычисляет контрольную сумму от всей информации о товаре из XML файла.
Возможные ошибки

Текст ошибки Что делать
Временная таблица не существует Ошибка возникает если с сайтом работает несколько 1С или одна 1С присылает несколько запросов одновременно. В одном потоке выполняется шаг 4.9, а другой запустил шаг 4.2.

Шаг 2.10 Деактивация/удаление товаров (повторяющийся).

Ответ
Если идет обработка progress
Обработано <число> из <число> элементов
Если обработка завершена progress
Деактивация/Удаление элементов завершены
Если ошибка failure
<текст ошибки>
Сессия ($_SESSION[BX_CML2_IMPORT][NS])
STEP 8
DONE Ассоциативный массив, счетчик обработанных товаров и всех товаров в файле

На этом шаге раньше (как и на шаге 2.8 Пересчет дерева разделов) Битрикс проводил чистку товаров. Чистка товаров происходила только если в узле “Классификатор” XML файла не было пометки СодержитТолькоИзменения="true" (старый формат выгрузки). Есть аналогичная настройка для выбора, что делать с товарами.

4. 2-11.jpg

В 2019 году на этом шаге ничего не происходит.

Шаг 2.11 Завершение импорта

Ответ
Если успех success
Импорт успешно завершен
Если ошибка failure
<текст ошибки>
Сессия ($_SESSION[BX_CML2_IMPORT][NS])
STEP 9

Служебный шаг. Обработки данных нет, только испускается событие OnSuccessCatalogImport1C.

Шаг 3. Деактивация старых данных.

Запрос
GET-параметры type=<тип обмена>
mode=deactivate
sessid=<ID сессии>
timestamp=<время на сервере>
Cookie <имя Cookie>=<значение Cookie>
Ответ
Если успех success
Деактивация элементов завершена
Если ошибка failure
Ошибка деактивации элементов

На этом шаге в 2019 году Битрикс деактивирует все товары и разделы каталога, не затронутые в текущей сессии. Для этого время последнего изменения сравнивается с timestamp, который передает 1С — время начала текущей сессии, полученное на шаге авторизации.
Напомним, что эти настройки в панели управления сайта сейчас ни на что не влияют (всегда происходит деактивация):

5. 3.jpg

Этот шаг будет выполнен, только если современная 1С делает полную выгрузку. Для выгрузки изменений и в старых версиях 1С этого шага нет.

Шаг 4. Завершение импорта.

Запрос
GET-параметры type=<тип обмена>
mode=complete
sessid=<ID сессии>
timestamp=<время на сервере>
Cookie <имя Cookie>=<значение Cookie>
Ответ
Если успех success
Завершение процедуры импорта
Если ошибка failure
<текст ошибки>

Служебный шаг. Обработки данных нет, только испускается недокументированное событие модуля catalog OnCompleteCatalogImport1C. Аргументы обработчика аналогичны обработчикам события OnSuccessCatalogImport1C, возвращаемого значения нет.

{{ ELEMENTS.length }}
Наименование
Цена
Количество
Артикул : {{ item.MODEL }}
{{ item.STATUS }}
{{ item.PRICE }} руб.
{{ item.OLD_PRICE }} руб.
- +
Вы экономите: {{ DATA.TOTAL_DISCOUNT_SUM }} руб.
Итого: {{ DATA.TOTAL_SUM }} руб.
Вы можете вернуться в каталог и продожить покупки
Вернуться и продолжить покупки