WooCommerce
List Integration Instances
List all WooCommerce integration instances.
Create Integration Instance
Create a new WooCommerce integration instance.
Show Integration Instance
Show a single WooCommerce integration instance with loaded integration and store relations.
Update Integration Instance
Update a WooCommerce integration instance.
Delete Integration Instance
Delete a WooCommerce integration instance. This dispatches a background job to clean up all associated data.
Update WooCommerce Integration
Update the settings of a WooCommerce integration instance. All fields are optional - only the fields you send are changed, and `integration_settings` is deep-merged with the existing settings on PATCH.
Get Authorization URL
Get the WooCommerce OAuth authorization URL for a given integration instance.
List Products
List WooCommerce products (one row per sellable unit — parent products and variations unified) for an integration instance.
Show Product
Get a single WooCommerce product.
Update Product
Update a WooCommerce product record.
Delete Product
Delete a single WooCommerce product record from SKU.io.
Create SKU Products from WooCommerce
Queue a job to create SKU.io products from the selected WooCommerce products.
Refresh Products
Queue a background job to refresh all WooCommerce products from the store API.
Refresh Products (Tracked)
Dispatch a tracked background job to re-fetch products from WooCommerce.
Map Products
Map WooCommerce products to SKU.io products.
Smart Match Product
Find suggested SKU product matches for a single WooCommerce listing.
Get Raw Product from WooCommerce
Fetch the raw WooCommerce REST API response for a single product, live from /wp-json/wc/v3/products/{id}. Powers the 'Load Raw Data from WooCommerce' button on the listing detail page.
Create SKU Product from WooCommerce Product
Create a new SKU product from a WooCommerce listing's data and map it. If a SKU product with the same SKU already exists, the existing one is linked instead of creating a duplicate (response includes linked_existing=true).
Export Products
Export WooCommerce products as a file download (CSV or Excel).
Archive Products
Archive WooCommerce products (hide from active list without deleting).
Unarchive Products
Unarchive previously archived WooCommerce products.
Check Archiveable Products
Check which products from the provided list can be archived.
Delete Products
Permanently delete WooCommerce products from SKU.io (does not delete from WooCommerce).
Check Deleteable Products
Check which products from the provided list can be deleted.
Import Product Mappings
Queue a background job to import product field mappings for this integration instance.
Sync Inventory to WooCommerce
Push current SKU.io inventory quantities to WooCommerce for selected products.
List Orders
List WooCommerce orders for an integration instance.
Show Order
Get a single WooCommerce order with order items loaded.
Update Order
Update a WooCommerce order record.
Delete Order
Delete a WooCommerce order record from SKU.io.
Create SKU Orders from WooCommerce
Create SKU.io sales orders from selected WooCommerce orders.
Update SKU Orders from WooCommerce
Update SKU.io sales orders from WooCommerce order data.
Refresh Orders
Queue a background job to refresh all orders from the WooCommerce API.
Refresh Single Order
Refresh a single WooCommerce order by its unique WooCommerce order ID.
Export Orders
Export WooCommerce orders as a file download.
Fulfill Orders
Submit fulfillments to WooCommerce for the specified orders.
Get Integration Activity Log
Get the paginated activity history recorded against the orders synced for a WooCommerce integration instance - status changes, sync events, and edits, with the user who caused each change.
Get Cached Reports
Get the most recently cached WooCommerce reports for a specific integration instance.
Refresh Reports
Dispatch a background job to re-fetch WooCommerce reports for the integration instance.
List WooCommerce Refunds
Get a paginated list of WooCommerce order refunds for a specific integration instance.
Refresh WooCommerce Refunds
Dispatch a tracked background job to re-fetch all order refunds from WooCommerce.
Refresh Orders from WooCommerce
Start a background refresh that downloads orders from WooCommerce into SKU.io.
Get Latest Order Sync Info
Get a summary of the most recently synced WooCommerce order plus counts of how many local WooCommerce orders exist and how many are linked to SKU.io sales orders. Useful for deciding whether a refresh is needed.
Bulk Archive Orders
Archive multiple WooCommerce orders by their local IDs. Orders that are already archived are skipped.
Bulk Unarchive Orders
Restore multiple archived WooCommerce orders by their local IDs. Orders that are already active are skipped.
Archive Order
Archive a single WooCommerce order. Archived orders are hidden from active listings but remain stored and can be restored later.
Unarchive Order
Restore a single archived WooCommerce order to the active list.
Get Order Activity Log
Get the paginated activity history for a single WooCommerce order - status changes, sync events, and edits, with the user who caused each change.
Get Order Notes
Fetch the notes for a single order live from the WooCommerce store - both system status notes and customer-facing notes. The response is the raw WooCommerce order notes payload.
Get Raw Order
Fetch the raw order payload for a single order directly from the WooCommerce REST API (live request, not the locally cached copy).
Delete Linked SKU.io Order
Delete the SKU.io sales order linked to a WooCommerce order, keeping the WooCommerce order record intact. Pass `archive_order=true` to also archive the WooCommerce order afterwards.
Bulk Delete Linked SKU.io Orders
Delete the SKU.io sales orders linked to the given WooCommerce orders, keeping the WooCommerce order records intact. Set `archive_orders` to true to also archive the WooCommerce orders after their linked sales orders are removed.
Bulk Delete Orders
Permanently delete multiple local WooCommerce order records by their local IDs. This removes the local copies only - orders in the WooCommerce store are not affected. Linked SKU.io sales orders are not deleted.
List Pre-Start-Date Orders
Query the WooCommerce store live for orders created before your SKU.io inventory start date, so historical orders can be selectively imported without affecting inventory.
Search Pre-Start-Date Orders
Search the WooCommerce store for specific pre-start-date orders by order number, order ID, or customer email. Returns the same response format as the list endpoint, including eligibility and already-imported flags.
Import Pre-Start-Date Orders
Import selected pre-start-date orders from WooCommerce by their WooCommerce order IDs. Full order data is downloaded and stored flagged as a pre-start-date import so it does not affect inventory. Orders that already exist locally are marked instead of duplicated, and cancelled orders are skipped.
Search WooCommerce Products
Search products on the remote WooCommerce store. Used by the Refresh modal's Search Specific Product tab to locate a product and offer a one-click download.
Refresh Single Product
Fetch a single product (and its variations) from WooCommerce and persist it locally. Used by the Refresh modal's Search Specific Product tab download button.
Get WooCommerce Products Latest Sync Info
Return summary information about the locally-cached WooCommerce products for a single integration instance.
Map Product
Map a WooCommerce product to an existing SKU.io product by creating (or updating) its product listing.
Unmap Product
Remove the mapping between a WooCommerce product and its SKU.io product by deleting the product listing. The WooCommerce product and the SKU.io product both remain.
List Orders for Product
Get a paginated list of WooCommerce orders that contain a given product, newest first.
Get Field Mappings
Get the product field mappings for a WooCommerce integration instance - which WooCommerce product fields populate which SKU.io product fields when products are created or updated from listings.
Update Field Mappings
Replace the custom product field mappings for a WooCommerce integration instance. Each mapping pairs a WooCommerce `listing_field` with a SKU.io `sku_field`, with optional `parsers` applied to transform the value. Custom mappings override the defaults for the same field.
List WooCommerce Customers
Get a paginated list of WooCommerce customers for a specific integration instance.
Sync WooCommerce Customers
Sync customers from WooCommerce for the integration instance.
List Fulfillments
Get a paginated list of fulfilled shipments for sales orders that originated from this WooCommerce store. Each item shows whether it has been submitted to WooCommerce (`sync_status` of submitted or pending).
List Pending Fulfillments
Get a paginated list of fulfilled shipments that have not yet been submitted to WooCommerce. Pickup fulfillments and fulfillments on cancelled orders are excluded.
Get Fulfillment Stats
Get the count of fulfillments waiting to be submitted to WooCommerce, plus the automatic sync schedule. Pending fulfillments are submitted automatically every 10 minutes.
Submit Fulfillment
Submit a single fulfillment to WooCommerce, recording the shipment and its tracking details on the WooCommerce order and marking the order completed according to the store's settings.
Bulk Submit Fulfillments
Submit multiple fulfillments to WooCommerce by their IDs. The response reports how many were submitted and how many failed, with per-fulfillment error details.
Submit All Pending Fulfillments
Submit every pending fulfillment for the integration instance to WooCommerce in one call. The response reports how many were submitted and how many failed, with per-fulfillment error details.
List Inventory Comparison
Get a paginated side-by-side comparison of SKU.io quantities vs WooCommerce quantities, one row per mapped product listing. Each row includes the variance and a status of synced, variance, or needs_recalc.
Get Inventory Summary
Get aggregate inventory sync statistics for the integration instance: total product rows, how many are in sync, how many have a variance, how many need recalculation, and the timestamps of the last fetch from WooCommerce and last sync to WooCommerce.
List Inventory Locations
Get the inventory locations for the integration instance. WooCommerce has no native location concept, so a single synthetic 'WooCommerce Store' location is returned whose ID equals the integration instance ID. It is always active.
Recache Inventory Quantities
Start a background job that recalculates SKU.io inventory quantities for every product listing mapped to this WooCommerce store. Run this when the comparison shows rows needing recalculation.
Get Recache Progress
Poll the progress of an inventory recache job using the `tracked_job_log_id` returned when the job was queued. The response includes the job status, item counts, and completion percentage.
Sync Inventory to WooCommerce
Start a background job that pushes SKU.io inventory quantities to the WooCommerce store, updating stock levels on the mapped products.
Get Inventory Sync Progress
Poll the progress of an inventory sync job using the `tracked_job_log_id` returned when the job was queued. The response includes the job status, item counts, and completion percentage.
Fetch Live Inventory
Start a background job that downloads the current stock quantities from the WooCommerce store into the local comparison cache, so the comparison reflects the latest store-side values.
Get Live Inventory Fetch Progress
Poll the progress of a live inventory fetch job using the `tracked_job_log_id` returned when the job was queued. The response includes the job status, item counts, and completion percentage.
Get Webhook Configurations
Get all webhook configurations for the integration instance.
Enable Webhook
Enable a webhook for a specific WooCommerce topic. The webhook is registered on the WooCommerce store so the store notifies SKU.io when the topic fires. Enabling a webhook never deletes or resets existing synced data.
Disable Webhook
Disable a webhook for a specific WooCommerce topic. The webhook is deleted from the WooCommerce store, so the store stops notifying SKU.io for that topic. Previously synced data is unaffected.
Order Created Webhook
Inbound webhook endpoint called by WooCommerce when a new order is created.
Order Updated Webhook
Inbound webhook endpoint called by WooCommerce when an order is updated.
Order Deleted Webhook
Inbound webhook endpoint called by WooCommerce when an order is deleted.
Product Created Webhook
Inbound webhook endpoint called by WooCommerce when a product is created.
Product Updated Webhook
Inbound webhook endpoint called by WooCommerce when a product is updated.
Product Deleted Webhook
Inbound webhook endpoint called by WooCommerce when a product is deleted.