Grundlegende Telematikfunktionen von YellowFox sollen externen Programmen zugänglich gemacht werden.

Allgemein

 Der Nutzer der Schnittstelle soll einen Befehl an den Webserer senden und erhält dabei eine Antwort zurück. Die Übertragung der Nutzdaten erfolgt über das Protokoll http bzw. https, so dass normalerweise keinerlei Anpassungen im IT-Equipment des Kunden notwendig sind. Das Remote Tracking Interface (RTI) erhält dabei eine speziell formatierte Anfrage und beantwortet diese mit dem Ergebnis des auf die Anfrage hin ausgeführten Befehls. Das RTI agiert dabei immer nur auf eine Anfrage. Es kann weder Daten von selber versenden noch ohne Zutun des Kunden von allein tätig werden.

Das RTI lässt sich für folgende Dinge nutzen:

• Abfrage von Fahrzeugstandorten
• Änderung von trackingeinstellungen
• Konfiguration von Hardwarezubehör wie Displays
• Versenden von Aufträgen
• Empfangen von Auftragsstatusmeldungen
• Versenden und Empfangen von Textnachrichten

Die Funktionen des RTI können auf einfachste Weise mit Anwendungen wie Google Earth oder der Speditionssoftware M3 von Dr. Malek getestet werden.

Aktivierung

Das RTI wird durch unseren Support bzw. Innendienst freigeschaltet. Rufen Sie einfach an um dieses Modul für sich freizuschalten. Im Portal können Sie dann unter Extras -> RTI (Schnittstelle) RTI Schlüssel für Ihre Firma und den zugehörigen Fuhrpark erzeugen. Diese dienen dann als Authentifizierungsschlüssel.

 Fehlerwerte

Bei der Rückgabe "ERROR:Text" enthält "Text" die Fehlerbeschreibung. Mögliche Fehler:

Abarbeitungsfehler

• ERROR_$Parameter (Parameter ist nicht korrekt)
• ERROR_MISSING_$Parameter (Parameter fehlt)
• ERROR_MISSING_COMPANY (Key zur Authentifizierung der Firma fehlt)
• ERROR_MISSING_SESSIONKEY|VEHICLE|GROUP (Es wurde keiner von 3 möglichen Parametern übergeben)
• ERROR_MISSING_SESSIONKEY (Der Parmater "sessionkey" fehlt)
• ERROR_MISSING_VEHICLE (Der Parameter "vehicle" fehlt)
• ERROR_MISSING_GROUP (Der Parameter "group" fehlt)
• ERROR_MISSING_DISTANCE (Der Parameter "distance" fehlt)
• ERROR_MISSING_CYCLE (Der Parameter "cycle" fehlt)
• ERROR_MISSING_RADIUS (Der Parameter "radius" fehlt)
• ERROR_MISSING_CUSTOMORDERID - Eigene Auftragsnummer fehlt
• ERROR_MISSING_ORDERTEXT - Auftragstext fehlt
• ERROR_ORDER_NUMBER_TOO_LONG(MAX_20_CHARS) - Eigene Auftragsnummer zu lang, maximal 20 Zeichen
• ERROR_STREET_TOO_LONG(MAX_100_CHARS) - Straßenname zu lang, maximal 100 Zeichen
• ERROR_HOUSENUMBER_TOO_LONG(MAX_100_CHARS) - Hausnummer zu lang, maximal 100 Zeichen
• ERROR_ZIPCODE_TOO_LONG(MAX_10_CHARS)- Postleitzahl zu lang, maximal 10 Zeichen
• ERROR_CITY_TOO_LONG(MAX_100_CHARS) - Stadt zu lang, maximal 100 Zeichen
• ERROR_COUNTRY_TOO_LONG(MAX_100_CHARS) - Land zu lang, maximal 3 Zeichen
• ERROR_LATITUDE_MISSING - Latitude Wert wurde nicht angegeben
• ERROR_LONGITUDE_MISSING - Longitude Wert wurde nicht angegeben
• ERROR_LATITUDE_NOT_NUMERIC - Latitude Wert muss eine Zahl sein
• ERROR_LONGITUDE_NOT_NUMERIC - Longitude Wert muss eine Zahl sein
• ERROR_LATITUDE_NOT_IN_VALID_RANGE(-90_TO_90) - Latitude muss im Bereich von -90 bis +90 liegen
• ERROR_LONGITUDE_NOT_IN_VALID_RANGE(-90_TO_90) - Longitude muss im Bereich von -90 bis +90 liegen
• ERROR_TARGET_TIME_IS_INVALID - Angegebens Datum hat nicht die richtige Länge
• ERROR_TARGET_TIME_IS_NOT_A_DATE - Angegebenes Datum ist kein richtiges Datum
• ERROR_FORMULAR_NOT_ALLOCATED_BY_VEHICLE - Angegebenes Formular wurde der Hardware nicht zugeordnet
• ERROR_FORMULAR_NOT_SUPPORTED_BY_HARDWARE - Hardware unterstützt keine Aufträge mit angehängten benutzerdef. Formularen
• ERROR_ORDER_TEXT_TOO_LONG(MAX_300_CHARS) - Auftragstext ist zu lang, maximal 300 Zeichen (ACHTUNG: Bei Garmins wird die erwartete Ankunftszeit und die Adresse an den Anfang der Nachricht gesetzt, dies verringert die maximale Anzahl der Zeichen für den Auftragstext)
• ERROR_COMPANY (Authentifizierung der Firma fehlerhaft)
• ERROR_VEHICLE (Es wurde eine ungültige Fahrzeugkennung übergeben)
• ERROR_GROUP (Es wurde eine ungültige Fahrzeuggruppe übergeben)
• ERROR_DISTANCE (Der Parameter "distance" ist fehlerhaft)
• ERROR_CYCLE (Der Parameter "cycle" ist fehlerhaft)
• ERROR_RADIUS (Der Parameter "radius" ist fehlerhaft)
• ERROR_DUPLICATE_CUSTOMORDERID (Auftragsnummer mehrfach vorhanden, Aktion nicht ausführbar)
• ERROR_ORDER_NOT_FOUND (Der Angeforderte Auftrag konnte nicht gefunden werden)
• ERROR_TEXT_TOO_LONG (Auftragstext und eigene Auftragsnummer überschreiten die maximale Länge).
• ERROR_GROUP_NOMEMBER (Die abgefragte Fahrzeuggruppe enthält keinerlei Fahrzeuge)
• ERROR_MAINTENANCE (aus Wartungsgründen nicht verfügbar)
• REQUEST_NOT_FOUND (interner Fehler)
• ERROR_NOT_SUPPORTED_BY_HARDWARE (Die Hardware im Fahrzeug unterstützt diese Aktion nicht)

Serverfehler

•  TIMEDOUT (DB-Timeout (500-100))
• UNKNOWN (unbekannter Fehler,?? was sollte das sein? (500-100))
• NOTFOUND (Kommando nicht gefunden (404))