You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 42 Next »

Gets the status messages of an order.

Description

GET 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 keystringEither vehicle, group or import parameter(yes)
groupRTI vehicle group keystringEither vehicle, group or import parameter
Only with time selection		(yes)
import

RTI import key (all vehicles)

stringEither vehicle, group or import parameter
Only with time selection		(yes)
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 DATETO(yes)*1
DATEFROMStart date to return the orders from.stringFormat: YYYYMMDD or DD.MM.YYYY(yes)*1
DATETOEnd date to return the orders to.stringFormat: YYYYMMDD or DD.MM.YYYY
The max. timespan is 7 days.		(yes)*1
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

*1 Manadatory is either CUSTORDERID or ( DATEFROM and DATETO )

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

SeparatorComma (,)
DelimiterDouble quote( " )
Lineend0x0D 0x0A (CarriageReturn LineFeed)
HeaderLine 1

Columns for request by order number

Column
Description

DATEThe action dateDD.MM.YYYY HH:MM:SS
STATEThe action description
SOURCETYPEThe action trigger typePND for vehicle or RTI or PORTAL
SOURCEThe action triggerPerson/vehicle sign

Columns for request by time range

Column
Description

CUSTORDERIDown order number
DATEThe action dateDD.MM.YYYY HH:MM:SS
STATEThe action description
SOURCETYPEThe action trigger typePND for vehicle or RTI or PORTAL
SOURCEThe action triggerPerson/System
REQUESTDATEThe request system date time
METAmeta info
RTI_IDENT
RTI Identonly via import key or group key request
STATE_IDENTcustom ident (if set)
STATE_LANGcountry code, if status was selected in another language on the display 
STATE_TRANStranslation of status text, if status was selected in another language on the display 

Possible status texts

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

Garmin specific return values

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

Example

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

Example calls

Request for a order
https://map.yellowfox.de/rti/get_orderstate_v2.asp?company=RTI_COMPANYKEY&vehicle=RTI_VEHICLEKEY&language=deu&CUSTORDERID=123456789
Request for a date time range 04.05.2015 00:00:00 - 06.05.2015 23:59:59
https://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
  • No labels