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

Технические данные

Совместимые редакции

• Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Старт
• Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Стандарт
• Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Малый бизнес
• Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Бизнес

Описание

Модуль представляет собой интеграцию Вашего Битрикс сайта с Маркетплейсом Яндекс Маркет (Yandex market) по API. Вы сможете автоматизировать экспорт товаров, цен, остатков и импорт заказов уже через 10 минут!

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

---------------------------------------------------------------------------------------------------

Также предлагаем рассмотреть Комплект модулей «Интеграция с Ozon и Яндекс Маркет». Это готовое решение для автоматизации продаж на двух крупнейших маркетплейсах России, которое включает в себя модули Интеграция с OZON и Интеграция с Яндекс Маркет со значительной экономией для Вашего бизнеса.

---------------------------------------------------------------------------------------------------

Возможности:

1. Выгрузка товаров в в Яндекс Маркет (все поля и характеристики), с возможностью опциональной настройки каждого поля или атрибута. Вы можете выгружать конкретный товар (через Тестирование Выгрузки), а также выгружать все допустимые товары через Агент или Cron.

2. Выгрузка цен товаров в Яндекс Маркет. Вы можете выгружать цены для конкретного товара (через Тестирование Выгрузки), а также выгружать для всех допустимых товаров через Агент или Cron.Применить

3. Выгрузка остатков товаров в Яндекс Маркет. Вы можете выгружать остатки для конкретного товара (через Тестирование Выгрузки), а также выгружать для всех допустимых товаров через Агент или Cron

4. Загрузка заказов из Яндекс Маркет. Вы можете загружать конкретные заказы (через Тестирование Выгрузки), а также загружать все подходящие заказы через Агент или Cron. Также Вы сможете настроить соответствие статусов заказов на вашем сайте и в Яндекс Маркет

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

6. Журнал обмена. Просматривайте информацию об экспорте/импорте или ошибках в Журнале обмена

7. Многофункциональный фильтр. Настройте фильтр на экспорт товаров, цен, остатков, который соответствует Вашим конкретным условиям

8. Высокая отказоустойчивость. Модуль будет пытаться автоматически обработать некорректные данные и возникающие ситуации как со стороны Битрикса, так и со стороны Яндекс Маркет. Если автоматически не удастся решить проблему, то она будет зафиксирована в Журнале обмена, а работа модуля продолжится.

9. Обработчики событий модуля. Вы можете программно переопределить данные при экспорте товаров, цен, остатков, а также при импорте заказов через обработчики событий модуля (список событий с примерами кода приводится далее в описании)

10. Без ограничений в Демо-период. Без создания дополнительных шаблонов сайта. Без каких-либо изменений Ваших настроек или настроек Битрикса. Без возможности хоть как-то сломать функционал Вашего сайта.

Алгоритм для базовой настройки экспорта товаров, цен, остатков:

1. В Основных настройках задать данные для подключения к API Яндекс Маркет и настроить соответствие основных полей товаров
   
2. В Управлении связями категорий соотнести Ваши категории с категориями Яндекс Маркет, активировать нужные связи для последующей выгрузки (на этапе 5, 6)
   
3. В Управлении связями характеристик соотнести Ваши характеристики с характеристиками категории Яндекс Маркет
   
4. В Управлении связями значений характеристик соотнести значения Ваших характеристик с типом список (или справочник) со списочными значениями характеристик категории Яндекс Маркет
   
5. В Тестировании выгрузки можете проверить корректность выгрузки товаров, цен, остатков в Яндекс Маркет
   
6. Для массовой выгрузки необходимо активировать нужных агентов выгрузки (товаров, цен, остатков), либо поставить нужные скрипты выгрузок на cron (пути на скрипты описаны далее)
   
7. Наслаждаться автоматизированным экспортом в Яндекс Маркет
   

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

1. В Основных настройках задать данные для подключения к API Яндекс Маркет и настроить соответствие основных полей товаров
   
2. В Настройках заказов настроить основные поля для заказа, и по желанию соответствие статусов заказов на вашем сайте и статусов в Яндекс Маркет
   
3. Для массовой загрузки необходимо активировать агента загрузки заказов, либо поставить нужный скрипт загрузки на cron (путь на скрипт описан далее)
   
4. Наслаждаться автоматизированным импортом из Яндекс Маркет
   

Важно:

1. Для успешной выгрузки полей, характеристик: необходимо, чтобы у Вас были настроены связи на все обязательные поля (артикул, габариты и т.д.) и обязательные характеристики в категориях. Т.к если у Вас не настроено хоть 1 обязательное поле или 1 обязательная характеристика для связанных категорий, то в Яндекс Маркет может не обновится информация ни по полям, ни по каким-либо характеристикам у товаров определенной категории.

