Portail et application Telematics

Informations générales
La fonction « External Push » permet d'exporter des données télématiques depuis le système KRONE afin de les rendre disponibles dans d'autres systèmes et contextes.
Une publication peut être créée sous « Publications externes ». Vous pouvez y définir la période, le package de transfert (les champs à partager), le fournisseur et les véhicules à inclure.
Pour créer un fournisseur, vous avez besoin du point de terminaison (URI) vers lequel les données doivent être transférées, ainsi que des identifiants d’authentification requis pour vous connecter au système du fournisseur.

Processus et logique
Le service envoie une requête HTTP POST, telle que décrite dans le point de terminaison /ok du fichier externalpush.json, vers l’URI spécifiée qui a été enregistrée lors de la création du fournisseur. Aucune négociation SSL n’a lieu pour chaque paquet envoyé. Pour l’authentification, le mot de passe est haché en SHA-256 et encodé en base64 avec le nom d’utilisateur.
Les paquets qui ne peuvent pas être transmis sont placés par le service dans une file d’attente de secours afin d’être retransmis ultérieurement. Si aucune tentative d’envoi d’un enregistrement de données de partage n’aboutit dans un délai de 3 jours, le statut de l’ensemble du partage passe de « RUNNING » à « ERROR », ce qui désactive le partage.
Pour garantir un fonctionnement sans heurts, les réponses provenant du système du client doivent respecter le format de réponse défini dans la documentation technique (documentation Swagger), car le système KRONE ne peut interpréter que les réponses conformes à ce format.

Une réponse ininterprétable ou l'absence totale de réponse est considérée par le système comme une erreur lors de la réception des données. Les paquets de données sont alors transférés vers une file d'attente de secours et renvoyés dès que possible. Si cela échoue encore au bout de 3 jours, la transmission est mise à l'état « ARRÊTÉ ». Dès qu’une transmission a le statut « ARRÊTÉ » — que ce soit en raison d’un échec de transmission ou d’un arrêt manuel initié par le client ou en son nom —, les données ne sont plus collectées et, par conséquent, ne peuvent plus être renvoyées.

Divers (Développeur/Fournisseur)
La documentation technique ci-dessous explique la structure des données envoyées au client (RequestBody).
L’objet `data` du RequestBody contient un identifiant client (`externalCustomerIdentification`), qui sert d’identifiant pour le partage et peut être utilisé pour identifier de manière unique ce partage. De plus, le RequestBody contient deux champs libres (specificFields) pouvant être renseignés avec des identifiants spécifiques au client ou d’autres informations pertinentes. Toutefois, ces champs librement définissables ne peuvent être définis qu’au niveau global, c’est-à-dire pour tous les véhicules. La définition au niveau du véhicule n’est pas prise en charge. Par ailleurs, l’objet `data` contient les données du véhicule (boxdata).
Le traitement des données et l’analyse des paquets de données spécifiques relèvent de la responsabilité du destinataire. Nous préparons les enregistrements de données à l’avance afin qu’ils ne contiennent aucun champ vide. Toutefois, à l’exception de quelques champs obligatoires, les enregistrements de données peuvent différer les uns des autres, car les paramètres sans valeur ne sont pas transmis.

Spécification OpenAPI / Swagger
Les données spécifiées dans le schéma Boxdata de la spécification OpenAPI ne constituent qu'un petit échantillon des champs Boxdata, car les champs Boxdata envoyés varient considérablement dans la pratique. Il n'arrivera jamais que tous les champs possibles soient renseignés et envoyés. Cet exemple a pour but de vous aider à comprendre la conception et la structure du modèle de données.

Avec la nouvelle plateforme mykrone.blue, les données relatives aux véhicules sont enrichies de champs supplémentaires. Ces champs viennent compléter l'ensemble de données existant issu du portail KRONE Telematics.

Nouveaux champs dans l'objet « vehicle »

• VH_ILU_CODE : code ILU (unité de chargement intermodale) du véhicule
• VH_LICENSE_PLATE : numéro d'immatriculation
• VH_EQN : numéro d'équipement
• VH_VIN : numéro d'identification du véhicule (VIN)
• VH_FLEET_NUMBER : désignation de la flotte

Identifiant principal : VIN

KRONE recommande d'utiliser le VH_VIN comme identifiant principal. Le VIN permet d'identifier de manière unique les véhicules, de dédupliquer les enregistrements et d'établir des liens entre différents systèmes. Les autres identifiants complètent le VIN en tant qu'attributs, mais ne doivent pas servir de clé unique, car les numéros d'immatriculation et les désignations de flotte peuvent changer.

Disponibilité

Les champs supplémentaires ne sont transmis que si le client utilise mykrone.blue. Les clients qui continuent à utiliser le portail KRONE Telematics ne reçoivent pas ces champs.

Conseils d'utilisation

• Les champs qui ne sont pas transmis ne sont pas vides, mais sont absents de l'enregistrement. Le traitement doit tenir compte des champs facultatifs.
• Les valeurs doivent être traitées comme des chaînes de caractères. Les espaces dans VH_ILU_CODE et VH_LICENSE_PLATE doivent être normalisés avant toute comparaison.
• Les champs inconnus doivent être ignorés afin que les extensions futures n'interrompent pas le traitement.

Pour toute question concernant la structure des données ou le passage d'un portail à l'autre, veuillez contacter votre interlocuteur KRONE.