Scoder: Модуль интеграции с сервисом Onliner.by по Api

1.0.5 (31.01.2023)	Корректировки для php8
1.0.4 (24.08.2021)	Добавлен "Метод отправки прайс-листа"
1.0.3 (12.08.2021)	Корректировка работы агента в связи с новой опцией "Выгружать только товары с доступным количеством больше 0"
1.0.2 (11.08.2021)	Добавлена опция "Выгружать только товары с доступным количеством больше 0"
1.0.1 (10.08.2021)	Корректировка ошибки при удалении модуля

Модуль устанавливается через стандартный механизм установки модулей.


Настройка модуля достаточно сложная, нужно хорошо понимать работу сервиса Onliner.


После установки решения необходимо:

1. В настройках модуля (на странице Настройки -> Настройки продукта -> Настройки модулей -> Scoder: Модуль интеграции с сервисом Onliner.by по Api) указать Client ID и Client Secret, полученные в сервисе Onliner.
   
2. Настроить профиль отправки данных в сервис Onliner на странице Контент -> Highload-блоки -> Scoder: Модуль интеграции с сервисом Onliner.by по Api. Настройки и добавить запись. На момент публикации модуля интерфейс настроек профиля может быть сложным для заполнения, мы используем только родные возможности 1С-Битрикс, а именно Hilgload-блоки. Обещаем исправиться и со временем выпустить более "человечный" интерфейс. =)
   

Отправка данных в сервис Onliner происходит периодически с помощью агента CScoderOnlinerAgents::PriceList(). При необходимости изменить периодичность или время запуска, необходимо редактировать непосредственно агент.


Колонки названы аналогично колонкам в Onliner: https://github.com/onlinerby/onliner-b2b-api/blob/master/docs/price-lists/formats.md

• ИД инфоблока - целое число, равен ИД каталога товаров, который необходимо отправлять в Onliner.
  
• Поле для ИД раздела из Onliner - в данный момент не используется, модуль выгружает только товары, не категории
  
• Выгружаемые разделы - не обязательное поле, по умолчанию все категории. В каждой строке необходимо указать целое число, равное ИД раздела инфоблока, товары которых необходимо выгружать.
  
• Поле для названия раздела - стандартное или пользовательское поле (UF_*) раздела инфоблока, откуда берется название для категории. Например, NAME.
  
• courierDeliveryPrices - в данный момент не используется.
  

Все остальные поля могут браться из стандартных полей элементов инфоблока, свойств элементов инфоблока и полей торгового каталога и заполняются по следующему принципу:

• Если необходимо указать стандартное поле, то перед кодом поля нужно добавить префикс ELEMENT_. Например, ELEMENT_ID, ELEMENT_NAME, ELEMENT_PREVIEW_TEXT...
  
• Если необходимо указать свойство, то перед кодом свойства нужно добавить префикс PROPERTY_. Например, PROPERTY_BRAND, PROPERTY_ARTICLE, зависит от того, какой код ваших свойств. Если используется свойства типа привязки к элементам то, через "точку", например PROPERTY_BRAND.PROPERTY_MANUFACTURER... Т.е. работает принцип метода CIBlockElement::GetList.
  
• Если необходимо указать поле торгового каталога, то перед кодом поля нужно добавить префикс CATALOG_. Например, CATALOG_QUANTITY, CATALOG_PRICE_1, CATALOG_CURRENCY_1...
  
• Если необходимо задать статичное значение или текст, то так и пишете как есть в соответствующую строку.
  

Немного о сервисе Onliner:

Сопоставления торговых предложений с карточками товара в Onliner происходит двумя способами, по связке:

1. "Производитель" - "Артикул"
   
2. Если Артикул не записан в каталог (не существует на стороне Onliner/не был предоставлен при создании карточки товара/вы передали ошибочный), то валидация происходит вторым способом: "Раздел" - "Производитель" - "Товар"
   

Другими словами, ваши наименования полей "Раздел" - "Производитель" - "Товар" - должны полностью совпадать с аналогичными полями товара в Onliner.


Все выделенные поля обязательны:



Поля:

• "stockStatus"
  
• "termHalva"
  
• "priceHalva"
  

это дополнительный подключаемый функционал, через обращение к менеджерам Onliner. В json можно не указывать, пока не будет необходимости подключать функционал.

Техническая поддержка осуществляется по e-mail адресу scoder.ru@yandex.ru. Все просьбы и предложения, пожалуйста, отправляйте на указанный почтовый ящик или в комментариях к решению.

При обращении в службу поддержки обязательно указывайте:

• адрес сайта,
  
• логин и пароль администратора,
  
• ftp логин и пароль,
  
• e-mail покупателя модуля или номер вашего купона,
  
• техническая поддержка не оказывается, если закончился срок получения обновлений модуля.
  

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