Zum Hauptinhalt springen

Integrationen & API · Anleitung

Gerätemesswerte an A-REX senden

Binden Sie einen Logger, Tracker oder eine Flottenplattform an, damit Temperatur, Luftfeuchte, Türöffnungen und andere Messwerte Ihre verfolgten Lieferungen erreichen, geprüft nach einheitlichen Regeln.

Gerätemesswerte zeigen, wie die Ware unterwegs war: die Temperatur im Auflieger, die Luftfeuchte in einem Container, wann eine Tür geöffnet wurde. A-REX nimmt sie von jedem Gerät und jeder Plattform an, die eine Nachricht senden kann, prüft jeden Messwert nach denselben veröffentlichten Regeln und fügt ihn der verfolgten Lieferung hinzu. Eine Partnerschaft mit dem Gerätehersteller brauchen Sie nicht: Ihr Unternehmen oder Ihr Frachtführer richtet die eigene Plattform auf eine Adresse aus, die A-REX Ihnen gibt.

Ein Messwert ändert eine Lieferung nie von selbst. Er fließt in das Diagramm der Lieferung, in ihre Hinweise und in Vorschläge, die eine Person genehmigt.

Wählen Sie, wie Messwerte ankommen

Sie haben …Verwenden Sie
eine Flotten-, Tracking- oder Logger-Plattform, die einen Webhook senden kanneinen Eingehend-Endpunkt mit dem Ziel Gerätemesswerte
eigene Software, die sich als Maschinen-Client anmelden kanndie Messwert-API, mit einem Client, der Messwerte schreiben darf
einen Logger, den Sie nach der Fahrt auslesenLogger-Datei hochladen bei der Lieferung

Eine Plattform anbinden

  1. Öffnen Sie Eingehend und wählen Sie Eingehenden Endpunkt hinzufügen. Legen Sie Gerätemesswerte als das fest, was er empfängt, und das Format, das Ihre Plattform sendet: A-REX-Messwerte JSON oder EPCIS-Sensordaten.
  2. Kopieren Sie Adresse und Geheimnis in die Weiterleitungseinstellungen Ihrer Plattform. Wählen Sie auf beiden Seiten dieselbe Art der Signatur.
  3. Sendet Ihre Plattform ein anderes JSON, öffnen Sie den Endpunkt und verwenden Sie Anderes JSON zuordnen unter Messwertzuordnung: Geben Sie an, wo Zeit, Werte und Geräte-ID stehen, fügen Sie eine Beispielnachricht ein und probieren Sie die Zuordnung aus, bevor Sie sie veröffentlichen.
  4. Registrieren Sie jedes Gerät unter Messwerte im Bereich Messwertquellen, mit der ID, die es sendet, und wie oft es senden soll. Siehe Messwertquellen und Geräte.

Vor dem Start prüfen

Jede Nachricht erhält einen Prüfbericht: wie viele Messwerte gespeichert wurden und, bei den abgelehnten, was nicht stimmt und wie Sie es beheben, nach Feldname. Gültige Messwerte werden behalten, auch wenn andere in derselben Nachricht abgelehnt werden. Siehe Einen Prüfbericht lesen.

Den Datenfeed verfolgen

Die Karte der Lieferung auf der Seite der Partie zeigt Qualität des Datenfeeds mit einem Buchstaben von A bis E. Öffnen Sie sie, um die Bewertung und die zwei wichtigsten Probleme zu sehen, zum Beispiel eine lange Lücke. Siehe Qualität des Datenfeeds erklärt.

Was erfasst wird

Bei jedem Messwert bleibt festgehalten, wer dahintersteht: Von Ihrem Unternehmen angegeben (eine Datei, die Sie hochgeladen haben), Von einer verbundenen Plattform gemeldet oder Vom Gerät gemessen und signiert. Messwerte werden ab ihrem Empfang im Register erfasst, in Zeiträumen von bis zu vier Stunden. Positionen sind personenbezogene Daten des Fahrers und werden gesondert behandelt; siehe Positionen und Datenschutz.