Интеграция с Яндекс Маркет

Что умеет решение

Модуль обеспечивает интеграцию сайта на 1С-Битрикс с маркетплейсом Яндекс Маркет через API. Решение позволяет настроить автоматический экспорт каталога, цен и остатков, а также импорт заказов в течение 10 минут. Синхронизация данных и управление заказами снижают операционные затраты бизнеса.

Функционал включает выгрузку всех полей и характеристик товаров в Яндекс Маркет с возможностью индивидуальной настройки каждого атрибута. Поддерживается тестовая выгрузка отдельного товара, а также пакетная выгрузка всех доступных позиций через фоновый агент или планировщик Cron.

Модуль обеспечивает интеграцию с Яндекс Маркет для автоматического обмена данными. Функционал включает выгрузку цен и остатков товаров, а также загрузку заказов. Для каждого типа данных доступна ручная проверка через тестовый режим и автоматическая обработка всех подходящих записей с помощью фоновых агентов или планировщика Cron. При работе с заказами предусмотрена возможность настройки соответствия статусов между сайтом и площадкой.

Архитектура модуля поддерживает неограниченное количество профилей Яндекс Маркет, что позволяет гибко настраивать параметры для каждого из них. Система способна работать с любым числом магазинов одновременно. Все операции экспорта и импорта, а также возникающие ошибки, фиксируются в журнале обмена для последующего анализа. Для управления потоками данных реализован многофункциональный фильтр, позволяющий точно настраивать условия выгрузки товаров, цен и остатков.

Модуль обеспечивает высокую отказоустойчивость при обмене данными с Яндекс Маркет. Система автоматически пытается обработать некорректные данные и сбои как на стороне платформы «1С-Битрикс», так и на стороне маркетплейса. В случае невозможности автоматического устранения ошибки проблема фиксируется в Журнале обмена, после чего работа модуля продолжается без остановки.

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

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

Базовая настройка экспорта товаров, цен и остатков выполняется в три этапа:

1. В разделе «Основные настройки» вводятся данные для подключения к API Яндекс Маркет и настраивается соответствие основных полей товаров.

2. В разделе «Управление связями категорий» осуществляется сопоставление категорий сайта с категориями Яндекс Маркет, после чего активируются необходимые связи для выгрузки (этапы 5 и 6).

3. В разделе «Управление связями характеристик» производится сопоставление характеристик сайта с характеристиками категорий Яндекс Маркет.

В разделе управления связями значений характеристик сопоставьте параметры вашего каталога с типом «список» или «справочник», используемым для характеристик категории в Яндекс Маркете.

В разделе тестирования выгрузки проверьте корректность передачи товаров, цен и остатков в Яндекс Маркет.

Для массовой выгрузки активируйте соответствующих агентов (товаров, цен, остатков) или настройте выполнение скриптов выгрузки через cron (путь к скриптам указан далее).

Алгоритм базовой настройки импорта заказов:

В основных настройках укажите данные для подключения к API Яндекс Маркета и настройте соответствие основных полей товаров.

В настройках заказов определите основные поля, а при необходимости — соответствие статусов заказов на вашем сайте и статусов в Яндекс Маркете.

Для массовой загрузки активируйте агента загрузки заказов или настройте выполнение скрипта загрузки через cron (путь к скрипту указан далее).

Важно:

Для успешной выгрузки данных в Яндекс Маркет необходимо заранее настроить связи для всех обязательных полей (артикул, габариты и другие) и характеристик в соответствующих категориях. Отсутствие хотя бы одного обязательного поля или характеристики для связанных категорий приведет к тому, что информация о товарах в данной категории не обновится в маркетплейсе.

В настройках инфоблока Битрикса для свойств обязательно должны быть указаны их технические коды, а не только названия.

Особенности работы:

Выгрузка товаров, цен, остатков и импорт заказов по умолчанию доступны через агенты Битрикса. Эти задачи требуют активации и настройки периодичности запуска; чрезмерно частые интервалы не рекомендуются. Для обеспечения стабильной работы сайта предпочтительнее использовать Cron-задачи вместо агентов. При работе через агенты обработка данных происходит постепенно, что снижает нагрузку на сервер, тогда как настройка через Cron обеспечивает полную и мгновенную обработку всех необходимых данных.

В функции Агента число в скобках указывает ID профиля, для которого настраивается агент. Если число отсутствует, агент применяется к профилю с ID 1.

Рекомендуется настроить все операции экспорта через планировщик задач (Cron). После переноса скриптов на Cron отключите соответствующие агенты модуля, если они ранее были активны. Путь к скриптам может отличаться в зависимости от конфигурации сервера; точные пути уточняйте у системного администратора или в службе технической поддержки хостинга.

Примеры путей для профиля с ID 1:

Выгрузка товаров: /public_html/bitrix/tools/guryev.ym/cron/export_products.php

Выгрузка цен: /public_html/bitrix/tools/guryev.ym/cron/export_prices.php

Выгрузка остатков: /public_html/bitrix/tools/guryev.ym/cron/export_stocks.php

Загрузка заказов: /public_html/bitrix/tools/guryev.ym/cron/import_orders.php

Примечание: для профилей с ID, отличным от 1, необходимо передавать аргумент profile_id. Например, для выгрузки товаров профиля с ID 2 путь скрипта должен выглядеть так: /public_html/bitrix/tools/guryev.ym/cron/export_products.php profile_id:2

Обработчики событий:

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

Для изменения данных о товарах (название, НДС, характеристики и прочее) используется событие OnExportProduct. Для корректировки цен применяется OnExportPrice, а для настройки остатков — OnExportStock. При импорте заказов из платформы активируется обработчик OnImportOrder.

Важное ограничение: в обработчиках OnExportProduct, OnExportPrice и OnExportStock запрещено реализовывать собственную логику фильтрации или отсечения товаров. Это может привести к полному отсутствию выгрузки данных. Разрешено исключительно переопределение значений существующих параметров.

Ниже приведен пример класса с реализацией обработчиков для init.php. Не забудьте зарегистрировать эти методы через функцию AddEventHandler.

Модуль интеграции с Яндекс Маркетом содержит хуки для автоматической корректировки данных перед выгрузкой. Функция экспорта товаров увеличивает базовую цену каждого предложения на 100 единиц. Функция экспорта цен обрабатывает данные по кампаниям или для всего личного кабинета, добавляя к цене 200 единиц. Функция экспорта остатков также предусмотрена для обработки данных о наличии товара.

Модуль обеспечивает интеграцию с Яндекс Маркетом для платформы 1С-Битрикс. Для корректной работы требуется наличие API-ключа, который можно получить в личном кабинете партнера Яндекс Маркет. При формировании выгрузки данные о наборах и комплектах не передаются.

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

General iT поможет установить модуль, настроить его и проверить работу на твоём сайте.