Skip to content

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 scheduled product 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. It supports simple and variable products, warehouse-level stock, forced sync, and manual product mapping. Sale-price sync is not supported.

Import Products creates simple and variable WooCommerce products from OneSoft's catalogue, assigns categories and attributes, and supports skip rules. Product-image import is not supported. On first run it drafts all products that don't yet exist in WooCommerce. 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

FeatureSupported
HPOSYes
Product SyncYes
Product MappingYes
Product ImportYes
Order SyncYes
WP-CLI Product SyncYes
WP-CLI Product ImportYes

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 cd /var/www/html && /usr/local/bin/wp onesoft sync

# Import new products once a day at midnight
0 0 * * * www-data cd /var/www/html && /usr/local/bin/wp onesoft create-wc-products