Обмен 1С и 1С-Битрикс: пошаговая настройка, файлы и команды

Технический разбор обмена 1С и «1С-Битрикс: Управление сайтом» на новом сайте: что проверить до старта, как настроить форму интеграции и модуль 8.x, какие файлы приезжают при выгрузке товаров, какими командами идёт обмен заказами и что делать при типовых ошибках. С примерами кода и отличиями от ветки 7.x.

Что определить до настройки: вводные, которые меняют весь порядок

Обмен нельзя настраивать «по инструкции из интернета», не зафиксировав пять параметров. Каждый из них меняет и последовательность шагов, и состав работ.

ВводнаяПочему критична
Конфигурация 1С и её релизОт неё зависит ветка модуля обмена: для «Розницы» ред. 2.3 в документации описан модуль 8.0.x, для «Управление торговлей» ред. 11.5 — 8.1.x, для УТ ред. 11.1–11.3 — 7.0.x, для «Управление нашей фирмой» — 8.x
Типовая или доработанная конфигурацияДоработки влияют на обязательные реквизиты и на то, встанет ли расширение без конфликтов
Файловая или клиент-серверная базаОт этого зависит, будет ли обмен запускаться по расписанию автоматически
Используется ли РИБПри распределённой информационной базе модуль ставится в подчинённый узел, а не в корневой
Редакция «1С-Битрикс: Управление сайтом»Форма «Интеграция с 1С» недоступна в редакциях «Старт» и «Стандарт»; в «Малом бизнесе» один вид цены и нельзя разнести остатки по складам

И шестое, организационное: кто мастер по каталогу. Штатно поддерживаются оба направления — выгрузка каталога из 1С на сайт и выгрузка каталога с сайта в 1С. Это разные закладки настроек и разные компоненты. Дальше в статье основной сценарий — новый сайт, мастер по товарам 1С; отдельно разберу вариант, когда каталог ведётся на сайте.

Направления обмена, которые работают без разработки:

  • type=catalog — товары, разделы, свойства, торговые предложения, типы цен, склады, цены, остатки;
  • type=reference — пользовательские справочники, на сайте превращаются в highload-блоки;
  • type=sale — заказы в обе стороны, а также контрагенты и пользователи.

Шаг 0. Проверка редакции и модулей на сайте

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

  1. Смотрю текущую редакцию: Marketplace → Обновление платформы.
  2. Проверяю, что форма Магазин → Настройки → Интеграция с 1С открывается. В «Старт» и «Стандарт» её нет.
  3. Проверяю установленные модули: информационных блоков, торгового каталога, интернет-магазина. Их отсутствие сайт сообщает прямо на шаге авторизации или импорта метаданных: «Модуль Информационных блоков не установлен», «Отсутствует модуль "Торговый каталог". Импорт торговых предложений и цен невозможен».
  4. Если редакция «Малый бизнес», сразу фиксирую два ограничения и что с ними делать:
Ограничение «Малого бизнеса»Что настроить
Доступен только один вид ценыВ отборах выгрузки в 1С настроить выгрузку одной цены по конкретному соглашению; сверить внешний код типа цены в XML и на сайте (Магазин → Настройки → Типы цен), а также название типа цены в 1С и поле «код» на сайте
Нельзя разнести остатки по складамОтключить выгрузку остатков по складам либо убедиться, что склад ровно один. При превышении импорт возвращает ошибку

Несколько типов цен доступны начиная с редакции «Бизнес». Если проект изначально предполагает оптовую и розничную цену плюс склады — это разговор о смене редакции, а не о настройке обмена.

Шаг 1. Подготовка структуры каталога на новом сайте

На новом сайте соблазн велик: «пусть 1С сама создаст инфоблоки». Так делать можно, но часть решений необратима после первого обмена — их принимают заранее.

Тип инфоблока и привязка к сайтам. В настройках указывается тип инфоблока; есть вариант «Создать по необходимости» — тогда при импорте будет создан новый тип. Отдельно задаётся, к каким сайтам привязывать вновь создаваемые инфоблоки.

Товары и предложения — один инфоблок или два. Опция «Загружать предложения (характеристики) в отдельный инфоблок» разводит товары и торговые предложения по разным инфоблокам. Если у ассортимента есть варианты (цвет, размер, фасовка) — включаем. Если вариантов нет, работает опция «Цены только в инфоблоке торговых предложений»: для каждого товара без характеристик будет создано одно предложение, и цена будет храниться в нём. Это решение влияет на шаблоны, фильтр и выгрузки в маркетплейсы, поэтому его нельзя менять «по ходу».

Символьный код и URL. В настройках две отдельные опции транслитерации символьного кода из названия: при добавлении элемента или раздела и при обновлении. Вторая означает, что переименование товара в 1С поменяет символьный код на сайте, а с ним и URL страницы. Для проекта, который рассчитывает на поисковый трафик, я либо выключаю транслитерацию при обновлении, либо заранее проектирую карту редиректов. Там же задаётся символ замены неалфавитных символов.

Свойства и разделы. Выгружаются только те свойства, которые перечислены в настройках обмена в 1С, и они не привязываются к разделам инфоблоков автоматически — привязка делается вручную на сайте. На новом сайте это отдельный этап работ после первого обмена, а не «само настроится».

Изображения. Есть опция «Использовать настройки инфоблока для обработки изображений» — тогда параметры инфоблока имеют приоритет над настройками импорта. Иначе задаются генерация картинки анонса и изменение детальной картинки с ограничением по максимальной ширине и высоте. Это защита от приезда из 1С фотографий по несколько мегабайт.

Индексация. В настройках инфоблока индексацию элементов, разделов и свойств можно отключить — официальный раздел типичных ошибок называет включённую индексацию одной из причин медленного импорта. На большом первичном импорте это заметно.

Структура разделов, если учётная иерархия не годится для витрины. Три варианта, все решаются до старта:

  1. Пользовательское дерево групп в модуле обмена — своя структура для сайта без изменения иерархии номенклатуры в 1С, товар можно включить в несколько групп.
  2. Прайс-лист в 1С как прокси: секции создаются в прайс-листе, на сайт уходит его структура.
  3. Отдельный инфоблок-классификатор на сайте: приехавшая структура живёт в служебном инфоблоке, «человеческие» разделы связываются с ней свойством-привязкой к разделам, в том числе множественной.

Шаг 2. Форма «Интеграция с 1С» на сайте: по закладкам

Форма находится в Магазин → Настройки → Интеграция с 1С и содержит четыре закладки: «Каталог», «Экспорт каталога», «Заказы», «Профили обмена».

Закладка «Каталог»: приём товаров из 1С

ОпцияЧто ставлю на новом сайте и почему
Тип инфоблокаЗаранее созданный тип под каталог, а не «Создать по необходимости» — чтобы структура была предсказуемой
Привязывать вновь создаваемые инфоблоки к сайтамТекущий сайт или конкретный сайт из списка
Разрешить загрузку группам пользователейТолько группа служебного пользователя обмена
Загружать предложения в отдельный инфоблокПо решению из шага 1
Транслитерация символьного кода при добавленииВключаю
Транслитерация символьного кода при обновленииПо решению о URL; для SEO-проекта выключаю
Замена для неалфавитных символовЕдиный символ, обычно дефис или подчёркивание
Не импортировать верхний уровень группы товаров, если он единственныйВключаю, если в 1С одна корневая группа-«обёртка»
При выгрузке учитывать тип инфоблокаВключаю, когда каталогов несколько и они разводятся по типам
Не менять код (название) типа цены, если используется внешний код (XML_ID)Включаю, чтобы код типа цены не «уезжал» при синхронизации
Цены только в инфоблоке торговых предложенийПо решению из шага 1

