Guide · WooCommerce
Connect WooCommerce to WooliiPorter, link stocked SKUs and record supplier parcels. Select an available logistics product or save a channel default. Store orders, warehouse work, packed quotes and tracking stay connected, so your team can follow each shipment from receipt to dispatch and settlement.
WooliiPorter combines China logistics service with technology that connects your store and warehouse. Your chosen suppliers, stocked SKUs and shipment decisions remain part of one operating workflow, with order and status sync supporting daily fulfillment work.
The backend uses live warehouse inventory to prepare each order line. Logistics product selection is a separate, clear choice based on available destination services.
| What the line looks like | Fulfillment action | What you see on the order |
|---|---|---|
| Mapped SKU with enough warehouse stock | Stocked fulfillment | Stock is reserved and a warehouse fulfillment order is created. |
| Mapped SKU with insufficient stock | Supplier forwarding | Record domestic tracking with quantities allocated to the products your supplier sends. |
| Unmapped product or Always forward | Supplier forwarding | Prepare the supplier parcel details and complete any product-link action shown. |
| Stocked and unstocked lines in one order | Recorded merchant choice | Choose whole-order forwarding, waiting for stock, or another inventory check. |
| A line awaiting its warehouse SKU | Product-link action | The order shows the mapping action needed to prepare fulfillment. |
| A service, digital item or deposit | Excluded from physical fulfillment | Eligible physical goods continue through the fulfillment workflow. |
| Product, destination or declaration needs attention | Preparation action | The order shows the information or configured product needed to proceed. |
| Wallet needs funding | Funding action | Top up the wallet to prepare the new warehouse work. |
Create a merchant account and run Test and connect with a sandbox key. Use merchant bundle 0.9.0 for the latest product-selection workflow.
Map products or variations to warehouse SKUs. Select a logistics product for the destination or save a WooCommerce channel default in the merchant workspace.
Warehouse stock checks prepare stocked lines and supplier-forwarded lines. A mixed order presents a recorded choice for your team.
For forwarding lines, send supplier parcels to your assigned warehouse and enter domestic tracking numbers with per-product quantities.
Warehouse scans, photos, measured parcels and operation records connect receiving and packing to the order.
Review the measured quote and applicable fees, then pay it manually or let authorised wallet autopay settle it before dispatch. After handover, WooliiPorter tracking updates return to the store order.
Install the stable plugin from the WordPress.org plugin directory at version 0.9.0, or download merchant upgrade bundle 0.9.0 from the merchant console for the latest product-selection alignment. The Shopify app is listed on the Shopify App Store.
Review the key environment, connection checks and submission settings as part of your first-order setup.
| Setting | What it does |
|---|---|
| API key & environment | Use wp_sk_test_… for sandbox and wp_sk_live_… for production. Test and connect verifies the real key environment and refuses a mismatch. |
| API base | Production is pinned to https://api.woolii.com/v1/merchant. Developer mode accepts only exact local hosts or code-allowlisted HTTPS origins, preventing credential exfiltration. |
| Order processing | The compatibility smartRouting setting enables fulfillment intents after features.smartRouting=true and Store registration. The shipping product is an explicit selection. |
| Automatic submission | Off by default. Can be enabled only after connection, environment, scope, Store, webhook-secret and Action Scheduler checks all pass. |
| Shipping product | Select productCode or save a store/account default. Each product has a fixed provider per country. Orders retain their selected product and public name snapshot. |
| Webhook signing secret | Required in every environment. The receiver verifies HMAC, Store identity, intent identity (when known), timestamp and eventId deduplication before writing order state. |
Use a staging store and sandbox key to check each step before enabling production submission.
| Claim | How to check it |
|---|---|
| Choose the correct plugin package | WordPress.org provides stable version 0.9.0; merchant bundle 0.9.0 is downloaded from the merchant console and includes the latest logistics product-selection alignment. |
| Confirm the connection | Run Test and connect on a staging store and review the account, key environment, scopes, store registration and scheduler checks. |
| Select the logistics product | Choose an available product for the destination or save a WooCommerce channel default in the merchant workspace. |
| Review a mixed order | Create an order with stocked and unstocked lines and check the recorded fulfillment choice. |
| Review the shipment record | Follow warehouse work, packed quote, tracking and applicable fee items against the same order reference. |
You choose suppliers and manage purchasing. WooliiPorter receives their parcels at your assigned China warehouse and links receipt, packing, shipment charges and tracking to the store order.
Supplier forwarding supports goods bought per order; stocked fulfillment uses selected merchant-owned SKUs held in the warehouse. Both are managed from the same account.
Your team chooses whole-order forwarding, waiting for stock, or a fresh inventory check. The choice stays attached to the order history.
Select an available logistics product for the destination or save a channel default. The product and country identify the configured service, with cargo and parcel restrictions checked before fulfillment.
After packing and measurement, the product price produces a packed quote. Freight and applicable fees are shown for review before dispatch and remain linked to the shipment.
Enable automatic submission after the connection checks. Eligible orders reaching processing submit through Action Scheduler in the background; signed webhooks return fulfillment updates to the order.
Download merchant bundle 0.9.0 from the merchant console for the latest logistics product-selection alignment. WordPress.org provides stable version 0.9.0.