psimport

📌 Modulversion: 1.0.0 📅 Letzte Aktualisierung: 13.07.2026 👤 Herausgeber/Lizenz: Philippe GRAND / Atoo-Net / GNU GPL v3+ 🌍 Sprachen der Benutzeroberfläche: 📧 Support: per E-Mail unter contact@atoo-net.com ✅ Dolibarr-Kompatibilität: Dolibarr 24.0 oder höher ✅ PrestaShop-Kompatibilität: PrestaShop 1.6 bis 9.x ✅ Erforderliche PHP-Version: PHP 8.1 oder höher 💡 Kostenlose Updates für ein Jahr innerhalb derselben Version, anschließend 50 % Rabatt auf die nächste Version.

Migrieren Sie die Daten Ihres PrestaShop-Shops mit psimport nach Dolibarr

Das Modul psimport stellt eine vollständige Sammlung von Migrationswerkzeugen bereit, mit denen Daten aus einem bestehenden PrestaShop-Shop nach Dolibarr ERP/CRM übertragen werden können.

Es ermöglicht den Abruf und Import Ihrer Kategorien, Kunden, Adressen, Produkte, Produktbilder, herunterladbaren Dateien und Bestellungen.

Die Migration verwendet die standardmäßige PrestaShop REST-Webservice-API. Ein direkter Zugriff auf die MySQL-Datenbank von PrestaShop ist normalerweise nicht erforderlich.

Anstatt die Datensätze sofort in Dolibarr zu erstellen, speichert psimport die abgerufenen Informationen zunächst in temporären Staging-Tabellen. Dadurch können Sie die Daten kontrollieren, Fehler erkennen und Probleme beheben, bevor der endgültige Import durchgeführt wird.

Der Staging-Mechanismus ermöglicht außerdem, ausschließlich fehlgeschlagene Importe erneut auszuführen, ohne sämtliche Daten erneut von PrestaShop herunterladen zu müssen.

🔄 Migrierbare Daten

🧩 Ein sicherer Migrationsprozess in zwei Schritten

Jeder Migrationsvorgang ist in zwei getrennte Schritte unterteilt:

1. Abruf: Die Daten werden über die Webservice-API aus PrestaShop abgerufen und anschließend in den Staging-Tabellen von psimport gespeichert.

2. Import: Die geprüften und validierten Staging-Datensätze werden in Dolibarr-Objekte umgewandelt.

Diese Trennung bietet eine bessere Kontrolle als eine direkte Migration, da die abgerufenen Daten überprüft werden können, bevor Änderungen an der Dolibarr-Datenbank vorgenommen werden.

🗃️ Temporäre Staging-Tabellen

psimport verwendet spezielle Tabellen, deren Namen mit folgendem Präfix beginnen:

llx_psimport_*

Diese Tabellen speichern die aus PrestaShop abgerufenen Informationen vor dem endgültigen Import in Dolibarr.

Für jede Ressource zeigt das Modul Folgendes an:

📊 Benutzeroberfläche zur Importverwaltung

Die Registerkarte Importverwaltung bietet eine zentrale Übersicht über alle Migrationsvorgänge.

Über diese Benutzeroberfläche können Sie:

• Daten mit der Aktion Fetch aus PrestaShop abrufen

• Staging-Daten mit der Aktion Importieren in Dolibarr importieren

• Die Anzahl der ausstehenden, erfolgreich importierten und fehlerhaften Datensätze anzeigen

• Fehlerhafte Datensätze zurücksetzen, damit nur diese erneut verarbeitet werden

• Eine Staging-Tabelle vor einem neuen Migrationstest leeren

• Das Datum des letzten Datenabrufs anzeigen

🔁 Nur fehlerhafte Importe erneut ausführen

Jeder Staging-Datensatz besitzt einen Importstatus:

Nachdem die Fehlerursache behoben wurde, verwenden Sie die Aktion Fehler zurücksetzen, um die betroffenen Datensätze wieder in den Status „Ausstehend“ zu versetzen.

Anschließend können Sie den entsprechenden Import erneut ausführen. Bereits erfolgreich importierte Datensätze werden nicht erneut verarbeitet.