Расширенные настройки каталога: то, что определяет скорость и безопасность

ОпцияСмысл
Интервал одного шага в секундахДлительность шага пошагового импорта. 0 — выполнить за один шаг
Размер единовременно загружаемой части файла (в байтах)Второе ограничение пошаговой загрузки файла
Использовать сжатие zip, если доступноЗаметно уменьшает XML-файлы
Использовать контрольные суммы элементов для оптимизации обновления каталогаПри полной выгрузке обновляются только изменившиеся элементы
Что делать с товарами, отсутствующими в файле импортаудалить / ничего / деактивировать
Что делать с группами, отсутствующими в файле импортаудалить / ничего / деактивировать
Тегированный кеш инфоблокаСбрасывать после каждой операции, в конце каждого шага импорта, после окончания импорта или не сбрасывать
Использовать настройки инфоблока для обработки изображенийПриоритет настроек инфоблока над настройками импорта
Автоматически генерировать картинку анонса, максимальная ширина и высотаОграничение размеров анонса
Изменять детальную картинку, максимальная ширина и высотаОграничение размеров детального изображения

Две ловушки, о которых предупреждаю заказчиков:

  • «Не сбрасывать» тегированный кеш означает, что информация на сайте не обновляется, даже если импорт отработал успешно. Для витрины с ценами это неприемлемо; выбираю сброс после окончания импорта как компромисс между скоростью и свежестью.
  • Удаление вместо деактивации при обрыве сеанса способно унести часть каталога. На новом сайте первые обмены я провожу с вариантом «ничего», а решение о деактивации принимаю, когда выгрузка стабильно доходит до конца.

Отдельно: параметр «что делать с товарами, отсутствующими в файле» в документации помечен как не работающий с модулем обмена версии 6.0, а для групп есть примечание про модули 4.x, где группы деактивировались всегда. Поведение этой группы опций исторически менялось вместе со схемой выгрузки, поэтому проверять его нужно на своей связке версий, а не по чужому скриншоту.

Закладка «Экспорт каталога»: если мастер по товарам — сайт

Настройки: инфоблок каталога, количество элементов, выгружаемых за один шаг (0 — за один шаг), интервал одного шага в секундах, «Разрешить выгрузку группам пользователей», сжатие ZIP. Это направление используется, когда каталог ведут на сайте, а 1С загружает товары к себе.

Закладка «Заказы»

ОпцияНа что влияет
Сайт, заказы которого выгружать в 1СКакой магазин отдаёт заказы; можно развести несколько сайтов на разные учётные системы
Создавать новые заказы и контрагенты из 1СБудут ли добавляться на сайт заказы, созданные в учёте
Сайт, на который добавлять новые заказы и контрагентыКуда их добавлять
Префикс номера заказа при выгрузкеПрефикс к номеру при передаче
Выгружать только оплаченные заказыФильтр отдачи
Выгружать только заказы с разрешённой доставкойФильтр отдачи
Выгружать заказы начиная со статусаФильтр по статусу; «Не выбрано» — все заказы
Менять статусы заказов по информации из 1ССтатус на сайте follows статус в учёте
Статус, в который переводить заказ при получении отгрузки от 1СРекомендуется «Не выбрано», если включена опция выше
Заменять валюту при выгрузке в 1СПодмена обозначения валюты, без конвертации
Наличный расчёт, безналичный расчёт, эквайринговая операция — платёжные системы для новых оплатКакая платёжная система подставляется в документы оплаты из 1С; тип сообщает 1С
Платёжная система для автоматической оплаты по статусу от 1САвтооплата при приходе статуса
Служба доставки для новых заказовПодставляется в документы новых заказов из 1С
Увеличивать количество продукта в корзине, если количество в доставке из 1С большеПоведение при расхождении количеств
Создавать новые документы оплаты из 1ССоздание документов оплаты
Создавать новый документы доставки из 1ССоздание документов доставки
Создавать новый заказ при получении новой доставки, если заказ-основание не найденПоведение при отсутствии исходного заказа
Группы, пользователям которых разрешена выгрузкаПрава на отдачу заказов
Сжатие zip, интервал одного шага в секундах, размер части файлаТранспорт и пошаговость

На новом сайте чаще всего именно фильтры отдачи («только оплаченные», «начиная со статуса») становятся причиной «1С не забирает заказы». Проверяю их первыми, когда заказы не уходят.

Закладка «Профили обмена»

Это настройка полей экспорта заказа, отдельно для каждого типа плательщика: название параметра, тип, значение, флаг «По умолчанию» (общее для всех бизнес-смыслов либо частная настройка), кнопка «Добавить реквизит» для дополнительного параметра, который попадёт в реквизиты заказа в 1С.

Критичные поля — «Наименование» и «Полное Наименование». Если соответствия не заданы, обмен заказами падает с ошибкой вида «Поле объекта не обнаружено (Наименование)». Это первое место, куда я смотрю при такой ошибке.

Шаг 3. Служебный пользователь и права

Обмен авторизуется на сайте методом HTTP Basic: логин и пароль берутся из настроек обмена в 1С.

Порядок:

  1. Создаю отдельного пользователя под обмен. Не администратор сайта: егоcredentials лежат в настройках 1С и используются автоматически.
  2. Создаю или выбираю группу, которой разрешён обмен, и добавляю пользователя в неё.
  3. В закладке «Каталог» указываю эту группу в «Разрешить загрузку группам пользователей»; в закладке «Заказы» — в «Группы, пользователям которых разрешена выгрузка».
  4. Если используются собственные страницы обмена (шаг 12), для разрешённых групп уровень доступа к странице должен быть не ниже «Чтение», для остальных доступ закрывается.

Ошибка «У Вас нет прав для импорта каталога. Проверьте настройки компонента» означает именно этот пункт, а не проблему с паролем.

Шаг 4. Установка модуля обмена в 1С: ветка 8.x

Модуль ставится в 1С, а не на сайт. Он берёт на себя клиентскую часть протокола: авторизацию, формирование XML, разбиение на части, повторные запросы.

Последовательность для 8.0.x по документации:

  1. Установить скачанный установщик модуля обмена согласно прилагаемой инструкции.
  2. Запустить «1С:Предприятие» в режиме Конфигуратор.
  3. Сделать архивную копию базы: Администрирование → Выгрузить информационную базу.
  4. Закрыть конфигуратор и запустить систему в режиме «1С:Предприятие». База должна быть в монопольном режиме — других пользователей быть не должно.
  5. Перейти: Администрирование → Печатные формы, отчёты и обработки → Расширения.
  6. Нажать Добавить и указать скачанный файл .cfe.
  7. Снять флаг «Безопасный режим».
  8. Перезапустить сеанс подключения к базе.

Два обязательных замечания:

  • Раздел с настройками модуля видят только администратор и пользователи с правом «(1С-Битрикс: Управление сайтом) Администратор». Если специалист «не видит настроек» — вопрос в правах, а не в установке.
  • При распределённой информационной базе модуль устанавливается в подчинённый узел; дальнейшая синхронизация между узлами идёт по правилам РИБ.

Привязка веток к решениям, зафиксированная в документации: 8.0.x «Интернет-магазин + 1С» предназначен для «Розницы» ред. 2.3; для «Управление торговлей» ред. 11.5 описан модуль 8.1.x; для УНФ — ветка 8.x. Состав экранов настройки в 8.1.x и 8.0.x различается, поэтому названия пунктов сверяю в той сборке, которая стоит у заказчика.

