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 zurückgegeben werdenstringFormat: YYYYMMDD oder DD.MM.YYYYja
DATETODatum bis zu dem alle Aufträge 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 eine 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

TrennzeichenSemikolon ( ; )
TextbegrenzerDoppeltes Hochkomma ( " )
Zeilenende0x0D 0x0A (CarriageReturn LineFeed)
HeaderZeile 1
KodierungUTF-8

Spalten bei Abfrage über eigene Auftragsnummer

Spalte
Beschreibung
DATEDatum der ausgeführten Aktion (YYYY-MM-DD HH:MM:SS)
STATEBeschreibung der Aktion
SOURCETYPEAuslösertyp der Aktion (PND für Fahrzeug oder RTI oder PORTAL)
SOURCEAuslöser der Aktion (Person/Fahrzeugkennzeichen)

Spalten bei Abfrage über Zeitraum

Spalte
Beschreibung
CUSTORDERIDeigene Auftragsnummer
DATEDatum der ausgeführten Aktion (YYYY-MM-DD HH:MM:SS)
STATEBeschreibung der Aktion
SOURCETYPEAuslösertyp der Aktion (PND für Fahrzeug oder RTI oder PORTAL)
SOURCEAuslöser der Aktion (Person/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
Sv translation
languageen

Gets the status messages of an order.

Description

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

Parameter

parameter
description
type
note
required
companyRTI company keystring yes
vehicleRTI vehicle keystring yes
import

RTI import key (all vehicles)

stringOnly with time selectionyes
languageDefines the output language (deu/gbr/ita/fra)string
  • no value or "deu" = german
  • "gbr" = english
  • "fra" = french
  • "ita" = italian
no
CUSTORDERIDOwn order numberstringEither this field is set, or DATEFROM and DATETOyes
DATEFROMStart date to return the orders from.stringFormat: YYYYMMDD or DD.MM.YYYYyes
DATETOEnd date to return the orders to.stringFormat: YYYYMMDD or DD.MM.YYYY
The max. timespan is 7 days.
yes
timefromClarification of the beginning date of the timestringFormat: HHMMSSno
timetoClarification of the ending date of the timestringFormat: HHMMSSno
datetype"insertdate" return all entries inside the timerange, depending to server insertion date.string no

Return

A string is returned. Otherwise on error a "ERROR:Description" is returned.

CSV Format

The result (if order data was found) is a CSV list. The first row defines the header and contains the column namens.

Meta informations

SeparatorSemicolon ( ; )
DelimiterDouble quote( " )
Lineend0x0D 0x0A (CarriageReturn LineFeed)
HeaderLine 1
EncodingUTF-8

Columns for request by order number

Column
Description
DATEThe action dateDatum der ausgeführten Aktion (YYYY-MM-DD HH:MM:SS)
STATEBeschreibung der Aktion
SOURCETYPEAuslösertyp der Aktion (PND für Fahrzeug oder RTI oder PORTAL)
SOURCEAuslöser der Aktion (Person/Fahrzeugkennzeichen)

Spalten bei Abfrage über Zeitraum

Spalte
Beschreibung
CUSTORDERIDeigene Auftragsnummer
DATEDatum der ausgeführten Aktion (YYYY-MM-DD HH:MM:SS)
STATEBeschreibung der Aktion
SOURCETYPEAuslösertyp der Aktion (PND für Fahrzeug oder RTI oder PORTAL)
SOURCEAuslöser der Aktion (Person/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
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