getCustomerGroups

This call is deprecated. We recommend to use CRM API instead.

The corresponding new call is: GET /v1/customers/groups or GET /v1/customers/groups/indented (for populating a dropdown list).

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

Input parameters

Parameter name Description Possible value Required
changedSince Retrieve 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)
searchAttributeName Name of attribute to search from. Both "searchAttributeName" and "searchAttributeValue" have to be specified. Error 1030 will be returned if value is an array. string
searchAttributeValue Attribute value to search for. Error 1030 will be returned if value is an array. string
lang Retrieve 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 name Type Description
customerGroupID integer Customer group ID.
parentID integer Parent element ID.
name string
pricelistID integer Customer group price list 1.
pricelistID2 integer Customer group price list 2.
pricelistID3 integer Customer group price list 3.
pricelistID4 integer Customer group price list 4.
pricelistID5 integer Customer group price list 5.
added integer Unix timestamp. Creation time.
lastModified integer Unix timestamp. Last modification time.
attributes array Additional attributes. Each item looks like this:

Field nameTypeDescription
attributeNameStringAttribute name
attributeTypeStringAttribute type
attributeValueStringAttribute value

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.