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

Базовая настройка модуля

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

Настройка модуля выполняется на странице административного раздела «DOBROsite» > «Интеграция с Яндекс Маркетом».

Внесите значение токена авторизации в соответствующее поле и выберите кабинет Яндекс Маркета из выпадающего списка.

Настройка каталога

На вкладке «Настройка каталога» необходимо указать параметры каталога для экспорта товаров на сайт Яндекс Маркета:

• Идентификатор каталога или инфоблока, который содержит товары.
  
  
• Артикул товара / торгового предложения — идентификатор товара в системе Яндекс Маркет. Обязательное поле для работы модуля. Значение артикула должно быть уникальным в пределах продавца. По этому параметру производится сопоставление товаров / торговых предложений из каталога вашего сайта с товарами на сайте Яндекс Маркет. Если каталог поддерживает торговые предложения, то будут доступны два поля: одно для простого товара, другое — для торгового предложения.
  
  
• Выбор этапов экспорта: «Загружать информацию о ценах» и/или «Загружать информацию об остатках».
  
  

Ограничить список товаров / торговых предложений для экспорта можно с помощью массива фильтрации в формате JSON.

Массив фильтрации в формате JSON

Для построения массива фильтрации в состав модуля входит визуальный конструктор, вызов которого происходит по клику на кнопку «Изменить фильтр».

В конструкторе фильтр формируется из одного или нескольких блоков логики, каждый из которых содержит одно или несколько условий. В системе 1С-Битрикс поддерживаются два вида логики: И и ИЛИ.

• Логика И позволяет выбрать только те товары, которые удовлетворяют сразу всем условиям блока. Блок окрашен в зелёный цвет. Такой блок может быть только один и должен содержать хотя бы одно условие.
  
  
• Логика ИЛИ позволяет выбрать товары, соответствующие хотя бы одному из условий (например, товары указанных брендов или товары из определённых разделов каталога). Блок окрашен в синий цвет. В фильтре может быть несколько блоков ИЛИ, каждый из которых должен содержать минимум два условия.
  
  

Между собой все блоки фильтра объединяются логикой И.

Каждое условие блока включает:

• свойство каталога, по которому выполняется фильтрация;
  
  
• оператор сравнения (больше, меньше, равно и т. д.);
  
  
• значение свойства.
  
  

Набор доступных свойств зависит от структуры каталога:

• для простого инфоблока доступны все его свойства;
  
  
• для торгового каталога без торговых предложений — свойства инфоблока-каталога, список типов цен, список доступных складов, а также свойства торгового каталога (доступность, общее количество, вес и габариты упаковки);
  
  
• для торгового каталога с поддержкой торговых предложений — свойства инфоблока торговых предложений, типы цен, доступные склады и свойства торгового каталога (доступность, общее количество, вес и габариты упаковки).
  
  

Каждое условие может содержать только одно значение свойства.

Если требуется более сложная структура фильтра, чем позволяет сформировать конструктор, поле «Массив фильтрации в формате JSON» можно заполнить вручную. Для этого необходимо составить массив $arFilter и сконвертировать его в JSON-формат. Подробнее о массиве $arFilter можно узнать в документации 1С-Битрикс.

Цены товаров

Вкладка «Цены» предназначена для управления ценами товаров на сайте Яндекс Маркет.

Зачёркнутая цена — цена товара до применения скидки. Если выбранный инфоблок является торговым каталогом, из выпадающего списка нужно выбрать тип цены или свойство товара / торгового предложения, значение которого будет сконвертировано в валюту Яндекс Маркета и округлено до целого числа по математическим правилам. Для простого инфоблока доступны только его свойства — они также округляются до целого числа.

Базовая цена (для всех магазинов) — цена, на основе которой рассчитывается стоимость товара, отображаемая покупателю на витрине Яндекс Маркета. Если выбранный инфоблок является торговым каталогом, из выпадающего списка нужно выбрать тип цены или свойство товара / торгового предложения. Для простого инфоблока доступны только его свойства. Также предусмотрена возможность использовать зачёркнутую цену для расчёта базовой.

На цены можно установить наценку или скидку как в процентах, так и в рублях.

Остатки товаров на складе Яндекс Маркета

Вкладка «Остатки» предназначена для управления остатками товаров на складах Яндекс Маркета (FBS, Экспресс и DBS).

Магазин Яндекс Маркета — остатки можно загрузить во все подходящие магазины кабинета, либо выбрать один из них.