Dadurch muss nicht die gesamte Migration wegen einiger ungültiger oder unvollständiger Datensätze neu gestartet werden.

📦 Migration von Produkten und Dienstleistungen

psimport importiert PrestaShop-Produkte einschließlich ihrer wichtigsten kaufmännischen und steuerlichen Informationen in Dolibarr.

Die Produktmigration umfasst:

• Die Produktreferenz

• Den Produktnamen und die Beschreibung

• Preise ohne und einschließlich Mehrwertsteuer

• Die Ermittlung des Mehrwertsteuersatzes anhand der PrestaShop-Steuerregelgruppen

• Die Zuordnung zu den importierten Kategorien

• Das Hauptbild des Produkts

• Die vollständige Produktbildergalerie

• Herunterladbare Dateien virtueller Produkte

Der Zielobjekttyp in Dolibarr kann in der Modulkonfiguration ausgewählt werden.

Für Softwaremodule, Lizenzen, Dokumente und andere digitale Artikel wird empfohlen, PrestaShop-Produkte als Dolibarr-Dienstleistungen zu importieren.

🧾 Ermittlung der Mehrwertsteuersätze

PrestaShop stellt den endgültigen Mehrwertsteuersatz nicht immer direkt in der Produktressource bereit.

psimport ermittelt den anwendbaren Steuersatz durch Auslesen der PrestaShop-Steuerkonfiguration über die folgenden Webservice-Ressourcen:

• tax_rule_groups

• tax_rules

• taxes

Dadurch können Produktpreise und Mehrwertsteuersätze genauer nach Dolibarr übertragen werden.

Die Mehrwertsteuerwerte sollten dennoch in den Staging-Daten und anhand einer Auswahl von Dolibarr-Produktkarten geprüft werden, bevor der vollständige Katalog importiert wird.

🖼️ Hauptbilder und vollständige Produktgalerien

psimport kann sowohl das Hauptbild als auch die vollständige Bildergalerie jedes PrestaShop-Produkts abrufen.

Die Galerie wird über den PrestaShop-Endpunkt für Produktbilder abgerufen und vor dem Import in Dolibarr in einer speziellen Staging-Tabelle gespeichert.

Das Modul:

• Ruft alle einem Produkt zugeordneten Bilder ab

• Behält nach Möglichkeit die von PrestaShop zurückgegebene Bildreihenfolge bei

• Erkennt und ignoriert exakte Duplikate zwischen Hauptbild und Galerie

• Meldet Bilder, die nicht heruntergeladen oder importiert werden konnten

Da sich die genaue API-Antwort je nach PrestaShop-Version unterscheiden kann, wird empfohlen, zunächst einen Test mit einer begrenzten Anzahl von Produkten durchzuführen.

📥 Herunterladbare Dateien virtueller Produkte

Die standardmäßige PrestaShop-Webservice-API stellt die herunterladbaren Dateien virtueller Produkte nicht bereit.

Zur Umgehung dieser Einschränkung enthält psimport das optionale PrestaShop-Modul Psimport Bridge.

Nach der Installation im Quellshop ermöglicht diese Bridge psimport den Abruf von Dateien, die bereits in der PrestaShop-Tabelle für Produktdownloads registriert sind.

Die Bridge:

• Verwendet denselben PrestaShop-Webservice-API-Schlüssel wie psimport

• Arbeitet ausschließlich im Lesemodus

• Ändert die PrestaShop-Datenbank nicht

• Ändert keine auf dem PrestaShop-Server gespeicherten Dateien

• Ermöglicht nur den Zugriff auf Dateien, die bereits als herunterladbare Produktdateien registriert sind

• Kann nach Abschluss der Migration entfernt werden

Alternativ ist auch eine manuelle Migration möglich, indem die PrestaShop-Tabelle für Produktdownloads exportiert und das Download-Verzeichnis des Quellshops kopiert wird.

👥 Migration von Kunden und Adressen

psimport ruft Kunden und deren Adressen aus PrestaShop ab, bevor die entsprechenden Geschäftspartner in Dolibarr erstellt werden.

Die Migration kann Folgendes umfassen:

• Die Identität des Kunden

