WooCommerce Integration

Before you start

• A WordPress website with WooCommerce installed and activated.
• A WooCommerce REST API key with Read/Write permission (WooCommerce → Settings → Advanced → REST API → Add key). Read/Write is what lets Simplio3D add configured products; a read-only key only supports adding the product as it is.
• A Simplio3D Configurator project with its share link enabled, and an Add to Cart field in its form (Editor → Forms → Add Field → Add to Cart).

Connect your store

1. 1Open Dashboard → Integrations → WooCommerce.
2. 2Enter your store URL, Consumer Key and Consumer Secret, then click "Connect to WooCommerce".
3. 3The connection test also checks whether your key can create products, and finds your store's cart and checkout pages (even when they have translated names such as /warenkorb/ or /panier/). If it says the key is read-only, create a Read/Write key and save it here.
4. 4Re-test the connection after changing keys or store settings.

Link a product and choose how checkout works

Every project links one WooCommerce product. Open Projects, choose Link WooCommerce Product on the project (or Batch Link WooCommerce Product for several), pick the product, and choose three options. Once a product is linked, every change you make in this dialog is saved immediately and applies to your Share link and your website right away.

How configured products work

• When a shopper adds a configuration, Simplio3D adds a hidden product to your store for it: the name lists the chosen options, the image is the shopper\'s 3D configuration, and the price is the one you chose. WooCommerce then shows it in the cart, checkout, order e-mails and the order like any other product.
• Hidden products don\'t appear in your shop or search. They copy the tax class, shipping class, weight, dimensions and categories of the product you linked, so tax and shipping work the same.
• The same configuration reuses the same product. A product that was never ordered is deleted after 30 days; one that was ordered is kept, because the order links to it. You can recognise them by their SKU, which starts with S3D-.
• The price is never taken from the shopper\'s browser: Simplio3D checks the configuration against your project and recalculates the price on the server, rounded exactly as the configurator shows it.
• The linked product itself stays in your store unchanged and can still be bought at its own price from your shop. If you only want to sell configurations, you can set it to Private in WooCommerce — it then works as a template only.

When the Simplio3D price can\'t be used

The link dialog tells you when a project can\'t use the Simplio3D configured price, and why. Choose the WooCommerce price for these projects:

• Modular projects (they are priced from the modules a shopper places).
• Projects whose pricing Simplio3D can\'t recalculate on the server, such as rules that depend on numeric conditions, or bespoke price blocks.
• Projects with no pricing yet.
• Projects priced in a different currency from your store. Set the store\'s currency in the project\'s pricing settings.

Simplio3D never falls back to a different price on its own. If a shopper can\'t check out, the link dialog shows the last failed attempt with the reason — for example a read-only API key, or a linked product that was deleted or is out of stock.

How it works for customers

1. 1The customer opens the configurator (embedded on your website or via the share link).
2. 2They configure the product — materials, colours, options, dimensions — and the price updates as they go.
3. 3They click Add to Cart. Simplio3D prepares the configured product (a few seconds the first time, instantly for a configuration it has seen before).
4. 4They land on your cart or checkout with the configured product. When the configurator is embedded on your website, the whole page goes to the cart; if their browser blocks that, an "Open cart" button appears.