Edit an association between a price list and a store region (change the price list's priority).

Store regions can be used for grouping stores (locations, warehouses). The main feature of store regions is that price lists can also be applied to a region, not just individual stores, thereby simplifying price list management. A region can also have an unlimited number of price lists, unlike a location, which is limited to 5 price lists.

To retrieve a list of regions (and price lists associated with them), see getStoreRegions. To associate a price list with a region, see addStoreRegionPriceList. To remove a price list from a region, see removeStoreRegionPriceList.

The price lists associated with a region will be automatically applied when making a sale from POS or creating a sales document in Erply back office, or when calling API calculateShoppingCart.

This API call is available only if "Store regions" module has been enabled on your account.

Input parameters

Parameter name Description Possible value Required
priceListID Price list ID. Integer yes
storeRegionID Store region ID. Integer yes

Price list's position.

Move the price list to a specific position, among this region's price lists; positionNumber = 1 sets it as the region's first price list (and moves the existing ones down), positionNumber = 2 sets it as the second price list and so on.

Price lists will be applied by Erply in the same order, meaning that each successive price list "overwrites" the previous one, or applies its discount percentage on top of the previous list price. Hence, the last price list has the highest priority. Location (store) price lists will be applied on top of region price lists.

If you specify a negative or zero value, error 1016 will be returned.

Integer yes

This API call returns error code 1006 if "Store regions" module has not been enabled on your account, or error code 1077 if this price list has not been associated with this region.