• Den Firmennamen, sofern vorhanden

• Die E-Mail-Adresse

• Telefonnummern

• Die Postanschrift

• Postleitzahl und Ort

• Länderinformationen

• Zugeordnete Liefer- und Rechnungsadressen

Kunden und Adressen werden gemeinsam verarbeitet, damit die Verbindung zwischen jedem Kunden und seinen Adressdaten erhalten bleibt.

🛒 Migration von Bestellungen

psimport kann PrestaShop-Kundenbestellungen und deren Bestellpositionen abrufen und importieren.

Die Bestellmigration umfasst:

• Die PrestaShop-Bestellreferenz

• Den zugeordneten Kunden

• Das Bestelldatum

• Die bestellten Produkte und Dienstleistungen

• Mengen und Einzelpreise

• Mehrwertsteuersätze

• Die Gesamtsummen der Bestellung

• Die Zuordnung der Zahlungsarten

• Die Filterung nach ausgewählten PrestaShop-Bestellstatus

Vor dem Import der Bestellungen müssen die zulässigen PrestaShop-Bestellstatus-IDs und die Zuordnungen der Zahlungsarten entsprechend der Konfiguration des Quellshops geprüft werden.

Produkte und Kunden sollten vor den Bestellungen importiert werden, damit die Bestellpositionen den richtigen Dolibarr-Objekten zugeordnet werden können.

📋 Empfohlene Migrationsreihenfolge

Um die Beziehungen zwischen den importierten Objekten zu erhalten, wird folgende Reihenfolge empfohlen:

1. Kategorien

2. Kunden und Adressen

3. Produkte oder Dienstleistungen

4. Herunterladbare Produktdateien

5. Vollständige Produktbildergalerien

6. Bestellungen und Bestellpositionen

Jeder Schritt sollte überprüft werden, bevor mit dem nächsten fortgefahren wird.

🔍 Empfohlene Kontrollen nach jedem Schritt

• Die Anzahl der Datensätze in PrestaShop, den Staging-Tabellen und Dolibarr vergleichen

• Ausstehende und fehlerhafte Staging-Datensätze prüfen

• Die importierte Kategorienhierarchie kontrollieren

• Kundennamen, E-Mail-Adressen und Postanschriften überprüfen

• Produktreferenzen, Beschreibungen und Kategoriezuordnungen kontrollieren

• Nettopreise, Bruttopreise und Mehrwertsteuersätze überprüfen

• Eine Auswahl von Produktbildern und herunterladbaren Dateien öffnen

• Kunden- und Produktzuordnungen in den importierten Bestellungen kontrollieren

• Bestellpositionen und Gesamtsummen zwischen PrestaShop und Dolibarr vergleichen

⚙️ Voraussetzungen auf PrestaShop-Seite

Der PrestaShop-Webservice muss über folgenden Menüpunkt aktiviert werden:

Erweiterte Einstellungen → Webservice → PrestaShop-Webservice aktivieren

Anschließend muss ein Webservice-API-Schlüssel mit Leserechten für die erforderlichen Ressourcen erstellt werden:

categories, customers, addresses, countries, products, images, tax_rule_groups, tax_rules, taxes, orders, order_details

Es sind ausschließlich GET-Berechtigungen erforderlich, da psimport Daten aus PrestaShop liest und keine Daten in den Quellshop zurückschreibt.

⚙️ Voraussetzungen auf Dolibarr-Seite

Die folgenden Standardmodule von Dolibarr sollten vor Beginn der Migration aktiviert werden:

Bei der Aktivierung von psimport werden die erforderlichen Staging-Tabellen automatisch erstellt. Bei einer Standardinstallation ist kein manueller SQL-Import erforderlich.

🔑 Konfiguration der API-Verbindung

Die Verbindung wird auf der Konfigurationsseite des psimport-Moduls in Dolibarr eingerichtet.

Vor Beginn der Migration kann mit einem Verbindungstest die API-URL und der Webservice-Schlüssel überprüft werden.

🛡️ Schutz des Quellshops

psimport wurde so entwickelt, dass Informationen aus PrestaShop gelesen werden, ohne den Quellshop zu verändern.

