Anbindung an einen Versanddienstleister bzw. Fulfillment Dienstleister (XML/CSV/PDF/EDI)

Die Anbindung an einen Fulfillment Dienstleister ermöglicht u.a. die Übertragung von XML Strukturen oder CSV Dateien an einen Fulfiller und im Anschluss das Einlesen der vom Fulfiller zurückgemeldeten Daten wie z.B. Trackingnummern, Lagerbestände, Mindesthaltbarkeitsdaten etc. Die Schnittstelle ermöglicht ebenso ein Einlesen von neuen Kundenaufträgen z.B. aus einer externen Software/Auftragsplattform (z.B. EBISS).

Fulfillment Anbindung

Generell ist es möglich Daten als Datei auf einem Server abzulegen. Diese Daten werden dann vom Fulfiller abgeholt und weiterverarbeitet.Der Fulfiller meldet im Anschlss z.B. 1x Nachts die Trackingnummern, aktualisierte Lagerbestände und z.B. auch MHDs an den Server zurück. Diese Daten werden dann über einen Cronjob von Xentral eingelesen und aktualisiert. Eine Rückmeldung an Shops zur Bestandsaktualisierung oder die Trackingnummer an den Shop als gleichzeitigen Trigger für eine Rechnungs-E-Mail sind parallel möglich. Info:Die Weiterverarbeitung der Daten und das Ablegen der Rückmeldungs-Datei für Xentral mit den notwendigen Feldern wird meist von Seiten des Fulfillers erstellt.

Externe-Plattform Anbindung

Die Schnittstelle ermöglicht ebenso ein Einlesen von neuen Kundenaufträgen z.B. aus einer externen Software/Auftragsplattform (z.B. EBISS).

Ablauf-Schema

In folgendem Schema ist die Interaktion zwischen Xentral, einem Onlineshop/Marktplatz und einem Versanddienstleister/Fulfiller grob dargestellt. :entwickler:fulfillment_uebertragungsstruktur.png Aus Wawision kann eine automatische Übertragung der Belege, wie Lieferscheine oder Aufträge, via XML- oder CSV-Datei zum Versanddienstleister hin, eingerichtet werden. Dabei kann die Übertragung via FTP, FTPS, Email oder in ein lokales Verzeichnis erfolgen.

Einrichtung/Grundeinstellung Übertragung

Welche Grundeinstellungen Sie für die Übertragung vornehmen müssen, erfahren Sie in folgendem Artikel: Grundeinstellung für Übertragungen (EDI / XML / PDF)

Beispiel XML-Dateien