Остаток товара на складе — если выбранный инфоблок является торговым каталогом, источником данных может выступать доступное количество на всех складах, на одном из складов или одно из свойств товара / торгового предложения. Для простого инфоблока доступны только его свойства.

При установленном флаге «Обнулить остаток, если количество товаров меньше n шт.» на сайте Яндекс Маркета остаток будет принудительно обнулён, если фактическое значение окажется меньше указанного числа n.

Список товаров, выбранных из каталога / инфоблока при работе модуля, может не совпадать со списком товаров, загруженных в каталог Яндекс Маркета. Параметр «Остатки товаров, которые не попали в выборку модуля» определяет поведение модуля в этом случае:

• Не изменять — на складе Яндекс Маркета будут обновлены только те товары / элементы, которые попали в выборку модуля. Остальные товары затронуты не будут.
  
  
• Обнулять — позволяет принудительно установить нулевой остаток для товаров, которые загружены в каталог Яндекс Маркета, но не попали в выборку модуля.
  
  

Работа с профилями модуля

Использование дополнительных профилей позволяет:

• экспортировать товары из нескольких каталогов / инфоблоков 1С-Битрикс на сайт Яндекс Маркета;
  
  
• одновременно работать с несколькими кабинетами / магазинами Яндекс Маркета.
  
  

Каждый профиль содержит настройки для одного каталога / инфоблока 1С-Битрикс и одного кабинета / магазина Яндекс Маркета.

Для каждого добавленного профиля необходимо выполнить базовую настройку.

Запуск процедуры экспорта

После завершения всех настроек необходимо запустить процедуру экспорта. Для этого добавьте исполняемый файл, указанный на вкладке «Параметры профиля», в утилиту cron. Рекомендации по настройке cron можно получить в службе технической поддержки вашего хостинг-провайдера.

Если исполняемый файл добавлен без аргументов, все профили модуля будут выполняться последовательно. При больших объёмах данных это может занять продолжительное время. Чтобы запустить экспорт для каждого профиля одновременно (параллельные процессы), необходимо добавить исполняемый файл для каждого профиля отдельно, указав в качестве аргумента идентификатор профиля. Идентификатор можно посмотреть в адресной строке в параметре export_ym_pid.

Пример настройки cron для параллельного запуска двух профилей:

0 1 * * * /usr/bin/php/home/bitrix/www/bitrix/modules/dobrosite.exportym/tools/cron_export_ym.php 0
0 2 * * * /usr/bin/php/home/bitrix/www/bitrix/modules/dobrosite.exportym/tools/cron_export_ym.php 1>

В этом примере экспорт профиля с идентификатором 0 запускается ежедневно в 1:00, а профиля с идентификатором 1 — ежедневно в 2:00.

Информация о последнем запуске cron отображается на странице настройки модуля в параметре «Последний запуск утилиты cron» для каждого профиля индивидуально. Если информация отсутствует или дата / время запуска неактуальны, значит настройка cron выполнена некорректно.

Результаты экспорта и возникшие ошибки можно просмотреть на вкладке «Лог», выбрав нужную дату.

ПОЛЬЗОВАТЕЛЬСКОЕ СОГЛАШЕНИЕ

Перед началом любого использования указанного ниже Приложения внимательно ознакомьтесь с условиями его использования, содержащимися в настоящем Пользовательском соглашении (далее – Соглашение). Любое начало использования Приложения означает надлежащее заключение Соглашения и Ваше полное согласие со всеми его условиями. Если Вы не согласны безоговорочно принять условия Соглашения, Вы не имеете права использовать Приложение.

Соглашение применяется к следующей программе:

Программа для ЭВМ «Интеграция с Яндекс Маркетом»

Основные термины:

Разработчик - Калинин Роман Олегович

Приложение – копия указанной выше программы для ЭВМ (как в целом, так и ее компоненты), а также любая документация по ее использованию, исключительные имущественные права на которую принадлежат Разработчику.

Договор – возмездный лицензионный договор между Пользователем и Разработчиком на предоставление права использования Приложения, в котором предусмотрены способы использования Приложения и иные существенные условия, неотъемлемой частью которого является настоящее Соглашение.

Демо-версия – версия Приложения, в которой установлено ограничение по сроку ее использования и доступному функционалу и которая предназначена исключительно для целей самостоятельного ознакомления, оценки и проверки Пользователем функциональных возможностей Приложения на условиях настоящего Соглашения и не предназначена для продажи или иного отчуждения третьим лицам.

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