2. У ваших свойств в настройках соответствующего инфоблока в Битриксе, должны быть заданы Коды (а не только Название)

Нюансы:

1. По умолчанию выгрузка товаров, цен, остатков, а также загрузка заказов доступны на Агентах, но их надо Активировать и при желании изменить периодичность запуска (НЕ рекомендуется ставить слишком часто). Крайне рекомендуется настроить экспорт/импорт не через Агенты, а с использование Cron. Если настроено через Агенты, то данные будут обрабатываться постепенно при каждом запуске агента (так необходимо, чтобы у клиентов не тормозил Ваш сайт), если настроено через Cron, то будет полная обработка необходимых данных.

2. Если в функции Агента в скобках () указано число, то это ID профиля, под который настраивается Агент. Если в скобках () нет числа, то это Агент под профиль с ID = 1

Крайне рекомендуется поставить все экспорты на Сron. После перевода скриптов на Cron деактивируйте соответствующие Агенты модуля (если ранее их активировали). Пути скриптов (начало пути может отличаться от вашего - уточняйте у штатного программиста или в ТП хостера). Пример настроек для профиля с ID = 1:

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

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

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

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

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

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

Доступны обработчики событий для программистов. Примеры обработчиков для init.php:

1. Переопределить значения при выгрузке информации о товарах в Яндекс Маркет (название, ндс, характеристики и т.д):  AddEventHandler("guryev.ym", "OnExportProduct", ["MyClassGuryevYm", "OnExportProduct"]);

2. Переопределить значения при выгрузке цен товаров в Яндекс Маркет: AddEventHandler("guryev.ym", "OnExportPrice", ["MyClassGuryevYm", "OnExportPrice"]);

3. Переопределить значения при выгрузке остатков товаров в Яндекс Маркет: AddEventHandler("guryev.ym", "OnExportStock", ["MyClassGuryevYm", "OnExportStock"]);

4. Переопределить значения при загрузке заказа из Яндекс Маркет: AddEventHandler("guryev.ym", "OnImportOrder", ["MyClassGuryevYm", "OnImportOrder"]);

Примечание к обработчикам: в OnExportProduct, OnExportPrice, OnExportStock собственная реализация фильтра/отсева товаров недопустима, и может повлечь отсутствие выгрузки данных. Для успешной выгрузки разрешено только переопределение значений!

Пример класса с обработчиками для init.php

*Не забудьте также подключить их через AddEventHandler

class MyClassGuryevYm

{

   /**

   * @param array $profileData - текущий профиль

   * @param array $preparedData - данные для выгрузки

   * @return array

   */

   public static function OnExportProduct(array $profileData, array $preparedData): array

   {

       foreach ($preparedData as $key => $value) {

           $updPrice = $value["offer"]["basicPrice"]["value"] + 100;

           $preparedData[$key]["offer"]["basicPrice"]["value"] = (int)$updPrice;

       }

       return $preparedData;

   }

   /**

    * @param array $profileData - текущий профиль

    * @param array $preparedData - данные для выгрузки (первый ключ - id Магазина в Яндекс Маркете; если ключ = 0, то выгрузка для всего личного кабинета)

    * @return array

    */

   public static function OnExportPrice(array $profileData, array $preparedData): array {

      foreach ($preparedData as $campaignId => $values) {

           foreach ($values as $key => $value) {

               $updPrice = $value['price']['value'] + 200;

               $preparedData[$campaignId][$key]['price']['value'] = (int)$updPrice;

           }

      }

      return $preparedData;

   }

 /**

   * @param array $profileData - текущий профиль

   * @param array $preparedData - данные для выгрузки (первый ключ - id Магазина в Яндекс Маркете)

   * @return array

   */

   public static function OnExportStock(array $profileData, array $preparedData): array {

       foreach ($preparedData as $campaignId => $values) {

           foreach ($values as $key => $value) {

               $updStock = $value["items"][0]["count"] + 1;

               $preparedData[$campaignId][$key]["items"][0]["count"] = (int)$updStock;

           }

       }

       return $preparedData;

   }

  /**

   * @param array $profileData - текущий профиль

   * @param Bitrix\Sale\Order $bitrixOrder - заказ в Битриксе

   * @param array $ymOrder - заказ в Яндекс Маркет

   * @return array

   */

   public static function OnImportOrder(array $profileData, Bitrix\Sale\Order $bitrixOrder, array $ymOrder): Bitrix\Sale\Order {

       $bitrixOrder->setField("STATUS_ID", "N");

       return $bitrixOrder;

   }

}

ВНИМАНИЕ! Для работы модуля необходим ключ API, который можно получить в личном кабинете партнера на Яндекс Маркет. Наборы и комплекты в выгрузке не участвуют.

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