• Der PrestaShop-Webservice-Schlüssel benötigt ausschließlich GET-Berechtigungen

• Die Migration schreibt Daten ausschließlich in die Dolibarr-Datenbank und die Dolibarr-Dokumentverzeichnisse

• Das optionale Psimport-Bridge-Modul arbeitet im Lesemodus

• Die Bridge stellt ausschließlich bereits in PrestaShop registrierte herunterladbare Dateien bereit

• Keine Bestellung, kein Kunde und kein Produkt wird in PrestaShop verändert

Vor jeder Migration wird dennoch dringend empfohlen, eine vollständige Sicherung beider Anwendungen und ihrer Dokumente zu erstellen.

☁️ Fehlerbehebung bei Cloudflare und HTTP-403-Fehlern

Wenn die API-Verbindung im Browser funktioniert, psimport jedoch eine leere Antwort mit dem Status HTTP 403 Forbidden erhält, kann die Anfrage durch eine Firewall oder einen Bot-Schutz blockiert werden, bevor sie PrestaShop erreicht.

Dies kann insbesondere auftreten, wenn der Quellshop durch Cloudflare Bot Fight Mode, ModSecurity oder eine andere Web Application Firewall geschützt wird.

Prüfen Sie bei Cloudflare folgenden Bereich:

Sicherheit → Analyse → Ereignisse

Wenn die Anfrage als verwaltete Herausforderung von Bot Fight Mode angezeigt wird, deaktivieren Sie den Schutz während der Migration vorübergehend oder erstellen Sie eine entsprechende Ausnahmeregel, sofern der verwendete Cloudflare-Tarif dies unterstützt.

Der Sicherheitsschutz kann nach Abschluss der Migration wieder aktiviert werden.

🧪 Zunächst mit einer begrenzten Auswahl testen

Vor einer vollständigen Migration wird dringend empfohlen, jede Ressource zunächst mit einer kleinen Anzahl von Datensätzen zu testen.

Dadurch können Sie:

• Die API-Verbindung validieren

• Die Struktur der abgerufenen Daten kontrollieren

• Die Ermittlung der Mehrwertsteuersätze bestätigen

• Die Zuordnung von Produkten und Kunden überprüfen

• Die Download-Berechtigungen für Bilder und Dateien kontrollieren

• Die Zuordnungen von Bestellstatus und Zahlungsarten bestätigen

• Kompatibilitätsunterschiede zwischen PrestaShop-Versionen erkennen

Nach erfolgreicher Prüfung der Auswahl kann derselbe Vorgang ohne Begrenzung ausgeführt werden, um den vollständigen Datenbestand zu migrieren.

🧭 Typische Anwendungsfälle

• Einen PrestaShop-Shop durch einen Dolibarr-Marktplatz ersetzen: Den bestehenden Katalog, die Kunden und die Bestellhistorie vor dem Plattformwechsel übernehmen.

• Geschäftsdaten zentralisieren: PrestaShop-Kunden, Produkte und Bestellungen in das Dolibarr ERP/CRM des Unternehmens übernehmen.

• Einen Shop für Softwaremodule migrieren: Virtuelle Produkte, Modularchive, Dokumentationsdateien und Produktbilder nach Dolibarr übertragen.

• Eine kontrollierte Migration vorbereiten: Die Staging-Daten prüfen und korrigieren, bevor Datensätze in Dolibarr erstellt werden.

• Eine unterbrochene Migration fortsetzen: Nur fehlerhafte Datensätze erneut ausführen, ohne bereits erfolgreiche Datensätze erneut herunterzuladen oder zu importieren.

• Die historische Bestellübersicht erhalten: Frühere Kundenbestellungen und deren Positionen zur Anzeige und kaufmännischen Nachverfolgung nach Dolibarr übernehmen.

❓ FAQ

• Ist ein direkter Zugriff auf die MySQL-Datenbank von PrestaShop erforderlich?
  Nein. Die Standardmigration verwendet die PrestaShop REST-Webservice-API. Ein manueller Datenbankexport ist nur eine optionale Alternative zum Abruf herunterladbarer Dateien, wenn die Psimport Bridge nicht installiert werden kann.