In diesem Abschnitt findet man Beispieldateien für Versanddienstleister bzw. Fulfillmentanbietern.
Lieferschein (Ausgehend von Xentral zu Versanddienstleister)
Hier finden Sie die Datenstruktur des Lieferscheins mit allen notwendigen Feldern. Die PDF-Datei vom Lieferschein bzw. weitere Anhänge findet man im Feld pdf base64-codiert.
<?xml version="1.0" encoding="UTF-8"?>
<response>
   <xml>
      <lieferschein_list>
         <lieferschein>
            <datum>2016-11-10</datum>
            <projekt>1</projekt>
            <lieferscheinart />
            <belegnr>13256</belegnr>
            <bearbeiter>Sachbearbeiter1</bearbeiter>
            <auftrag>AH200019</auftrag>
            <auftragid>15</auftragid>
            <freitext />
            <status>versendet</status>
            <adresse>26</adresse>
            <name>Musterfirma GmbH</name>
            <abteilung />
            <unterabteilung />
            <strasse>Müsterstraße 12</strasse>
            <adresszusatz />
            <ansprechpartner />
            <plz>12345</plz>
            <ort>Musterhausen</ort>
            <land>DE</land>
            <ustid />
            <email>musterfirma@waw.de</email>
            <telefon />
            <telefax />
            <betreff />
            <kundennummer>12000</kundennummer>
            <versandart>DHL</versandart>
            <versand />
            <firma>1</firma>
            <versendet>1</versendet>
            <versendet_am>2016-11-10 12:05:35</versendet_am>
            <versendet_per>sonstiges</versendet_per>
            <versendet_durch>VersandMA1</versendet_durch>
            <inbearbeitung_user>0</inbearbeitung_user>
            <logdatei>2016-11-10 12:06:59</logdatei>
            <vertriebid>0</vertriebid>
            <vertrieb>Johannes Schmid</vertrieb>
            <ust_befreit>0</ust_befreit>
            <ihrebestellnummer />
            <anschreiben />
            <usereditid>1</usereditid>
            <useredittimestamp>2016-11-10 12:06:59</useredittimestamp>
            <lieferantenretoure>0</lieferantenretoure>
            <lieferantenretoureinfo />
            <lieferant>0</lieferant>
            <schreibschutz>1</schreibschutz>
            <pdfarchiviert>0</pdfarchiviert>
            <pdfarchiviertversion>0</pdfarchiviertversion>
            <typ>firma</typ>
            <internebemerkung />
            <ohne_briefpapier>0</ohne_briefpapier>
            <lieferid>0</lieferid>
            <ansprechpartnerid>0</ansprechpartnerid>
            <projektfiliale>0</projektfiliale>
            <projektfiliale_eingelagert>0</projektfiliale_eingelagert>
            <zuarchivieren>0</zuarchivieren>
            <internebezeichnung />
            <angelegtam>0000-00-00 00:00:00</angelegtam>
            <kommissionierung>0</kommissionierung>
            <sprache />
            <bodyzusatz />
            <id_ext />
            <rechnung_name>Musterfirma GmbH</rechnung_name>
            <rechnung_anrede />
            <rechnung_strasse>Musterstrasse 12</rechnung_strasse>
            <rechnung_adresszusatz />
            <rechnung_ansprechpartner>Mustermann</rechnung_ansprechpartner>
            <rechnung_abteilung />
            <rechnung_unterabteilung />
            <rechnung_plz>12345</rechnung_plz>
            <rechnung_ort>Musterhausen</rechnung_ort>
            <rechnung_land>CN</rechnung_land>
            <anzahluebertragungen>1</anzahluebertragungen>
            <lieferschein_position_list>
               <lieferschein_position>
                  <lieferschein>10</lieferschein>
                  <projekt>1</projekt>
                  <bezeichnung>Musterartikel</bezeichnung>
                  <beschreibung />
                  <internerkommentar />
                  <nummer>AI-100-2</nummer>
                  <seriennummer />
                  <menge>3</menge>
                  <lieferdatum>0000-00-00</lieferdatum>
                  <vpe />
                  <sort>1</sort>
                  <status>angelegt</status>
                  <bemerkung />
                  <geliefert>0</geliefert>
                  <abgerechnet>0</abgerechnet>
                  <logdatei>2016-11-10 11:59:02</logdatei>
                  <explodiert_parent_artikel>0</explodiert_parent_artikel>
                  <einheit />
                  <zolltarifnummer>0</zolltarifnummer>
                  <herkunftsland>0</herkunftsland>
                  <artikelnummerkunde />
                  <freifeld1 />
                  <freifeld2 />
                  <freifeld3 />
                  <freifeld4 />
                  <freifeld5 />
                  <freifeld6 />
                  <freifeld7 />
                  <freifeld8 />
                  <freifeld9 />
                  <freifeld10 />
                  <lieferdatumkw>0</lieferdatumkw>
                  <auftrag_position_id>30</auftrag_position_id>
                  <kostenlos>0</kostenlos>
                  <lagertext />
                  <teilprojekt>0</teilprojekt>
                  <explodiert_parent>0</explodiert_parent>
                  <id_ext />
                  <ean />
                  <gewicht />
                  <herstellernummer />
                  <lagerartikel>1</lagerartikel>
               </lieferschein_position>
            </lieferschein_position_list>
         </lieferschein>
      </lieferschein_list>
   </xml>