Шаг 5. Настройка обмена в 1С: каталог, отборы, свойства, остатки, цены

В документации модуля для УТ 11.5 настройка разбита на разделы, и это удобный чек-лист того, что вообще нужно настроить: общие настройки обмена с сайтами, создание настройки обмена с сайтом, выгрузка информации о товарах, обмен документами, выгрузка пользовательских справочников, выгрузка контрагентов, зарегистрированные изменения, журнал обменов, журнал ошибок, идентификаторы объектов БУС, картинки и файлы характеристик номенклатуры, импорт товаров из интернет-магазина.

Каталоги и отборы

Каждый выгружаемый каталог — отдельный инфоблок на сайте. В левой части окна настройки перечисляются каталоги, в правой — параметры выбранного каталога; для каждого каталога настройки индивидуальные. Кнопка «Подробно» показывает идентификаторы каталога, по которым происходит связка с инфоблоками.

Кнопка «Отбор» открывает окно отборов по выгружаемой информации; можно использовать предопределённые отборы или задать свой.

Здесь самая частая ошибка новичков: настраивается именно фильтр, а не выбор полей для выгрузки. Если поле отмечено, значение фильтра должно быть задано. Иначе при нажатии «Выполнить обмен» сразу приходит «Изменения товаров не зарегистрированы. Выгрузка товаров не произведена». При полной выгрузке настройка фильтра не обязательна — выделение со всех отмеченных полей нужно снять.

Пользовательское дерево групп

Позволяет собрать структуру разделов для сайта, не меняя иерархию в 1С; один товар можно указать сразу нескольким группам. Дерево привязывается к каталогу через идентификатор каталога, вызывается кнопкой настройки дерева групп на вкладке выгрузки товаров. Созданное дерево можно сохранить в файл и загрузить из файла, а также сформировать отчёт по выбранной номенклатуре. Функция подсветки уже выбранных товаров на большом дереве потребляет много памяти — это noted в документации.

Вкладка «Товары»

  • «Выгружать информацию о товарах» — выгрузка самих товаров.
  • «Выгружать картинки и файлы» — выгружаются только новые или изменённые.
  • «Выгружать значения свойств в товары» — значения поедут, даже если сами свойства выгружаются другой настройкой обмена.
  • «Выгружать штрихкоды» — если штрихкоды не используются, флаг лучше не ставить: это замедляет выгрузку.
  • «Выгружать планируемую дату поступления» — информация о ближайшем поступлении.
  • Настройка соответствий полей номенклатуры — правила, в какое поле XML товара выгружается конкретная информация. Основные реквизиты постоянны, ограничений на дополнительные реквизиты нет, служебные поля XML редактировать нельзя. Значения наименований полей 1С могут быть предопределёнными или задаваться по произвольному алгоритму.

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

Вкладка «Предложения»

Флаги: выгружать предложения, выгружать картинки и файлы предложений (только новые или изменённые), выгружать значения свойств, выгружать характеристики (если достаточно выгружать их как свойства — можно не включать), штрихкоды, планируемую дату поступления.

Вкладка «Свойства»

Выгружаются только свойства, перечисленные в таблицах выгружаемых свойств — отдельно для товаров (номенклатуры) и предложений (характеристик). Списочным свойствам можно указать выгрузку в highload-справочники флагом «Выгружать в HL-справочники»; строковым и числовым — «Выгружать как справочник». И ключевое: свойства автоматически не привязываются к разделам инфоблоков, это делается вручную на стороне сайта.

Вкладка «Остатки»

Остатки выгружаются только по складам из таблицы. Флаг «Выгружать остатки по магазинам» переключает выгрузку между сводной и в разрезе каждого склада. Флаг «Выгружать остатки с учётом резерва» включает разрез резерва. Если бизнесу нужно показывать доступное количество, а не физическое наличие, — настройка начинается здесь.

Вкладка «Цены»

Цены выгружаются только по прайсам, указанным в таблице. Для «Малого бизнеса» здесь же в отборах указывается конкретное соглашение, по которому выгружается единственная цена.

Что должно быть в самой базе до обмена

  • Виды номенклатуры «Товар» и «Услуга» должны существовать: без них обмен падает с «Не удалось найти вид номенклатуры». У выгружаемых позиций реквизит вида номенклатуры должен быть «Товар».
  • Если в конфигурации обязательны реквизиты контрагента — например, группа доступа к контрагенту, регион доставки, основная форма оплаты — заказ не загрузится: 1С не сможет создать контрагента и вернёт «Не удалось найти/создать контрагента».
  • Настроено соглашение, по которому выгружаются цены.

Шаг 6. Первый обмен каталога: какие файлы должны приехать

Формат — CommerceML 2. Данные распределены по файлам:

ФайлСодержимое
import.xmlРазделы, товары, группы маркировки товаров, размеры, типы цен, склады, свойства товаров, единицы измерения
offers.xmlПредложения товаров и их свойства
prices.xmlЦены предложений
rests.xmlОстатки предложений
documents.xmlДокументы
contragents.xmlКонтрагенты
references.xmlПользовательские справочники, на сайте — элементы highload-блоков

Модуль обмена выгружает архив со следующей структурой:

import.xml            <- корневой: группы/разделы, типы цен, склады, единицы измерения
goods/
  import.xml          <- товары
  offers.xml          <- торговые предложения
  prices.xml          <- цены товаров и предложений
  rests.xml           <- остатки товаров и предложений
properties/
  import.xml          <- свойства товаров
  offers.xml          <- свойства предложений
references.xml        <- пользовательские справочники (в highload-блоки)
import_files/         <- картинки и файлы (рекомендуемое имя папки)

Три требования из документации, которые нарушают чаще всего:

  1. Порядок загрузки. При пакетном обмене информация, на которую ссылается объект, должна быть уже загружена: к моменту загрузки товаров на сайте должны быть группы, свойства и единицы измерения; к моменту загрузки предложений — товары.
  2. Уникальные имена файлов. В конце названия файла до точки перед расширением рекомендуется указывать случайное значение — это повышает безопасность передачи. Поэтому в каталоге обмена лежат import_0a1b2c.xml, а не import.xml.
  3. Папка изображений — рекомендуемое имя import_files. В XML передаются относительные пути, сами файлы едут в пакете.

Файлы обмена сайт складывает в служебный каталог загрузок, по умолчанию /upload/1c_catalog/. Это место, где лежит доказательная база для любого разбора «чья ошибка».

Как выглядит товар в import.xml

Сокращённый фрагмент по примеру из документации:

<?xml version="1.0" encoding="UTF-8"?>
<КоммерческаяИнформация xmlns="urn:1C.ru:commerceml_2"
                        ВерсияСхемы="2.09"
                        ДатаФормирования="2015-06-26T18:28:09">
  <Каталог СодержитТолькоИзменения="true">
    <Ид>3e376578-5aae-466f-8301-6842d2796cf9</Ид>
    <ИдКлассификатора>3e376578-5aae-466f-8301-6842d2796cf9</ИдКлассификатора>
    <Наименование>Каталог материалов</Наименование>
    <Товары>
      <Товар>
        <Ид>3532350a-e424-11db-95d9-505054503030</Ид>
        <НомерВерсии>AAAAAQAAAHI=</НомерВерсии>
        <ПометкаУдаления>false</ПометкаУдаления>
        <Артикул/>
        <Наименование>Клей</Наименование>
        <БазоваяЕдиница>166</БазоваяЕдиница>
        <Группы>
          <Ид>13dab563-e271-11db-95d9-505054503030</Ид>
        </Группы>
        <Описание/>
        <ЗначенияСвойств>
          <ЗначенияСвойства>
            <Ид>13dab530-e271-11db-95d9-505054503030</Ид>
            <Значение/>
          </ЗначенияСвойства>
        </ЗначенияСвойств>
        <СтавкиНалогов>
          <СтавкаНалога>
            <Наименование>НДС</Наименование>
            <Ставка>20</Ставка>
          </СтавкаНалога>
        </СтавкиНалогов>
        <ЗначенияРеквизитов>
          <ЗначениеРеквизита>
            <Наименование>ВидНоменклатуры</Наименование>
            <Значение>Материал</Значение>
          </ЗначениеРеквизита>
          <ЗначениеРеквизита>
            <Наименование>ТипНоменклатуры</Наименование>
            <Значение>Товар</Значение>
          </ЗначениеРеквизита>
          <ЗначениеРеквизита>
            <Наименование>Полное наименование</Наименование>
            <Значение>Клей</Значение>
          </ЗначениеРеквизита>
        </ЗначенияРеквизитов>
        <Вес>0</Вес>
      </Товар>
    </Товары>
  </Каталог>
</КоммерческаяИнформация>

Куда попадают поля товара на сайте

Это нужно знать до обмена, иначе контент и SEO-тексты будут вести себя неожиданно.

Узел CommerceMLПоле на сайте
<Описание>Подробное описание товара
Реквизит ОписаниеВФорматеHTMLОписание товара в формате HTML
Реквизит Полное наименованиеАнонс товара
Реквизит ФайлМестонахождение приложенного файла
Реквизит ОписаниеФайлаОписание файла или картинки, формат адрес#описание
<Картинка>Изображения товара; первый элемент — основная картинка
<Вес>, реквизит ВесВес товара
<Ширина>, <Длина>, <Высота>Габариты
<БазоваяЕдиница>Единица измерения
<Изготовитель>Изготовитель: идентификатор, наименование, официальное наименование
<СтавкиНалогов>Наименование налога и ставка
<ЗначенияСвойств>Значения свойств товара по идентификаторам свойств

Служебные узлы, которые нельзя игнорировать:

  • <Ид> — уникальный идентификатор. Сопоставление с сайтом идёт по внешнему коду XML_ID, а не по названию.
  • <НомерВерсии> — версия элемента, используется для оптимизации обновления.
  • <ПометкаУдаления> — признак того, что элемент должен быть деактивирован.
  • <Внешний> у свойства — признак хранения значения в справочнике (highload-блоке); если свойство хранит картинку, признак должен быть true.
  • <ТипЗначений> свойства — допустимы «Строка», «Число», «Справочник».
  • <Наименование> типа цены должно быть уникальным, иначе новый тип не добавится.

Атрибут СодержитТолькоИзменения у классификатора и каталога в новой схеме обмена не используется: в документации прямо сказано, что он бесполезен при пакетном обмене. Это одно из ключевых отличий от старой схемы, к которому вернусь в разделе про версии.

Точные поэлементные таблицы offers.xml, prices.xml и rests.xml есть в документации по интернет-магазину; корневой элемент пакета предложений — ПакетПредложений, он содержит предложения, цены и остатки. Я не привожу их структуру по памяти: в проектах сверяюсь с страницами описания этих файлов и с реальной выгрузкой заказчика.

Шаг 7. Протокол обмена каталогом: команды и ответы строго по порядку

Инициатор всегда 1С. Сайт отвечает простым текстом. Все запросы идут на /bitrix/admin/1c_exchange.php.

№ЗапросОтвет сайта
1?type=catalog&mode=checkauth + HTTP BasicТри строки: success, имя cookie, значение cookie. Далее cookie передаётся во всех запросах
2?type=catalog&mode=initДве строки: zip=yes или zip=no, затем file_limit=<число> — максимальный размер файла в байтах за один запрос
3?type=catalog&mode=file&filename=<имя> , содержимое или его часть в теле POSTsuccess при успешной записи
4?type=catalog&mode=import&filename=<имя>progress + строка статуса — нужно повторить тот же запрос; success — обработка файла завершена
5?type=catalog&mode=deactivate&timestamp=<время>Деактивация того, что не затронуто в текущем сеансе
6?type=catalog&mode=completeСлужебное завершение процедуры импорта

При ошибке в первой строке ответа приходит failure, в следующих — описание ошибки. Если произошла необрабатываемая ошибка уровня ядра продукта или SQL-запроса, сайт вернёт HTML — именно это 1С показывает как «получен неизвестный статус импорта».

Что происходит внутри одного шага import

Один и тот же запрос mode=import выполняет последовательность внутренних операций: распаковка архива (если передавался ZIP), удаление и создание временных таблиц, пошаговое чтение файла во временную таблицу, индексация, импорт метаданных (инфоблоки, служебные свойства, типы цен, склады, единицы измерения), импорт разделов, пересчёт дерева разделов, импорт товаров, завершение. Прогресс хранится в сессии — поэтому потеря сессии означает старт импорта с начала.

Практические следствия, которые я использую при разборе:

  • Сопоставление разделов и товаров идёт по XML_ID. Если объект с таким внешним кодом найден и не изменился, при включённых контрольных суммах он только «отмечается» и пропускается — за счёт этого повторный обмен быстрее первого.
  • Импорт метаданных ничего не удаляет: случайно выгруженный из 1С склад или тип цены останется на сайте, пока администратор не удалит его вручную.
  • Импорт разделов не разбит на шаги так же granularно, как импорт товаров, поэтому на очень большом дереве разделов возможен таймаут. Повтор выгрузки помогает: уже обработанные разделы пропускаются, и работа продолжается дальше.

Это детали реализации, и они зависят от версии модулей — в спорных случаях я сверяюсь с поведением конкретной сборки, а не с описанием трёхлетней давности.

Ручная проверка обмена без 1С

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

# 1. Авторизация. Сохраняем cookie в файл.
curl -s -u "exchange_user:PASSWORD" -c cookies.txt \
  "https://example.ru/bitrix/admin/1c_exchange.php?type=catalog&mode=checkauth"

# Ожидаем три строки: success / имя cookie / значение cookie
# В ответе также приходит sessid — его нужно передавать в следующих запросах.

# 2. Согласование параметров.
curl -s -b cookies.txt \
  "https://example.ru/bitrix/admin/1c_exchange.php?type=catalog&mode=init&sessid=SESSION_ID"

# Ожидаем: zip=yes|no и file_limit=<число>

Передача файла и запуск импорта:

# 3. Передача файла сырым POST-телом.
curl -s -b cookies.txt -X POST --data-binary @import_test.xml \
  "https://example.ru/bitrix/admin/1c_exchange.php?type=catalog&mode=file&filename=import_test.xml&sessid=SESSION_ID"

# 4. Импорт. Повторяем один и тот же запрос, пока не получим success.
curl -s -b cookies.txt \
  "https://example.ru/bitrix/admin/1c_exchange.php?type=catalog&mode=import&filename=import_test.xml&sessid=SESSION_ID"

Если на первом запросе приходит HTML страницы авторизации или редирект — проблема на стороне веб-сервера, и в 1С её не исправить.

Шаг 8. Обмен заказами: команды, файлы, что проверяется

Направление type=sale. Инициатор тот же — 1С, но данные отдаёт сайт.

