Перейти к содержанию

Модуль для Битрикс

1. Обзор модуля

1.1 Назначение модуля

Модуль "Интеграция с selectyre" предназначен для автоматической синхронизации каталога товаров между платформой selectyre и интернет-магазином на 1С-Битрикс.

1.2 Основные возможности

  • ✅ Автоматический импорт товаров с полными характеристиками
  • ✅ Обновление цен и остатков в реальном времени
  • ✅ Загрузка фотографий товаров с автоматическим обновлением
  • ✅ Умное распределение по категориям и разделам
  • ✅ Автоматическое удаление устаревших товаров
  • ✅ Полная автоматизация через Cron задачи
  • ✅ Детальное логирование всех операций

1.3 Поддерживаемые типы товаров

  • 📦 Категория 1:
  • Подкатегория 1.1
  • Подкатегория 1.2
  • Подкатегория 1.3
  • 📦 Категория 2:
  • Подкатегория 2.1
  • Подкатегория 2.2
  • Подкатегория 2.3

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

2.1 Минимальные требования

  • 1С-Битрикс: Версия 20.0 и выше
  • PHP: Версия 7.4 и выше
  • Память PHP: не менее 128MB
  • Обязательные модули Битрикс:
  • Информационные блоки
  • Торговый каталог

2.2 Рекомендуемые требования

  • Память PHP: 512MB или больше
  • Время выполнения: 300 секунд
  • Доступ к API: selectyre.ru
  • Cron поддержка: для автоматизации
  • Highload-блоки: для больших каталогов

3. Установка и настройка

3.1 Шаг 1: Установка модуля

  1. Скачайте архив selectyre.integration.zip
  2. Войдите в административную панель Битрикс
  3. Перейдите в раздел: Контент → файлы и папки → bitrix → modules
  4. Нажмите «Загрузить файл», выберите архив и подтвердите сохранение
  5. Найдите загруженный архив в списке модулей по тому же пути и распакуйте его, кликнув по иконке «сэндвич».
  6. Откройте раздел: Marketplace (установленные решения), найдите модуль «Интеграция с Selectyre (selectyre.integration)» и установите его

📍 Расположение модуля в админке:

После установки модуль будет доступен по пути:

Рабочий стол → Магазин → Интеграция с selectyre

3.2 Шаг 2: Настройка API ключей

  1. Получите API ключи в личном кабинете selectyre (selectyre.ru)
  2. Перейдите в Рабочий стол → Магазин → Интеграция с selectyre
  3. Заполните поля: (про формат и какие выгрузки)
  4. API KEY IMPORT — для импорта товаров
  5. API KEY UPDATE — для обновления цен
  6. Нажмите «Сохранить ключи»

3.3 Шаг 3: Создание инфоблоков

  1. В разделе «Создание инфоблоков» нажмите соответствующие кнопки:
  2. «Создать каталог [Категория1]»
  3. «Создать каталог [Категория2]»
  4. «Создать каталог [Категория3]» (при необходимости)
  5. Модуль автоматически создаст структуру с:
  6. Необходимыми свойствами товаров
  7. Разделами по умолчанию
  8. Настройками ЧПУ с проверкой уникальности
  9. Торговыми предложениями
  10. Структурой для фильтров

3.4 Шаг 4: Настройка интеграции

  1. В разделе «Выбор инфоблоков для интеграции» назначьте созданные инфоблоки типам товаров
  2. Пример правильной связки:
  3. [ТипТовара1] → инфоблок «[Категория1]»
  4. [ТипТовара2] → инфоблок «[Категория2]»
  5. Нажмите «Сохранить настройки инфоблоков»

4. Работа с модулем

📍 Доступ к модулю:

Все операции выполняются через административный интерфейс:

Рабочий стол → Магазин → Интеграция с selectyre

