Thema "Betreff: Events => equipmentType, errorEventType, errorDescription => language." in The Viessmann API

Events => equipmentType, errorEventType, errorDescription => language.

nerixs — Mon, 05 Dec 2022 13:43:18 GMT

Hello,

In the example below the responses "equipmentType, errorEventType, errorDescription" are in English.

{ "eventType": "device-error", "gatewaySerial": "XXXXXXXXXXXXXXXX", "body": { "errorCode": "0f", "deviceId": "0", "modelId": "VScotHO1_200_11", "active": false, "equipmentType": "Boiler", "errorEventType": "Error", "errorDescription": "Service required" }, "createdAt": "2022-09-24T10:04:04.208Z", "eventTimestamp": "2022-09-24T10:03:36.000Z", "editedBy": "system", "origin": "system" },

Vicare gives these answers in the language of the boiler (for me in French).

Are these translations accessible from the API?

Betreff: Events => equipmentType, errorEventType, errorDescription => language.

CaCicala — Wed, 07 Dec 2022 20:33:39 GMT

Salut,

Je ne pense pas que l'API te donne les messages d'erreur, etc. dans une autre langue que l'anglais. L'API sert en quelque sorte de base avec un Output uniforme et standardisé.
ViCare prend ces messages et les adapte aux différentes langues.
La traduction n'a donc rien à faire avec l'api.
Bonne chance

Chris

Re: Events => equipmentType, errorEventType, errorDescription => language.

CustomerCareMichael — Fri, 09 Dec 2022 14:09:07 GMT

Hi @nerixs, you can try and use the service documents endpoints in addition to the events endpoint: https://documentation.viessmann.com/service-documents/v3#service-documents_List_Errors_From_Database

Here, you have the following input:

materialNumber = the first 7 digits of your device's serial number
errorCode = the error code you want to read – in your described case, it would be "0f"
countryCode = 2-letter country code – e.g. fr
languageCode = 2-letter language code – e.g. fr

This will output a description (and measure) for the provided error in the chosen language.

Best,

Michael

Re: Events => equipmentType, errorEventType, errorDescription => language.

nerixs — Fri, 09 Dec 2022 22:16:44 GMT

Hi @CustomerCareMichael,

Thank you for this procedure.

Better,

Eric