Описание
MC: OZON интеграция — это модуль от команды Maxi Cart для платформы CS-Cart (всех редакций) и MultiVendor (всех редакций) 4.11.1 - 4.18.2.
Модуль поможет Вам упростить работу с маркетплейсом OZON
Модуль позволяет:
- Синхронизировать цены между Вашим CS-Cart магазином и маркетплейсом OZON;
- Синхронизировать остатки (наличие) товаров между Вашим CS-Cart магазином и маркетплейсом OZON. Модуль работает как совместно с модулем "Склады" так и без него;
- Вы можете выбрать какое поле товара CS-Cart будете использовать для привязывания к товару на маркетплейсе. Например: ID товара, код товара, указать значение в отдельном поле. Либо же добавить своё поле товара с этой целью (например использовать идентификатор из системы учёта 1С);
- Синхронизировать заказы с заказами с маркетплейса. Модуль позволит с помощью CRON получить список необработанных FBS отправлений и отобразить их в административной панели Вашего магазина CS-Cart.
- Вы сможете просматривать список доступных промо-акций маркетплейса прямо из административной панели CS-Cart магазина. На странице доступных промо-акций так же отображается информация о товарах доступных для участия в акциях.
Техническая поддержка
Общие условия технической поддержки доступны по этой ссылке (обязательно изучите эти условия, все решения от команды разработчиков MaxiCart поставляются с ограниченной технической поддержкой).
Обратите внимание, что за ответ на вопрос, который уже описан в документации специалист поддержки вправе списать с Вас баллы.
Использование
Установка
Для установки модуля Вам необходимо выполнить следующие шаги:
- Перейти на Маркетплейс и авторизоваться под учётной записью владельца заказа
- Перейти в заказ с модулем «OZON интеграция», там Вы сможете увидеть ссылку для скачивания архива модуля
- Произвести установку скачанного архива в своём магазине (стандартная для CS-Cart установка: Модули → Управление модулями, в меню шестерёнки выберите Ручная установка, загрузите архив в появившемся окне и нажмите кнопку Установить).
Настройки
1. Client Id (Идентификатор клиента)
Укажите в данном поле Идентификатор клиента
из личного кабинета Маркета.
2. API key (API ключ)
Получите API key (API ключ)
в настройках личного кабинета OZON продавца.
3. Поле артикула
Поле товара в CS-Cart которое будет использовано как артикул на стороне маркетплейса.
Артикул товара на стороне Маркетплейса должен быть равен значению выбранного поля товара на стороне магазина.
Расширить список вариантов Вы можете через хук mc__ozon_sync_offer_id_field_post
4. Ценовая маржа, %
Настройка определяет маржу цен между сайтом и Маркетплейсом. Вы можете задать какую наценку (в процентах) нужно прибавить к цене перед отправкой цен на Маркетплейс.
Настройка поддерживает отрицательные значение (первым знаком в значении настройки, в таком случае должен быть -
).
RUB
.
5. Склад по умолчанию
Настройка используется для обновления остатков в случае если на Маркетплейсе создано более одного склада.
Настройка используется когда модуль "Склады" неактивен.
6. Статус заказа
Настройка определяет статус заказа, который будет присвоен всем новым заказам создаваемым в момент синхронизации.
Работа со встроенным функционалом
В этом разделе представлена информация исключительно по функциям, которые добавляет «OZON интеграция».
Мы настоятельно рекомендуем Вам ознакомиться с документацией к использованию CS-Cart перед тем как приступать работать с модулем.
Товары
Для корректной работы функционала синхронизации цен и остатков необходимо настроить соответствие товаров в магазине к товарам на Маркете. Нужные Вам настройки находятся на странице "Товары → Товары → *Страница настроек конкретного товара* → вкладка "MC: OZON интеграция".
1. OZON ID товара
В данном поле необходимо указать значение идентификатора товара в системе Маркетплейса.
После корректного заполнения этого поля появится ссылка Редактировать на маркете
.
Чтобы заполнить артикул товара на маркетплейсе автоматически или используя кнопку, он должен совпадать со значением поля, которое Вы выбрали как "Поле артикула", на сайте.
2. В наличии
Доступна кнопка "Обновление остатков". По нажатию на данную кнопку наличие данного товара на Маркетплейсе будет обновлено.
3. Действия
Служебные действия с товарами на Маркетплейсе. Доступны следующие действия:
Архивировать
— Архивирует товар на Маркете (возможность этого действия вынесена на отдельную привелегию администратора)Восстановить из архива
— Восстановить товар из архива на Маркете (доступно только после архивации)Удалить
— Полностью удалить товар с Маркетплейса (доступно только после архивации)
4. Настройки цен
Данная секция содержит поля для работы с ценой товара на Маркетплейсе
5. Информация
Информационная секция служит для того, чтоб Вы могли убедиться что правильно настроили синхронизацию данного товара (связали товар с правильным товаром на Маркете).
Склады
Если Вы используете модуль "Склады", то для корректной работы функционала обновления остатков Вам нужно проставить соответствие складам магазина к складам Маркета. Нужные Вам настройки находятся на странице "Администрирование → Магазины и ПВЗ → *Страница настроек конкретного склада* → вкладка "Модули" → секция "MC: OZON интеграция".
В поле "Идентификатор склада OZON" необходимо указать идентификатор склада Маркетплейса.
Синхронизация
Работа с функционалом синхронизации осуществляется в автоматическом (по CRON) и ручном (по нажатию кнопки) режимах.
Вы можете перейти на страницу с данным функционалом по пути: "Товары → OZON интеграция → Синхронизация с маркетплейсом".
На данной странице отображен полный список доступных CRON заданий и кнопки для ручного запуска синхронизации. Обратите внимание, что CRON задания Вы должны самостоятельно добавить на выполнения в панели управления сервером (или обратиться к системному администратору).
Список доступных действий:
Обновление остатков
— Обновить остатки на МаркетплейсеОбновление цен
— Обновить цены на МаркетплейсеСписок необработанных FBS отправлений
— Загрузить необработанных FBS отправления с Маркетплейса. Будет создан отдельный заказ на сайте для каждого отправления.Связать товары
— Массово связать товары магазина с товарами Маркетплейса. Используется поле выбранное как "Поле артикула" в настройках модуля
Экспорт и импорт
Модуль додає можливість працювати з додатковими полями під час експорту та імпорту товарів:
- OZON product ID
- OZON product code
- OZON price
- OZON minimal price
- OZON premium price
Промо-акции и скидки
На странице "Маркетинг → Промо-акции и скидки → MC: OZON интеграция: Промо-акции" отображена информация о промо-акциях доступных на Маркете, а также товары магазина, участвующие в акциях.
Разработка
Добавить свое поле артикула
mc__ozon_sync_offer_id_field_post
:
/**
* @param array $offer_id_fields List of sku field variants
*/
fn_set_hook('mc__ozon_sync_offer_id_field_post', $offer_id_fields);
Список релизов
1.3.0 → 1.4.0 (2024-03-31)
Новый функционал:
- На странице редактирования категории во вкладке "Модули" добавлена настройка "Ozon категория". Данная настройка позволяет связать категории с категориями и типами товаров на Маркетплейсе. В будущем будет доступно создание товаров на Маркетплейсе через функционал модуля.
- На странице редактирования товара во вкладке "MC: OZON интеграция" добавлены настройки "Типов цен" для полей "Цена (на Маркетплейсе)", "Минимальная цена" и "Премиальная цена". Вы имеете возможность выбрать один из вариантов: "Указать статическое значение", "Значение наценки в основной валюте магазина", "Значение наценки в %", "Значение скидки в основной валюте магазина" или "Значение скидки в %".
- Добавлена настройка "Обновить остатки на складе" для товара. Эта настройка позволяет указать склад по умолчанию для обновления остатков на уровне товара. Она будет отображаться только в том случае, если модуль "Склады" не активен.
Исправления ошибок:
- При использовании кода товара в качестве "Поля артикула" на OZON возникали ошибки при автоматическом сопоставлении товаров. Исправлено.
- CS-Cart Ultimate. Импорт товаров доступных для более чем одной витрины работал некорректно. Исправлено.
1.2.1 → 1.3.0 (2024-01-28)
Новый функционал:
- Расширена поддержка Ultimate версии: теперь доступна функция общего доступа к товарам и складам для различных витрин (т.н. "Шаринг").
Исправления ошибок:
- Некорректно работало обновление остатков на складах, если товары имели наличие более чем на одном складе. Исправлено.
1.2.0 → 1.2.1 (2022-12-01)
Исправления ошибок:
- На странице "Маркетинг -> Промо-акции и скидки -> MC: OZON интеграция: Промо-акции" отсутствовала языковая переменная. Исправлено.
- На странице "Модули -> Управление модулями -> MC: OZON интеграция -> вкладка "Настройки" -> подвкладка "Общие" отсутствовала ссылка на документацию модуля. Исправлено.
- В административной панели при переходе на удаленный заказ возникала PHP ошибка (вместо 404). Исправлено.
1.1.0.RC → 1.2.0 (2022-11-17)
Новые возможности и улучшения:
- Добавлено отображение сообщений о количестве обновленных товаров при запуске обновления цен и остатков через командную строку (по CRON).
- На странице "Заказы -> Все заказы" в окне "Расширенный поиск" добавлена возможность поиска по заказам синхронизированным с OZON.
- Добавлено читабельное отображение ряда ошибок при импорте отправлений (в случаях если: не найден товар или не удалось конвертировать цену).
- Добавлен функционал "Связать товары" для массового связывания товаров с магазина с товарами на маркетплейсе.
Изменения в существующей функциональности:
- На странице "Товары -> MC: OZON интеграция -> Синхронизация с маркетплейсом" изменен список команд CRON.
- При импорте необработанных FBS отправлений с Маркета значение цен для товаров будет равным значению цены на OZON (ранее значение цены было равно значению цены товара на сайте).
Исправления ошибок:
- На странице "Товары -> Товары -> Редактирование конкретного товара -> вкладка "MC: OZON интеграция" возникала JS ошибка при нажатии кнопки "Получить ID товара с Маркета" если товар не был найден. Исправлено.
1.0.0 → 1.1.0.RC (2022-10-17)
Новые возможности и улучшения:
- На странице редактирования товара добавлена информация о товаре получаемая с Маркетплейса (название, фото, цены).
- Добавлена отдельная привилегия для администраторов на удаление товаров с Маркетплейса (раньше функционал был доступен для администратора, который имел привилегии на редактирование информации модуля).
- Добавлена настройка модуля «Ценовая маржа, %». Настройка позволяет задать маржу цены, которую Вы хотите задать для товаров на Маркетплейсе.
- На странице «Товары -> *Редактирование товара* -> во вкладке «MC: OZON интеграция» добавлено поле товара «Цена (на Маркетплейсе)». Вы можете указать цену данного товара на Маркетплейсе. Она будет использована для синхронизации. Оставьте цену равной 0 чтоб её значение не учитывалось в момент синхронизации. Данная цена игнорирует значение маржи из настроек модуля.
- Добавлена настройка модуля «Склад по
умолчанию». Настройка используется для обновления остатков в случае если
на Маркетплейсе создано больше одного rFBS склада (используется когда
модуль «Склады» неактивен). Оставьте настройку пустой если Вы используете только один склад.
- Добавлена поддержка украинского языка.
Исправления ошибок:
- При синхронизации цен значения цен передавались некорректно, если основная валюта магазина не RUB. Исправлено.