Get the list of languages currently activated on this Erply account.
For a list of all supported languages, see getAllLanguages; getActiveLanguages returns a subset of those. For the default language, see getDefaultLanguage.
These two API calls are useful if you are building a frontend application and need to read or write multilingual data (product names, product group names). Using the list of languages, the application can figure out which field name to use for retrieving or updating a product's name in French, for example.
For more information about languages in Erply, see this article.
|name||String||Name of the language in English. This is unique for each record.|
|nativeName||String||The language's native name, eg. "Español", "Ελληνικά" or "简体中文". If you want to build a language selection dropdown, this is the preferred label to use.|
|shortDisplayName||String||A shorter identifier for the language. Erply back office uses it in field and column labels, such as “Name FRA” or “Description FRA”.|
A three-letter identifier. This is the identifier you must use in Erply API.
To get item names returned in a particular language, use input parameter
A few API calls (including getProducts) also support an input parameter
The "save" API calls, eg. saveProduct also allow to set the name in multiple languages, and similarly accept input parameters "nameENG", "nameSPA" and so on.
Note that the value can sometimes be unexpected: the
Standard ISO 639-1 code for this language. This is the identifier you must use in newer APIs, such as PIM API or CRM API.
For Simplified Chinese and Traditional Chinese, the identifiers are "zh-Hans" and "zh-Hant", respectively.
|countries||Array||List of countries where this language can be activated. (Allowing certain languages to be activated only in specific countries is due to a technical limitation.) If the array is empty, the language is available globally.|
|isOverride||Boolean||The value is "true" for languages that reuse a legacyIdentifier that belongs to some other language — such as Dutch, which repurposes the legacyIdentifier "gre".|