Edit an association between price list, customer group and a store region (change the price list's priority).
To learn more about regions, see the documentation of API call getStoreRegions. With getStoreRegions, you can retrieve lists of each region's price lists and customer group-specific price lists.
To associate a new price list with a region and customer group, see addStoreRegionCustomerGroupPriceList. To remove a customer group-specific price list from a region, see removeStoreRegionCustomerGroupPriceList.
The price lists associated with region and customer group 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 |
| customerGroupID | Customer group ID. | integer | yes |
| positionNumber | Price list's position. Move the price list to a specific position, among this region's and this customer group'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. 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 and customer group.