Как подключить WooCommerce к порталу: кнопка, заказы, остаткиБета

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

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

1. Что умеет интеграция

Живой магазин по этой инструкции ещё проверяется: интеграция сделана по официальной спецификации WooCommerce REST API.

2. Что нужно заранее

• Магазин на WooCommerce с адресом на HTTPS. Адрес с http:// и закрытые адреса (внутренняя сеть, localhost) портал не принимает.
• Включённые «красивые» постоянные ссылки: без них REST API магазина недоступен.
• Права администратора магазина: именно он создаёт ключи.
• Тариф Web Plus: раздел «Маркетплейсы» доступен на нём (сейчас в бете).
• Право «Подключения к площадкам» у вашей роли в мастерской.
• Артикулы (SKU) у товаров и вариаций: по ним портал связывает позиции заказа с изделиями склада.

3. Подключение кнопкой

1. Откройте раздел «Маркетплейсы» → «Подключения» и нажмите «Подключить» у WooCommerce.
2. Введите адрес магазина, например https://shop.example.com.
3. Проверьте страну, валюту и часовой пояс магазина. Часть значений портал подставит сам после подключения, остальное можно поправить в настройках подключения.
4. Нажмите «Подключить магазин». Откроется сайт магазина со страницей подтверждения доступа WooCommerce: нажмите «Подтвердить».
5. Магазин вернёт вас в портал, появится сообщение «Магазин подключён». Ключи создались в магазине, портал их сохранил в зашифрованном виде.

Ссылка подтверждения одноразовая и действует 15 минут. Если не успели, начните заново.

Подключение вручную

Нужно, если страница подтверждения у магазина недоступна (например, её закрывает защита сайта).

1. В магазине: WooCommerce → Настройки → Дополнительно → REST API → «Добавить ключ».
2. Укажите описание («Портал»), пользователя-администратора и права «Чтение/запись». Нажмите «Сгенерировать».
3. Скопируйте Consumer key и Consumer secret: Consumer secret показывается один раз.
4. В портале в форме подключения нажмите «Ввести ключи вручную» и вставьте адрес и оба ключа.

Ключ сохранится только после успешной проверки связи с магазином.

4. Настройки подключения

• Запросы через сервер в Финляндии. Включите, если магазин закрыт для российских адресов или не отвечает порталу напрямую. Запросы пойдут через наш прокси-сервер. Если у магазина белый список адресов, адрес прокси выдаёт поддержка.
• Ключи в адресе запроса. Включите, если хостинг режет заголовок Authorization и портал получает ошибку 401 при верных ключах. Ключи уйдут параметрами адреса: только по HTTPS.
• Страна, валюта и часовой пояс. По умолчанию берутся из магазина. Валюта влияет на то, как подписаны суммы заказов. Смена валюты не пересчитывает уже загруженные заказы.
• Запись на площадку. «Остатки», «Цены», «Действия с заказами»: каждый переключатель включает отдельный вид записи в магазин.

5. Заказы

• Валюта. Сумма заказа хранится в валюте магазина. В карточку заказа, склад и финансы она переходит в валюте вашей мастерской по курсу, который фиксируется один раз, когда заказ впервые появился в портале.
• Склад. Если позиция связана с изделием склада и его хватает, заказ встаёт в «Сборку заказа», остаток списывается один раз. При отмене остаток возвращается один раз. Возврат после выполнения склад не двигает: решайте, вернулся ли товар, вручную.
• Вариации. Остатки ведутся по каждой вариации отдельно, по её артикулу.
• Обновления. Новые заказы и изменения приходят уведомлениями магазина за секунды. Портал дополнительно опрашивает магазин по расписанию, поэтому потерянное уведомление ничего не ломает.

Передача статуса и трек-номера: на странице заказа кнопка «Собрать» ставит заказ в магазине в статус «Выполнен» и добавляет покупателю примечание с трек-номером. Работает при включённом переключателе «Действия с заказами». Результат виден в «Журнале».

6. Остатки и цены

• Остаток уходит в магазин по событию: после продажи, списания или правки количества изделия. Вариации обновляются отдельно. Для товара включается учёт остатков в магазине.
• Если остаток не определён (товар не связан со складом), портал не трогает остаток в магазине: ноль по ошибке не уйдёт.
• Цена уходит в поле «Базовая цена». Цена ниже себестоимости не выгружается.

7. Ограничения

• Нужен HTTPS и работающий REST API магазина.
• Этикеток и покупки доставки в этой версии нет.
• Живой магазин на этой интеграции пока проверяется.
• Если магазин за Cloudflare или другой защитой от ботов, разрешите запросы с адреса портала или включите «через сервер в Финляндии».

8. Частые ошибки

9. Безопасность

• Consumer key и Consumer secret хранятся в зашифрованном виде и не показываются после сохранения.
• Уведомления магазина подписаны: портал принимает только те, что подписаны секретом вашего подключения.
• Запись в магазин включается отдельно: по умолчанию портал только читает.
• Подключение можно поставить на паузу или отключить; ключ можно отозвать в магазине.
• Права: «Заказы площадок», «Товары на площадках», «Финансы площадок».

10. Изменения

• 26.10.2026 — первая версия инструкции.