Клиент для WooCommerce

Что делает

Плагин WordPress opotopo-seller-api выгружает каталог магазина WooCommerce на площадку: заводит и обновляет объявления по товарам, вариантам и остаткам, снимает товары, выпавшие из каталога, переносит заказы площадки в заказы магазина и исполняет их из админки заказа. Код писать не нужно.

Плагин построен на клиенте на PHP и открыт по лицензии MIT: код и выпуски — github.com/AdzerKI/seller-api-woocommerce.

Установка

1. Скачайте архив последнего выпуска.
2. В админке WordPress: «Плагины» → «Добавить новый плагин» → «Загрузить плагин», выберите архив и нажмите «Активировать».

WordPress не активирует плагин без WooCommerce и на версиях WordPress, WooCommerce и PHP ниже требований плагина.

Настройки

«WooCommerce» → «Настройки» → вкладка «ОПОТОПО»:

• «Ключ API» — ключ раздела «API» с разрешениями записи и снятия объявлений, загрузки файлов, чтения и исполнения заказов
• «ID организации» — организация продавца; без него товары заводятся от организации ключа, у личного ключа — от его владельца
• «Публикация» — без отметки новые товары остаются черновиками
• «Секрет подписи вебхука» — секрет адреса приёма заказов
• «Адрес площадки» — адрес API площадки

Каталог

На площадку уходят опубликованные простые и вариативные товары, кроме скрытых:

• артикул — SKU товара, без него — wc- и ID товара
• цена — действующая, у вариативного товара — наименьшая цена вариаций
• штрихкод — GTIN, бренд — бренд товара, характеристики — видимые атрибуты товара
• изображения — обложка и галерея
• вес и габариты — в единицах магазина, у вариативного товара — наибольшие среди вариаций
• количество — остаток товара либо сумма остатков вариаций; без учёта остатка — без количества
• варианты — вариации в наличии с ценой: название — значения атрибутов вариации, фото — изображение вариации, файлы — загружаемые файлы вариации; простой загружаемый товар — одним вариантом с его файлами

Категории

Категория магазина товара — путь его самой глубокой категории от корня. Категорию площадки для неё выбирают в карточке «Категории магазина» раздела «API»: пути появляются в карточке с первой синхронизацией, товар несопоставленной категории получает отказ с её путём, следующая синхронизация после выбора заводит его.

Синхронизация

• Изменение, удаление товара либо вариации и смена остатка ставят синхронизацию в очередь; полный прогон — раз в час; прогоны не накладываются
• Очередь исполняет WP-Cron; при отключённом WP-Cron нужен его запуск планировщиком сервера
• На вкладке «ОПОТОПО» — итог последней синхронизации, отказы товаров с подробностями и кнопка «Синхронизировать сейчас»; коды отказов — клиент на PHP

Заказы

1. Адрес приёма заказов показан под полем «Секрет подписи вебхука». В блоке «Webhooks» раздела «API» добавьте этот адрес с событиями «Новый заказ», «Отзыв покупки» и «Смена статуса заказа», его секрет подписи — в поле «Секрет подписи вебхука».
2. Покупка на площадке становится заказом WooCommerce, оплаченным площадкой, в статусе «Обработка» со списанием остатка: строки — товары магазина по объявлениям, доставка — строкой заказа, получатель, адрес и пункт — в адресе доставки и заметке заказа.

• Статус заказа площадки — в заметках заказа; получен покупателем — «Выполнен», отменён — «Отменён» с возвратом остатка
• Отзыв покупки — возврат WooCommerce на её сумму с возвратом остатка без платёжного шлюза

Исполнение заказа

Панель «ОПОТОПО» экрана заказа показывает статус и способ получения заказа площадки и действия, доступные по статусу; действие уходит сохранением заказа:

• «Передать в доставку» — своя доставка: служба, трек-номер и адрес отслеживания
• «Передать службе доставки» — пункт приёма либо «Курьер службы заберёт» и места весом и габаритами в единицах магазина; без мест каждая единица уходит отдельным местом с упаковкой товара
• «Готов к выдаче» — самовывоз
• «Отменить заказ на ОПОТОПО» — с причиной
• «Ярлык» и «Накладная» — документы отправления

Отказ площадки показывается ошибкой экрана заказа с её текстом.

Удаление

Удаление плагина в «Плагинах» снимает его таблицы, настройки и задачи; объявления на площадке остаются.