</response>
Lieferschein mit Stückliste (Ausgehend von Xentral zum Versanddienstleister)
<?xml version="1.0" encoding="UTF-8"?>
<response>
   <xml>
      <lieferschein_list>
         <lieferschein>
            <id>87</id>
            <datum>2017-11-02</datum>
            <projekt>1</projekt>
            <lieferscheinart />
            <belegnr>171102-10</belegnr>
            <bearbeiter>Administrator</bearbeiter>
            <auftrag>200091</auftrag>
            <auftragid>122</auftragid>
            <freitext />
            <status>versendet</status>
            <adresse>2</adresse>
            <name>Beispielkunde</name>
            <abteilung>Wareneingang</abteilung>
            <unterabteilung>Elektronik</unterabteilung>
            <strasse>Rue de bellvue</strasse>
            <adresszusatz />
            <ansprechpartner>Testkontakt</ansprechpartner>
            <plz>1620</plz>
            <ort>Brüssel</ort>
            <land>BE</land>
            <ustid>4545446656446</ustid>
            <email />
            <telefon />
            <telefax />
            <betreff />
            <kundennummer>10003</kundennummer>
            <versandart>DPD</versandart>
            <versand>Administrator</versand>
            <firma>1</firma>
            <versendet>1</versendet>
            <versendet_am>0000-00-00 00:00:00</versendet_am>
            <versendet_per />
            <versendet_durch />
            <inbearbeitung_user>0</inbearbeitung_user>
            <logdatei>2017-11-02 08:55:17</logdatei>
            <vertriebid>1</vertriebid>
            <vertrieb>Administrator</vertrieb>
            <ust_befreit>3</ust_befreit>
            <ihrebestellnummer />
            <anschreiben />
            <usereditid />
            <useredittimestamp>0000-00-00 00:00:00</useredittimestamp>
            <lieferantenretoure>0</lieferantenretoure>
            <lieferantenretoureinfo />
            <lieferant>0</lieferant>
            <schreibschutz>1</schreibschutz>
            <pdfarchiviert>0</pdfarchiviert>
            <pdfarchiviertversion>0</pdfarchiviertversion>
            <typ>firma</typ>
            <internebemerkung />
            <ohne_briefpapier />
            <lieferid>0</lieferid>
            <ansprechpartnerid>0</ansprechpartnerid>
            <projektfiliale>0</projektfiliale>
            <projektfiliale_eingelagert>0</projektfiliale_eingelagert>
            <zuarchivieren>0</zuarchivieren>
            <internebezeichnung />
            <angelegtam />
            <kommissionierung>65</kommissionierung>
            <sprache />
            <bundesland />
            <gln />
            <rechnungid>53</rechnungid>
            <bearbeiterid />
            <bodyzusatz />
            <lieferbedingung />
            <titel />
            <standardlager>0</standardlager>
            <kommissionskonsignationslager>0</kommissionskonsignationslager>
            <abweichendebezeichnung>0</abweichendebezeichnung>
            <id_ext />
            <anzahluebertragungen>1</anzahluebertragungen>
            <rechnung_name>Testkunde</rechnung_name>
            <rechnung_anrede />
            <rechnung_strasse>Musterstrasse 7</rechnung_strasse>
            <rechnung_adresszusatz>Anlieferbereich C</rechnung_adresszusatz>
            <rechnung_ansprechpartner>Testansprechpartner</rechnung_ansprechpartner>
            <rechnung_abteilung>Einkauf</rechnung_abteilung>
            <rechnung_unterabteilung>Technik</rechnung_unterabteilung>
            <rechnung_plz>848415</rechnung_plz>
            <rechnung_ort>Musterhausen</rechnung_ort>
            <rechnung_land>DE</rechnung_land>
            <internet />
            <shopextid />
            <lieferschein_position_list>
               <lieferschein_position>
                  <id>127</id>
                  <lieferschein>87</lieferschein>
                  <artikel>1</artikel>
                  <projekt>1</projekt>
                  <bezeichnung>Muster</bezeichnung>
                  <beschreibung />
                  <internerkommentar />
                  <nummer>1000001</nummer>
                  <seriennummer />
                  <menge>5.0000</menge>
                  <lieferdatum>0000-00-00</lieferdatum>
                  <vpe>1</vpe>
                  <sort>1</sort>
                  <status>angelegt</status>
                  <bemerkung />
                  <geliefert>0.0000</geliefert>
                  <abgerechnet>0</abgerechnet>
                  <logdatei>2017-11-02 08:55:17</logdatei>
                  <explodiert_parent_artikel>0</explodiert_parent_artikel>
                  <einheit />
                  <zolltarifnummer />
                  <herkunftsland />
                  <artikelnummerkunde />
                  <freifeld1 />
                  <freifeld2 />
                  <freifeld3 />
                  <freifeld4 />
                  <freifeld5 />
                  <freifeld6 />
                  <freifeld7 />
                  <freifeld8 />
                  <freifeld9 />
                  <freifeld10 />
                  <lieferdatumkw>0</lieferdatumkw>
                  <auftrag_position_id>226</auftrag_position_id>
                  <kostenlos>0</kostenlos>
                  <lagertext />
                  <teilprojekt>0</teilprojekt>
                  <explodiert_parent>0</explodiert_parent>
                  <freifeld11 />
                  <freifeld12 />
                  <freifeld13 />
                  <freifeld14 />
                  <freifeld15 />
                  <freifeld16 />
                  <freifeld17 />
                  <freifeld18 />
                  <freifeld19 />
                  <freifeld20 />
                  <id_ext />
                  <ean>4001222601064</ean>
                  <gewicht />
                  <herstellernummer />
                  <altersfreigabe />
                  <lagerartikel>0</lagerartikel>
               </lieferschein_position>
               <lieferschein_position>
                  <id>128</id>
                  <lieferschein>87</lieferschein>
                  <artikel>3</artikel>
                  <projekt>1</projekt>
                  <bezeichnung>*** Einbauteil A</bezeichnung>
                  <beschreibung>Lager: HL001(5)</beschreibung>
                  <internerkommentar />
                  <nummer>1000002</nummer>
                  <seriennummer />
                  <menge>5.0000</menge>
                  <lieferdatum>0000-00-00</lieferdatum>
                  <vpe />
                  <sort>2</sort>
                  <status>angelegt</status>
                  <bemerkung />
                  <geliefert>0.0000</geliefert>
                  <abgerechnet>0</abgerechnet>
                  <logdatei>2017-11-02 08:55:17</logdatei>
                  <explodiert_parent_artikel>1</explodiert_parent_artikel>
                  <einheit />
                  <zolltarifnummer>0</zolltarifnummer>
                  <herkunftsland>0</herkunftsland>
                  <artikelnummerkunde />
                  <freifeld1 />
                  <freifeld2 />
                  <freifeld3 />
                  <freifeld4 />
                  <freifeld5 />
                  <freifeld6 />
                  <freifeld7 />
                  <freifeld8 />
                  <freifeld9 />
                  <freifeld10 />
                  <lieferdatumkw>0</lieferdatumkw>
                  <auftrag_position_id>227</auftrag_position_id>
                  <kostenlos>0</kostenlos>
                  <lagertext>HL001 (5)</lagertext>
                  <teilprojekt>0</teilprojekt>
                  <explodiert_parent>127</explodiert_parent>
                  <freifeld11 />
                  <freifeld12 />
                  <freifeld13 />
                  <freifeld14 />
                  <freifeld15 />
                  <freifeld16 />
                  <freifeld17 />
                  <freifeld18 />
                  <freifeld19 />
                  <freifeld20 />
                  <id_ext />
                  <ean />
                  <gewicht />
                  <herstellernummer />
                  <altersfreigabe />
                  <lagerartikel>1</lagerartikel>
               </lieferschein_position>
               <lieferschein_position>
                  <id>129</id>
                  <lieferschein>87</lieferschein>
                  <artikel>4</artikel>
                  <projekt>1</projekt>
                  <bezeichnung>*** Einbaukosten/Stk.</bezeichnung>
                  <beschreibung />
                  <internerkommentar />
                  <nummer>1000004</nummer>
                  <seriennummer />
                  <menge>5.0000</menge>
                  <lieferdatum>0000-00-00</lieferdatum>
                  <vpe />
                  <sort>3</sort>
                  <status>angelegt</status>
                  <bemerkung />
                  <geliefert>0.0000</geliefert>
                  <abgerechnet>0</abgerechnet>
                  <logdatei>2017-11-02 08:55:17</logdatei>
                  <explodiert_parent_artikel>1</explodiert_parent_artikel>
                  <einheit />
                  <zolltarifnummer>0</zolltarifnummer>
                  <herkunftsland>0</herkunftsland>
                  <artikelnummerkunde />
                  <freifeld1 />
                  <freifeld2 />
                  <freifeld3 />
                  <freifeld4 />
                  <freifeld5 />
                  <freifeld6 />
                  <freifeld7 />
                  <freifeld8 />
                  <freifeld9 />
                  <freifeld10 />
                  <lieferdatumkw>0</lieferdatumkw>
                  <auftrag_position_id>228</auftrag_position_id>
                  <kostenlos>0</kostenlos>
                  <lagertext />
                  <teilprojekt>0</teilprojekt>
                  <explodiert_parent>127</explodiert_parent>
                  <freifeld11 />
                  <freifeld12 />
                  <freifeld13 />
                  <freifeld14 />
                  <freifeld15 />
                  <freifeld16 />
                  <freifeld17 />
                  <freifeld18 />
                  <freifeld19 />
                  <freifeld20 />
                  <id_ext />
                  <ean />
                  <gewicht />
                  <herstellernummer />
                  <altersfreigabe />
                  <lagerartikel>0</lagerartikel>
               </lieferschein_position>
               <lieferschein_position>
                  <id>130</id>
                  <lieferschein>87</lieferschein>
                  <artikel>17</artikel>
                  <projekt>1</projekt>
                  <bezeichnung>*** Einbauteil B</bezeichnung>
                  <beschreibung>Lager: HL001(10)</beschreibung>
                  <internerkommentar />
                  <nummer>1000008</nummer>
                  <seriennummer />
                  <menge>10.0000</menge>
                  <lieferdatum>0000-00-00</lieferdatum>
                  <vpe />
                  <sort>4</sort>
                  <status>angelegt</status>
                  <bemerkung />
                  <geliefert>0.0000</geliefert>
                  <abgerechnet>0</abgerechnet>
                  <logdatei>2017-11-02 08:55:17</logdatei>
                  <explodiert_parent_artikel>1</explodiert_parent_artikel>
                  <einheit />
                  <zolltarifnummer>0</zolltarifnummer>
                  <herkunftsland>0</herkunftsland>
                  <artikelnummerkunde />
                  <freifeld1 />
                  <freifeld2 />
                  <freifeld3 />
                  <freifeld4 />
                  <freifeld5 />
                  <freifeld6 />
                  <freifeld7 />
                  <freifeld8 />
                  <freifeld9 />
                  <freifeld10 />
                  <lieferdatumkw>0</lieferdatumkw>
                  <auftrag_position_id>229</auftrag_position_id>
                  <kostenlos>0</kostenlos>
                  <lagertext>HL001 (10)</lagertext>
                  <teilprojekt>0</teilprojekt>
                  <explodiert_parent>127</explodiert_parent>
                  <freifeld11 />
                  <freifeld12 />
                  <freifeld13 />
                  <freifeld14 />
                  <freifeld15 />
                  <freifeld16 />
                  <freifeld17 />
                  <freifeld18 />
                  <freifeld19 />
                  <freifeld20 />
                  <id_ext />
                  <ean />
                  <gewicht />
                  <herstellernummer />
                  <altersfreigabe />
                  <lagerartikel>1</lagerartikel>
               </lieferschein_position>
            </lieferschein_position_list>
         </lieferschein>
      </lieferschein_list>
   </xml>
   <status>
      <action>belege</action>
      <message>OK</message>
      <messageCode>1</messageCode>
   </status>
