Обмен изображениями и файлами товаров с 1С

Изображения и файлы товаров передаются из 1С в 1С-Битрикс в том же CommerceML-обмене, что и каталог — отдельного протокола для них нет. Картинки лежат внутри выгрузки как относительные пути, а сами файлы кладутся рядом с import.xml. Разберём, как это устроено, куда попадают детальное и превью-изображение, как выгружать дополнительные картинки и произвольные файлы, и почему обмен нередко приходит без картинок.

Как изображения попадают в выгрузку

В протоколе CommerceML картинка не встраивается в XML как base64 — вместо этого 1С кладёт файл в каталог выгрузки, а в import.xml прописывает относительный путь к нему в теге <Картинка> внутри элемента <Товар>. При обмене по HTTP файлы предварительно упаковываются рядом с XML и передаются на сайт отдельными POST-запросами (режим mode=file), а модуль bitrix.xml_import раскладывает их во временную папку.

Физически на сайте всё оседает в каталоге обмена, по умолчанию /upload/1c_catalog/. Внутри — import.xml, offers.xml и подпапки с картинками (часто import_files/). Битрикс читает путь из тега <Картинка>, находит соответствующий файл в этой структуре, регистрирует его в модуле main (таблица b_file) и привязывает к элементу инфоблока.

Детальная картинка и превью

У элемента инфоблока в Битриксе два системных поля под изображения: PREVIEW_PICTURE (анонс) и DETAIL_PICTURE (детальная). Обработка обмена заполняет их по такому правилу:

• первая картинка товара из 1С уходит в детальное изображение (DETAIL_PICTURE);
• превью (PREVIEW_PICTURE) не приходит из 1С готовым — Битрикс создаёт его сам, если в настройках инфоблока включено автоуменьшение;
• остальные картинки (2-я, 3-я и т. д.) складываются в свойство типа «Файл» с множественным значением.

Чтобы превью генерировалось автоматически, в настройках инфоблока (Контент → Инфоблоки → Каталог → вкладка «Поля») для поля «Картинка для анонса» задают размеры уменьшенной копии. Тогда при импорте детальной картинки Битрикс сам создаёт из неё превью нужного размера. Это удобнее, чем гонять два файла из 1С.

Дополнительные изображения (галерея)

Для галереи товара в каталоге заводят пользовательское свойство инфоблока типа Файл с признаком «Множественное». Стандартно оно называется MORE_PHOTO — именно его используют шаблоны Битрикса (bitrix:catalog.element) для вывода дополнительных фото.

Обработка обмена автоматически кладёт все картинки товара, кроме первой, в свойство с кодом MORE_PHOTO, если оно существует в инфоблоке. Отдельной настройки в 1С для этого не требуется — достаточно, чтобы у номенклатуры было присоединено несколько файлов-изображений, а на сайте было создано свойство с нужным символьным кодом.

Картинки торговых предложений

Если каталог использует торговые предложения (SKU) — цвета, размеры, варианты — то у каждого предложения может быть своя картинка. В CommerceML предложения выгружаются в отдельный файл offers.xml, и картинки к ним привязываются тем же тегом <Картинка>, но уже внутри элемента <Предложение>.

Импортируются они в инфоблок торговых предложений (SKU-инфоблок), в его собственные поля DETAIL_PICTURE / PREVIEW_PICTURE и свойство MORE_PHOTO этого инфоблока. Частая логика витрины: при выборе варианта на карточке подменяется картинка предложения; если у предложения картинки нет — показывается изображение родительского товара. Чтобы такое поведение работало, картинки должны быть присоединены именно к вариантам номенклатуры (характеристикам) в 1С, а не только к базовому товару.

Произвольные файлы: инструкции, сертификаты, документы

Кроме картинок к товару в 1С можно присоединить любые файлы — PDF-инструкции, сертификаты, паспорта, прайсы. Механизм тот же: CommerceML передаёт их через тег <Картинка> (протокол не различает «картинку» и «файл» по типу — различие только в расширении), и Битрикс складывает их в множественное свойство типа «Файл».

Чтобы документы не смешивались с фотографиями, заводят отдельное свойство инфоблока, например DOCUMENTS или FILES, и настраивают сопоставление на этапе импорта. Стандартная обработка кладёт все файлы в один поток, поэтому разнесение картинок и документов по разным свойствам обычно требует доработки обработчика события OnBeforeIBlockElementUpdate либо расширения импорта на стороне интегратора.

• Расширение имеет значение: по .jpg/.png Битрикс понимает, что это изображение; по .pdf/.doc — что это файл. От этого зависит, покажется ли превью.
• Размер файлов влияет на объём выгрузки: тяжёлые PDF раздувают пакет обмена и замедляют передачу по HTTP.

Настройки обмена и обновление картинок

На стороне сайта поведение задаётся в мастере настройки обмена (Магазин → Настройки → Интеграция с 1С) и в самом инфоблоке. Ключевые моменты, которые стоит проверить:

1. Права на запись в каталог обмена /upload/1c_catalog/ — без них файлы не сохранятся, а картинки «не приедут».
2. Лимит размера файла на приём: параметры upload_max_filesize и post_max_size в PHP, а также ограничение веб-сервера — крупные изображения могут обрезаться.
3. Дробление файла обмена: если включено ограничение размера пакета, картинки передаются отдельными частями; при обрыве связи возможна потеря части файлов.

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

Почему обмен приходит без картинок

Самая частая жалоба после настройки — «товары обновляются, а фото нет». Причины почти всегда из короткого списка:

• В 1С нет присоединённых файлов. Картинки хранятся в базе, но не как «файлы номенклатуры», а, например, в дополнительных реквизитах — стандартная обработка их не выгружает.
• Нет прав на запись в /upload/1c_catalog/ — XML приходит, а файлы не сохраняются.
• Обрезка по размеру — крупные изображения не проходят лимиты PHP или nginx/Apache.
• Отсутствует свойство MORE_PHOTO — тогда пропадают все картинки, кроме детальной.
• Выгрузка «только изменений» — новые фото к старым товарам не подхватываются без полной выгрузки.

Диагностировать проще всего по содержимому /upload/1c_catalog/: если файлы картинок физически лежат там, но не привязаны — проблема на стороне импорта Битрикса; если их нет вовсе — проблема в выгрузке из 1С. Логи обмена и сам import.xml покажут, есть ли в нём теги <Картинка>.

Итог

Изображения и файлы товаров не требуют отдельного канала — они едут внутри стандартного CommerceML-обмена как относительные пути в import.xml и физические файлы в /upload/1c_catalog/. Первая картинка становится детальной, превью генерирует сам сайт, остальные фото уходят в свойство MORE_PHOTO, а документы — в отдельное файловое свойство. Большинство проблем сводится к трём вещам: нет присоединённых файлов в 1С, не хватает прав на запись или не создано нужное свойство инфоблока.

Мы в B2Bsite настраиваем полную передачу медиа — галереи товаров, картинки торговых предложений, сертификаты и инструкции — с корректным обновлением при повторных выгрузках и без разрастания /upload/. Если картинки «не приезжают» или дублируются, поможем найти причину в связке 1С и Битрикса и довести обмен до стабильной работы.