Telematicaportaal & app

Algemene informatie
De External Push wordt gebruikt om telematicagegevens uit het KRONE-systeem te exporteren, zodat deze in andere systemen en contexten beschikbaar kunnen worden gemaakt.
Onder „Externe releases“ kan een release worden aangemaakt. Hier kunt u de periode, het pushpakket (de velden die moeten worden gedeeld), de provider en de op te nemen voertuigen definiëren.
Om een provider aan te maken, hebt u het eindpunt (URI) nodig waarnaar de gegevens moeten worden gepusht, evenals eventuele authenticatiegegevens die nodig zijn om u bij het systeem van de provider te authenticeren.

Proces en logica
De dienst verstuurt een HTTP POST-verzoek, zoals beschreven in het /ok-eindpunt in externalpush.json, naar de opgegeven URI die bij het aanmaken van de provider is opgeslagen. Er vindt geen SSL-handshake plaats voor elk verzonden pakket. Voor authenticatie wordt het wachtwoord samen met de gebruikersnaam met SHA-256 gehasht en in base64 gecodeerd.
Pakketten die niet kunnen worden afgeleverd, worden door de dienst in een back-upwachtrij geplaatst om op een later tijdstip opnieuw te worden verzonden. Als er binnen 3 dagen geen succesvolle poging is gedaan om een gegevensrecord voor het delen te verzenden, wordt de status van het gehele delen gewijzigd van „RUNNING“ naar „ERROR“, waardoor het delen wordt gedeactiveerd.
Om een soepele werking te garanderen, moeten de reacties van het systeem van de klant voldoen aan het reactieformaat dat is gedefinieerd in de technische documentatie (Swagger-documentatie), aangezien het KRONE-systeem alleen reacties kan interpreteren die aan dit formaat voldoen.

Een onleesbaar antwoord of het uitblijven van een antwoord wordt door het systeem tijdens de gegevensontvangst als een fout beschouwd. De gegevenspakketten worden vervolgens naar een reservewachtrij verplaatst en bij de eerste gelegenheid opnieuw verzonden. Als dit na 3 dagen nog steeds niet lukt, krijgt de push de status „STOPPED“. Zodra een push de status „STOPPED“ heeft – hetzij vanwege een mislukte verzending, hetzij vanwege een handmatige stop die door de klant of namens hem is geïnitieerd – worden er geen gegevens meer verzameld en kunnen deze bijgevolg ook niet opnieuw worden verzonden.

Diversen (Ontwikkelaar/Aanbieder)
In de onderstaande technische documentatie wordt de structuur van de naar de klant verzonden gegevens (RequestBody) toegelicht.
Het `data`-object in de RequestBody bevat een klant-ID (`externalCustomerIdentification`), dat dient als identificatie voor het delen en kan worden gebruikt om het delen eenduidig te identificeren. Daarnaast bevat de RequestBody twee vrije velden (specificFields) die kunnen worden gevuld met klantspecifieke ID’s of andere relevante informatie. Deze vrij definieerbare velden kunnen echter alleen op globaal niveau worden gedefinieerd – dat wil zeggen, voor alle voertuigen. Definitie op voertuigniveau wordt niet ondersteund. Verder bevat het `data`-object de voertuiggegevens (boxdata).
De verwerking van de gegevens en de analyse van de specifieke gegevenspakketten vallen onder de verantwoordelijkheid van de ontvanger. Wij bereiden de gegevensrecords van tevoren voor, zodat ze geen lege velden bevatten. Afgezien van enkele verplichte velden kunnen de gegevensrecords echter van elkaar verschillen, aangezien parameters zonder waarden niet worden verzonden.

OpenAPI Spec/Swagger
De gegevens die in het Boxdata-schema in de OpenAPI Spec worden gespecificeerd, bevatten slechts een kleine greep uit de Boxdata-velden, aangezien de verzonden Boxdata-velden in de praktijk sterk zullen variëren. Het zal nooit voorkomen dat alle mogelijke velden worden ingevuld en verzonden. Het voorbeeld is bedoeld om u inzicht te geven in het ontwerp en de structuur van het gegevensmodel.

Met het nieuwe platform mykrone.blue worden de voertuiggegevens uitgebreid met extra velden. Deze velden vormen een aanvulling op de bestaande gegevensset uit het KRONE Telematics Portal.

Nieuwe velden in het object ‘vehicle’

• VH_ILU_CODE: ILU-code van het voertuig (Intermodal Loading Unit)
• VH_LICENSE_PLATE: kenteken
• VH_EQN: uitrustingsnummer
• VH_VIN: voertuigidentificatienummer (VIN)
• VH_FLEET_NUMBER: vlootnaam

Primaire identificatiecode: VIN

KRONE raadt aan om VH_VIN als primaire identificatiecode te gebruiken. Het VIN is geschikt voor de eenduidige toewijzing van voertuigen, voor het verwijderen van dubbele gegevensrecords en voor het koppelen tussen verschillende systemen. De overige identificatiecodes vullen de VIN aan als attributen, maar mogen niet als enige sleutel dienen, aangezien kentekens en wagenparkbenamingen kunnen veranderen.

Beschikbaarheid

De uitgebreide velden worden alleen verzonden als de klant gebruikmaakt van mykrone.blue. Klanten die nog steeds het KRONE Telematics Portal gebruiken, ontvangen deze velden niet.

Richtlijnen voor de verwerking

• Velden die niet worden doorgegeven, zijn niet leeg, maar ontbreken in het gegevensrecord. Bij de verwerking moet rekening worden gehouden met optionele velden.
• Waarden moeten als tekenreeksen worden verwerkt. Spaties in VH_ILU_CODE en VH_LICENSE_PLATE moeten vóór vergelijkingen worden genormaliseerd.
• Onbekende velden moeten worden genegeerd, zodat toekomstige uitbreidingen de verwerking niet verstoren.

Neem bij vragen over de gegevensstructuur of over de overstap van het ene portaal naar het andere contact op met uw KRONE-contactpersoon.