</response>
Info Artikelübertragung: Für die Übertragung an den Fulfiller können die Lagerartikel im Lieferschein ausgefiltert werden. Im Projekt ist bei den Logistikoptionen folgende Einstellung möglich: "Nur Lagerartikel übernehmen beim Weiterführen von Auftrag zu Lieferschein" Das XML hat hierfür folgenden Wert: Lagerartikel =0 oder =1 → der Setartikel ist z.B. kein Lagerartikel, die Unterartikel dieser Stückliste aber schon. Eine normale Stückliste ist ein Lagerartikel.
Antwort Lieferschein Rückmeldung Trackingnummer (Eingehend zu Xentral)
Die Trackingnummer wird Xentral über diese Datei gemeldet. In einer Datei können mehrere Lieferscheine gemeldet werden. Pflichtangabe:
  • tracking
  • belegnr des Lieferscheins
Optional
  • id vom Lieferschein
  • lieferschein positionen
  • in den lieferschein_positionen kann man statt id auch sort als Feld verwenden (das ist dann die Position von 1 bis x im Lieferschein)
<?xml version="1.0" encoding="UTF-8"?>
<response>
  <xml>
    <lieferschein_list>
      <lieferschein>
        <belegnr>121212</belegnr>
        <tracking>1234567890</tracking>
        <tracking_link>http://dhl.de/sendungsverfolgung?tracking=123456</tracking_link>
        <tracking_sprache>english</tracking_sprache>
        <lieferschein_position_list>
          <lieferschein_position>
            <id>105</id>
            <geliefert>1</geliefert>
          </lieferschein_position>
        </lieferschein_position_list>
      </lieferschein>
    </lieferschein_list>
  </xml>