№ЗапросЧто происходит
1?type=sale&mode=checkauthАвторизация, три строки ответа с cookie
2?type=sale&mode=initСогласование zip и file_limit
3?type=sale&mode=queryСайт передаёт сведения о заказах в формате CommerceML 2
4?type=sale&mode=success1С подтверждает успешное получение и запись заказов
5?type=sale&mode=file&filename=<имя> , содержимое в POST1С загружает на сайт файл обмена; сайт отвечает success, в следующих строках возможны замечания по загрузке

Ошибка на любом шаге — failure плюс описание; при необрабатываемой ошибке ядра или SQL — HTML.

Структура заказа в файле обмена

Сокращённый фрагмент по примеру из описания протокола:

<КоммерческаяИнформация ВерсияСхемы="2.03" ДатаФормирования="2008-03-28">
  <Документ>
    <Ид>20</Ид>
    <Номер>20</Номер>
    <Дата>2007-10-16</Дата>
    <ХозОперация>Заказ товара</ХозОперация>
    <Роль>Продавец</Роль>
    <Валюта>RUB</Валюта>
    <Курс>1</Курс>
    <Сумма>9683.42</Сумма>
    <Контрагенты>
      <Контрагент>
        <Ид>1#admin#Петров Петр</Ид>
        <Наименование>Петр Петров</Наименование>
        <Роль>Покупатель</Роль>
        <ПолноеНаименование>Петр Петров</ПолноеНаименование>
        <Фамилия>Петров</Фамилия>
        <Имя>Петр</Имя>
        <АдресРегистрации>
          <Представление>6546, улица</Представление>
          <АдресноеПоле><Тип>Почтовый индекс</Тип><Значение>6546</Значение></АдресноеПоле>
        </АдресРегистрации>
        <Контакты/>
      </Контрагент>
    </Контрагенты>
    <Время>15:40:40</Время>
    <Комментарий/>
    <Товары>
      <Товар>
        <Ид>ORDER_DELIVERY</Ид>
        <Наименование>Доставка заказа</Наименование>
        <ЦенаЗаЕдиницу>348.00</ЦенаЗаЕдиницу>
        <Количество>1</Количество>
        <Сумма>348.00</Сумма>
        <ЗначенияРеквизитов>
          <ЗначениеРеквизита><Наименование>ВидНоменклатуры</Наименование><Значение>Услуга</Значение></ЗначениеРеквизита>
        </ЗначенияРеквизитов>
      </Товар>
      <Товар>
        <Ид>cbcf498f-55bc-11d9-848a-00112f43529a</Ид>
        <ИдКаталога>bd72d8f9-55bc-11d9-848a-00112f43529a</ИдКаталога>
        <Наименование>Комбайн MOULINEX A77 4C</Наименование>
        <ЦенаЗаЕдиницу>9335.42</ЦенаЗаЕдиницу>
        <Количество>1.00</Количество>
        <Сумма>9335.42</Сумма>
      </Товар>
    </Товары>
    <ЗначенияРеквизитов>
      <ЗначениеРеквизита><Наименование>Заказ оплачен</Наименование><Значение>true</Значение></ЗначениеРеквизита>
      <ЗначениеРеквизита><Наименование>Доставка разрешена</Наименование><Значение>true</Значение></ЗначениеРеквизита>
      <ЗначениеРеквизита><Наименование>Отменен</Наименование><Значение>false</Значение></ЗначениеРеквизита>
      <ЗначениеРеквизита><Наименование>Статус заказа</Наименование><Значение>[F] Доставлен</Значение></ЗначениеРеквизита>
    </ЗначенияРеквизитов>
  </Документ>
</КоммерческаяИнформация>

Реквизиты заказа, которые передаются в ЗначенияРеквизитов:

Наименование реквизитаСмысл
Дата оплатыДата оплаты
Номер платежного документаНомер платёжного документа
Метод оплатыНапример, «Наличный расчет»
Дата разрешения доставкиДата разрешения доставки
Заказ оплаченtrue / false
Доставка разрешенаtrue / false
Отмененtrue / false
Финальный статусtrue / false
Статус заказаКод и название статуса, например [F] Доставлен
Дата изменения статусаДата и время изменения

Доставка идёт служебной позицией с идентификатором ORDER_DELIVERY и видом номенклатуры «Услуга» — это не «лишний товар», а именно так передаётся стоимость доставки.

Значения ХозОперация в стандарте не ограничены заказом: «Заказ товара», «Счет на оплату», «Отпуск товара», «Счет-фактура», «Возврат товара», «Передача товара на комиссию», «Возврат комиссионного товара», «Отчет о продажах комиссионного товара», «Выплата наличных денег», «Возврат наличных денег», «Выплата безналичных денег», «Возврат безналичных денег», «Переоценка товаров», «Передача прав», «Прочие». Роли участников: «Продавец», «Покупатель», «Плательщик», «Получатель», «Комитент», «Комиссионер», «Лицензиар», «Лицензиат». Для интернет-магазина рабочая связка — «Заказ товара» и роль «Продавец» у документа.

Правила обработки заказа, которые нужно знать до запуска

Из описания протокола:

  • При передаче в 1С заказу устанавливается категория «Заказ с сайта»; записываются номер и дата, с которыми он оформлен на сайте.
  • Контрагент ищется по ИНН или по наименованию — в зависимости от настроек загрузки.
  • Договор ищется среди существующих договоров клиента с признаком ведения взаиморасчётов по заказам по указанной организации; если не найден — создаётся новый.
  • Загружаются все свойства заказа, переданные с сайта. Свойства ищутся по наименованию; если свойства с таким наименованием нет, создаётся новое со значением типа строка или число.
  • Заказ может модифицироваться в 1С, и изменения выгружаются на сайт.
  • Состояния по оплате и отгрузке передаются на сайт только при полном выполнении операции — полной оплате и полной отгрузке. До этого заказ считается неоплаченным и неотгруженным.
  • Если в 1С изменить заказ, по которому уже прошла оплата или отгрузка, на сайт он как изменённый не загрузится, и пользователь получит сообщение.
  • После каждой выгрузки заказа на сайт значения его категорий определяются на стороне сайта.

Первые два пункта объясняют, почему в 1С появляются «дубли контрагентов», а последние два — почему частичная предоплата не отображается в личном кабинете. Это правила протокола, а не поломка, и их нужно согласовать с бизнесом заранее.

Почему не меняется статус заказа

Статус меняется, если из 1С передались дата оплаты либо дата отгрузки. Чтобы эти даты попали в XML, документы должны быть сформированы и проведены:

  • оплата в УТ регистрируется документами на основании заказа: «Платежное поручение входящее», «Приходный кассовый ордер»;
  • отгрузка — документом «Реализация товаров и услуг»;
  • если в регистре «Расчеты с контрагентами» остаток по заказу меньше или равен нулю — заказ считается оплаченным;
  • если в регистре «Заказы покупателей» остаток по заказу меньше или равен нулю — заказ считается отгруженным.

На стороне сайта статусы, в которые переводится заказ при получении дат оплаты и отгрузки, задаются параметрами «При получении оплаты переводить заказ в статус» и «При получении разрешения доставки переводить заказ в статус».

Шаг 9. Обмен справочниками: type=reference

Недооценённый штатный механизм. Данные приезжают в highload-блоки, где у сущности есть полный набор событий — это способ расширить интеграцию без переписывания импорта каталога. Типовые задачи: персональные цены и скидки, бонусы, данные для личного кабинета партнёра, справочники для форм.

Что важно знать про ограничения:

  • 1С может создавать справочник и поля, но не удалять их;
  • допустимые типы создаваемых полей: Строка, Булево, Дата, Число;
  • создаваемые поля одиночные, необязательные, скрытые в фильтре, показанные и редактируемые в таблице;
  • автоматически создаются поля UF_NAME, UF_XML_ID, UF_VERSION, UF_DESCRIPTION;
  • название справочника должно начинаться с буквы и состоять только из латинских букв и цифр.

