do_order.asp

Zuletzt geändert von YellowFox_RD am 2025/01/20 15:37

Inhaltsverzeichnis

Beschreibung
Parameter
Rückgabewerte
Beispiele

DEPRECATED
Erstellt einen Auftrag und sendet diesen an das angegebene Fahrzeug

Beschreibung

do_order.asp?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&customorderid=NR123XYZ&ordertext=Auftragstext&lat=51.0374&lon=13.587813

Parameter

Parameter	Beschreibung	Typ	Hinweis	Pflicht
company	RTI Firmenschlüssel	string		ja
customorderid	eigene Auftragsnummer	string	max. 20 Zeichen (eigene Auftragsnummer wird nicht auf Duplikate geprüft)	ja
ordertext	Auftragstext	string	max. 500 Zeichen (CE Display, Tablet) max. 200 Zeichen (restliche Displays)	ja
vehicle	RTI Fahrzeugschlüssel	string		ja
lat	Latitude des Navigationsziels	float	-90 bis +90 im Format WGS84	ja bei Garmin Displays
lon	Longitude des Navigationsziels	float	-180 bis +180 im Format WGS84	ja bei Garmin Displays
street	Straßenname des Navigationsziels	string	max. 100 Zeichen	nein
hnr	Hausnummer des Navigationsziels	string	max. 10 Zeichen	nein
zipcode	Postleitzahl des Navigationsziels	string	max. 10 Zeichen	nein
city	Stadt des Navigationsziels	string	max. 100 Zeichen	nein
country	Ländercode des Navigationsziels	string	max. 3 Zeichen	nein
target_time	Vorgabeankunftszeit	datestring	Format: YYYYMMDDHHMM verringert die maximale Anzahl der Zeichen des Auftragstextes um 15 Zeichen	nein
sortnumber	Sortiernummer	int	steht am Anfang des Auftragstextes in eckigen Klammern und verringert die Anzahl der Auftragstextzeichen	nein
formname	Name des Benutzerdefinierten Formulares, was nach Abschluss des Auftrages angezeigt werden soll	string	max. 20 Zeichen (verfügbar für CE Displays ab Version 1.1.67 und Tablets) Achtung Das Formular muss vorher dem Fahrzeug als Konfiguration gesendet worden sein!	nein
textlayout	Layout wie der Auftragstext auf dem Display angezeigt wird	int	0 = [Sortiernummer][Adresstext][Vorgabeankunftszeit]Auftragstext (Standard) 1 = [Sortiernummer]Auftragstext[Adresstext][Vorgabeankunftszeit] (nur für Garmin Geräte verfügbar) 2 = [Sortiernummer][Vorgabeankunftszeit][Adresstext]Auftragstext (nur für Garmin Geräte verfügbar) Achtung Sortiernummer, Auftragstext und Vorgabeankunftszeit werden nur mit eingefügt, falls diese mit übermittelt worden sind	nein

Rückgabewerte

Es wird ein string zurückgegeben. Bei Erfolg wird als Antwort "OK" zurückgegeben. Ansonsten wird ein "ERROR:Beschreibung" zurückgegeben

Beispiele

Einfacher Auftrag
https://map.yellowfox.de/rti/do_order.asp?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&customorderid=NR1234&ordertext=Auftragstext

Beispiel mit Navigationsziel und Zielankunftszeit
https://map.yellowfox.de/rti/do_order.asp?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&customorderid=NR1234&ordertext=Auftragstext&lat=51.0374&lon=13.587813&street=Hauptstr&hnr=3&zipcode=01723&city=Kesselsdorf&country=D&target_time=201411310800

Beispiel mit Navigationsziel + Formular + Sortiernummer + Textlayout
https://map.yellowfox.de/rti/do_order.asp?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&customorderid=NR1234&ordertext=Auftragstext&lat=51.0374&lon=13.587813&street=Hauptstr&hnr=3&zipcode=01723&city=Kesselsdorf&country=D&sortnumber=1&formname=Abholung&textlayout=2