Get the list of all languages that Erply supports.
For a list of languages that are currently activated on the given account, see getActiveLanguages. 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.
The languages listed here cannot be all simultaneously activated; some of these are available in certain countries only, and there is a limit of maximum 10 languages.
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 identifier is used 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.
This field is more or less unique, with one exception: there are separate entries for "English" and "English (Australia)", for legacy purposes, and both of these have isoCode="en". Most likely you can ignore the language "English (Australia)", and all other codes are unique.
|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".|