Активация – действие, направленное на регистрацию на конкретного Пользователя, осуществляемое в порядке, предусмотренном в Соглашении.

Активационный код – набор символов (лицензионный ключ), представляющий собой техническое средство защиты авторских прав и предназначенный для Активации.

Техническая поддержка – мероприятия, осуществляемые Разработчиком в установленных им пределах и объемах для обеспечения функционирования Приложения, включая информационно-консультационную поддержку Пользователей по вопросам использования Приложения.

1. УСЛОВИЯ ИСПОЛЬЗОВАНИЯ И ОГРАНИЧЕНИЯ

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

1.2. Пользователь не может копировать, распространять Приложение в любой форме, в том числе в виде исходного кода, каким-либо способом, в том числе сдавать в аренду/прокат. Пользователю не разрешается использовать Приложение каким-либо способом, если такое использование противоречит или приводит к нарушению Соглашения или действующего законодательства Российской Федерации.

1.3. Запрещается любое использование Приложения, противоречащее Соглашению, Договору и действующему законодательству Российской Федерации.

2. АВТОРСКИЕ ПРАВА И ТОВАРНЫЕ ЗНАКИ

2.1. Приложение является результатом интеллектуальной деятельности и объектом авторских прав Разработчика.

2.2. Алгоритмы работы Приложения и его исходные коды (в том числе их части) являются коммерческой тайной Разработчика. Любое их использование или использование Приложения в нарушение Соглашения рассматривается как нарушение прав Разработчика и является достаточным основанием для лишения Пользователя предоставленных по Соглашению и Договору прав.

2.3. Пользователю не предоставляются права на использование товарных знаков и знаков обслуживания Разработчика и/или его партнеров.

2.4. Пользователь не может ни при каких условиях удалять или изменять внешний вид информации и сведения об авторских правах, правах на товарные знаки или патенты, указанные в Приложении.

2.5. Для защиты авторских прав и ограничения использования Приложения Разработчик использует различные технические средства защиты.

3. ВИДЫ ЛИЦЕНЗИЙ И СРОКИ ИХ ДЕЙСТВИЯ

3.1. Стандартная Лицензия:

3.1.1. Стандартная Лицензия предоставляется на срок, указанный в Договоре, со дня Активации, если иное не установлено настоящим Соглашением. По окончании указанного срока Пользователь вправе продолжить использование Приложения на условиях Ограниченной Лицензии, либо заключить новый Договор для продления использования Приложения на условиях Стандартной лицензии на очередной срок.

3.1.2. Активация Стандартной Лицензии должна быть осуществлена в обязательном порядке посредством ввода Активационного кода в соответствующее поле одним из следующих способов: (а) на соответствующем этапе установки Приложения; (б) в специальном поле раздела обновлений; (в) в сети Интернет по адресу https://www.1c-bitrix.ru/support/key_info.php.

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

3.1.4. Права на все новые версии (обновления) Приложения, а также доступ к их установке и использованию, предоставляются без выплаты дополнительного вознаграждения только при наличии у Пользователя одновременно платной  лицензии на программу для ЭВМ «1С-Битрикс: Управление сайтом» и Стандартной Лицензии на Приложение на условиях настоящего Соглашения и Договора. Все обновления Приложения являются его неотъемлемой частью и используются исключительно вместе с Приложением как единая программа для ЭВМ в порядке, предусмотренном в Соглашении.  Стороны соглашаются и подтверждают свое понимание того, что установка новых версий (обновлений) Приложения не влечет за собой предоставления нового права на использование Приложения или продления срока действующей Стандартной Лицензии. При этом Пользователю может быть предложено ознакомиться и принять дополнение к Соглашению или новую версию Соглашения.

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

Разработчик несет единоличную ответственность за техническое обслуживание и поддержку Приложения в соответствии с Соглашением и требованиями действующего законодательства.

3.2. Ограниченная Лицензия:

3.2.1. Ограниченная Лицензия предоставляется Пользователю без дополнительного вознаграждения (безвозмездно) на весь срок действия исключительных прав на Приложение только в случае и со дня предоставления ему Стандартной Лицензии.

3.2.2. Ограниченная Лицензия предоставляет Пользователю право на использование тех функциональных возможностей Приложения, которые были предоставлены ему в рамках Стандартной Лицензии, за исключением права на получения новых версий (обновлений) Приложения и Технической поддержки.

4. ОТВЕТСТВЕННОСТЬ

