EDI-Anbindung für Dienstleister

Ist das Modul "Electronic Data Interchange" aktiviert, kann die EDI-Anbindung in den Dienstleistereinstellungen konfiguriert werden.

Es werden hierbei die (S)FTP-Einstellungen des Bestelldatenexports genutzt, die in den Dienstleistereinstellungen hinterlegt werden können.

Einstellungen

Einstellung

Beschreibung

Hotfolder für Response-Datei

Angabe des Ordners auf dem externen Server.

Die eigentliche Serververbindung wird in den Dienstleistereinstellungen vorgenommen.

Dateischema für Response-Datei

Wird eine SFTP-Verbindung genutzt, können relevante Dateien mithilfe von regulären Ausdrücken ermittelt werden (beispielsweise: xml_desadv_.*\.xml).

Bei der Verwendung einer FTP-Verbindung können Wildcards genutzt werden (beispielsweise: xml_desadv_*.xml).

Empfehlung: Es sollte der Bestellcode mit in den Dateinamen übernommen werden, um eine bessere Übersicht zu behalten.

Bereits übertragene Datei nicht übertragen

Ist diese Funktion aktiv, wird vor der Übertragung und Verarbeitung geprüft, ob diese Datei bereits abgeholt wurde. Diese Funktion sollte nur dann deaktiviert werden, wenn Bestellpositionen ausschließlich nacheinander verarbeitet werden und die Response-Datei mehrfach angepasst wird (nicht zu empfehlen, da es zu Fehlern bei der Aktualisierung kommen kann).

Musterdatei

<?xml version="1.0"?>
<desadv>
    <header>
        <sender_id>XXX</sender_id>
        <receiver_id>SHOP</receiver_id>
        <reference_nr>XX-001</reference_nr>
        <buyer_order_nr>XXXXXX</buyer_order_nr>
        <date_document>20211109</date_document>
        <time_document>1008</time_document>
        <date_despatch>20211109</date_despatch>
        <date_delivery>20211109</date_delivery>
        <party>
            <party_role>471</party_role>
            <party_id/>
        </party>
        <party>
            <party_role>DP</party_role>
            <party_id/>
        </party>
        <party>
            <party_role>SU</party_role>
            <party_id>XXX</party_id>
        </party>
    </header>
    <body>
        <lineitem>
            <pos_nr>1</pos_nr>
            <ean_nr></ean_nr>
            <buyer_part_nr>2882255</buyer_part_nr>
            <qty>4</qty>
            <delivery_provider>DPD</delivery_provider>
            <delivery_tracking_id>123456789</delivery_tracking_id>
            <delivery_status>SHIPPED</delivery_status>
        </lineitem>
    </body>
</desadv>

Importverhalten

Der Cronjob wird alle 60 Sekunden durchlaufen und versucht die Dateien zu importieren.

Es gibt 2 Modi

Modus 1:
Es sind lineItems angegeben

Die enthaltenen lineItems werden ignoriert und übersprungen, sobald folgende Bedingungen zutreffen:
-es ist keine oder leere buyer_part_nr angegeben (Pflichtfeld)
-es ist keine oder eine leere buyer_order_nr angegeben (Pflichtfeld)
-delivery_status entspricht nicht "SHIPPED"
-die angegebene Bestellposition kann nicht gefunden werden

Sofern ein delivery_provider angegeben wurde und dieser im System gefunden werden kann (bspw. DHL), wird dieser auch der Bestellposition hinzugefügt (optionaler Parameter).
Dieselbe Regelung gilt für die delivery_tracking_id (unabhängig vom delivery_provider – ebenfalls optional).

Modus 2:
Es sind keine lineItems angegeben

In diesem Fall wird die gesamte Bestellung aktualisiert und alle Bestellpositionen mit dem Status "SHIPPED" versehen. Hierbei ist lediglich die buyer_order_nr ein Pflichtfeld.