Marketplaces that are selling certain consumables are legally required to provide customers with specific information related to those products, including a comparative price. These fields are only supported by our Connected Marketplace configuration.
Comparative Unit Price (CUP)
- Measure type (only displayed in the UI)
- Item Size
- Item Unit
- Comparative Size
- Comparative Unit
Units and measurements available
This table shows a summary of measurement units currently supported. To enable the imperial units with metric units, you must enable the following setting in the operator interface: CONFIGURATION > Advert Settings > Enable imperial units of measurement on Comparative Unit Pricing fields.
| Type of Measurement | Unit | Abbreviation |
|---|---|---|
| Weight | Milligram | mg |
| Weight | Gram | g |
| Weight | Kilogram | kg |
| Weight | Pound | lb |
| Weight | Ounce | oz |
| Volume | Millilitre | ml |
| Volume | Litre | l |
| Volume | Centiliters | cl |
| Volume | Kilolitre | kl |
| Volume | Gallon | gal |
| Volume | Quart | qt |
| Volume | Pint | pt |
| Volume | Cup | c |
| Volume | Fluid Ounce | fl. oz |
| Volume | Tablespoon | tbsp |
| Volume | Teaspoon | tsp |
| Length | Millimetre | mm |
| Length | Centimetre | cm |
| Length | Metre | m |
| Length | Mile | mi |
| Length | Yard | yd |
| Length | Foot | ft |
| Length | Inch | in |
| Area | Square Metre | sqm |
| Number | Pack | pack |
| Number | Sheet | sheet |
| Number | Each |
each |
Locate the Comparative Unit Price (CUP) fields
CUP fields are visible in the Seller portal while editing variants, including the advert CSV file, GraphQL API, and V2 REST API.
This table shows a summary of where the fields are available:
|
Read |
Create/Update |
Delete |
|
|
Seller Portal Interface |
Yes |
Yes |
Yes |
|
Advert CSV file |
Yes |
Yes |
Yes |
|
V2 API |
|||
|
GraphQL API |
|||
|
MConnect |
No |
No |
No |
CUP field validation rules
To reduce the risk of manual error while setting them, we implemented these rules:
In the Seller Portal Interface
- Item and Comparative Unit dropdown are dependent on what measure unit has been selected in the "measure type" field
- On the "measure type" field,
- When the user selects "Weight", the Item Unit and Comparative Unit can only have a variation of "g" as a unit measurement.
- When the user selects "Length", the Item Unit and Comparative Unit can only have a variation of "m" as a unit measurement.
- When the user selects "Area", the Item unit and Comparative Unit can only have a variation of "sqm" as unit measurement.
- When the user selects "Volume", the Item unit and Comparative Unit can only have a variation of "l" as a unit measurement
- When the user selects "number", the Item unit and Comparative Unit can only have "Pack" "Sheet" or "Each" as unit measurement.
- If the user enters an Item Size, then the Item Unit is mandatory, and vice versa.
- If the user enters a Comparative Size, then a Comparative Unit is mandatory, and vice versa.
In the CSV file
- The Measure type field is not in the CSV.
- Only the 4 unit and size fields are required to be completed. The Measure type field is automatically calculated based on the measurement unit selected.
- The same rules in the CSV apply per Seller Portal Interface.
Related articles