Info@ybm.support

ybm_logo_neu_2024

UNSER SUPPORT HILFT INFORMIEREN SIE SICH IM WIKI ERSTELLEN SIE EIN TICKET

Inhalt

Produkte

Integrationen

Versanddienste

Beispiele

Funktionen

XML-Stapelverarbeitung in BarcodeShipping


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 Deinem Shopsystem nach BarcodeShipping übertragen werden sollen) und „BCS 2 Wawi“ (für alle Daten, die von BarcodeShipping in Dein Shopsystem übertragen werden).
 
Zuerst werden mit den Daten aus Deinem Shopsystem CSV/XML-Dateien erstellt. Jede Zeile enthält eine Bestellung, inklusive aller für den Versandprozess notwendigen Daten – beispielsweise Empfängeradresse und bestellte Artikel. Diese Datei wird im Ordner „Wawi 2 BCS“ gespeichert. Du kannst in den Einstellungen von BarcodeShipping den Pfad zu diesem Ordner hinterlegen, damit BarcodeShipping automatisch auf diesen Ordner zugreifen und regelmäßig prüfen kann, ob neue Dateien vorhanden sind.
 
Darüber hinaus kannst Du in BarcodeShipping das Mapping einrichten und den Spalten die passenden Werte zuordnen, die aus der Tabelle ausgelesen werden sollen. Wenn Du einen Wert nicht aus Deinem Shop exportieren kannst, 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 kannst Du 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“ verschoben.
 
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 inklusive Trackingnummer.
 
Dein Shopsystem prüft mehrmals pro Minute den Ordner auf neue Dateien. Dadurch werden alle Bestellungen umgehend auch in Deinem Wawi als „vollständig“ markiert und die Trackingnummer dort gespeichert.

XML Konfiguration - Teil 1

(Stand: 20.03.2026 – Version 2311)

1

Aktivieren:
Aktiviere hier die XML-Stapelverarbeitung für das unten
links ausgewählte Profil.
2

Berechne Paketgewicht:
Aktiviere diese Checkbox, wenn BarcodeShipping das
Paketgewicht aus den Artikelgewichten ausrechnen soll.
Voraussetzung dafür ist natürlich die Übergabe der
Artikelgewichte.
3

Abfrageverzeichnis (Eingang):
Wähle hier das Verzeichnis aus, in dem die XML-Dateien
abgelegt werden und von BarcodeShipping eingelesen
werden sollen.
4

Filtern:
Gib hier einen Filter für die Dateiformate an. Die vorgegebenen Standardwerte reichen im Normalfall aus.
5

Ausgabeverzeichnis (Ausgang):
Wähle hier das Verzeichnis aus, in das BarcodeShipping die
Ausgabe-XML-Dateien ablegen soll, zur Rückgabe an Dein
Shop-/WaWi-System.
6

Vorlage für Dateinamen:
Konfiguriere hier den Dateinamen der Ausgabedatei
mit Hilfe von Variablen. Eine Liste der möglichen Variablen
findest du im Link unten ...
7

Lese Wartezeit:
Gib hier in Sekunden an, wie lange BarcodeShipping warten
soll, bevor es anfängt, die Datei(en) einzulesen.
Eine längere Wartezeit kann zum Beispiel hilfreich sein bei
langsamen Druckern oder bei Druckern, deren
Arbeitsspeicher sehr klein ist. Hiermit wird die Erzeugung
eines Druckauftrags verlangsamt.
8

Parse Adresse:
Wenn Deine Adressdaten (Straße und Hausnummer) nur in
einer Spalte eingetragen sind, der Versender diese aber
separiert verlangt, aktiviere diese Checkbox.
9

Parse Namen:
Wenn Vor- und Zuname des Empfängers in nur einer Spalte
zusammengefasst sind, der Versender diese aber separiert
benötigt, aktiviere diese Checkbox.
10

Erzwinge Ein-Paketsendung:
Wenn deine Datei mehrere Sendungen/Bestellungen
enthält, kann mit der Aktivierung dieser Checkbox für jede
Sendung ein Paket erzwungen werden.
11

Unterstützung für XML Namensräume aktivieren:
...
12

Zeichensatz (Format):
Wähle hier das Zeichensatzformat aus, mit dem deine
XML-Datei geschrieben wurde. Wir empfehlen UTF-8.
13 - 58

