Что такое команды cron
Всю периодическую работу плагина — публикацию товаров, обновление цен и остатков, получение заказов — выполняют команды планировщика заданий (cron). Расписание плагин себе не ставит: без записи в cron автоматическая работа не начнётся. Готовые строки запуска и полный перечень команд показывает вкладка «Команды cron» экрана настроек плагина (Магазин → Плагины → Ozon: Цифровые товары).
Общий вид строки запуска
Для обычного хостинга команда имеет вид:
[путь к интерпретатору php] /путь-к-установке/cli.php shop ozondigitalPlugin -task КОМАНДА [параметры]
В Облаке Webasyst в приложение «Облако» добавляется команда для приложения Shop-Script вида:
ozondigitalPlugin -task КОМАНДА [параметры]
Путь к интерпретатору PHP и порядок создания заданий cron уточняйте у своего хостинг-провайдера.
Перечень команд
| Команда | Назначение | Рекомендуемая частота |
|---|---|---|
export | «Публикация цифровых товаров»: отправляет в Ozon очередь публикации, новые товары настроенных категорий и (при настройке «Выгружать артикулы товара» = «Все артикулы») новые артикулы опубликованных товаров | не чаще 1 раза в 10 минут |
update | «Актуализация цен и/или остатков»: обновляет цены и остатки связанных артикулов, а в начале прогона проверяет состояние принятых Ozon заданий публикации | не чаще 1 раза в час |
orders | «Получение заказов и передача кодов»: создаёт и обновляет заказы по отправлениям Ozon, при включённой автопередаче выдаёт и передаёт коды | не чаще 1 раза в 10 минут |
service | «Служебная задача»: обновляет справочник категорий Ozon и словари характеристик | 1 раз в сутки |
upgrade | «Обновление данных плагина»: переотправляет в Ozon карточки связанных товаров, у которых изменились описание или характеристики | 1 раз в сутки |
Параметры команд
Общий параметр команд export, update, orders и upgrade:
-account X— где X — id аккаунта Ozon (номер виден в форме аккаунта в настройках). Если параметр не указан, будут обработаны все доступные аккаунты Ozon.
Команда update дополнительно принимает параметр -mode price|quantity: price — обновлять только цены, quantity — только остатки; без параметра обновляется и то и другое. Команда export принимает -mode sku|product|category: product — очередь ручной публикации, sku — новые артикулы опубликованных товаров, category — товары настроенных категорий; без параметра обрабатываются все три источника.
Примеры строк запуска
shop ozondigitalPlugin -task export— публикация товаров для всех доступных аккаунтов Ozon;shop ozondigitalPlugin -task update— обновление цен и остатков всех доступных аккаунтов Ozon;shop ozondigitalPlugin -task update -account 2 -mode price— обновление только цен аккаунта Ozon с id 2;shop ozondigitalPlugin -task update -mode quantity— обновление только остатков всех аккаунтов Ozon;shop ozondigitalPlugin -task orders— синхронизация заказов для всех доступных аккаунтов Ozon;shop ozondigitalPlugin -task orders -account 3— синхронизация заказов для аккаунта Ozon с id 3;shop ozondigitalPlugin -task service— выполнение служебных операций;shop ozondigitalPlugin -task upgrade— обновление данных для всех доступных аккаунтов Ozon.
Рекомендуемое расписание
Минимальный набор — четыре записи: export и orders каждые 10 минут, update раз в час, service и upgrade раз в сутки (в ночные часы).
Что учесть
- Без действующей лицензии команда не выполняется: в консоль и журнал плагина пишется «Нет действующей лицензии плагина Ozon: Цифровые товары. Команда прервана.»
- Команды обрабатывают только включённые аккаунты Ozon; если включённых аккаунтов нет, в журнал пишется «Нет включённых аккаунтов Ozon».
- Итог каждого прогона (сколько обработано, отправлено, какие ошибки) записывается в журнал плагина; ошибки — в отдельный журнал ошибок.
- Команда
upgradeпропускает аккаунты, у которых обновление описаний запрещено системной настройкой.
