Агрегатор

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

Начиная от версии системы ImageCMS 4.11, функционал, обеспечивающий выгрузку товаров в прайс-агрегатор Яндекс.Маркета, был перенесен в отдельный модуль - "Агрегатор".

В предыдущих версиях системы для этих целей использовался отдельный модуль "Яндекс Маркет".

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

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

• 1. Модуль "Агрегатор" в админ-профиле
• 2. Модуль "Агрегатор" на сервере
• 3. Модуль "Агрегатор" в БД
• 4 Интеграция дополнений для выгрузки
• 4.1. Модуль NADAVI
• 4.2. МойСклад
• 4.3. Price.UA
• 4.4. Hotline.UA
• 4.4.1 Настройка выгрузки в hotline в карточках товаров
• 4.4.2 Модуль hotline в базе данных
• 4.5. Интеграция Satu.kz, Prom.UA, Prom.MD, Tiu.Ru, Deal.By

1. Модуль "Агрегатор" в админ-профиле

Изначально, модуль уже установлен и находится в общем списке модулей, по пути "Модули" - "Все модули" - "Агрегатор".

Если же модуля нет в общем списке модулей, необходимо установить его из одноименной вкладки , в этом же списке.

Для того чтобы вывести модуль по более короткому пути доступа: "Модули" - "Агрегатор", вам необходимо перевести переключатель в активное положение, в колонке "Показывать в меню":

2. Модуль "Агрегатор" на сервере

На сервере, все файлы модуля (не считая дополнительных модулей, описанных ниже в пункте "4 Интеграция дополнений для выгрузки") содержатся в папке aggregator в директории \application\modules\

3. Модуль "Агрегатор" в БД

Для работы модуля в базе данных сайта предусмотрена отдельная таблица aggregator, которая, по умолчанию, содержит только те колонки, которые необходимы для работы с Яндекс.Маркетом:

• id - колонка, содержащая уникальный идентификатор связки товара/значения выгрузки в таблице aggregator
• product_id - колонка, содержащая уникальный идентификатор товара в системе, к которому привязаны выгружаемые свойства (id товара из списка товаров в админ-профиле)
• aggregator_id - колонка, содержащая идентификатор модуля выгрузки (например, доступного по умолчанию модуля Яндекс.Маркет - ymarket)
• field - поле, которое содержит название поля выгружаемого параметра. Например country_of_origin (страна производитель) manufacturer_warranty и seller_warranty (гарантия)
• value - поле, которое содержит значение для параметра, указанного в поле field, в кодированном виде или открытом виде. Например гарантия от производителя - P2Y (2 года) или P3M (три месяца). В то же время, страна производитель будет указана без кодировки, например - Австрия.

Также, для работы модуля "Агрегатор" используется строка в таблице components, которая содержит настройки модуля.

4 Интеграция дополнений для выгрузки

При покупке дополнения вы имеете возможность заказать через вашего менеджера бесплатную интеграцию дополнительных модулей. Однако, если вы желаете самостоятельно установить дополнение (если это Надави, МойСклад, Price.UA, Hotline.UA), необходимо следовать инструкциям ниже:

Шаг 1: Скачайте архив приобретенного дополнения из вашего личного кабинета на imagecms.net, в разделе "Мои дополнения":

Шаг 2: Извлеките папку модуля из загруженный архива на сервер в дирректорию application\modules посредством FTP-клиента

Шаг 3: Перейдите в админ-профиль к списку модулей

Осуществите переход в админ профиле "Модули" → "Все модули" → вкладка "Установить модули":

Шаг 4: Клик по ссылке "Установить"

В открывшемся списке модулей должен отображаться приобретенный модуль - необходимо осуществить клик по ссылке "Установка" напротив данного модуля:

В некоторых случаях модуль уже может быть установлен - находиться в общем списке всех модулей (например , "чистая" установка системы с демо-данными).

Шаг 5: После завершения установки - очистите кеш из админ панели

Если установка прошла корректно, то в форме редактирования товаров, на вкладке "Дополнения модулей", будут отображаться поля установленного модуля

4.1. Модуль NADAVI

После установки модуля интеграции с NADAVI, его можно вывести в пункте главного меню "Модули". Последующая работа с модулем - аналогична работе с модулем "Яндекс.Маркет"

В базе данных модуль интеграции с NADAVI создает таблицу mod_nadavi, которая содержит следующее колонки:

• id - колонка, которая содержит уникальный идентификатор, используемый в модуле интеграции с NADAVI
• categories - колонка, которая содержит id категорий товаров в кодированном виде, которые выбраны в настройках модуля (если таковые были указаны). Если категории не выбраны в настройках, то значение поля останется пустым.
• brands - колонка, которая содержит id бренда производителя в кодированном виде, которые выбраны в настройках модуля (если таковые были указаны). Если бренды не были выбраны в настройках, то значение поля останется пустым.

Так же, модуль NADAVI после установки создает строку nadavi в таблице components, в которой прописываются внутренние настройки модуля в системе или другая служебная информация модуля.

4.2. МойСклад