</response>
oder wenn es basierend auf dem Auftrag zurückgesendet wird entsprechend so:
<?xml version="1.0" encoding="UTF-8"?>
<response>
  <xml>
    <lieferschein_list>
      <lieferschein>
        <auftragextid>78787878</auftragextid>
        <tracking>1234567890</tracking>
        <tracking_link>http://dhl.de/sendungsverfolgung?tracking=123456</tracking_link>
        <tracking_sprache>english</tracking_sprache>     
      </lieferschein>
    </lieferschein_list>
  </xml>
</response>
Hinweis: auftragextid ist die Belegnummer vom originalen Auftrag.
Rückmeldung mehrerer Trackingnummern in einer Datei:
<?xml version="1.0" encoding="UTF-8"?>
<response>
  <xml>
    <lieferschein_list>
      <lieferschein>
        <belegnr>200001</belegnr>
        <tracking>12345678901231</tracking>
        <tracking_link>https://nolp.dhl.de/nextt-online-public/de/search?piececode=12345678901231</tracking_link>
        <tracking_sprache>german</tracking_sprache>
        <lieferschein_position_list>
          <lieferschein_position>
            <id>1</id>
            <geliefert>12</geliefert>
          </lieferschein_position>
          <lieferschein_position>
            <id>2</id>
            <geliefert>2</geliefert>
          </lieferschein_position>
        </lieferschein_position_list>
      </lieferschein>
      <lieferschein>
        <belegnr>200001</belegnr>
        <tracking>12345678901232</tracking>
        <tracking_link>https://nolp.dhl.de/nextt-online-public/de/search?piececode=12345678901232</tracking_link>
        <tracking_sprache>german</tracking_sprache>
        <lieferschein_position_list>
          <lieferschein_position>
            <id>3</id>
            <geliefert>4</geliefert>
          </lieferschein_position>
        </lieferschein_position_list>
      </lieferschein>
    </lieferschein_list>
  </xml>
</response>
Hinweis: Folgender Block wird hier mehrfach wiederholt: <lieferschein> <belegnr>200001</belegnr> <tracking>12345678901232</tracking> <tracking_link>https://nolp.dhl.de/nextt-online-public/de/search?piececode=12345678901232</tracking_link> <tracking_sprache>german</tracking_sprache> <lieferschein_position_list> <lieferschein_position> <id>3</id> <geliefert>4</geliefert> </lieferschein_position> </lieferschein_position_list> </lieferschein>
Bestandsdatei/ Lagerbestände (Eingehend zu Xentral)
Im folgenden finden Sie die benötigte Bestandsdatei für die Rückmeldung der Lagerzahlen. Optional kann man bei Artikel mit Mindesthaltbarkeitsdatum noch das Feld mhd oder Charge charge hinzufügen. Dann wird das Datum für die gemeldete Menge und dem Lagerzahlen eingetragen auf dem optional angegeben Lagerplatz lager_platz eingelagert.
  • nummer → Artikelnummer
  • lagerzahl → neuer Lagerbestand total
  • lager_platz → Regalname von Xentral z.B. HL001
Wichtiger Hinweis: Die Rückmeldung der Bestände des Fulfillers ist so zu koordinieren, dass folgender Ablauf gewährleistet ist:
  • Xentral übermittelt Aufträge mit Lagerabzug (Fulfillmentlager) an den Fulfiller
  • Der Fulfiller arbeitet ALLE offenen Aufträge ab
  • ->>> somit ist das Lager auf beiden Seiten ausgeglichen (bis auf Bestandsänderungen Retouren, Wareneingänge)
  • erst jetz erfolgt die Meldung der Lagerbestände des Fulfillers zurück nach Xentral (im Idealfall Abends oder nachts, bei geringen Bestandsänderungen z.B. nur einmal wöchentlich, z.B. am Wochenende)
<?xml version="1.0" encoding="UTF-8"?>
<response>
  <xml>
    <artikel_list>
      <artikel>
        <nummer>123456</nummer>
        <lagerzahl>7</lagerzahl>
        <lager_platz>HL001</lager_platz>
      </artikel>
    </artikel_list>
  </xml>
