Retrieve product parameters.

“Product parameters” is a ERPLY add-on module, primarily for web shops. (It is not enabled by default. If you are looking for a simple way to attach extra key-value data to products, you may want to consider using attributes instead.)

To work with parameters, you first need to define “parameter groups” in Erply backend, and associate these with product groups. Each group must define a set of parameters for a specific type of product. Eg.: inner and outer diameter for bearings; volume, energy rating and physical dimensions for refrigerators etc.

Then, on product card, you can set specific parameter values for each item (eg. Refrigerator XYZ has a volume of 250 L, energy rating “A+” and measures 500 x 650 x 1700 mm).

This API call will return list of parameters and which parameter group they belong to. Unfortunately, API does not have calls for listing all the groups yet, or querying which product groups are associated with which parameter groups.

To get products and their parameter values, use API call getProducts, set getParameters = 1 and see output field “parameters”.

Input parameters

Parameter nameDescriptionPossible valueRequired
parameterIDRetrieve one specific parameter.Integer
parameterGroupIDRetrieve all parameters in a specific group.Integer
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


Field nameTypeDescription
parameterIDIntegerParameter ID
parameterNameStringParameter Name (eg. "Volume")
parameterUnitNameStringUnit of measure for numeric values (eg. "L")
parameterTypeStringPossible values: TEXT, NUMERIC, BOOLEAN, MULTIVALUE.
parameterGroupIDIntegerGroup (or set) where this parameter belongs.
parameterGroupNameStringSet name (eg. "Parameters for refrigerators").
addedUnix timestampCreation time.
lastModifiedUnix timestampLast modification time.
optionsArrayList of options for a MULTIVALUE element. Each item looks like this:

Field nameTypeDescription
parameterOptionIDIntegerOption ID
parameterOptionNameStringOption name