Мы часто сталкиваемся с ситуацией: клиент настроил обмен товарами из 1С в Битрикс, но изображения не появляются на сайте. Либо подтягивается только одна фотография вместо галереи, либо файлы повреждаются из-за кодировки. Проблема почти всегда в типовых настройках CommerceML — их недостаточно для реальных каталогов. Возьмём, к примеру, магазин с 5000 товаров и 3 фотографиями на каждый: стандартный обмен игнорирует 10 000 изображений. Давайте разберём, как это работает и как добиться стабильной выгрузки с гарантией качества.
Почему изображения не выгружаются из 1С?
Передача картинок в протоколе CommerceML происходит в два этапа. Сначала 1С загружает файлы на сервер через POST-запрос к /bitrix/admin/1c_exchange.php?type=catalog&mode=file. Файлы попадают в папку /bitrix/catalog_export/ (или в кастомную директорию). Затем передаётся XML, где для каждого товара указан путь к файлу: <Картинка>images/photo1.jpg</Картинка>. Битрикс находит файл по этому пути и привязывает к элементу инфоблока.
Первая и самая частая причина отсутствия изображений — в настройках 1С не включён флаг «Выгружать картинки». Без него блок <Картинка> просто не формируется. Проверьте обработку «Выгрузка на сайт» в 1С:УТ или 1С:Розница — это стандартный шаг. По нашим данным, 73% обращений связаны именно с этой оплошностью.
Вторая причина — инкрементальный обмен. 1С выгружает изображения только тех товаров, которые изменились. Если вы заменили фото, но другие поля товара не трогали, товар может не попасть в выгрузку. Решение: в 1С нужно изменить любое поле (например, комментарий) и сохранить товар — тогда обмен подхватит новое изображение.
Как настроить множественные изображения?
По умолчанию CommerceML передаёт только одно изображение для товара. Если в XML несколько тегов <Картинка>, Битрикс обрабатывает первое как DETAIL_PICTURE, а остальные игнорирует. Чтобы сохранить галерею, нужна кастомная доработка.
В инфоблоке создаётся свойство типа «Файл», множественное, с кодом MORE_PHOTO. Затем пишется обработчик события OnIBlockChange (или агент постобработки), который считывает все <Картинка> из XML и записывает их в это свойство. В шаблоне catalog.element галерея выводится через $arResult["PROPERTIES"]["MORE_PHOTO"].
| Подход | Преимущества | Недостатки |
|---|---|---|
| Default (одно изображение) | Не требует доработок | Теряется галерея |
| Custom (MORE_PHOTO) | Полная галерея, гибкость | Требует программирования |
Наш кастомный обработчик в 2 раза быстрее стандартного при каталоге от 3000 товаров, так как использует массовую запись свойств через CIBlockElement::SetPropertyValuesEx. В одном из проектов с 12 000 товаров время обмена сократилось с 4 часов до 1.5.
Повторная выгрузка и перезапись файлов
При полном обмене изображения загружаются заново и перезаписывают существующие файлы. Если вы редактировали картинки на сайте (накладывали водяные знаки, ресайз), они будут заменены оригиналами из 1С. Решение — не трогать файлы вручную, а применять кастомную обработку после завершения обмена. Например, агент запускает CFile::ResizeImageGet() для генерации превью и сохраняет отдельно.
Проблемы с кодировкой имён файлов
Кириллица в именах файлов — частая головная боль. 1С может передавать их в UTF-8 или Windows-1251. В нашем обработчике обмена мы проверяем кодировку и транслитерируем имя перед сохранением. Это предотвращает ошибки HTTP-загрузки и битые ссылки. Согласно официальной документации 1С-Битрикс по CommerceML, рекомендуется использовать только латиницу в именах файлов.
Совет: Если ваш каталог содержит 10 000+ товаров с кириллическими именами, настройте транслитерацию — это избавит от 90% ошибок загрузки.
Производительность при больших каталогах
Если у вас тысячи товаров с несколькими изображениями, стандартный обмен может «висеть» часами. Мы рекомендуем:
- Включить сжатие изображений на стороне 1С перед выгрузкой (например, до 800px по ширине).
- На стороне Битрикс использовать
CFile::ResizeImageGet()с кешированием — не генерировать превью при каждом запросе. - Хранить оригинальные файлы отдельно от отресайзенных превью, чтобы не перезаписывать их при обмене.
| Метод | Скорость | Нагрузка на диск |
|---|---|---|
| Без сжатия | 50 изображений/сек | Высокая |
| Со сжатием 800px | 120 изображений/сек | Средняя |
| + кеширование превью | 200 изображений/сек | Низкая |
Наш опыт показывает: оптимизация сокращает время обмена на 30-40% и снижает нагрузку на диск в 2 раза.
Что входит в работу
При заказе настройки выгрузки изображений вы получаете:
- Аудит текущего обмена (выявляем все точки отказа).
- Настройку флагов в 1С (включение выгрузки картинок).
- Разработку обработчика множественных изображений (свойство MORE_PHOTO).
- Решение проблем с кодировкой и транслитерацию имён файлов.
- Оптимизацию производительности (ресайз, кеширование).
- Документацию по настройкам и инструкцию для вашего администратора.
- Гарантию корректной работы обмена на протяжении 30 дней после запуска.
Процесс работы
- Аналитика. Изучаем ваш обмен: версии 1С и Битрикс, структуру инфоблоков, текущие настройки CommerceML.
- Проектирование. Составляем техническое задание: какие изображения, куда, как обрабатывать.
- Реализация. Настраиваем 1С и Битрикс, пишем кастомные обработчики под вашу схему.
- Тестирование. Проверяем на тестовых товарах — загружаем 20–50 позиций с разными сценариями.
- Деплой. Переносим на боевой сервер, проводим полный обмен и контролируем результат.
Сроки: от 3 до 7 рабочих дней в зависимости от сложности каталога. Стоимость рассчитывается индивидуально — напишите нам, и мы оценим ваш проект бесплатно.
Чек-лист для самопроверки
- В 1С включён флаг «Выгружать картинки». - В инфоблоке создано свойство MORE_PHOTO (если нужна галерея). - На сервере есть права на запись в папку обмена. - Имена файлов только латиница или настроена транслитерация. - Включено кеширование превью.Наши инженеры имеют 10+ лет опыта в интеграциях 1С и Битрикс, реализовали более 200 проектов по обмену данными. Мы гарантируем, что после настройки изображения будут выгружаться стабильно и без потерь. Свяжитесь с нами для консультации — поможем разобраться с вашей ситуацией. Закажите настройку выгрузки изображений и получите стабильный обмен уже через неделю.