Verzeichnisstruktur

Auf dem Server stehen dem Partner vier Verzeichnisse zur Verfügung. Jedes Verzeichnis hat genau einen „Eigentümer“, der darin schreibt.

/
├── orders/            Partner → neue Bestellungen (*.xml)
├── orders_processed/  TyreSoft → importierte Bestellungen
├── tracking/          TyreSoft → Frachtbriefe (*.pdf) + Waybill (*.csv)
└── stock/             TyreSoft → stock.csv, aktueller Bestand

Bestellung XML

Jede Bestellung ist eine eigene XML-Datei mit fester Struktur. Im Folgenden beschreiben wir alle Elemente, die Formatierungsregeln und ein vollständiges Beispiel.

Allgemeine Regeln

• Eine Datei = eine Bestellung. Zeichenkodierung UTF-8, Deklaration <?xml version="1.0" encoding="UTF-8"?>.
• Der Dateiname ist die Bestellnummer des Partners mit der Endung .xml, z. B. 00006475-WY.xml. Dateinamen dürfen sich nicht wiederholen.
• Wurzelelement <DOCUMENTORDER>; Reihenfolge der Abschnitte: INVOICE → Bestelldaten → PRODUCTS → DELIVERY.
• Datumsangaben im Format JJJJ-MM-TT. Beträge mit Punkt als Dezimaltrennzeichen (157.00). Preise sind Nettopreise.
• Optionale Felder können entfallen oder leer bleiben, z. B. <PHONE></PHONE>.
• Sonderzeichen müssen maskiert werden: & → &, < → <, > → >.

Beschreibung der Elemente

W = Pflichtfeld (wymagane) · O = optional

Beispiel einer vollständigen Datei

Bestellung mit zwei Positionen und ausgefüllten optionalen Feldern.

<?xml version="1.0" encoding="UTF-8"?>
<DOCUMENTORDER>
<INVOICE>
  <NUMBER>181</NUMBER>
  <FROM>1234563218</FROM>
  <NAME>Firma Przykładowa Sp. z o.o.</NAME>
  <TAXID>1234563218</TAXID>
  <STREET>Przykładowa</STREET>
  <STREETNUMBER>1/2</STREETNUMBER>
  <POSTALCODE>00-001</POSTALCODE>
  <CITYNAME>Warszawa</CITYNAME>
  <COUNTRY>Polska</COUNTRY>
</INVOICE>
<DATE>2026-10-31</DATE>
<DELIVERYDATE>2026-11-02</DELIVERYDATE>
<ORDERCURRENCY>PLN</ORDERCURRENCY>
<NUMBER>00008120-WY</NUMBER>
<PRODUCTS>
  <PRODUCT>
    <CODE>PO488H1</CODE>
    <NAME>Opona 205/65R16C SNOWTOUR 107/105R POWERTRAC</NAME>
    <ORDERQUANTITY>4</ORDERQUANTITY>
    <SELL_PRICE>157.00</SELL_PRICE>
  </PRODUCT>
  <PRODUCT>
    <CODE>225/70R15CSC328</CODE>
    <NAME>Opona 225/70R15C SC328 112/110R GOODRIDE</NAME>
    <ORDERQUANTITY>2</ORDERQUANTITY>
    <SELL_PRICE>178.00</SELL_PRICE>
  </PRODUCT>
</PRODUCTS>
<DELIVERY>
  <MODEOFTRANSPORT>1</MODEOFTRANSPORT>
  <CODCOST>0</CODCOST>
  <CUSTOMERNAME>Firma Przykładowa Sp. z o.o.</CUSTOMERNAME>
  <STREET>Przykładowa</STREET>
  <STREETNUMBER>1/2</STREETNUMBER>
  <POSTALCODE>00-001</POSTALCODE>
  <CITYNAME>Warszawa</CITYNAME>
  <COUNTRY>Polska</COUNTRY>
  <PHONE>+48 600 100 200</PHONE>
  <PACKQ>6</PACKQ>
  <LINK></LINK>
  <COMMENTS>Dostawa w godz. 8-16</COMMENTS>
</DELIVERY>
</DOCUMENTORDER>

Frachtbriefe PDF

Für jedes versendete Paket legt TyreSoft im Verzeichnis /tracking ein Versanddokument im PDF-Format ab.

