Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Sv translation
languagede

Liefert die Statusmeldungen von Aufträgen zurück.

Beschreibung

get_orderstate_v2.asp?company=RTI_COMPANYKEY&import=RTI_IMPORTKEY&language=deu&DATEFROM=YYYYMMDD&DATETO=YYYYMMDD&timefrom=HHMMSS&timeto=HHMMSS&datetype=insertdate

Parameter

Parameter
Beschreibung
Typ
Hinweis
Pflicht
companyRTI Firmenschlüsselstring ja
vehicleRTI Fahrzeugschlüsselstring ja
import

RTI Importschlüssel (alle Fahrzeuge)

stringNur über Zeitauswahlja
languageBestimmt die Ausgabesprache (deu/gbr/ita/fra)string
  • kein Wert oder "deu" = Deutsch
  • "gbr" = englisch
  • "fra" = französisch
  • "ita" = italienisch
nein
CUSTORDERIDeigene AuftragsnummerstringEntweder dieses Feld ist gesetzt, oder DATEFROM und DATETOja
DATEFROMDatum ab dem alle Aufträge Auftragsstatus zurückgegeben werdenstringFormat: YYYYMMDD oder DD.MM.YYYYja
DATETODatum bis zu dem alle Aufträge Auftragsstatus zurückgegeben werdenstringFormat: YYYYMMDD oder DD.MM.YYYY
Die maximale Zeitspanne beträgt 7 Tage.
ja
timefromPräzisierung des Anfangsdatums mit der ZeitstringFormat: HHMMSSnein
timetoPräzisierung des Enddatums mit der ZeitstringFormat: HHMMSSnein
datetype"insertdate" gibt alle Einträge zurück welche im abgefragten Zeitraum im Rechenzentrum verarbeitet worden sindstring nein

Rückgabe

Es wird ein string zurück gegeben. Ansonsten wird bei einem Fehler ein "ERROR:Beschreibung" zurückgegeben

CSV Format

Das Ergebnis (sofern Auftragsdaten gefunden wurden) ist eine CSV Liste. Die erste Zeile ist Header und enthält die Feldnamen. Als Textbegrenzer wird das Doppelte Hochkomma verwendet.

Metainformationen

TrennzeichenKomma( , )
TextbegrenzerDoppeltes Hochkomma ( " )
Zeilenende0x0D 0x0A (CarriageReturn LineFeed)
HeaderZeile 1

Spalten bei Abfrage über eigene Auftragsnummer

Spalte
Beschreibung
 
DATEDatum der ausgeführten AktionDD.MM.YYYY HH:MM:SS
STATEBeschreibung der Aktion 
SOURCETYPEAuslösertyp der AktionPND für Fahrzeug oder RTI oder PORTAL
SOURCEAuslöser der AktionPerson/Fahrzeugkennzeichen

Spalten bei Abfrage über Zeitraum

Spalte
Beschreibung
 
CUSTORDERIDeigene Auftragsnummer 
DATEDatum der ausgeführten AktionDD.MM.YYYY HH:MM:SS
STATEBeschreibung der Aktion 
SOURCETYPEAuslösertyp der AktionPND für Fahrzeug oder RTI oder PORTAL
SOURCEAuslöser der AktionPerson/System
REQUESTDATESystemzeit der Abfrage 

Mögliche Statustexte

  • Zustellungsversuch
  • Zustellung erfolgreich
  • Gelesen
  • selbst definierte Auftragsstatus(Auftragsverwaltung-->Einstellungen)

Garminspezifische Rückgaben

  • Gelesen - Auftrag Inaktiv
  • Aktiv
  • Erledigt
  • Gelöscht

Beispiel

Code Block
"CUSTORDERID","DATE","STATE","SOURCETYPE","SOURCE","REQUESTDATE"
"ORDER1","04.08.2010 09:34:49","Erledigt","PND","Fahrzeugname","04.08.2010 09:35:00"
"ORDER1","04.08.2010 09:34:17","Aktiv","PND","Fahrzeugname","04.08.2010 09:35:00"
"ORDER1","04.08.2010 09:33:18","Gelesen - Auftrag Inaktiv","PND","Fahrzeugname","04.08.2010 09:35:00"
"ORDER1","04.08.2010 09:29:15","Zustellung erfolgreich","PND","Fahrzeugname","04.08.2010 09:35:00"
"ORDER1","04.08.2010 09:29:09","Zustellungsversuch","PORTAL","RTI","04.08.2010 09:35:00"

Beispielaufrufe

Code Block
titleAbfrage für Auftrag
http://map.yellowfox.de/rti/get_orderstate_v2.asp?company=RTI_COMPANYKEY&vehicle=RTI_VEHICLEKEY&language=deu&CUSTORDERID=123456789
Code Block
titleAbfrage für Zeitraum 04.05.2015 00:00:00 - 06.05.2015 23:59:59
http://map.yellowfox.de/rti/get_orderstate_v2.asp?company=RTI_COMPANYKEY&import=RTI_IMPORTKEY&language=deu&DATEFROM=20150504&DATETO=20150506&timefrom=000000&timeto=235959&datetype=insertdate

...