• Welche PrestaShop-Versionen werden unterstützt?
  psimport unterstützt PrestaShop 1.6 bis 9.x über die standardmäßige PrestaShop-Webservice-API.

• Welche Dolibarr-Version ist erforderlich?
  Das Modul benötigt Dolibarr 24.0 oder höher.

• Welche PHP-Version ist erforderlich?
  PHP 8.1 oder höher ist erforderlich.

• Verändert psimport Daten in PrestaShop?
  Nein. Die PrestaShop-API wird ausschließlich mit GET-Berechtigungen verwendet. Die Daten werden aus PrestaShop gelesen und in Dolibarr erstellt.

• Verändert die Psimport Bridge PrestaShop?
  Nein. Die Bridge arbeitet im Lesemodus und stellt ausschließlich Dateien bereit, die bereits als herunterladbare Produkte registriert sind.

• Können fehlerhafte Datensätze erneut importiert werden?
  Ja. Korrigieren Sie die Daten oder die Konfiguration, setzen Sie die fehlerhaften Datensätze zurück und führen Sie anschließend nur den betroffenen Import erneut aus.

• Werden bereits importierte Datensätze beim erneuten Ausführen eines Imports dupliziert?
  Nein. Über den Staging-Status werden bereits erfolgreich importierte Datensätze erkannt.

• Kann ich die Informationen vor dem Import überprüfen?
  Ja. Alle abgerufenen Daten werden zunächst in den Staging-Tabellen gespeichert, damit sie vor dem endgültigen Import kontrolliert werden können.

• Warum gibt der API-Test einen HTTP-403-Fehler zurück?
  Die Anfrage kann durch Cloudflare Bot Fight Mode, ModSecurity oder eine andere Firewall vor dem PrestaShop-Shop blockiert werden.

• Sollte ich die Migration testen, bevor ich alles importiere?
  Ja. Testen Sie jede Ressource zunächst mit einer begrenzten Auswahl und prüfen Sie das Ergebnis vor der vollständigen Migration.

Warum psimport verwenden?

• Einen PrestaShop-Shop migrieren, ohne eigene SQL-Konvertierungsskripte entwickeln zu müssen

• Die standardmäßige PrestaShop-Webservice-API verwenden, ohne direkten Datenbankzugriff zu benötigen

• Daten kontrollieren und korrigieren, bevor Objekte in Dolibarr erstellt werden

• Kategorien, Kunden, Adressen, Produkte, Bilder, Dateien und Bestellungen importieren

• Herunterladbare Dateien virtueller Produkte abrufen

• Mehrwertsteuersätze anhand der PrestaShop-Steuerkonfiguration ermitteln

• Ausstehende, erfolgreiche und fehlerhafte Importe über eine zentrale Benutzeroberfläche verfolgen

• Nur fehlerhafte Datensätze erneut ausführen, anstatt die gesamte Migration zu wiederholen

• Den PrestaShop-Quellshop während der Migration unverändert lassen

• Einen kontrollierten Übergang von PrestaShop zu einem Dolibarr-basierten Shop vorbereiten

⚠️ Wichtige Empfehlung

Eine Datenmigration sollte immer zunächst auf einer separaten Dolibarr-Instanz getestet werden, bevor sie in einer Produktivumgebung durchgeführt wird.

Erstellen Sie vor Beginn eine vollständige Sicherung von:

• Der PrestaShop-Datenbank

• Den PrestaShop-Dateien und dem Download-Verzeichnis

• Der Dolibarr-Datenbank

• Dem Dolibarr-Dokumentverzeichnis

Vergleichen Sie nach jedem Migrationsschritt die Anzahl der Datensätze in Quelle und Ziel und überprüfen Sie manuell eine repräsentative Auswahl der importierten Daten.

📖 Dokumentation

Die vollständige Moduldokumentation ist im offiziellen Dolibarr-Wiki verfügbar:

👉 Dolibarr-Wiki – psimport-Modul (DE)

Französische Dokumentation:

👉 Dolibarr-Wiki – Modul psimport (FR)

Englische Dokumentation:

👉 Dolibarr-Wiki – psimport Module (EN)

Weitere Module