</response>
Mit mindestens 2 MHDs sieht die Struktur so aus:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<response xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <xml>
    <artikel_list>
      <artikel>
        <nummer>1650007</nummer>
        <lagerzahl>3</lagerzahl>
        <lager_platz>KR-HR-11</lager_platz>
        <mhd>30.10.2018</mhd>
      </artikel>
      <artikel>
        <nummer>1650007</nummer>
        <lagerzahl>3</lagerzahl>
        <lager_platz>KR-HR-12</lager_platz>
        <mhd>15.02.2019</mhd>
      </artikel>
    </artikel_list>
  </xml>
</response>
Auftrag (Eingehend zu Xentral)
<?xml version="1.0" encoding="UTF-8"?>
<response>
   <xml>
      <auftrag_list>
         <auftrag>
            <datum>2016-12-14</datum>
            <projekt>1</projekt>
            <auftragart />
            <extid />
            <bearbeiter>Administrator Bruno</bearbeiter>
            <freitext />
            <status>freigegeben</status>
            <name>Musterfirma &amp; Sohn GmbH</name>
            <abteilung />
            <unterabteilung />
            <strasse>Musterstrasse 1</strasse>
            <adresszusatz />
            <ansprechpartner />
            <plz>86343</plz>
            <ort>Musterstadt</ort>
            <land>DE</land>
            <ustid />
            <email>bla@example.com</email>
            <telefon />
            <telefax />
            <betreff />
            <kundennummer />
            <versandart>DHL</versandart>
            <ust_befreit>0</ust_befreit>
            <ihrebestellnummer />
            <anschreiben />
            <typ>firma</typ>
            <internebemerkung />
            <ohne_briefpapier />
            <internebezeichnung />
            <sprache />           
            <absender />
            <bundesland />
            <gln />
            <id_ext />
            <rechnung_name />
            <rechnung_anrede />
            <rechnung_strasse />
            <rechnung_adresszusatz />
            <rechnung_ansprechpartner />
            <rechnung_abteilung />
            <rechnung_unterabteilung />
            <rechnung_plz />
            <rechnung_ort />
            <rechnung_land>DE</rechnung_land>
            <auftrag_position_list>
               <auftrag_position>
                  <bezeichnung>Name 1</bezeichnung>
                  <beschreibung />
                  <nummer>100001</nummer>
                  <menge>1</menge>
                  <preis>12,95</preis>
                  <lieferdatum>2017-01-01</lieferdatum>
               </auftrag_position>
                <auftrag_position>
                  <bezeichnung>Name 2</bezeichnung>
                  <beschreibung />
                  <nummer>100002</nummer>
                  <menge>3,4</menge>
                  <preis>12,95</preis>
               </auftrag_position>
            </auftrag_position_list>
         </auftrag>
      </auftrag_list>
   </xml>