Диагностика идёт по кодам ошибок разбора XML: отсутствие или пустой узел Ид справочника, отсутствие Наименование, неизвестный ТипЗначений в реквизите, отсутствие ЗначениеРеквизита у элемента справочника и так далее. При полной выгрузке элементы справочника, не относящиеся к текущей сессии, удаляются — версионность хранится в UF_VERSION.

Шаг 10. Расписание и строго один поток

Расписание живёт в 1С. Если база файловая, а не клиент-серверная, автоматический запуск по расписанию нужно проверять отдельно: типичный симптом — «обмен работает, только когда бухгалтер открыл 1С».

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

Практически это значит: расписание каталога и заказов разводится по времени, а не запускается «одновременно, чтобы быстрее».

Шаг 11. Проверка результата: что смотреть после первого обмена

Порядок проверки, по которому я сдаю первый обмен:

  1. Файлы. В /upload/1c_catalog/ лежит полный пакет: корневой файл метаданных, файлы товаров, свойств, предложений, цен, остатков, папка с изображениями. Имена уникальны.
  2. Метаданные. Созданы инфоблоки товаров и предложений, типы цен, склады, единицы измерения, свойства. Лишних складов и типов цен нет — импорт метаданных их не удаляет, чистка вручную.
  3. Количества. Число товаров и предложений на сайте совпадает с составом выгрузки.
  4. Сопоставление. У выборки позиций совпадают XML_ID и GUID из 1С, наименования, артикулы, штрихкоды.
  5. Контент. Описания и анонсы попали в ожидаемые поля; SEO-тексты, которые ведутся на сайте, не затёрты.
  6. URL. Символьные коды не изменились там, где не должны; для изменённых есть редиректы.
  7. Свойства. Привязаны к разделам вручную и работают в фильтре.
  8. Цены. Внешние коды типов цен совпадают с 1С; значения сверены по выборке.
  9. Остатки. Сверены по складам, проверены нулевой остаток и позиция в резерве.
  10. Изображения. На месте, основная картинка выбрана верно, размеры ограничены настройками.
  11. Повторный обмен. Не создаёт дублей и отрабатывает заметно быстрее первого при включённых контрольных суммах.
  12. Заказы. Тестовый заказ уходит целиком, включая доставку служебной позицией и дополнительные реквизиты; после подтверждения не выгружается повторно.
  13. Статусы. Полная оплата и полная отгрузка из 1С меняют состояние заказа на сайте.
  14. Витрина. После импорта показываются свежие цены и остатки — выбранная схема сброса кеша работает.

Шаг 12. Типовые ошибки: сообщение, причина, точное действие

Сообщение или симптомПричинаЧто делать
«Ошибка авторизации. Неверное имя пользователя или пароль»Неверные реквизиты в настройках 1ССверить логин и пароль служебного пользователя
«У Вас нет прав для импорта каталога»Пользователь не в разрешённой группе либо закрыт доступ к странице обменаНастроить «Разрешить загрузку группам пользователям» и права на страницу
Авторизация не работает, при этом логин верныйPHP в режиме CGI не передаёт данные HTTP-авторизацииПроверить phpinfo(), раздел Server API; применить обход через mod_rewrite
«Ошибка проверки источника запроса»Проверка источника в настройках обменаОбновить модуль обмена в 1С; отключение проверки — крайняя мера, снижает безопасность
«Включена смена идентификатора сессий»Проактивная защита меняет ID сессии, шаг импорта теряетсяОтключить смену идентификатора сессии для страницы обмена
«Время на сервере базы данных отличается от времени на веб-сервере больше, чем на 10 минут»Расхождение часовых поясовНастроить время и зоны на веб-сервере и сервере БД
«Получен неизвестный статус импорта» и сообщение о превышении допустимого объёма памятиНе хватает памяти на масштабирование изображенийУвеличить memory_limit либо отключить выгрузку картинок и передать их отдельно
«Получен неизвестный статус импорта», в ответе ошибка БДФайл обрезается при передаче, часто через проксиПроверить передачу без прокси, отключить ZIP-сжатие
«Файл не отправлен», «Файл для импорта пуст»Файрвол или антивирус на машине с 1С, некорректная работа ZIPПроверить блокирующее ПО, обновить модули, отключить ZIP
«Ошибка импорта метаданных»Название свойства начинается с цифрыПервый символ названия свойства должен быть буквой
«В редакции Малый Бизнес нет возможности иметь более одного типа цены»В выгрузке больше одного вида цены, не указано соглашениеНастроить выгрузку одной цены по соглашению в отборах 1С
«Количество импортированных складов превышает разрешённое для данной редакции»Ограничение редакцииОтключить выгрузку по складам либо сменить редакцию
«В выгрузке настроены цены с одинаковым названием»Неуникальные названия типов ценСделать названия уникальными
«Изменения товаров не зарегистрированы»Отбор настроен как выбор полей, а не фильтр; либо изменений действительно не было; либо вид номенклатуры не «Товар»Задать значения фильтра или снять выделение полей при полной выгрузке; проверить вид номенклатуры
«Не удалось найти вид номенклатуры: Товар / Услуга»В 1С нет соответствующих видов номенклатурыСоздать виды номенклатуры «Товар» и «Услуга»
«Не удалось найти/создать контрагента», не установлены реквизитыВ конфигурации обязательны реквизиты контрагентаЗаполнить или снять обязательность для группы доступа, региона доставки, формы оплаты
«Поле объекта не обнаружено (Наименование)»Не заданы соответствия полей заказаНастроить закладку «Профили обмена», критичны «Наименование» и «Полное Наименование»
Изменения с сайта не приходят в 1СРазвёрнутая копия базы перехватывает обменСменить пароль пользователя обмена, чтобы копия перестала авторизовываться
Медленный импортВключённая индексация инфоблока; смена ID сессииОтключить индексацию на время обмена; отключить смену идентификатора сессии
Неполная выгрузка картинокКартинки выгружаются только при первой полной выгрузке, далее только новые и изменённыеВыполнить принудительную полную выгрузку картинок в модуле обмена
Ошибка об отсутствии временной таблицыПараллельные обменыРазвести расписания, обеспечить один поток
Товары задвоилисьИзменился идентификатор в 1СВосстановить идентификаторы; сопоставление идёт по XML_ID, а не по названию

Обход проблемы авторизации при PHP в режиме CGI

Из официального описания проблемы. В корень сайта в .htaccess:

RewriteEngine on
RewriteRule .* - [E=REMOTE_USER:%{HTTP:Authorization},L]

В файле bitrix/admin/.htaccess закомментировать строки, отключающие mod_rewrite (файл может отсутствовать, он создаётся вручную):

#<IfModule mod_rewrite.c>
# RewriteEngine Off
#</IfModule>

В bitrix/php_interface/dbconn.php:

<?php
$remote_user = $_SERVER["REMOTE_USER"]
    ? $_SERVER["REMOTE_USER"]
    : $_SERVER["REDIRECT_REMOTE_USER"];
$strTmp = base64_decode(substr($remote_user, 6));
if ($strTmp) {
    list($_SERVER['PHP_AUTH_USER'], $_SERVER['PHP_AUTH_PW']) = explode(':', $strTmp);
}

Документация прямо предупреждает: обход не всегда решает проблему, и если авторизация не заработала — вопрос к хостинг-провайдеру.

Отключение смены идентификатора сессии для страницы обмена