После установки модуля интеграции с МойСклад, его можно вывести в пункте главного меню "Модули". Последующая работа с модулем - аналогична работе с модулем "Яндекс.Маркет"

В базе данных модуль интеграции с МойСклад не создает своих таблиц - модуль использует данные внесенные в таблицу aggregator и другие необходимые данные

Однако, модуль после установки создает строку moy_sklad в таблице components, в которой прописываются внутренние настройки модуля в системе.

4.3. Price.UA

После установки модуля интеграции с Price.UA, его можно вывести в пункте главного меню "Модули". Последующая работа с модулем - аналогична работе с модулем "Яндекс.Маркет"

В базе данных модуль интеграции с Price.UA создает таблицу mod_price_ua, которая содержит следующее колонки:

• id - колонка, которая содержит уникальный идентификатор, используемый в модуле интеграции с Price.UA.
• categories - эта колонка содержит id категорий товаров в кодированном виде, которые выбраны в настройках модуля (если таковые были указаны). Если категории не выбраны в настройках, то значение поля останется пустым.
• brands - эта колонка содержит id бренда производителя в кодированном виде, которые выбраны в настройках модуля (если таковые были указаны. Если бренды не были выбраны в настройках, то значение поля останется пустым.

Так же, модуль Price.UA после установки создает строку price_ua в таблице components, в которой прописываются внутренние настройки модуля в системе.

4.4. Hotline.UA

После установки модуля интеграции с Hotline.UA, его можно вывести в пункте главного меню "Модули". Последующая работа с модулем - аналогична работе с модулем "Яндекс.Маркет"

4.4.1 Настройка выгрузки в hotline в карточках товаров

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

Это поля:

Страна производитель - поле, в котором из выпадающего списка можно выбрать страну производства товара:

Страна производитель может быть только одна. Для упрощения поиска нужной страны используйте строку поиска по названию, которое появляется после клика по полю "Страна производитель"

Тип гарантии/месяцев - ячейка, при помощи которой можно определить/указать, имеется ли гарантия на конкретный товар. Если значение:

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

Доступность товара - поле, в котором можно указать статус доступности товара. Доступны 2 статуса:

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

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

• Новый
• Заводское восстановление
• Бывший в употреблении, в т.ч. уцененный

Если гарантия на товар предоставляется больше чем на 11 месяцев (на 12 и больше), то система автоматически переконвертирует время в годы.

В дополнительном поле при настройках параметра "Доступность товара", если выбрать статус "Под заказ", следует указать количество дней цифрами, без каких либо примечаний или дополнительного содержимого (пробелов, знаков препинания и т.д.)

Например, если для доставки/изготовления товара необходимо семь дней, то следует прописать только цифру "7". Любые другие данные (например: семь дней, 7 дней, неделя и т.д) будут некорректными.

4.4.2 Модуль hotline в базе данных

В базе данных, модуль интеграции с Hotline.UA создает таблицы mod_hotline и mod_hotline_products_fields, которая содержит следующее колонки:

Таблица mod_hotline

• id - колонка, которая содержит уникальный идентификатор, используемый в модуле интеграции с Hotline.UA
• categories - колонка, которая содержит id категорий товаров в кодированном виде, которые выбраны в настройках модуля (если таковые были указаны). Если категории не выбраны в настройках, то значение поля останется пустым.
• brands - колонка, которая содержит id бренда производителя в кодированном виде, которые выбраны в настройках модуля (если таковые были указаны). Если бренды не были выбраны в настройках, то значение поля останется пустым.
• adult - колонка, которая содержит информацию о том, является ли товар подлежащий выгрузке, товаром из категории "для взрослых (18+)". Возможно два значения: "0" - нет (товар не для взрослых) и "1" - да (товар для взрослых). По умолчанию - значение "0". Поле не может быть пустым.

Таблица mod_hotline_products_fields

• id - колонка, которая содержит уникальный идентификатор используемый в модуле
• product_id - колонка, которая содержит id товара в системе (содержимое в колонке id, в списке товаров)
• country_of_origin - колонка, которая содержит данные о стране производителе в открытом, не кодированном виде.
• guarantee - колонка, которая содержит данные о предоставляемой гарантии (тип и срок, в кодированном виде)
• stock - колонка, которая содержит данные о статусе доступности товара (статус доступности и срок в днях, в кодированном виде)
• condition - колонка, которая содержит данные о состоянии товара на момент продажи. Допустимы следующие значения:
• 0 - Новый
• 1 - Заводское восстановление
• 2 - Бывший в употреблении, в т.ч. уцененный

Так же, модуль Hotline.UA после установки создает строку hotline в таблице components, в которой прописываются внутренние настройки модуля в системе или другая служебная информация модуля.

4.5. Интеграция Satu.kz, Prom.UA, Prom.MD, Tiu.Ru, Deal.By

На момент написания статьи, самостоятельная установка модулей расширений для интеграции с Satu.kz, Prom.UA, Prom.MD, Tiu.Ru, Deal.By не возможна из-за специфики нашей системы и упомянутых ресурсов.

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