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.
| Parameter name | Description | Possible value | Required |
|---|---|---|---|
| priceListID | Price list ID. | integer | yes |
| storeRegionID | Store region ID. | integer | yes |
| positionNumber | Price list's position. Move the price list to a specific position, among this region's price lists; 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.