===== Tracking - Meldungen =====


==== Push-Meldungen per XML ====


Alle Meldungen können wir Ihnen zyklisch (alle 30 Minuten) gesammelt per XML auf Ihren sFTP-Server übermitteln. Hierbei werden alle zuvor innerhalb einer Queue gesammelten Veränderungen zu Transaktionen, Aufträgen, Artikeln, Paketen und Errors gesammelt in einer oder mehreren XML-Files übermittelt.


Die Meldungen werden nach "order_type" (NORMAL, MANUAL, SAMPLE_INTERN, SAMPLE_CUSTOMER, TEST) getrennt/gruppiert in XML-Dateien geliefert.


==== Konvention XML-Datei ====


**"order-type = NORMAL"** 
<code>
<eindeutige_id_fuer_request_paket>_<YYYYMMDDHHIISS>.xml

z.B. "1234567890_20130603220547.xml"
</code>


**alle anderen "order-type" ** 
<code>
<order_type>_<eindeutige_id_fuer_request_paket>_<YYYYMMDDHHIISS>.xml

z.B. "TEST_1234567890_20130603220547.xml"
</code>


YYYY: 	Jahr, 4stellig\\  MM: 	Monat, 2stellig\\  DD: 	Tag, 2stellig\\  HH:	Stunde, 2stellig\\  Minute, 2stellig\\  SS:	Sekunde, 2stellig


==== Schnittstellenformat ====


Aktuelle XSD: {{wiki:statusreporting_v2-3.xsd|statusreporting_v2-3.xsd}} 


Beispiel XML: {{wiki:statusreporting_sample.xml|statusreporting_sample.xml}} 


==== Server ====


URL: tracking.pdi.elanders-germany.com \\  Port: 22\\  Protokolle: sFTP, SCP\\  Authorized Keys: RFC 4716


==== Push-Meldungen per GET / POST ====


Sie können bei der aktiven Rückmeldung (Push) zwischen GET und POST wählen. Der Einsatz ihrerseits von SSL (https) ist in beiden Fällen möglich.


Die URL Ihrer Schnittstelle wird bei uns zum Projekt hinterlegt. Sobald ein Auftrag eine Statusänderung erhält, wird dieser Ihnen übermittelt.


**Erwartete Rückgabe bei GET / POST** 


Um zu prüfen ob die Statusübermittlung erfolgreich war, erwartet unser System eine Erfolgsmeldung sowie eine eventuelle Fehlermeldung in folgender Form:


<code>
success=true&msg=Ihr Text
</code>


|**Element**  |**Beschreibung**  |**Wert**  |
|success |  Gibt an, ob die Statusübermittlung erfolgreich war  |true, false |
|msg |Rückgabemeldung |String, max. 255 Zeichen |


**Hinweis:** Push-Meldungen sind nur für sehr kleine Projekte verfügbar und wenn eine Live-Rückmeldung zwingend erforderlich ist. Der Service ist nur gegen Aufpreis verfügbar.

\\