XML-Stapelverarbeitung:
Polling ist ein automatischer Prozess, bei dem BarcodeShipping auf alle Daten neuer Bestellungen über CSV/XML Dateien zugreifen und die passenden Versandlabel erstellen kann:
Für den Vorgang müssen zwei Ordner angelegt werden.
Wir empfehlen die Benennung „Wawi 2 BCS“ (für alle Dateien, deren Daten von Ihrem Shopsystem nach BarcodeShipping übertragen werden sollen) und „BCS 2 Wawi“ (für alle Daten, die von BarcodeShipping in Ihr Shopsystem übertragen werden).
Zuerst werden mit den Daten aus Ihrem Shopsystem CSV/XML Dateien erstellt.
Jede Zeile enthält eine Bestellung, inkl. aller für den Versandprozess notwendigen Daten – beispielsweise Empfängeradresse und bestellte Artikel.
Diese Datei wird im Ordner „Wawi 2 BCS“ gespeichert. Sie können in den Einstellungen von BarcodeShipping den Pfad zu diesem Ordner hinterlegen. Dadurch kann BarcodeShipping automatisch auf diesen Ordner zugreifen und regelmäßig prüfen, ob neue Dateien vorhanden sind.
Darüber hinaus können Sie in BarcodeShipping das Mapping einrichten und den Spalten die passenden Werte zuordnen, die aus der Tabelle ausgelesen werden sollen. Wenn Sie einen Wert nicht aus Ihrem Shop exportieren, dieser aber als Standardwert festgelegt werden kann, kann BarcodeShipping diesen Standardwert aus einer Spalte auslesen und für alle Bestellungen oder Artikel einfügen. So können Sie beispielsweise ein Standardgewicht von 0,5 für alle Artikel festlegen.
BarcodeShipping generiert und druckt automatisch Versandlabel mit neuen Bestelldaten.
Die Datei wird automatisch in einen Unterordner für bearbeitete Dateien verschoben. Sollte es zu einem Fehler während des Prozesses gekommen sein, wird die Datei in einen Ordner für „Errors“ geschoben.
BarcodeShipping erstellt außerdem für jede bearbeitete CSV/XML Datei eine neue im Ordner „BCS 2 Wawi“. Diese enthält entweder nur die Bestell- und Trackingnummer, alle Daten aus der Ursprungsdatei plus Trackingnummer oder ist im Easylog-Format inkl. Trackingnummer.
Ihr Shopsystem prüft mehrmals pro Minute den Ordner auf neue Dateien. Dadurch werden alle Bestellungen umgehend auch in Ihrem Wawi als „vollständig“ markiert und die Trackingnummer dort gespeichert.
XML Konfiguration - Teil 1
- Aktivieren 1
Aktivieren Sie hier die XML-Stapelverarbeitung.
- Berechne Paketgewicht 2
Aktivieren Sie diese Checkbox, wenn BarcodeShipping das Paketgewicht aus den Artikelgewichten ausrechnen soll. Voraussetzung dazu ist natürlich die Übergabe der Artikelgewichte.
- Abfrageverzeichnis (Eingang) 3
Wählen Sie hier das Verzeichnis aus, in dem die XML-Dateien abgelegt werden und von BarcodeShipping eingelesen werden sollen.
- Filtern 4
Geben Sie hier einen Filter für die Dateiformate an. Die vorgegebenen Standardwerte reichen im Normalfall aus.
- Ausgabeverzeichnis (Ausgang) 5
Wählen Sie hier das Verzeichnis aus, in das BarcodeShipping die Ausgabe-XML-Dateien ablegen soll, zur Rückgabe an Ihr Shopsystem.
- Vorlage für Dateinamen 6
Konfigurieren Sie hier den Dateinamen der Ausgabedatei mit Hilfe von Attributen.
- Lese Wartezeit 7
Geben Sie hier in Sekunden an, wie lange BarcodeShipping warten soll, bevor es anfängt die Datei(en) einzulesen. Eine längere Wartezeit kann z.B. hilfreich sein bei langsamen Druckern oder bei Druckern deren Arbeitsspeicher sehr klein ist. Hiermit wird dann die Erzeugung eines Druckauftrags verlangsamt.
- Parse Adresse 8
Wenn Ihre Adressdaten (Straße und Hausnummer) nur in einer Spalte eingetragen sind, der Versender diese aber separiert verlangt, aktivieren sie diese Checkbox.
- Parse Namen 9
Wenn Vor- und Zuname des Empfängers in nur einer Spalte zusammengefasst sind, der Versender diese aber separiert benötigt, aktivieren Sie diese Checkbox.
- Erzwinge Ein-Paketsendung 10
- Unterstützung für XML Namensräume aktivieren 11
- Zeichensatz (Format) 12
Wählen Sie hier das Zeichensatzformat aus, mit dem Ihre XML-Datei geschrieben wurde. Wir empfehlen UTF-8.
- Feldzuordnungen 13 bis 24
Konfigurieren Sie hier die XML Feldzuordnungen gemäß der auszulesenden Daten. In die linke Spalte bitte die Befehle zum Auslesen der Daten einpflegen. In die rechte Spalte können Sie feste, immer wieder kehrende Werte eintragen, z.B. bei "Währung" können Sie "EUR", sofern Ihre Währung IMMER Euro ist.
XML Konfiguration - Teil 2
XML Konfiguration - Teil 3
- Feldzuordung (Teil 3) 49 bis 58
Konfigurieren Sie hier die XML Feldzuordnungen gemäß der auszulesenden Daten. In die linke Spalte bitte die Befehle zum Auslesen der Daten einpflegen. In die rechte Spalte können Sie feste, immer wieder kehrende Werte eintragen, z.B. bei "Währung" können Sie "EUR", sofern Ihre Währung IMMER Euro ist.
- Feldzuordung der Positionen 59 bis 65
Konfigurieren Sie hier die XML Feldzuordnungen gemäß der auszulesenden Daten. In die linke Spalte bitte die Befehle zum Auslesen der Daten einpflegen. In die rechte Spalte können Sie feste, immer wieder kehrende Werte eintragen, z.B. bei "Währung" können Sie "EUR", sofern Ihre Währung IMMER Euro ist.
- Ausgabeformat 66
Hier stellen Sie ein, welches Ausgabeformat die XML-Datei haben soll, welche von BCS geschrieben wird.
Copy: erstellt eine Kopie Ihrer eingelesenen Datei, zuzüglich der Trackingnummer des erstellten Labels.
Simple: erstellt eine Datei mit den grundlegensten Daten, wie Bestellnummer und Trackingnummer.
JAXB: - XSLT 67
Beispiel zur XML-Einrichtung
In der BarcodeShipping-XML-Einrichtung befindet sich unter dem Punkt Feldzuordnung eine zweispaltige Tabelle.
Konfigurationseinträge aus der XML-Datei tragen Sie in die linke Spalte ein.
In die rechte Spalte können Sie feste, immer wiederkehrende Werte eintragen, die nicht aus der XML-Datei ausgelesen werden. Wenn Sie z.B. immer die Währung Euro verwenden, so können Sie auf der rechten Seite, in die entsprechende Zeile (Währung) EUR eintragen.
Beispiel: Aus der XML Datei werden die Daten wie folgt ausgelesen:
Der Aufbau der XML ähnelt einem Code, in dem ein Parent-Attribut steht und darunter die weiteren Attribute.
So wäre die Empfängeradresse unter angegeben. Darunter die einzelnen Attribute wie z.B. (Vorname des Empfängers); (Nachname des Empfängers).
In BarcodeShipping wäre dies z.B. unter Vorname als SHIP_TO/FIRSTNAME/text() einzutragen und für den Nachnamen als SHIP_TO/NAME/text() einzutragen.
Für Artikel (Positionen) gilt das gleiche Schema:
Die Anzahl der Positionen wird in der XML-Datei mit beschrieben und in BarcodeShipping als ITEMS/QUANTITY/text() eingetragen.
