✅ Goal

This guide explains how to use the Powersoft Sync plugin inside the WordPress dashboard and what each option means.

The plugin connects your WooCommerce eShop with Powersoft365 ERP, allowing you to synchronize important data such as:

🟢 Categories
🟢 Attributes
🟢 Items (products)
🟢 Stock
🟢 Images

📌 Where to find the plugin

In your WordPress dashboard menu, go to:

✅ Powersoft Sync

This page is the main control panel for syncing your eShop with Powersoft365.

Sync Console explained

The Sync Console is where you run manual synchronizations between the eShop and Powersoft365.

You will see a table with the following:

• Type

• Pending

• Action

✅ What “Pending” means

The “Pending” number shows how many items are waiting to be processed by the sync queue.

Example:
If it shows Items: 3 pending, it means there are 3 items waiting to be synced.

1) Categories

✅ What it does

Syncs product categories from Powersoft365 to WooCommerce.

Button: “Sync Categories”

🟢 Imports or updates categories in WooCommerce based on Powersoft365 data.

Use this when:
✅ You added new categories in Powersoft365
✅ You want to refresh category structure in the eShop

2) Attributes

✅ What it does

Syncs product attributes from Powersoft365 into WooCommerce attributes.

Examples of attributes:

• Color

• Size

• Brand

• Material

Button: “Sync Attributes”

🟢 Imports or updates attributes that will be used for product filtering and variations.

Use this when:
✅ You added new attributes in Powersoft365
✅ Filters are missing from the eShop
✅ You want to update attribute values

3) Items

✅ What it does

Syncs products (items) from Powersoft365 into WooCommerce.

This is the main “Product Sync”.

Button: “Sync Items”

🟢 Imports or updates product data (name, descriptions, categories, pricing fields based on your settings).

Use this when:
✅ You created new items in Powersoft365
✅ Your eShop product list needs to update
✅ You changed product information in Powersoft365

Button: “Remove Items”

🔴 Removes the synced items from WooCommerce.

Use this carefully when:
⚠️ You want to clean up WooCommerce products that were imported from Powersoft
⚠️ You are rebuilding the catalog from scratch

4) Stock

✅ What it does

Syncs product stock quantities from Powersoft365 into WooCommerce.

Button: “Sync Stock”

🟢 Updates stock availability for products in the eShop.

Use this when:
✅ You need the latest stock values
✅ You want to avoid overselling
✅ You updated inventory in Powersoft and need WooCommerce to match

5) Sync Images

✅ What it does

Syncs product images from Powersoft365 into WooCommerce product images.

Button: “Sync Images”

🟢 Downloads and assigns product images automatically.

Use this when:
✅ New items were added and images are missing
✅ Images were updated in Powersoft365
✅ The eShop needs image refresh

6) Remove Images

✅ What it does

Removes images that were synced into WooCommerce using the plugin.

Button: “Remove Images”

🔴 Deletes the synced images.

Use this when:
⚠️ You want to clean the media library
⚠️ You are re-syncing a new set of images
⚠️ You imported wrong images and need reset

Current Settings table explained (Field mapping)

The Current Settings section shows how the eShop is connected to Powersoft365.

This section is very important because it controls:

✅ Where the plugin reads product name, descriptions, and prices
✅ Which Powersoft365 price level is used as WooCommerce price
✅ Which store stock is synced
✅ Which product fields are used for extra information (video, PDF, etc.)

✅ Settings explained

Read type

Value: Categories

This shows the current sync mode or configuration source used for category handling.

Category name key

Value: name

This means WooCommerce category names are created using the Powersoft365 field:
✅ name

Regular price key

Value: 1 (price_incl_1)

This means the WooCommerce Regular Price is taken from:
✅ price_incl_1 (Price Level 1 in Powersoft365)

Example:
If price_incl_1 = 100.00
Then WooCommerce regular price will be 100.00

Sale price key

Value: 3 (price_incl_3)

This means the WooCommerce Sale Price is taken from:
✅ price_incl_3 (Price Level 3 in Powersoft365)

Example:
If price_incl_3 = 85.00
Then WooCommerce sale price will be 85.00

Additional categories

Value: -

This means additional category mapping is not enabled or not assigned.

Item name key

Value: name (item_name)

This means the WooCommerce Product Title is taken from:
✅ item_name (Powersoft365 item name field)

Short description key

Value: specifications

This means WooCommerce Short Description is taken from:
✅ specifications

This is usually used for:
✅ Technical specs
✅ Product features
✅ Quick bullet style info

Long description key

Value: notes

This means WooCommerce Description (main product description) is taken from:
✅ notes

This is usually used for:
✅ Full product description
✅ Extra information
✅ Notes from ERP

Video field

Value: 3 (text_field_3_value)

This means the product video field is connected to:
✅ text_field_3_value (custom text field number 3 inside Powersoft365)

This can be used for:
✅ YouTube link
✅ Video URL
✅ Product video embed link

PDF field

Value: -

This means no PDF field mapping is currently enabled.

If enabled later, it can be used for:
✅ Product manuals
✅ Technical documents
✅ Certificates

Stock stores

Value: all

This means stock is synced from:
✅ all available stores in Powersoft365

If this is changed, stock can be synced from a specific store only.

Shipping item code

Value: SHIPPING

This is the Powersoft365 item code used for shipping charges when sending orders from WooCommerce to Powersoft365.

Example:
When a customer places an order, the shipping line is sent to Powersoft365 using the item code:
✅ SHIPPING

✅ Best practice workflow (recommended order)

If this is a fresh setup or major update, run the sync in this order:

1. Sync Categories

2. Sync Attributes

3. Sync Items

4. Sync Stock

5. Sync Images

Need help?

If the sync fails or data looks incorrect, OS3 Support can help.
Please provide:

✅ Screenshot of the Powersoft Sync page
✅ What button you clicked
✅ What you expected to happen
✅ Any error message shown