Интеграция сайта на CMS Bitrix с 1С. Обмен товарами
Содержание
Обмен товарами (1С -> Битрикс).
Данный тип обмена (type=catalog) используется для создания и обновления на сайте следующих сущностей:
- инфоблок товаров
- UF-поля разделов в этом инфоблоке
- свойства элементов в этом инфоблоке
- инфоблок SKU
- типы цен
- склады
- разделы в инфоблоке товаров
- элементы в инфоблоке товаров (товары)
- цены товаров
- наличие товаров по складам
При обмене товарами 1С формирует XML-файлы, передает их на сайт и контролирует их обработку сайтом. 1С может передать 4 вида файлов:
- В файлах с префиксом import_ — разделы каталога, товары, свойства товаров
- В файлах с префиксом offers_ — SKU
- В файлах с префиксом prices_ — цены товаров и предложений
- В файлах с префиксом rests_ — остатки товаров и предложений по складам
На шаге авторизации в случае успеха сервер вернет дополнительный параметр timestamp (текущее время). 1С сохранит timestamp и передаст на сайт на последнем шаге обмена товарами.
Шаг 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 |
На этом шаге создаются или обновляются следующие данные:
- Инфоблоки товаров и SKU
- Служебные свойства каталога (с префиксом CML2_: CML2_BAR_CODE, CML2_ARTICLE, CML2_ATTRIBUTES…)
- Торговый каталог
- Свойства инфоблоков
- UF-поля разделов инфоблоков
- Типы цен
- Склады
- Единицы измерения
Никакие сущности при импорте метаданных не удаляются. Случайно выгруженный из 1С склад или тип цены остается на сайте, пока администратор не удалит его вручную.
Возможные ошибки
| Текст ошибки | Что делать |
|---|---|
| Отсутствует модуль «Торговый каталог». Импорт торговых предложений и цен невозможен | Пояснения не требуются |
| Ошибка создания типа информационных блоков | После этого сообщения следует текст ошибки API, который пояснит причину ошибки. |
| Ошибка добавления новой единицы измерения (код единицы: <код>) | Текст ошибки Битрикс не выведет, необходимо разобрать XML файл самостоятельно и найти причину ошибки. |
| Количество импортированных складов превышает разрешенное для данной редакции | Пояснения не требуются |
| Ошибка импорта пользовательского свойства (xml_id: <код>) | Проверить параметры пользовательского свойства |
| Название справочника должно начинаться с буквы и состоять только из латинских букв и цифр. | Пояснения не требуются |
| В выгрузке настроены цены с одинаковым названием. Продолжение обмена невозможно. | Пояснения не требуются |
| В редакции Малый Бизнес нет возможности иметь более одного типа цены. Настройте выгрузку из 1С или перейдите на другую редакцию БУС. | Пояснения не требуются |
| Текст ошибки | Что делать |
| Ошибка создания индекса для временных таблиц | Возможная причина: проблемы с СУБД, правами в ней или подключением. |
Шаг 2.7 Импорт разделов каталога.
| Ответ | |
| Если успех | progress |
| Группы импортированы | |
| Если ошибка | failure |
| Ошибка импорта метаданных | |
| <текст ошибки> | |
| Сессия ($_SESSION[BX_CML2_IMPORT][NS]) | |
| STEP | 5 |
На этом шаге в инфоблоке создаются и обновляются все разделы каталога, которые были в XML файле. Сопоставление разделов из XML-файла и в БД происходит по XML_ID. Если на сайте нет раздела с XML_ID из файла, он создается. Если есть, то выполняется сравнение полей из XML файла с аналогичными полями в БД.
Если изменения нет, то Битрикс только обновляет поле TIMESTAMP_X и пропускает раздел. Если изменения есть — происходит полноценное обновление. Это происходит независимо от настроек сайта. Для экономии ресурсов сервера добавление разделов происходит без пересчета дерева (речь о полях LEFT_MARGIN и RIGHT_MARGIN).
Возможные ошибки Так как импорт разделов не пошаговый, при обмене большом дереве разделов на сайте может возникать ошибка превышения времени исполнения. Решения три.
- Увеличить время исполнения на странице «Интеграция с 1С» и в настройках сервера (nginx).
- Доработать 1С, чтобы ошибки на этом этапе игнорировались пока не будет получен ответ «progress».
- Повторить всю выгрузку несколько раз.
Объясним, как поможет повтор шага или всей выгрузки. Допустим, в 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С отличить полную выгрузку от частичной просто: при частичной в узле «Классификатор» был атрибут СодержитТолькоИзменения="true", при полной его не было. В 2019 году 1С всегда выгружает этот атрибут. Если этого атрибута нет, Битрикс мог (и до сих пор может, просто этот код не используется) удалить, деактивировать старые разделы (или пропустить их). На выбор влиял параметр на странице «Интеграция с 1С». Сейчас эта настройка уже ни на что не влияет и ни деактивации, ни удаления не происходит.
Также на этом шаге пересчитываются служебные поля LEFT_MARGIN и RIGHT_MARGIN всех разделов.
Шаг 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" (старый формат выгрузки). Есть аналогичная настройка для выбора, что делать с товарами.
В 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С — время начала текущей сессии, полученное на шаге авторизации.
Напомним, что эти настройки в панели управления сайта сейчас ни на что не влияют (всегда происходит деактивация):
Этот шаг будет выполнен, только если современная 1С делает полную выгрузку. Для выгрузки изменений и в старых версиях 1С этого шага нет.
Шаг 4. Завершение импорта.
| Запрос | |
| GET-параметры | type=<тип обмена> |
| mode=complete | |
| sessid=<ID сессии> | |
| timestamp=<время на сервере> | |
| Cookie | <имя Cookie>=<значение Cookie> |
| Ответ | |
| Если успех | success |
| Завершение процедуры импорта | |
| Если ошибка | failure |
| <текст ошибки> | |
Служебный шаг. Обработки данных нет, только испускается недокументированное событие модуля catalog OnCompleteCatalogImport1C. Аргументы обработчика аналогичны обработчикам события OnSuccessCatalogImport1C, возвращаемого значения нет.
Будьте уверены, что ваша компания всегда останется на шаг впереди конкурентов с помощью тарифов 1С:ИТС.