Search

getCustomerGroups

Get customer groups. In ERPLY, customer groups are hierarchical; a group can contain sub-groups.

Input parameters

Parameter nameDescriptionPossible valueRequired
changedSinceRetrieve only items that have been added or modified since the specified timestamp. Use it to keep a local database in sync with ERPLY.Integer (Unix timestamp)
langRetrieve item names in a specific language. If omitted, API will return item names in the default language of your ERPLY account.
Possible values:
  • 'eng' - English
  • 'spa' - Spanish
  • 'ger' - German
  • 'swe' - Swedish
  • 'fin' - Finnish
  • 'rus' - Russian
  • 'est' - Estonian
  • 'lat' - Latvian
  • 'lit' - Lithuanian
  • 'gre' - Greek
String

Response

Field nameTypeDescription
customerGroupIDIntegerCustomer group ID.
parentIDIntegerParent element ID.
nameString
pricelistIDIntegerCustomer group price list 1.
pricelistID2IntegerCustomer group price list 2.
pricelistID3IntegerCustomer group price list 3.
pricelistID4IntegerCustomer group price list 4.
pricelistID5IntegerCustomer group price list 5.
addedUnix timestampCreation time.
lastModifiedUnix timestampLast modification time.

If your account uses customer registry microservice (the list of customers is stored outside of ERPLY), you can still use this API call, but fields "pricelistID", "pricelistID2", "pricelistID3", "pricelistID4", "pricelistID5", "added" and "lastModified" will always return 0.

Also, you cannot use input parameter "changedSince" — it will return error code 1126. To synchronize customer groups, integrate with the customer registry directly.