Very Simple Order Protocol

Das Very Simple Order Protocol ist ein Weg, Lieferaufträge an HUDORA zu senden. In der Regel ist es auf Dreiecksgeschäfte Gerichtet, wo unsere Kunden nicht nur die Ware bei uns kaufen, sondern als zusätzliche Dienstleistung das Fullfillment Endverbrauchern gegenüber. Das Protokoll baut auf dem AddressProtocol auf.

Das Very Simple Order Protocol wurde entwickelt, um in möglichst vielen Umgebungan abbildbar zu sein. Das bevorzugte Format ist jedoch XML.

Required Fields

• menge - Menge des durch ean bezeichneten Artikels, die versendet werden soll.
• ean - EAN des zu versendenen Artikels.

Optional Fields

• kundenauftragsnr - Freitext, den der Kunde bei der Bestellung mit angegeben hat, 20 Zeichen.
• infotext_kunde - Freitext, der sich an den Warenempfänger richtet. Kann z.B. auf einem Lieferschein angedruckt werden. Der Umbruch des Textes kann durch das Backendsystem beliebig erfolgen, deshalb sollte der Text keine Zeilenumbrüche beinhalten.

Beispiele

XML

Dieses Beispiel codiert das Order Protcol als Plain Old XML (POX):

<order> 
  <name1>HUDORA GmbH</name1>
  <name2>Abt. Cybernetics</name2>
  <name3></name3>
  <strasse>Jägerwald 13</strasse>
  <land>DE</land>
  <plz>42897</plz>
  <ort>Remscheid</ort>
  <tel>+49 2191 60912 0</tel>
  <fax></fax>
  <mobil></mobil>
  <email>nobody@hudora.de</email>
  <menge>1</menge>
  <ean>4005998651698</ean>
  <kundenauftragsnr>XQ03244231</kundenauftragsnr>
  <infotext_kunde>Lieferung im Auftrag der "Kawuschel Sportausrüstung AG"</infotext_kunde>
</order >

CSV

Das Order Protocol kann zur not auch als CSV kodiert werden. Gennerell ist jedoch davon abzuraten, weil es zu Kodierungsproblemen mit Umlauten und Sonderzeichen, wie ";:`,.'| kommen kann.

Wenn doch CSV verwendet wird, ist UTF-8 Kodierung zu verwenden. Das Trennzeichen ist ,, Quoting erfolgt durch ". Soll das Quotingzeichen in einem string vorkommen ist es zu verdoppeln. Zeilen werden durch \r\n (Hex: 0a0d) beendet. Die erste Zeile muss eine Formatbeschreibung beinhalten und mit # beginnen. Alle weiteren Zeilen, die mit # beginnen, werden ignoriert. Wir verwenden den Python CSV Parser zum Einlesen der Daten.

# name1,name2,name3,strasse,land,plz,ort,tel,fax,mobil,email,menge,4005998651698,kundenauftragsnr,infotext_kunde
"HUDORA GmbH","Abt. Cybernetics","","Jägerwald 13","DE","42897","Remscheid","+49 2191 60912 0","","","nobody@hudora.de","1","4005998651698","XQ03244231","Lieferung im Auftrag der ""Kawuschel Sportausrüstung AG"""