Kapitel-HauptseiteZurückblätternWeiterblätternBO-Doku Startseite

XML-Erweiterung

 

Die Standard-Schnittstelle (24 Spalten) zum Auftragsimport kann um weitere Kriterien ergänzt werden, indem in der 12. Spalte "Fusstext" XML-Code eingebettet wird.

 

Codierung

Dem eigentlichen XML-Code muss eine Präambel vorausgestellt werden, die Auskunft über die XML-Version und die erwartete Codierung der Importdatei gibt:

 

<?xml version="1.0" encoding="UTF-8" standalone="no" ?>

 

Nur dann ist BO in der Lage, den angelieferten XML-Code richtig zu interpretieren.

 

Format UTF-8

Der Codierungsangabe entsprechend muss die Auftragsimportdatei im Format UTF-8 abgespeichert werden, damit sie korrekt in BO importiert werden kann. Das Format UTF-8 ist in BO v11 zwingend.

 

Nun zum eigentlichen XML-Code:

 

XML

Zwischen dem Start- und Ende-Tag

<PreferencesBO></PreferencesBO> kann z.B. eine abweichende Liefer- oder Rechnungsanschrift, die Email-Adresse oder ein Kommentar des Kunden angeliefert werden.

 

Nachfolgend ein Beispiel, an dem Sie die möglichen Zusatzkriterien ablesen können:

 

<PreferencesBO>

</PreferencesBO>

<?xml version="1.0" encoding="UTF-8" standalone="no" ?>

 

<PreferencesBO>

 

<Neuanlage>-900521</Neuanlage>

 

<Express-Rechnung/>

 

<USTID/>

 

<Kommentar>Bitte keine Teillieferung!</Kommentar>

 

 

<LAnschrift1>Wasserzweckverband Musterdorf</LAnschrift1>

 

<LAnschrift2>Martin Mustermeier</LAnschrift2>

 

<LAnschrift3></LAnschrift3> //neu in BO v20

 

<LStrasse>Ettersdorfer Straße</LStrasse>

 

<LHausnummer>33a</LHausnummer> //neu in BOv16

 

<LPLZ>86044</LPLZ>

 

<LOrt>Musterdorf</LOrt>

 

<LISO_Code/>DE</LISO_Code/> //neu in BO v16

 

<LLand/>

 

<LTelefon/> //neu in BO v16

 

<ExtBestellNr>20174839</ExtBestellNr> //neu in BO v16

 

<RAnschrift1/>

 

<RAnschrift2>Wasserzweckverband Musterdorf</RAnschrift2>

 

<RAnschrift3></RAnschrift3> //neu in BO v20

 

<RStrasse>Ettersdorfer Straße</RStrasse>

 

<RHausnummer>33</RHausnummer> //neu in BO v16

 

<RPLZ>86044</RPLZ>

 

<ROrt>Musterdorf</ROrt>

 

<RLand/>

 

<Email_Vorgang>mustermeier@wasserzweckverband-musterdorf.de</Email_Vorgang>

 

<REmail></REmail> //neu in BO v20

 

<keineTeillieferung/> //neu in BO v16

 

<KopftextAnSich/> //neu in BO v16

 

<FusstextAnSich/> //neu in BO v16

 

<Vertreter>Max Mustermann</Vertreter>

 

</PreferencesBO>

 

Positionsdaten

 

Neu in BO v16 ab Juni 2019:

 

Innerhalb der <PreferencesBO></PreferencesBO> können Positionsdaten im Rahmen eigener Preferences-Tags importiert werden (Angebot und Auftrag). Im Moment sind dies Angaben zum Bestellwesen sowie Rabattcodes (Coupon).

 

<PreferencesOrder>

<PreferencesOrder>

 

<BestellNr/>

 

<BestBezeichnung/>

 

<Free1/>

 

<Free2/>

 

<MandLieferantNr/>

 

<Coupon/>

 

</PreferencesOrder>

 

Hinweise:

 

- Nicht alle XML-Tags müssen beim Import definiert sein. Wenn Sie also z.B. nur eine Bemerkung des Kunden zusätzlich importieren möchten, müssten Sie in der Spalte "Fusstext" folgenden Code eintragen:

 

<PreferencesBO><Kommentar>Das ist die Bemerkung</Kommentar></PreferencesBO>

 

- Möchten Sie jedoch z.B. für den Versand über Logistikschnittstellen wie die Business OPEN shipcloud-Anbindung die Lieferanschrift-Einzelfelder nutzen, muss das XML-Tag <LAnschrift1> zwingend gefüllt sein. Dies ist für BO der Impuls, die restlichen Zeilen der Lieferanschrift in die Einzelfelder aufzulösen.

 

- Die Hausnummer muss hingegen nicht zwingend einzeln angeliefert werden, sondern kann auch innerhalb des LStrasse-Tags angegeben werden. BO extrahiert dann die Hausnummer automatisch aus der Straße, sofern sich zwischen Straße und Hausnummer mindestens ein Leerzeichen befindet.

 

- Die L- und R-Felder, also die Felder, die für eine Übergabe an z.B. shipcloud in Betracht kommen, sind auf eine Länge von 45 Zeichen begrenzt.

 

 

XML-Vorabprüfung in der Schnellerfassungsmaske


Kapitel-HauptseiteZurückblätternWeiterblätternBO-Doku Startseite