Feldzuordnungen:
Konfiguriere hier die XML-Feldzuordnungen gemäß der
auszulesenden Daten. In die linke Spalte bitte die Befehle
zum Auslesen der Daten einpflegen. In die rechte Spalte
kannst Du feste, immer wiederkehrende Werte eintragen,
zum Beispiel bei "Währung" kannst Du "EUR" eintragen,
sofern Deine Währung IMMER Euro ist.

Aktiviere hier die XML-Stapelverarbeitung für das unten links ausgewählte Profil.

Aktiviere diese Checkbox, wenn BarcodeShipping das Paketgewicht aus den Artikelgewichten ausrechnen soll. Voraussetzung dafür ist natürlich die Übergabe der Artikelgewichte.

Wähle hier das Verzeichnis aus, in dem die XML-Dateien abgelegt werden und von BarcodeShipping eingelesen werden sollen.

Gib hier einen Filter für die Dateiformate an.
Die vorgegebenen Standardwerte reichen im Normalfall aus.

Wähle hier das Verzeichnis aus, in das BarcodeShipping die Ausgabe-XML-Dateien ablegen soll,
zur Rückgabe an Dein Shop-/WaWi-System.

Konfiguriere hier den Dateinamen der Ausgabedatei mithilfe von Variablen.
Eine Liste der möglichen Variablen findest du hier.

Gib hier in Sekunden an, wie lange BarcodeShipping warten soll, bevor es anfängt, die Datei(en) einzulesen. Eine längere Wartezeit kann zum Beispiel hilfreich sein, bei langsamen Druckern oder bei Druckern, deren Arbeitsspeicher sehr klein ist. Hiermit wird die Erzeugung eines Druckauftrags verlangsamt.

Wenn Deine Adressdaten (Straße und Hausnummer) nur in einer Spalte eingetragen sind, der Versender diese aber separiert verlangt, aktiviere diese Checkbox.

Wenn Vor- und Zuname des Empfängers in nur einer Spalte zusammengefasst sind, der Versender diese aber separiert benötigt, aktiviere diese Checkbox.

Wenn deine Datei mehrere Sendungen/Bestellungen enthält, kann mit der Aktivierung dieser Checkbox für jede Sendung ein Paket erzwungen werden.

…

Wähle hier das Zeichensatzformat aus, mit dem Deine XML-Datei geschrieben wurde.
Wir empfehlen UTF-8.

Konfiguriere hier die XML-Feldzuordnungen gemäß der auszulesenden Daten.
In die linke Spalte bitte die Befehle zum Auslesen der Daten einpflegen.
In die rechte Spalte kannst Du feste, immer wiederkehrende Werte eintragen, zum Beispiel bei „Währung“ kannst Du „EUR“ eintragen, sofern Deine Währung IMMER Euro ist.

XML Konfiguration - Teil 2

59. Feldzuordung der Positionen

Konfiguriere hier die XML-Feldzuordnungen gemäß der auszulesenden Daten.
In die linke Spalte bitte die Befehle zum Auslesen der Daten einpflegen.
In die rechte Spalte kannst du feste, immer wiederkehrende Werte eintragen, z.B. bei „Währung“ kannst du „EUR“ eintragen, sofern deine Währung IMMER Euro ist.

Hier stellst du ein, welches Ausgabeformat die XML-Datei haben soll, welche von BCS geschrieben wird.
Copy: erstellt eine Kopie deiner eingelesenen Datei, zuzüglich der Trackingnummer
des erstellten Labels.
Simple: erstellt eine Datei mit den grundlegendsten Daten, wie Bestellnummer und Trackingnummer.
JAXB:

…

Beispiel zur XML-Einrichtung

In der BarcodeShipping-XML-Einrichtung befindet sich unter dem Punkt Feldzuordnung eine zweispaltige Tabelle.
 
Konfigurationseinträge aus der XML-Datei trägst du in die linke Spalte ein.
 
In die rechte Spalte kannst du feste, immer wiederkehrende Werte eintragen, die nicht aus der XML-Datei ausgelesen werden. Wenn du z. B. immer die Währung Euro verwendest, so kannst du 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 <ship_to> 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 <quantity> beschrieben und in BarcodeShipping als ITEMS/QUANTITY/text() eingetragen.