</response>
Datei in XML-Struktur ergänzen Ab der Version 18.2 ist es möglich im tag <dateiname> einen Pfad zu einer Datei anzugeben anstatt die base64 codierte Datei im tag <dateiinhalt> einzufügen.
Bestellung (Eingehend zu Xentral)
<?xml version="1.0" encoding="UTF-8"?>
<response>
   <xml>
      <bestellung_list>
         <bestellung>
            <id>30</id>
            <datum>2017-11-02</datum>
            <projekt>1</projekt>
            <bestellungsart />
            <belegnr>100023</belegnr>
            <bearbeiter>Administrator</bearbeiter>
            <angebot />
            <freitext>Bitte aufs Sperrlager einlagern</freitext>
            <internebemerkung />
            <status>versendet</status>
            <adresse>6</adresse>
            <name>Meine Firma</name>
            <vorname />
            <abteilung>Entwicklung/Produktion</abteilung>
            <unterabteilung />
            <strasse>Musterstrasse 6</strasse>
            <adresszusatz>Eingang C</adresszusatz>
            <plz>49646</plz>
            <ort>Musterhausen</ort>
            <land>DE</land>
            <abweichendelieferadresse>1</abweichendelieferadresse>
            <liefername>Testempfänger</liefername>
            <lieferabteilung>Logistik</lieferabteilung>
            <lieferunterabteilung />
            <lieferland>DE</lieferland>
            <lieferstrasse>Musterstrasse 7</lieferstrasse>
            <lieferort>Musterhausen</lieferort>
            <lieferplz>85344</lieferplz>
            <lieferadresszusatz>Tor 3</lieferadresszusatz>
            <lieferansprechpartner>Ansprechpartner Lieferadresse</lieferansprechpartner>
            <ustid>4648448649848</ustid>
            <ust_befreit>0</ust_befreit>
            <email>testmail@web.de</email>
            <telefon>082126841041</telefon>
            <telefax>081664644565</telefax>
            <betreff />
            <kundennummer />
            <lieferantennummer>70004</lieferantennummer>
            <versandart />
            <lieferdatum>0000-00-00</lieferdatum>
            <einkaeufer />
            <keineartikelnummern>0</keineartikelnummern>
            <zahlungsweise>rechnung</zahlungsweise>
            <zahlungsstatus />
            <zahlungszieltage>0</zahlungszieltage>
            <zahlungszieltageskonto>0</zahlungszieltageskonto>
            <zahlungszielskonto>0.00</zahlungszielskonto>
            <gesamtsumme>1.1900</gesamtsumme>
            <bank_inhaber />
            <bank_institut />
            <bank_blz>0</bank_blz>
            <bank_konto>0</bank_konto>
            <paypalaccount />
            <bestellbestaetigung>0</bestellbestaetigung>
            <firma>1</firma>
            <versendet>1</versendet>
            <versendet_am>2017-11-02 07:34:26</versendet_am>
            <versendet_per>sonstiges</versendet_per>
            <versendet_durch>Administrator</versendet_durch>
            <logdatei>2017-11-02 07:35:54</logdatei>
            <artikelnummerninfotext>0</artikelnummerninfotext>
            <ansprechpartner>Testansprechpartner</ansprechpartner>
            <anschreiben />
            <usereditid>1</usereditid>
            <useredittimestamp>2017-11-02 07:35:54</useredittimestamp>
            <steuersatz_normal>19.00</steuersatz_normal>
            <steuersatz_zwischen>7.00</steuersatz_zwischen>
            <steuersatz_ermaessigt>7.00</steuersatz_ermaessigt>
            <steuersatz_starkermaessigt>7.00</steuersatz_starkermaessigt>
            <steuersatz_dienstleistung>7.00</steuersatz_dienstleistung>
            <waehrung>EUR</waehrung>
            <bestellungohnepreis>0</bestellungohnepreis>
            <schreibschutz>1</schreibschutz>
            <pdfarchiviert>0</pdfarchiviert>
            <pdfarchiviertversion>0</pdfarchiviertversion>
            <typ>firma</typ>
            <verbindlichkeiteninfo />
            <ohne_briefpapier>0</ohne_briefpapier>
            <projektfiliale>0</projektfiliale>
            <bestellung_bestaetigt>0</bestellung_bestaetigt>
            <bestaetigteslieferdatum>0000-00-00</bestaetigteslieferdatum>
            <bestellungbestaetigtper>internet</bestellungbestaetigtper>
            <bestellungbestaetigtabnummer />
            <gewuenschteslieferdatum>0000-00-00</gewuenschteslieferdatum>
            <zuarchivieren>0</zuarchivieren>
            <internebezeichnung />
            <angelegtam>0000-00-00 00:00:00</angelegtam>
            <preisanfrageid>0</preisanfrageid>
            <sprache>deutsch</sprache>
            <kundennummerlieferant />
            <bodyzusatz />
            <lieferbedingung />
            <titel />
            <liefertitel />
            <skontobetrag>0.0000</skontobetrag>
            <langeartikelnummern>0</langeartikelnummern>
            <skontoberechnet>0</skontoberechnet>
            <id_ext />
            <anzahluebertragungen>1</anzahluebertragungen>
            <rabatt>0</rabatt>
            <gebuehr>0</gebuehr>
            <ust>0</ust>
            <bestellung_position_list>
               <bestellung_position>
                  <id>31</id>
                  <bestellung>30</bestellung>
                  <artikel>10</artikel>
                  <projekt>1</projekt>
                  <bezeichnunglieferant>Steckverbindung c10</bezeichnunglieferant>
                  <bestellnummer>Seriennummernartikel XY</bestellnummer>
                  <beschreibung />
                  <menge>2.0000</menge>
                  <preis>0.50000000</preis>
                  <waehrung>EUR</waehrung>
                  <lieferdatum>2017-11-30</lieferdatum>
                  <vpe>24</vpe>
                  <sort>1</sort>
                  <status>angelegt</status>
                  <umsatzsteuer />
                  <bemerkung />
                  <geliefert>0.0000</geliefert>
                  <mengemanuellgeliefertaktiviert>0</mengemanuellgeliefertaktiviert>
                  <manuellgeliefertbearbeiter />
                  <abgerechnet>0</abgerechnet>
                  <logdatei>2017-11-02 07:29:13</logdatei>
                  <abgeschlossen>0</abgeschlossen>
                  <einheit />
                  <zolltarifnummer>0</zolltarifnummer>
                  <herkunftsland>0</herkunftsland>
                  <artikelnummerkunde />
                  <auftrag_position_id>0</auftrag_position_id>
                  <preisanfrage_position_id>0</preisanfrage_position_id>
                  <freifeld1 />
                  <freifeld2 />
                  <freifeld3 />
                  <freifeld4 />
                  <freifeld5 />
                  <freifeld6 />
                  <freifeld7 />
                  <freifeld8 />
                  <freifeld9 />
                  <freifeld10 />
                  <auswahlmenge>0.0000</auswahlmenge>
                  <auswahletiketten>0</auswahletiketten>
                  <auswahllagerplatz>0</auswahllagerplatz>
                  <teilprojekt>0</teilprojekt>
                  <steuersatz>-1.00</steuersatz>
                  <steuertext />
                  <erloese />
                  <erloesefestschreiben>0</erloesefestschreiben>
                  <freifeld11 />
                  <freifeld12 />
                  <freifeld13 />
                  <freifeld14 />
                  <freifeld15 />
                  <freifeld16 />
                  <freifeld17 />
                  <freifeld18 />
                  <freifeld19 />
                  <freifeld20 />
                  <skontobetrag>0.0000</skontobetrag>
                  <id_ext />
                  <ean />
                  <gewicht />
                  <herstellernummer />
                  <altersfreigabe />
                  <lagerartikel>1</lagerartikel>
               </bestellung_position>
            </bestellung_position_list>
         </bestellung>
      </bestellung_list>
   </xml>
   <status>
      <action>belege</action>
      <message>OK</message>
      <messageCode>1</messageCode>
   </status>
