WooCommerce Remote Sync OneSoft

Documentation for the Plug and Pay WooCommerce Remote Sync OneSoft plugin.

Requirements

Technical Requirements

PHP: 8.1, 8.2, or 8.3
ionCube Loader: Required. For version requirements and installation details, check the IonCube Loader documentation.
WooCommerce: 3.5 or higher
WP-CLI: Recommended for background sync and product imports.

Store Setup Prerequisites

OneSoft API Credentials: API Host (Endpoint), API Username, and API Password provided by OneSoft.

Integrations

Sync Products periodically pulls product data (price, stock) from OneSoft into WooCommerce. Products must first be mapped manually in the admin before they are synced.

Import Products creates new WooCommerce products from OneSoft's catalogue. On first run it drafts all products that don't yet exist in WooCommerce, optionally fetching attributes per product. Products imported this way are automatically registered in the sync table, so there is no need to map them manually.

Order Sync pushes WooCommerce orders to OneSoft. It identifies customers via their personal ID and maps order items including shipping costs.

Technical Specification & Feature Support

Feature	Supported
HPOS	✅
Sync Products	✅
--Simple & variable products	✅
--Stock sync	✅
--Stock in warehouse sync	✅
--Price sync	✅
--Sale price sync	✅
--Force sync	✅
--Product mapping table	✅
Import Products	✅
--Simple products	✅
--Variable products	✅
--Categories	✅
--Attributes	✅
--Images	❌
--Skips configuration	✅
Order Sync	✅
--Customer sync	✅
--Personal ID checkout field	✅
--Shipping line item	✅

WP-CLI Commands

Sync Products

# Pull latest price and stock from OneSoft into WooCommerce
wp onesoft sync

# Download the remote product list into the local mapping table
wp onesoft download-list

Import Products

# Create WooCommerce products for all remote products not yet imported
wp onesoft create-wc-products

Cron Scheduling

Product sync is lightweight and can run frequently. Import is slower (especially with attributes enabled) and should run rarely. A typical setup runs sync every 15 minutes and import once at midnight:

# /etc/cron.d/remote-sync-onesoft

# Sync price & stock every 15 minutes
*/15 * * * * www-data wp --path=/var/www/html onesoft sync

# Import new products once a day at midnight
0 0 * * * www-data wp --path=/var/www/html onesoft create-wc-products