4.1 Ручной импорт товаров

  1. Перейдите в Рабочий стол → Магазин → Интеграция с selectyre
  2. Откройте раздел «Импорт и обновление данных»
  3. Для нужного типа товаров нажмите кнопку «Добавление»
  4. Следите за прогресс-баром выполнения
  5. Проверьте результат в журнале операций

Что происходит при импорте:

  • Создание разделов брендов и моделей
  • Генерация товаров с полными характеристиками
  • Загрузка и привязка фотографий
  • Настройка ЧПУ и мета-тегов
  • Создание торговых предложений

4.2 Обновление цен и остатков

  1. Используйте кнопку «Обновление» для нужного типа товаров
  2. Модуль автоматически выполнит:
  3. Обнуление текущих остатков
  4. Загрузку актуальных цен
  5. Обновление наличия товаров
  6. Корректировку свойств товаров

4.3 Управление фотографиями

Модуль автоматически отслеживает изменения фотографий через поле photo_last_modified. При изменении даты модификации фото автоматически обновляется.

Ручное обновление фото:

# Все товары категории 1
curl "https://ваш-сайт/bitrix/admin/selectyre.integration_cron.php?lang=ru&type=category1&action=update_pics"

# Все товары категории 2
curl "https://ваш-сайт/bitrix/admin/selectyre.integration_cron.php?lang=ru&type=category2&action=update_pics"

4.4 Удаление устаревших товаров

Модуль автоматически удаляет товары, отсутствующие в текущем каталоге selectyre, поддерживая ваш каталог в актуальном состоянии.

Команды для удаления:

# Удаление товаров категории 1
curl "https://ваш-сайт/bitrix/admin/selectyre.integration_cron.php?lang=ru&type=category1&action=delete"

# Удаление товаров категории 2
curl "https://ваш-сайт/bitrix/admin/selectyre.integration_cron.php?lang=ru&type=category2&action=delete"

4.5 Управление логами

Модуль ведет детальное логирование всех операций:

Типы логов:

  • add — импорт товаров
  • up — обновление данных
  • photo — работа с фото
  • del — удаление товаров
  • error — ошибки

Где смотреть логи:

  • Админка Битрикс → Настройки → Журнал событий
  • Раздел «Управление логами» в модуле
  • Файлы в /bitrix/modules/selectyre.integration/logs/

5. Автоматизация через Cron

5.1 Рекомендуемое расписание

  • Импорт: два раза в день
  • Остатки и цены: ежечасно
  • Обновление фото и параметров: раз в неделю

5.2 Готовые ссылки для Cron

Модуль автоматически генерирует правильные URL в разделе «Ссылки для cron». Просто скопируйте нужные команды из админки модуля.

5.3 Настройка Cron на сервере

Пример настройки через crontab -e:

# Основные задачи
0 */6 * * * curl "https://site.ru/bitrix/admin/selectyre.integration_cron.php?lang=ru&type=category1&action=import"
0 3 * * * curl "https://site.ru/bitrix/admin/selectyre.integration_cron.php?lang=ru&type=category1&action=update"
0 4 * * * curl "https://site.ru/bitrix/admin/selectyre.integration_cron.php?lang=ru&type=category1&action=update"

# Обновление фото и параметров
0 5 * * 1 curl "https://site.ru/bitrix/admin/selectyre.integration_cron.php?lang=ru&type=category1&action=update_pics"
0 6 * * 1 curl "https://site.ru/bitrix/admin/selectyre.integration_cron.php?lang=ru&type=category2&action=update_pics"

# Удаление товаров
0 1 * * 0 curl "https://site.ru/bitrix/admin/selectyre.integration_cron.php?lang=ru&type=category1&action=delete"
30 1 * * 0 curl "https://site.ru/bitrix/admin/selectyre.integration_cron.php?lang=ru&type=category2&action=delete"

5.4 Альтернативные команды

Если curl недоступен, используйте wget:

0 */6 * * * wget -q -O - "https://site.ru/bitrix/admin/selectyre.integration_cron.php?lang=ru&type=category1&action=import"

6. Решение проблем