В файле подключения страницы обмена, до подключения пролога:

<?php
define('BX_SESSION_ID_CHANGE', false);

Пример обработчика: включить количественный учёт у приехавших товаров

Типовая задача: после выгрузки из 1С у товаров не стоит флаг уменьшения количества при заказе. Решение из документации — обработчик события добавления продукта в init.php:

<?php
AddEventHandler('sale', 'OnProductAdd', 'myOnProductAdd');

function myOnProductAdd($ID, $Fields)
{
    CCatalogProduct::Update($ID, ['QUANTITY_TRACE' => 'Y']);
}

Это иллюстрация правильного подхода: не править ядро, а вешать обработчик на событие.

Шаг 13. Кастомизация: три способа и где именно они делаются

Штатная страница /bitrix/admin/1c_exchange.php в зависимости от GET-параметров подключает разные простые компоненты без шаблонов; основная логика вынесена в классы. В классической реализации картина такая:

НаправлениеtypeКомпонентКласс с логикой
Заказы, контрагентыsalebitrix:sale.export.1cCSaleOrderLoader
Товары, предложения, цены, склады, наличиеcatalogbitrix:catalog.import.1cCIBlockCMLImport
Справочникиreferencebitrix:catalog.import.hlCBitrixCatalogImportHl

Файлы ядра менять нельзя. Есть три принципиально разных пути доработки.

Способ 1. Обработчики событий

Импорт каталога выдаёт события начала и успешного завершения, а также служебное событие завершения процедуры; у импорта справочников свои события начала и завершения. Пример регистрации обработчика на завершение импорта каталога:

<?php
// /bitrix/php_interface/init.php
\Bitrix\Main\EventManager::getInstance()->addEventHandler(
    'catalog',
    'OnSuccessCatalogImport1C',
    'myOnSuccessCatalogImport1C'
);

function myOnSuccessCatalogImport1C(...$args)
{
    // Состав аргументов зависит от события и версии модуля:
    // на этапе отладки логируем всё, что пришло.
    AddMessage2Log(
        'OnSuccessCatalogImport1C: ' . print_r($args, true),
        'exchange1c'
    );

    // Здесь: инвалидация своего кеша, пересчёт производных данных,
    // уведомление ответственному об успешном сеансе.
}

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

Способ 2. Собственная страница обмена

Официально поддерживаемый вариант, когда нужны разные настройки обмена на одном сайте:

  1. Создать страницу, например catalog_import.php, и разместить на ней компонент «Импорт каталога из 1С» (bitrix:catalog.import.1c, раздел Контент → Каталог → Импорт каталога из 1С).
  2. Настроить параметры компонента — они аналогичны параметрам формы «Интеграция с 1С».
  3. Настроить права: для групп, которым разрешён импорт, уровень доступа не ниже «Чтение», остальным доступ закрыть.
  4. В настройках выгрузки в 1С указать путь к этой странице вместо штатного скрипта.

Аналогично создаются catalog_export.php с компонентом «Экспорт каталога в 1с» (bitrix:catalog.export.1c) и orders_export.php с компонентом «Экспорт заказов в "1С:Предприятие"» (bitrix:sale.export.1c, раздел Магазин → Экспорт заказов). У компонента экспорта заказов нет параметров «Префикс номера заказа при выгрузке» и «Статус, в который переводить заказ при получении отгрузки от 1С».

Обязательное условие: при использовании собственных настроек должен быть снят флаг «Переходить в режим правки сайта без перезагрузки страницы» в персональных настройках интерфейса (Настройки → Настройки продукта → Интерфейс → Персональные настройки). Иначе обращения 1С к сайту будут выполняться некорректно.

Пример страницы импорта с параметрами — так, как он приведён в документации для развода каталогов по разным типам инфоблоков:

<?php
require($_SERVER["DOCUMENT_ROOT"] . "/bitrix/header.php");
$APPLICATION->SetTitle("import1");

$APPLICATION->IncludeComponent("bitrix:catalog.import.1c", "", [
    "IBLOCK_TYPE"                   => "books",
    "SITE_LIST"                     => [],
    "INTERVAL"                      => "30",
    "GROUP_PERMISSIONS"             => [0 => "1"],
    "USE_OFFERS"                    => "N",
    "USE_IBLOCK_TYPE_ID"            => "Y",
    "SKIP_ROOT_SECTION"             => "N",
    "ELEMENT_ACTION"                => "D",
    "SECTION_ACTION"                => "D",
    "FILE_SIZE_LIMIT"               => "204800",
    "USE_CRC"                       => "Y",
    "USE_ZIP"                       => "Y",
    "USE_IBLOCK_PICTURE_SETTINGS"   => "N",
    "GENERATE_PREVIEW"              => "Y",
    "PREVIEW_WIDTH"                 => "100",
    "PREVIEW_HEIGHT"                => "100",
    "DETAIL_RESIZE"                 => "Y",
    "DETAIL_WIDTH"                  => "300",
    "DETAIL_HEIGHT"                 => "300",
    "TRANSLIT_ON_ADD"               => "Y",
    "TRANSLIT_ON_UPDATE"            => "Y",
    "TRANSLIT_MAX_LEN"              => "100",
    "TRANSLIT_CHANGE_CASE"          => "L",
    "TRANSLIT_REPLACE_SPACE"        => "_",
    "TRANSLIT_REPLACE_OTHER"        => "_",
    "TRANSLIT_DELETE_REPEAT_REPLACE"=> "Y",
], false);

require($_SERVER["DOCUMENT_ROOT"] . "/bitrix/footer.php");

Обратите внимание на ELEMENT_ACTION и SECTION_ACTION со значением D — это деактивация отсутствующих в выгрузке объектов. На первом обмене нового сайта я ставлю «ничего», а не деактивацию.

Если нужно менять саму логику разбора, поверх этого делается собственный компонент и класс-наследник класса импорта с переопределением нужного метода. Так меняется поведение без правки ядра — и обновления CMS не затирают доработку.

Способ 3. Выгрузка справочниками

Если у сущности из 1С нет аналога на сайте или штатный импорт не подходит, данные выгружаются как справочники в highload-блоки и обрабатываются самостоятельно на событиях этих блоков. Ограничения по типам полей и по невозможности удаления — из шага 9.

Шаг 14. Отличия нового обмена от старого

Это то, что нужно знать, если проект переезжает с ветки 7.x или если подрядчик предлагает «поставим модуль, какой найдём».

ПризнакВетка 7.xВетка 8.x
Способ установкиСравнение-объединение конфигурации с файлом .cf, подключение подсистемы обмена, обновление конфигурации базы данных и данных информационной базыПодключение расширения .cfe через «Администрирование → Печатные формы, отчёты и обработки → Расширения»
Влияние на типовую конфигурациюТребуется включить возможность изменения; для редактируемых объектов — «Объект поставщика редактируется с сохранением поддержки»Код типовой конфигурации не меняется
Что нужно после установкиОбновление конфигурации БД, запуск обновления информационной базы, добавление пользователям роли по работе с БУССнять «Безопасный режим», перезапустить сеанс; раздел настроек видят администратор и пользователи с правом «(1С-Битрикс: Управление сайтом) Администратор»
Требования совместимостиМодули 6.5.x и 7.x — только с версией модуля sale не ниже 17.0.1; соответствие со службами доставки — не ниже 17.0.21Определяются конкретной веткой и прикладным решением
РазвитиеРазвитие и обновление старых версий 7.0.x, включая исправление ошибок, прекращеноАктуальная ветка
Привязка к решениямУТ ред. 11.1–11.38.0.x — «Розница» ред. 2.3; 8.1.x — УТ ред. 11.5; 8.x — УНФ

