DF ERP Bridge — Geplanter ERP-Export (Sage 100, EBP, Cegid, Codial)

DF ERP Bridge exportiert Ihre PrestaShop-Bestellungen, –Kunden und –Bestände automatisch in Ihre Warenwirtschaft — Sage 100, EBP, Cegid, Codial — oder in ein generisches CSV-, XML- oder JSON-Format. Die Dateien werden im von Ihnen festgelegten Takt erzeugt und automatisch per FTP/FTPS oder E-Mail zugestellt, gesteuert durch einen Cron. Dieser Leitfaden behandelt Installation, Profilerstellung, Formate, Transporte, Planung und Sicherheit.

Installation

1. Öffnen Sie im Back-Office Module > Modulmanager, klicken Sie auf Modul hochladen und legen Sie die Datei dferpbridge.zip ab.
2. Klicken Sie nach der Installation auf Konfigurieren.
3. Bei der ersten Installation wird automatisch ein Cron-Token erzeugt und die Protokoll-Aufbewahrung auf 30 Tage gesetzt. Beides lässt sich im Abschnitt Einstellungen am Ende der Konfigurationsseite ändern.

Ein Export-Profil erstellen

Ein Profil beschreibt einen Export: welche Daten, in welchem Format, an welches Ziel und wie oft. Sie können beliebig viele Profile erstellen. Klicken Sie auf Profil hinzufügen und füllen Sie die Felder aus.

Hauptfelder

• Profilname — eine Bezeichnung zur Identifizierung (z. B. „Bestellungen an Sage — täglich“).
• Zu exportierende Daten — Bestellungen, Kunden oder Bestand.
• ERP-Format — Sage 100, EBP, Cegid, Codial oder ein generisches CSV- / XML- / JSON-Format.
• Transport — FTP-Upload oder E-Mail-Anhang.
• Frequenz — Stündlich, Täglich oder Wöchentlich. Wird bei jedem Cron-Aufruf ausgewertet.
• Bestellstatus-Filter — (nur Bestellungen) Mehrfachauswahl; leer lassen, um alle Status zu exportieren.
• Inkrementeller Export — exportiert nur die seit dem letzten Durchlauf erstellten Datensätze.
• Aktiv — ein inaktives Profil wird vom Cron übersprungen, kann aber manuell ausgeführt werden.

Die Export-Formate

Die vier ERP-Presets werden in Windows-1252-Kodierung erzeugt, mit Semikolon als Trennzeichen, CRLF-Zeilenenden und Komma-Dezimalstellen — die von französischen Import-Werkzeugen erwartete Konvention. Die generischen Formate werden in UTF-8 ausgegeben.

Sage 100

Zweistufige .txt-Datei: „E“-Kopfzeilen gefolgt von ihren „L“-Detailzeilen, in einer mit dem Dokumentenimport von Sage 100 Gestion Commerciale kompatiblen Struktur. Versandkosten werden als eigene „PORT“-Zeile hinzugefügt. Die Spaltenreihenfolge lässt sich im Assistenten „konfigurierbares Importformat“ von Sage neu zuordnen.

EBP

Flache .csv-Datei mit Kopfzeile, eine Zeile pro Bestellposition (Kopffelder werden wiederholt). Geeignet für den konfigurierbaren Import von EBP Gestion Commerciale.

Cegid

.xml-Dokument, strukturiert als DOCUMENTS / DOCUMENT mit einem ENTETE-Block und einem LIGNES-Block, für die Dokumentenintegration im Stil von Cegid Business / XRP Flex.

Codial

Flache .csv-Datei mit Kopfzeilen, eine Zeile pro Bestellposition, ausgelegt für das konfigurierbare Importmodul von Codial.

Generische CSV / XML / JSON

Für jedes andere Werkzeug (Odoo, Dolibarr, ein eigenes ERP, eine Tabelle) exportieren diese Formate alle Felder in UTF-8. Die generische CSV enthält ein BOM für das saubere Öffnen in Excel; das XML verschachtelt die Positionen unter jeder Bestellung; das JSON kapselt die Datensätze in einer Hülle mit Entität, Datum und Anzahl.

Transporte

FTP / FTPS