6.1 Диагностика проблем

  1. Перейдите в Рабочий стол → Магазин → Интеграция с selectyre
  2. Проверьте статус интеграции — должен быть «Настроена»
  3. Проверьте логи модуля в разделе «Управление логами»
  4. Убедитесь в доступности selectyre.ru
  5. Проверьте корректность API ключей

6.2 Частые проблемы и решения

❌ Проблема: не создаются инфоблоки
✅ Решение:

  • Проверьте права доступа к модулю «Информационные блоки»
  • Убедитесь, что установлен модуль «Торговый каталог»
  • Проверьте логи в админке Битрикс

❌ Проблема: не загружаются товары
✅ Решение:

  • Проверьте корректность API ключей
  • Убедитесь, что выбран инфоблок для интеграции
  • Проверьте доступность selectyre.ru
  • Проверьте наличие пробелов в начале/конце ключей

❌ Проблема: не обновляются остатки
✅ Решение:

  • Проверьте настройки Cron задач
  • Убедитесь, что URL в Cron правильные
  • Проверьте логи выполнения Cron
  • Убедитесь, что используется KEY UPDATE

❌ Проблема: не загружаются фото
✅ Решение:

  • Проверьте доступ к интернету с сервера
  • Убедитесь, что папка /upload/ доступна для записи
  • Проверьте настройки PHP (allow_url_fopen)
  • Проверьте поле photo_last_modified в товарах

6.3 Где искать логи

  • Админка Битрикс → Настройки → Журнал событий
  • Фильтр по модулю: «[название.модуля]»
  • Логи модуля: /bitrix/modules/[название.модуля]/logs/
  • Логи PHP: проверьте error_log сервера

6.4 Порядок диагностики

  1. Проверьте статус интеграции (должен быть «Настроена»)
  2. Проверьте выбор инфоблоков для каждого типа товаров
  3. Попробуйте ручной импорт небольшого количества товаров
  4. Проверьте логи модуля (все типы: add, up, photo, del, error)
  5. Обратитесь в техническую поддержку с логами

7. Часто задаваемые вопросы

7.1 Как получить API ключи?

Зарегистрируйтесь на selectyre.ru и обратитесь в техническую поддержку для получения API ключей. Ключи предоставляются после регистрации и настройки партнерских отношений.

7.2 Сколько времени занимает импорт?

Для каталога 50,000+ товаров процесс может занять 10–30 минут. Не прерывайте операцию! Для больших каталогов рекомендуется увеличить memory_limit и max_execution_time.

7.3 Как часто нужно обновлять данные?

  • Цены и остатки: ежечасно
  • Фотографии: 1–2 раза в неделю
  • Полный импорт: 1–2 раз в день
  • Удаление товаров: 1 раз в неделю

7.4 Безопасно ли автоматическое удаление?

Да, модуль удаляет только товары, отсутствующие в текущем каталоге selectyre. Все операции логируются. Рекомендуется настроить резервное копирование базы данных.

7.5 Какие настройки PHP рекомендуются?

memory_limit = 512M
max_execution_time = 300
max_input_vars = 3000
allow_url_fopen = On
display_errors = Off ; на продакшене

7.6 Как оптимизировать работу для больших каталогов?

  • Увеличьте memory_limit до 1024M
  • Установите max_execution_time = 600
  • Используйте разделение на пакеты в Cron
  • Настройте кеширование в Битрикс
  • Используйте отдельный сервер для Cron задач

Лицензионное соглашение

Права и обязанности:

  • ✅ Модуль можно использовать на неограниченном количестве доменов
  • ✅ Возможна модификация кода для собственных нужд
  • ❌ Запрещено распространение модуля без согласия автора
  • ❌ Запрещено удаление копирайтов и информации об авторе
  • ❌ Техническая поддержка сервиса не оказывает услуги по установке и настройке модуля (при необходимости воспользуетесь услугами вашей технической поддержки или сторонних специалистов)