</response>
Wareneingang (Eingehend zu Xentral)
<?xml version="1.0" encoding="UTF-8"?>
<response>
   <xml>
      <bestellung_list>
         <bestellung>
            <id>7</id>
            <belegnr>optional</belegnr>
            <bestellung_position_list>
               <bestellung_position>
                  <id>12</id>
                  <nummer>optional</nummer>
                  <geliefert>1</geliefert>
               </bestellung_position>
               <bestellung_position>
                  <id>13</id>
                  <geliefert>3</geliefert>
                  <nummer>optional</nummer>
               </bestellung_position>
            </bestellung_position_list>
         </bestellung>
         <bestellung>
            <id>8</id>
            <bestellung_position_list>
               <bestellung_position>
                  <id>14</id>
                  <nummer>optional</nummer>
                  <geliefert>3</geliefert>
               </bestellung_position>
            </bestellung_position_list>
         </bestellung>
      </bestellung_list>
   </xml>
   <status>
      <action>bestellunge</action>
      <message>OK</message>
      <messageCode>1</messageCode>
   </status>
</response>

Beispiel CSV-Dateien

Musterdaten als CSV
Mittlerweile gibt es für alle oben genannten XML Dateien auch passende CSV Dateien. Zudem kann man im Übertragen-Modul die Spalten über ein einfaches Mapping einstellen. Bei Fragen zu dem Thema kontaktieren Sie bitte unseren Support oder Vertrieb.
Antwort Lieferschein Rückmeldung Trackingnummer (Eingehend zu Xentral) als CSV
Die Trackingnummer wird Xentral über diese Datei im CSV Format gemeldet. Die Zellentrennung erfolgt mit einem Semikolon. Die auftragextid ist die Auftrag-ID des Verkäufers der den zugehörigen Auftrag zum Fulfiller gesendet hat. Beispiel im CSV Format: belegnr;auftragextid;tracking;tracking_link 20000;8;1234567890;https://example.com/?tracking=1234567890
belegnr auftragextid tracking tracking_link
20000 8 1234567890 https://example.com/?tracking=1234567890

Kundenspezifischer fileconverter

Mit den fileconvertern kann man in Xentral von einem nahe zu beliebigen maschinenlesbaren Format zu dem Xentral XML Format umwandeln. Dies kann man immer dann nutzen, wenn es auf der Gegenstelle keine Möglichkeit gibt auf das Format von Xentral XML zu reagieren. fileconverter sind immer kundenspezifisch entwickelt --> bitte nehmen Sie hierfür Kontakt zu unserem Vertrieb auf Sollte das Dateiformat des Fulfillers von dem aus Wawision ausgehenden Belegen abweichen bzw. dieser selbst kein Mapping vornehmen möchte, dann kann man diese von einem speziellen Prozessstarter(Parameter=fileconverter) abholen und konvertieren lassen. Dieser liegt als PHP-Datei im Ordner Cronjobs. Dieser kann zyklisch, zum Beispiel jede Stunde, oder zu einem festen Zeitpunkt augerufen werden.
Funtionsweise des fileconverters/Ablauf des Konvertierungsvorgangs
Voraussetzung für die Verwendung des fileconverters ist die Ablage der XML-Datei in ein lokales Verzeichnis. Wählen Sie hierzu die bereits erwähnte Übertragungsart im Modul. Als Eingabe dient nun das aus Wawision ausgehende XML Format, welches im lokalen Verzeichnis bereitgestellt wird. Der fileconverter liest alle im Verzeichnis befindlichen Dateien aus und wandelt diese in das Zielformat des Kunden bzw. Versanddienstleisters um.
Monitoring der Konvertierung
Im Übertragungsmodul finden Sie im Reiter "logfile converter" den Start-und Endzeitpunkt der Kovertierung. Die umgewandelte Datei wird im Anschluss entweder automatisch per FTP/FTPS oder per Mail übertragen oder kann beim gesetzten Haken "Manuelle Freigabe erforderlich" aus dem Reiter "zu Übertragen" manuell angestoßen werden. Diese Einstellung ist vorallem bei der Einrichtung des Moduls zu empfehlen. Bitte folgende Vorraussetzungen beachten:
  • Lieferschein muss den Status des Übertragungsmoduls besitzen
  • Sollte ein Mitarbeiter einen Auftrag manuell als Lieferschein weiterführt, ist darauf zu achten, dass der Lieferschein auf den eigetragenen Status (Freigegeben/Versendet etc.) gesetzt werden muss.
War der Artikel hilfreich?
Vielen Dank für Ihr Feedback!

Made with ❤ at zwetschke.de