Geben Sie Host, Port (standardmäßig 21), Benutzer, Passwort und den entfernten Pfad an (z. B. /exports/prestashop). Passivmodus und explizites SSL (FTPS) werden über eigene Schalter unterstützt.

E-Mail

Die Datei wird als Anhang an die unter Empfänger-E-Mail angegebene Adresse gesendet. Die E-Mail-Vorlagen liegen auf Französisch und Englisch vor.

Cron-Planung

Das Panel Geplante Ausführung (Cron) zeigt die gesicherte URL an, die aufzurufen ist. Fügen Sie sie zu Ihrer Crontab oder einem Cron-Dienst hinzu. Bei jedem Aufruf werden nur die Profile ausgeführt, deren Frequenz fällig ist (mit einer Toleranz von 5 Minuten).

*/15 * * * * curl -s "https://ihr-shop.tld/module/dferpbridge/cron?token=IHR_TOKEN" > /dev/null 2>&1

Optionale URL-Parameter:

• id_profile=N — führt nur ein einzelnes Profil aus.
• force=1 — umgeht die Frequenzprüfung und führt in jedem Fall aus.

Manuelle Ausführung

Jedes Profil verfügt unter der Liste über eine Schaltfläche Jetzt ausführen, die den Export sofort auslöst und die Frequenz ignoriert — praktisch zum Testen eines Profils nach der Konfiguration.

Inkrementeller Export und Filter

Im inkrementellen Modus sind die exportierten Bestellungen und Kunden nur diejenigen, die nach dem Datum des letzten erfolgreichen Durchlaufs erstellt wurden, was Duplikate in Ihrem ERP vermeidet. Der Bestand wird unabhängig von dieser Einstellung stets als vollständige Momentaufnahme exportiert.

Bei Bestellungen beschränkt der Statusfilter den Export auf die ausgewählten Status (zum Beispiel „Zahlung akzeptiert“ und „Versendet“). Jede Bestellung enthält ihre Positionen, die MwSt pro Zeile, die Versandkosten und die vollständige Rechnungsadresse (SIRET, innergemeinschaftliche USt-IdNr.).

Export-Protokoll und Aufbewahrung

Die letzten 20 Exporte erscheinen im Back-Office mit ihrem Status (Erfolg, leer, Fehler), der Datensatzanzahl, der erzeugten Datei und einer optionalen Meldung. Protokolle, die älter als der konfigurierte Aufbewahrungszeitraum sind (standardmäßig 30 Tage), werden bei jedem Cron-Durchlauf automatisch bereinigt.

Sicherheit

• Die Cron-URL ist durch ein in konstanter Zeit verglichenes Token geschützt; ein Aufruf ohne gültiges Token gibt einen 403-Fehler zurück.
• Das FTP-Passwort wird im Ruhezustand verschlüsselt und nur zum Verbindungszeitpunkt entschlüsselt.
• Sie können das Cron-Token in den Einstellungen neu generieren; die alte URL funktioniert dann nicht mehr.

Fehlerbehebung

„Invalid token“ beim Cron-Aufruf

Prüfen Sie, ob das Token in der URL exakt mit dem im Cron-Panel angezeigten übereinstimmt. Wenn es neu generiert wurde, aktualisieren Sie Ihre Crontab.

Der FTP-Export schlägt fehl

Stellen Sie sicher, dass die PHP-FTP-Erweiterung auf dem Server verfügbar ist, dass Host und Benutzer korrekt sind und der entfernte Pfad existiert. Versuchen Sie je nach Server, den Passivmodus zu aktivieren oder zu deaktivieren.

Das Profil läuft, aber es wird keine Datei erzeugt

Der Status „leer“ bedeutet, dass kein Datensatz zu den Filtern passte (zum Beispiel keine neuen Bestellungen seit dem letzten Durchlauf im inkrementellen Modus oder ein zu restriktiver Statusfilter).

XML-Formate schlagen fehl

Die Presets Cegid und generisches XML benötigen die PHP-XMLWriter-Erweiterung, die auf den meisten PrestaShop-Hostings Standard ist.

Kompatibilität

• PrestaShop 8.0, 8.1, 8.2 und 9.x
• PHP 7.4 bis 8.3
• Multishop
• PHP-FTP-Erweiterung für den FTP-Transport erforderlich; XMLWriter für XML-Formate erforderlich