For your webshop, CloudSuite may choose to work with dynamic price calculation on the PLP, PDP, and Basket (a.k.a, https://cloudsuite.atlassian.net/wiki/spaces/CFL/pages/1800798286).

When the shop uses dynamic pricing, all prices are retrieved from your ERP system. The Basket / Dynamic Pricing API handles this functionality and calls to an external web service implemented by the customer. https://cloudsuite.atlassian.net/wiki/spaces/CFL/pages/1802502560/Data+API#Basket-API

This specific call also returns order cost info of the specified order,

When using Dynamic ordercosts, some features in the CloudSuite platform are limited in functionality, such as Prices, Discounts, Promotion bundles, and the use of coupons.
This functionality only works with the prices ex. VAT setting on shop level.
To ensure the correct prices are presented, the user needs to be registered and logged in to the webshop. Before login, we can show a generic price list.

Request

The call contains the party, product codes, and related quantities. It is also possible to support a price-UOM. This feature allows the customer to see the product price and another price like Kg or liters, comparing products to similar products based on price UOM.

Also, you can request multiple products to show prices on the product overview pages (PLP), for example.

URL

The customer defines the URL.

Method

POST

Mapping

Extrinsic Field	Description	Remarks

Extrinsic Field	Description	Remarks
party	Import_key of the party
webshop	ID of the webshop
currency		EUR, USD etc
language	ISO code of the language	eg. nl_NL
address_import_key	The key of the delivery address
address_name	Name of the delivery address
address_street	Street of the delivery address
address_street_2	Street bis of the delivery address
address_zip	Zipcode of the delivery address
address_city	City of the delivery address
address_country	Country of the delivery address
desired_delivery_date	Requested delivery date
incTiers	Include tiers in the result	Tiers are only used for informational display on the Product Detail Page (PDP).
price_info	An array of additonal info which can be shown on the page.	Only for the PDP, only text
lines	An array of product info
lines - product	Import_key of the product
lines - quantity	Quantity
lines - grossprice	Grossprice
lines - discount	Discount in percent
lines - nettprice	Nettprice
lines - priceuom	The key to the price UOM	Necessary to show the correct price unit, when you want to show both the item price and a price per kilo or m² (priceunit) OPTIONAL
lines - priceuomprice	The price of the price unit	Necessary to show the correct price unit. This can be used when the customer wants to see the item price and price per UOM (kilo/m², box). OPTIONAL
price_info	Additional info to be used in the based

Request multiple products (Basket)

{
	"party": "1483521312",
	"webshop": 12,
    "currency": "EUR",	
    "language": "nl_NL",    
	"address_import_key": "363b952a-dc05-49db-a25d-f37d377c56bb",
	"address_name": "CloudSuite",
	"address_street": "PMP 8",
	"address_street_2": "",
	"address_zip": "2582 NB",
    "address_city": "Den Haag",
	"address_country": "NL",
	"desired_delivery_date": "2023-06-30",
	"lines": [
		{
			"product": "21695_STK",
			"quantity": 3,
			"price" : 55.55
		},
        {
			"product": "21456_STK",
			"quantity": 2,
            "price" : 66.66
		}
	]
}

Response with price-uom (basket multiple products)

Only the ordercost_lines[] info is used of the response. the rest of the data is ignored.

{
    "party": "1483521312",
    "currency": "EUR",
	"ordercost_lines": [{
		"product": "ORDERCOST1",
		"quantity": "1",
		"nettprice": 9.95,
        "overridename": "orderkosten naam"
	},{
		"product": "ORDERCOST2",
		"quantity": "1",
		"nettprice": 2.95,
        "overridename": "orderkosten naam 2"
	}]
}

Dynamic Ordercosts

Request

URL

Method

Mapping

Request multiple products (Basket)

Response with price-uom (basket multiple products)

Related content