Дополнительно про старые версии: для УТ 10.3 при установке 5.x требовалось снять режим совместимости конфигурации, а при переходе с модуля 4.x — сначала обновить его до последней версии и затем запустить внешнюю обработку, конвертирующую настройки обмена. Если вам предлагают «настроить обмен по инструкции 2014 года», это индикатор, что подрядчик не работает с актуальной веткой.

Отличия в самой схеме выгрузки

ПризнакСтарая схемаНовая пакетная схема
Признак частичной выгрузкиАтрибут СодержитТолькоИзменения у классификатора и каталогаВ описании файлов прямо указано, что атрибут не используется, так как бесполезен при пакетном обмене
Состав пакетаОдин файл с описанием товаровАрхив: корневой файл метаданных, папки с товарами и свойствами, отдельные файлы цен и остатков, справочники
Быстрое обновление цен и остатковЧерез полную выгрузкуВ стандарте есть отдельный элемент «ИзмененияПакетаПредложений» — изменения публикуемых предложений для быстрой загрузки на сайт
Деактивация отсутствующихЛогика была привязана к признаку частичной выгрузки и настройкам сайтаОтдельный шаг mode=deactivate с параметром timestamp, выполняется только при полной выгрузке
Имена файловФиксированныеРекомендуется случайный суффикс перед расширением для безопасности

Практический вывод: если разбор проблемы опирается на «атрибут частичной выгрузки», а выгрузка современная, — разбор неверен. Проверять нужно шаг деактивации и timestamp.

Шаг 15. Когда штатного обмена не хватает

Штатный обмен закрывает массовую выгрузку каталога и типовой обмен заказами. Он плохо подходит для точечных запросов в реальном времени: остаток конкретной позиции сейчас, персональная цена клиента, статус документа сию минуту.

Со стороны 1С есть штатные возможности:

  • REST-интерфейс на OData версии 3.0. Платформа автоматически формирует интерфейс для всего прикладного решения; после публикации на веб-сервере сторонние системы обращаются к нему по HTTP. Ответы — Atom/XML или JSON. Доступны справочники, документы, регистры, их реквизиты, а также часть методов: проведение и отмена проведения документа, старт бизнес-процесса, срезы первых и последних, остатки и обороты. При чтении и записи выполняются обычные проверки прав и вызываются обработчики событий, кроме проверки заполнения. Ошибки — HTTP 4XX и 5XX.
  • Собственные HTTP-сервисы в конфигурации — когда нужен свой контракт, а не универсальный доступ к объектам.

Пример запроса к стандартному интерфейсу из описания платформы:

GET /OData_Tests_Infobase/odata/standard.odata/Catalog_Goods?$filter=Price le 3.5 or Price gt 200

Важное ограничение: в платформе реализована только серверная часть REST-сервисов. Клиентскую часть для обращения к чужим сервисам делают средствами работы с HTTP.

Со стороны сайта нужно понимать: готового публичного REST-интерфейса с генерацией вебхуков, как в Битрикс24, в «1С-Битрикс: Управление сайтом» нет. API у CMS есть, но внешний HTTP-интерфейс — это собственная разработка или готовое решение из Маркетплейса.

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

Сводная таблица файлов и путей

Путь или файлНазначение
/bitrix/admin/1c_exchange.phpШтатная точка входа обмена; параметры type и mode
/upload/1c_catalog/Каталог приёма файлов обмена каталогом по умолчанию
import.xml, offers.xml, prices.xml, rests.xmlМетаданные и товары, предложения, цены, остатки
documents.xml, contragents.xml, references.xmlДокументы, контрагенты, пользовательские справочники
import_files/Папка изображений и файлов в пакете выгрузки
/bitrix/php_interface/init.phpРегистрация обработчиков событий
/bitrix/php_interface/dbconn.phpПодключение к БД; в документации — место обхода CGI-авторизации
bitrix/admin/.htaccessНастройки доступа к административной части
catalog_import.php, catalog_export.php, orders_export.phpСобственные страницы обмена с компонентами и своими параметрами
.cfeФайл расширения конфигурации для модуля 8.x
.cfФайл конфигурации для сравнения-объединения при установке 7.x

Где проверить самому

  • «Протокол обмена с сайтом» и стандарт CommerceML 2 — сайт фирмы «1С», раздел технологий обмена данными и интеграции: v8.1c.ru. Там же описание REST-интерфейса платформы.
  • Учебный курс «Интеграция с 1С» — dev.1c-bitrix.ru: установка модулей 5.x/6.x/7.x, 8.0.x, 8.1.x; настройки со стороны 1С и со стороны сайта; интеграция с УТ, УНФ, «Розницей»; типичные ошибки и проблемы; особенности интеграции «Малого бизнеса».
  • Справка формы «Магазин → Настройки → Интеграция с 1С» — пользовательская документация dev.1c-bitrix.ru, раздел настроек магазина.
  • «Описание файлов XML» и поэлементные таблицы import.xml, offers.xml, prices.xml, rests.xml — документация для разработчиков по интернет-магазину, dev.1c-bitrix.ru/api_help/sale/xml/.
  • Внутренняя механика импорта (временные таблицы, шаги, классы, события) детально разобрана в техническом материале компании «ИНТЕРВОЛГА» на Хабре. Это разбор реализации, а не официальная документация: детали зависят от версии, и в проекте я сверяю их со своей сборкой.

Названия пунктов меню, состав опций и поведение отдельных настроек меняются между версиями. Поэтому на конкретном проекте я сверяюсь с той сборкой, которая стоит у заказчика, а не с чужим скриншотом.

Что нужно, чтобы настроить обмен на вашем проекте

Чтобы дать точный порядок работ и оценку, мне нужны:

  • конфигурация 1С, релиз, типовая или доработанная;
  • ветка модуля обмена: 7.x или 8.x, и для какого прикладного решения;
  • база файловая или клиент-серверная, используется ли РИБ, есть ли доступ из интернета;
  • редакция «1С-Битрикс: Управление сайтом» и текущее состояние сайта;
  • количество товаров, характеристик, видов цен, складов; нужны ли резервы;
  • направления: только каталог или ещё справочники и контрагенты; что возвращается по заказам;
  • кто мастер по описаниям, SEO-полям и структуре разделов;
  • требуемая частота обмена и допустимое расхождение по остаткам;
  • кто ведёт сторону 1С и можно ли связаться с ним напрямую.

Я делаю сайты на «1С-Битрикс» и веб-сторону обмена: структуру каталога под приём данных, настройки формы интеграции и собственные страницы обмена, права служебного пользователя, обработчики событий, отдачу заказов и обновление их состояний, работу с URL и редиректами, логи и оповещения. Со стороны 1С работаю в связке с вашим 1С-программистом: даю контракт формата, показываю по файлам выгрузки, чего в нём не хватает, и проверяю результат по чек-листу из шага 11.

Если обмен уже настроен, но работает не так, — начнём с диагностики: посмотрю файлы в каталоге обмена и ответы скрипта по шагам и скажу, на чьей стороне проблема. Если сайт только предстоит — спроектируем каталог под вашу 1С сразу, чтобы не переделывать после первого обмена и не потерять поисковый трафик на смене URL.

АН
Автор

Алексей Нестеров

Веб-разработчик. Пишу о PHP, 1С-Битрикс, интеграциях и инструментах разработки.

Обо мне

Комментариев пока нет. Будьте первым.

Оставить комментарий

Комментарий появится после проверки модератором.