This article explains the content requirements for each pricing mechanism available in SpacesFlex.
There are three use cases which are usually used for the pricing: Slab, Linear, and Surface.
Slab
Slab pricing calculates the cost based on the catalog slabs that DS selects for a design.
To allow DS to pick and optimise the proper slabs, every slab item must contain the following data:
1. Unique identifier
- Each slab must be registered individually and have an individual code (itemRef) in the format worktop_<length>x<depth> (for example, 'worktop_3600x600')
- Every itemRef must correspond to an actual catalog entry
2. Dimensions
- Dimensions (width, depth, and thickness (if applicable) should be defined
- These dimensions should be added manually to each item
3. variantProposals
Dimensions should be manually added to each item's variantProposals. Please note that this action must be done item by item - the bulk editing is not available in this case.
Open an item and go to the Definiton tab.
In the variantProposals field:
- Select the required dimension in variesBy field ('dimension.width', 'dimension.height' or 'dimension.depth')
- Add the relevant itemRefs (you can list multiple items)
Repeat the same steps for any additional dimensions needed.
4. Catalog coverage
- Ensure all sizes used in configurations (e.g., 2400×600) exist and remain active in the catalog; otherwise an optimal layout cannot be built
When these requirements are met, DS returns the necessary slabs individually, and the Item List consolidates them into final item counts.
Linear
Linear pricing charges by total running width of a worktop. Different depths values can be used for this mechanism.
Each linear item needs a minimum and maximum allowable width so the total width for that depth stays within the supported range when pricing is calculated.
To add a width range:
- Open the item’s Definition tab and switch to Dimensions
- Select the required dimension (width or depth) and enter the minimum and maximum values in the range field
The catalog must contain the attribute with number dataType and refCode 'ref_linear_width' for this pricing.
For details on creating attributes, see this article.
The ref_linear_length attribute with $W$ value should be added to the required worktops attributes.
Surface
This pricing also requires minimum and maximum dimensions values (same as linear pricing) and refCode with 'ref_area' value and number dataType.
The ref_area attribute with $W$*$D$ value should be added to the required surface items.
When a design is priced, the Item List shows that single item and aggregates the measurement.
To learn more about creating and managing pricing rules, please see this article.