4.1. За нарушение условий настоящего Соглашения и Договора, в том числе нарушение авторских прав Разработчика, наступает ответственность, предусмотренная законодательством Российской̆ Федерации.

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

- сохранность в тайне Активационного кода Приложения с даты его выдачи;

- определение круга лиц, которым этот код может быть известен.

4.3. Разработчик несет единоличную ответственность за соответствие Приложения действующему законодательству.

4.4. Исключительно Разработчик несет ответственность за рассмотрение любых претензий Пользователей или любой третьей стороны, связанных с Приложением или владением и/или использованием Пользователем Приложения, включая, но не ограничиваясь: претензии об ответственности за качество Приложения;  любое утверждение о том, что Приложение не соответствуют каким-либо применимым правовым или нормативным требованиям; претензии, возникающие в соответствии с законодательством о защите потребителей, персональных данных, конфиденциальности или аналогичным законодательством. Разработчик осуществляет расследование, защиту, урегулирование и исполнение любого требования о нарушении прав на интеллектуальную собственность в случае претензий третьих лиц о том, что Приложение, владение им и/или его использование нарушает права третьих лиц на интеллектуальную собственность.

4.5. Во избежание сомнений, Разработчик и Пользователь признают и соглашаются с тем, что ООО «1С-Битрикс» (г. Москва, ИНН 7717586110):

- не является стороной настоящего Соглашения;

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

- не участвует в рассмотрении и не несет ответственность за рассмотрение Разработчиком любых претензий Пользователя или любой третьей стороны, связанных с Приложением или владением и/или использованием Приложения;

- не участвует в предоставлении Технической поддержки и не несет никаких обязательств по ее предоставлению, так же, как и каких-либо иных аналогичных услуг в отношении Приложения;

- не несет ответственности за соответствие Приложения и информации о нем действующему законодательству;

- не несет ответственность за расследование, защиту, урегулирование и исполнение любого требования о нарушении интеллектуальной собственности в отношении Приложения.

5. ОГРАНИЧЕННАЯ ГАРАНТИЯ

5.1. Приложение предоставляется по принципу «как есть» и Разработчик не гарантирует, что все его функциональные возможности будут отвечать ожиданиям Пользователя или смогут быть применимы для какой-либо конкретной его цели.

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

5.3. Если при использовании Приложения будут обнаружены ошибки, Разработчик предпримет меры для их исправления в максимально короткие сроки и/или выпустит новую, исправленную версию Приложения. Стороны соглашаются, что точное определение срока устранения ошибки не может быть установлено, так как Приложение тесно взаимодействует с другими программами для ЭВМ сторонних разработчиков, операционной системой и аппаратными ресурсами компьютера Пользователя, и работоспособность и время устранения проблем в полной мере не зависят только от Разработчика.

5.4. ООО «1С-Битрикс» не имеет никаких гарантийных и иных обязательств в отношении Приложения, а также любых претензий, убытков, обязательств, затрат или расходов, связанных с любым несоблюдением какой-либо гарантии Разработчиком.

6. ДЕЙСТВИЕ, ИЗМЕНЕНИЕ И РАСТОРЖЕНИЕ СОГЛАШЕНИЯ

6.1. Настоящее Соглашение регулируется в соответствии с законодательством Российской̆ Федерации.

6.2. В случае нарушения Пользователем условий настоящего Соглашения Разработчик имеет право в одностороннем порядке расторгнуть Договор.

6.3. При расторжении настоящего Соглашения Пользователь обязан прекратить использование Приложения полностью и уничтожить все копии Приложения, установленные на компьютерах Пользователя, включая резервные копии и все компоненты Приложения.

6.4. Пользователь вправе расторгнуть настоящее Соглашение в любое время, полностью удалив Приложение.

6.5. В случае если компетентный суд признает какие-либо положения Соглашения недействительными, Соглашение продолжает действовать в остальной части.

6.6. Соглашение также распространяется на все новые версии (обновления) Приложения, предоставляемые Пользователю, если только при обновлении Приложения Пользователю не будет предложено ознакомиться и принять дополнение к Соглашению или новое Соглашение.

6.7. Разработчик оставляет за собой право в одностороннем порядке периодически обновлять и изменять Соглашение.

7. КОНТАКТНАЯ ИНФОРМАЦИЯ РАЗРАБОТЧИКА

Калинин Роман Олегович
Почтовый адрес: Россия, 150025 Ярославская область, пос. Карачиха, ул.Садовая, дом 9, кв.8
Телефон: +74852607301

Служба техподдержки: sales@dobrosite.com