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.

Input parameters

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

Price list's position.

Move the price list to a specific position, among this region's and this customer group's price lists; positionNumber = 1 sets it as the region's and customer group'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.

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.