Configurable Products
List Configurable Products
List the configured SKUs seen on sales order lines. When a sales channel sends the SKU of a made-to-order variant in a line option (for example a `SKU` property on a Shopify line), that configured SKU decides which product the line is for. Each configured SKU is listed once per sales channel, with the base product the channel sent, the product it is mapped to (if any), and how many order lines are waiting for a product.
Get Configurable Product
Get one configured SKU with everything needed to decide its product.
Map Configurable Product to Product
Map a configured SKU to an existing product. Future order lines carrying this configured SKU are booked to that product.
Create Product from Configurable Product
Create the product a configured SKU stands for and map it. The new product's SKU is always the configured SKU.
Bulk Create Products from Configurable Products
Create products for several configured SKUs at once, each with the configured SKU as its SKU. One row failing never stops the rest.
Re-link Open Lines to Mapped Product
Move open order lines that were booked to the base product (for example, before the configured SKU was mapped) onto the mapped product.
Bulk Re-link Open Lines to Mapped Products
Run Re-link Open Lines for several configured SKUs at once: each mapped configured SKU moves its open lines on the base product onto its mapped product where that is safe, exactly as the single-row endpoint does. A configured SKU that is not mapped, whose mapped product is archived, that uses its base product, or that no longer exists is skipped with the reason; one whose re-link raises an error is reported as failed and the rest carry on.
Check Line Move to Configured Product
Check whether one sales order line that is still on its base product can move to its configured SKU's product (the product the configured SKU is mapped to or was created as), and what it would move to. Uses the same rules as Re-link Open Lines.
Move Line to Configured Product
Move one sales order line from its base product to its configured SKU's product — Re-link Open Lines for a single line. The line is replaced by a line for the configured product with the same quantity, price, channel tax and line discounts and its options, so the order's total, discount, tax and balance due don't change. Check Line Move to Configured Product tells you first whether it will move.
Delete Configurable Product Mapping
Remove a configured SKU's product mapping. Future order lines carrying it wait for a product again; lines already booked are not changed.
Bulk Use Base Product for Configurable Products
Run Use Base Product for several configured SKUs at once. A configured SKU with no base product recorded, an archived base product, or that no longer exists is skipped with the reason; one that raises an error is reported as failed and the rest carry on.
Use Base Product for Configurable Product
Say a configured SKU is just its base product ('This is just the base product'): its options don't change what is picked, packed or made — for example a binding edge chosen with no punching pattern. The configured SKU is mapped to the base product the channel sent, with status `uses_base` and `created_via` `base_product`.
Check Listing Mappings for Configured Products
Check channel listing mappings before saving them. Returns a warning for each mapping that points a listing at a configured product: orders that carry a SKU option still find their own configured product, but plain sales of the variant would land on the configured product, ship and cost as configured, and raise a manufacturing order when build to order is on. Nothing is saved; mappings that are not flagged are simply left out of the result.
List Listings Mapped to Configured Products
List channel listings that are already mapped to a configured product — a product that a configured SKU on the same channel resolves to, or whose SKU is one of that channel's configured SKUs. Plain sales of these variants (lines without a SKU option) land on the configured product; re-map each to its base product with Re-map Listing to Base Product.
Re-map Listing to Base Product
Re-map a channel listing to its base product, usually `warning.suggested_base_product.id` from List Listings Mapped to Configured Products. Future plain sales of the variant are booked to the base product, and past order lines still waiting on this listing are linked in the background. Order lines already booked to the configured product are not moved.