• Der Dateiname ist die Sendungsnummer, z. B. 10000000001.pdf. Dieselbe Nummer steht in der Spalte TrackingId der Waybill-CSV.
• Eine Bestellung, die in mehreren Paketen versendet wird, hat mehrere PDF-Dateien, eine pro Paket.
• Um ein PDF einer Bestellung zuzuordnen, suchen Sie die Nummer in der Waybill-CSV und lesen die Spalte CustomerRef.

So hängen die Dateien zusammen

Eigener Paketdienst des Partners (MODEOFTRANSPORT = 2)

Wird die Sendung vom Paketdienst des Bestellers abgeholt, übergibt der Partner seinen eigenen Frachtbrief als Adresse im Feld <LINK> des Abschnitts <DELIVERY>. Unter dieser Adresse muss eine druckfertige PDF-Datei abrufbar sein.

Waybill CSV

Die Waybill-CSV verknüpft Sendungsnummern mit den Bestellungen des Partners. TyreSoft legt sie im Verzeichnis /tracking ab.

Dateiformat

• Trennzeichen: Semikolon ;. Kodierung UTF-8. Die erste Zeile enthält die Spaltenüberschriften.
• Jede Zeile endet mit einem Semikolon.
• Eine Zeile = ein Paket (eine Sendungsnummer). Eine Bestellung in mehreren Paketen belegt mehrere Zeilen.
• Das Datum in der Spalte DeliveryDate hat das Format T-M-JJJJ, z. B. 21-7-2020.
• Dateiname: waybill_JJJJMMTT_HHMMSS.csv.
• Schlüssel zur Bestellung ist CustomerRef, also die Bestellnummer des Partners.

Beispiel

CompanyId;CustomerId;DeliveryDate;PickingListId;LineNum;PackingSlipId;OrderId;CustomerRef;ItemId;EanItemId;QuantityDelivered;TrackingId;DeliveryMode;
100;100001;21-7-2020;PM1071083;1;PX2120101;QV200686844;00007993-OW;GY2154516HEFFP;5452000571731;1;10000000001;GLSPLFR;
100;100001;21-7-2020;PM1071082;1;PX2120101;QV200688021;00008002-OW;PI2754521YSCZEASPLRX;8019227343250;1;10000000002;GLSPLFR;
100;100001;21-7-2020;PM1071082;2;PX2120101;QV200688021;00008002-OW;PI2754521YSCZEASPLRX;8019227343250;1;10000000003;GLSPLFR;
100;100001;21-7-2020;PM1071081;1;PX2120102;QV200682112;00007952-WY;HI2256516RTRANSIT;6953913105550;1;10000000004;GLSPLFR;
100;100001;21-7-2020;PM1071084;1;PX2120103;QV200685555;00007828-WY;GY2055516HEFFIPRE;5452000812018;1;10000000005;GLSPLFR;

Lagerbestand CSV

Das Verzeichnis /stock enthält immer genau eine aktuelle Datei stock.csv. TyreSoft überschreibt sie in festgelegten Abständen mit der vollständigen Liste verfügbarer Produkte. Die Datei enthält weder Historie noch inkrementelle Änderungen.

• Trennzeichen Semikolon ;, Kodierung UTF-8, Überschriften in der ersten Zeile, Punkt als Dezimaltrennzeichen.
• Lesen Sie immer die ganze Datei ein und behandeln Sie sie als Gesamtbestand: Ein Produkt, das fehlt, ist nicht verfügbar.
• Verwenden Sie den Wert der Spalte Code als <CODE> in der XML-Bestellung.
• Die Spalte UpdatedAt gibt an, wann der Bestand erzeugt wurde.

Code;EAN;Name;Quantity;Price;Currency;UpdatedAt
GY2154516HEFFP;5452000571731;Opona 215/45R16 Goodyear EfficientGrip Performance;24;289.00;PLN;2026-10-31 12:00
GY2055516HEFFIPRE;5452000812018;Opona 205/55R16 Goodyear EfficientGrip Performance;40;265.00;PLN;2026-10-31 12:00
PI2754521YSCZEASPLRX;8019227343250;Opona 275/45R21 Pirelli Scorpion Zero;8;912.00;PLN;2026-10-31 12:00
PO488H1;;Opona 205/65R16C SNOWTOUR 107/105R POWERTRAC;12;157.00;PLN;2026-10-31 12:00
225/70R15CSC328;;Opona 225/70R15C SC328 112/110R GOODRIDE;0;178.00;PLN;2026-10-31 12:00

Best Practices