Сайт на WooCommerce

Якщо ваш сайт працює на WordPress з WooCommerce, підключіть його до Рекс.Селлер — і кожне замовлення з сайту з’явиться в «Продажах» за кілька секунд: з покупцем, доставкою, вартістю доставки й товарами. Коли ви відправляєте замовлення, статус і номер ТТН повертаються на сайт.

Що потрібно

• WooCommerce з увімкненим REST API (є в усіх сучасних версіях).
• Сайт має працювати по HTTPS.
• Права адміністратора в WordPress, щоб створити ключ.

Крок 1. Ключ REST API у WooCommerce

1. В адмінці WordPress відкрийте WooCommerce → Налаштування → Додатково → REST API і натисніть «Додати ключ».
2. Опис — напр. «Рекс.Селлер», користувач — адміністратор, права — Read/Write (читання й запис: запис потрібен, щоб передавати статуси й ТТН).
3. Натисніть «Згенерувати ключ API» і скопіюйте Consumer key (ck_…) і Consumer secret (cs_…). Secret показується лише раз.

Крок 2. Підключення в Рекс.Селлер

1. Налаштування → «Інтеграції» → «Інтернет-магазини» → WooCommerce → «Підключити».
2. «Назва» і «Магазин» — у який магазин компанії потраплятимуть замовлення сайту.
3. «Адреса сайту» — напр. https://shop.ua, «Consumer key», «Consumer secret».
4. Перевірте налаштування (див. нижче), натисніть «Перевірити» і «Підключити».

Порада

Якщо перевірка не проходить, хоча ключі правильні, хостинг може відкидати заголовок авторизації. Увімкніть «Ключі в query string (якщо сервер відкидає Authorization)» і перевірте ще раз.

Крок 3. Вебхук — щоб замовлення приходили миттєво

Без вебхука Рекс.Селлер перевіряє нові замовлення кожні кілька хвилин. З вебхуком — одразу.

1. Відкрийте підключену інтеграцію → вкладка «Підключення» → блок «Вебхук» і скопіюйте «URL вебхука».
2. У WordPress: WooCommerce → Налаштування → Додатково → Вебхуки → «Додати вебхук».
3. Тема — «Замовлення створено», адреса доставки — скопійований URL, статус — «Активний». Поле «Секрет» можна лишити як є. Збережіть.
4. Додайте другий вебхук з темою «Замовлення оновлено» і тим самим URL — так у Рекс.Селлер прийдуть і зміни статусу на сайті.

Після цього на вкладці «Огляд» видно «Миттєво через вебхуки + перевірка кожні 5 хвилин» — опитування лишається як запасний шлях.

Налаштування

Загальні перемикачі — як у маркетплейсів (детальніше): «Імпортувати замовлення», «Передавати статуси й ТТН» (за замовчуванням вимкнено), «Автоматично приймати нові замовлення», «Створювати відсутні товари автоматично», «Перший імпорт: днів назад», «Інтервал опитування, хв».

Особливі для WooCommerce:

• «Статус Woo «completed» означає» — «Виконано» чи «Відправлено»: як розуміти статус completed на вашому сайті.
• «Додавати нотатку з ТТН покупцю» — коли замовлення відправлено, на сайті з’являється нотатка з номером ТТН.
• «Секрет вебхуків» — необов’язково; якщо порожньо, використовується згенерований секрет.

Статуси

«Наші статуси → майданчик»: що відправляти на сайт — processing, completed, cancelled… Статус «Відправлене» також додає нотатку з ТТН. «Статуси майданчика → наші»: як розуміти статуси сайту; «Ігнорувати» — не імпортувати такі замовлення (напр. pending — неоплачені, якщо не хочете їх бачити).

Важливо

«Автоматично приймати нові замовлення» для WooCommerce працює, лише якщо в «Наші статуси → майданчик» зіставлено статус нового замовлення (напр. «Не оброблене» → processing). Інакше Рекс не знає, яким статусом підтверджувати.

Що приходить із замовленням

• Покупець — ім’я, телефон, e-mail. Якщо телефону немає, клієнта знайдуть за e-mail, а телефон допишеться з наступного замовлення.
• Доставка — спосіб, місто й адреса; вартість доставки з сайту стає доставкою в замовленні.
• Товари — зіставляються з каталогом за зв’язками, артикулом і назвою. Опції в назві рядка (розмір, колір, вага) зіставляються з потрібним варіантом чи фасуванням.
• Номер на сайті — видно як зовнішній номер замовлення.

Рядок, який не знайдено в каталозі, позначений «Не з каталогу». «Знайти в каталозі» → оберіть товар, варіант чи фасування → «Замінити» — і Рекс.Селлер запам’ятає це для наступних замовлень. Або увімкніть «Створювати відсутні товари автоматично».

Товари сайту → каталог

На вкладці «Огляд» натисніть «Завантажити товари з сайту». Далі:

• «Імпортувати в каталог» — створить товари з назвою, артикулом, ціною, фото (до 5) й посиланням на товар на сайті, без дублів;
• «Зв’язати вручну» — якщо товари вже є в каталозі.

Детальніше — у Маркетплейси → Картка інтеграції.

Часті питання

Перевірка пише, що ключ не підходить. Переконайтеся, що адреса сайту з https://, ключ має права Read/Write, а плагіни безпеки не блокують /wp-json/wc/v3. Спробуйте «Ключі в query string».

Замовлення приходять із затримкою в кілька хвилин. Вебхук не налаштовано або вимкнено. Перевірте його статус у WooCommerce → Вебхуки і подивіться «Журнал» інтеграції.

Залишки на сайті не оновлюються. Передача залишків і цін на сайти зараз призупинена — Рекс.Селлер синхронізує замовлення, статуси й ТТН.