Price UOM in pricelists

This explains the way the price UOM and the UOM work together. A Price UOM is used when products have different UOM sizes (e.g. 1,5Kg and 2.45Kg etc) but you want to compare prices on a mutual measurement like kg or unit. This can also apply for pricing in m2 and wooden plates.

A price list with a price UOM key can be sent to CloudSuite to facilitate this feature.

If you do not want to use price_uom’s, then give the price_uom element value null, in this case the price is for the sale_uom.

The product itself does not need the same default UOM as provided in the pricelist, but it is best practice to do so. So the product can be STUKS and the price and factor can be ST1.25KG_KG

The price for the sale UOM is calculated with price UOM and the factor!

Product A

Sale UOM: Box of 1.5Kg
Price UOM: KG

UOM API Message:

PUT /api/uom/BOX1.5KG

{
    "key": "BOX1.5KG",
    "name": "Box of 1.5 Kilogram",
    "category": "Units",
    "digits": 0,
    "rounding": 0.01,
    "rate": 1.0,
    "factor": 1.0,
    "symbol": "BOX1.5KG",
    "uom_contents": [
        {
            "uom": "KG",
            "quantity": "1.50000"
        }
    ],
    "active": true
}

When sending in this UOM with the factor an automatic keyis created which is the key of the UOM concatenated with the compare UOM. In this case: BOX1.5KG_KG.
This key must be used in the pricelist if the send price is in this case in kg.

Pricelist for product A

...
{
    "product": "A",
    "create_netprice": false,
    "additional_discount": false,
    "price_uom": "BOX1.5KG_KG",
    "tiers": [
        {
            "quantity": 1,
            "value": "5.55"
        }
    ],
    "percentage": false
}
...

Price of product A → € 5.55 x 1.5 (factor) = € 8,33

Product B

Sale UOM: Box of 36 units
Price UOM: ST

UOM API Message:

PUT /api/uom/BOX36ST

{
    "key": "BOX36ST",
    "name": "Box of 36 units",
    "category": "Units",
    "digits": 0,
    "rounding": 0.01,
    "rate": 1.0,
    "factor": 1.0,
    "symbol": "BOX36ST",
    "uom_contents": [
        {
            "uom": "ST",
            "quantity": "36"
        }
    ],
    "active": true
}

When sending in this UOM with the factor an automatic keyis created which is the key of the UOM (BOX36ST) concatenated with the compare UOM (ST). In this case: BOX36ST_ST.
This key must be used in the pricelist if the send price is in this case in price (ST).

Pricelist for product B

...
{
    "product": "B",
    "create_netprice": false,
    "additional_discount": false,
    "price_uom": "BOX36ST_ST",
    "tiers": [
        {
            "quantity": 1,
            "value": "6.95"
        }
    ],
    "percentage": false
}
...

Price of product B → € 6.95 x 36 (factor) = € 250,20

Product C

Sale UOM: plate of 244cm x 122cm
Price UOM: m²

UOM API Message:

PUT /api/uom/PLATE244x122

{
    "key": "PLATE244x122",
    "name": "Plate of 244cm x 122cm",
    "category": "Units",
    "digits": 0,
    "rounding": 0.01,
    "rate": 1.0,
    "factor": 1.0,
    "symbol": "PLATE244122",
    "uom_contents": [
        {
            "uom": "M2",
            "quantity": "2.9768"
        }
    ],
    "active": true
}

When sending in this UOM with the factor an automatic key is created which is the key of the UOM (PLATE244x122) concatenated with the price UOM (M2).
In this case: PLATE244x122_M2.
This key must be used in the pricelist if the price UOM is M2.

Pricelist for product B

...
{
    "product": "C",
    "create_netprice": false,
    "additional_discount": false,
    "price_uom": "PLATE244x122_M2",
    "tiers": [
        {
            "quantity": 1,
            "value": "6.95"
        }
    ],
    "percentage": false
}
...

Price of product C → € 6.95 x 2.9768 (factor) = € 20,69

Cloudsuite REST API Documentation

Price UOM in pricelists

Related content