Grandoc: /* Andere Sprachen */

2026-07-10T09:25:15Z

Andere Sprachen

← Older revision		Revision as of 09:25, 10 July 2026
Line 203:		Line 203:
	* [[Module_psimport_FR\|Documentation en français du module psimport]]		* [[Module_psimport_FR\|Documentation en français du module psimport]]
	* [[Module_psimport_EN\|English documentation for the psimport module]]		* [[Module_psimport_EN\|English documentation for the psimport module]]
			* [[Module_psimport_ES\|Documentación en español del módulo psimport]]
			* [[Module_psimport_IT\|Documentazione in italiano del modulo psimport]]

	[[fr:Module_psimport_FR]]		[[fr:Module_psimport_FR]]
	[[en:Module_psimport_EN]]		[[en:Module_psimport_EN]]
			[[es:Module_psimport_ES]]
			[[it:Module_psimport_IT]]

Grandoc: Created page with "Category:Modules Category:AtooNet =Modul psimport= ==Übersicht== '''psimport''' ist ein Modul für Dolibarr ERP/CRM, veröffentlicht von [https://www.atoo-net.com..."

2026-07-10T09:13:23Z

Created page with "Category:Modules Category:AtooNet =Modul psimport= ==Übersicht== '''psimport''' ist ein Modul für Dolibarr ERP/CRM, veröffentlicht von [https://www.atoo-net.com..."

New page

[[Category:Modules]]
[[Category:AtooNet]]

=Modul psimport=

==Übersicht==

'''psimport''' ist ein Modul für Dolibarr ERP/CRM, veröffentlicht von [https://www.atoo-net.com Atoo-Net].

Es enthält Kommandozeilen-Werkzeuge, um einen '''PrestaShop-Shop nach Dolibarr zu migrieren''': Kategorien, Kunden/Adressen, Produkte (mit aufgelöster MwSt. und Titelbild), herunterladbare Dateien virtueller Produkte, Bildergalerien und Bestellungen. Die Migration nutzt die REST-Webservice-API von PrestaShop, mit Zwischentabellen (<code>llx_psimport_*</code>), in denen die Daten vor dem endgültigen Import in Dolibarr geprüft und korrigiert werden können, sowie einem erneuten Import ohne erneuten API-Zugriff.

Alle Produkte werden als '''Dienstleistung''' importiert (<code>Product::TYPE_SERVICE</code>), da es sich um dematerialisierte Module handelt, unabhängig vom auf PrestaShop-Seite eingestellten Typ.

{| class="wikitable"
|-
!Eigenschaft!!Wert
|-
|Autor||Philippe Grand — Atoo-Net
|-
|Version||1.0
|-
|Lizenz||GNU GPL v3+
|-
|Dolibarr minimum||v24.0
|-
|PHP minimum||v8.1
|-
|Unterstütztes PrestaShop||v1.6 bis 9.x (Webservice-API)
|}

==Warum psimport verwenden?==

Mit psimport können Sie alle Daten eines bestehenden PrestaShop-Shops nach Dolibarr übernehmen, ohne direkte Verbindung zur MySQL-Datenbank von PrestaShop (mit Ausnahme eines optionalen, einmaligen Schritts für herunterladbare Dateien). Jeder Schritt läuft über eine Zwischentabelle, die vor dem endgültigen Import überprüft werden kann.

===Anwendungsfälle===

====Vollständige Migration eines PrestaShop-Shops====
Abruf von Kategorien, Kunden/Adressen, Produkten (mit über die Steuerregelgruppen von PrestaShop aufgelöster MwSt.) und Bestellungen über die REST-Webservice-API, ohne zusätzliche Installation auf PrestaShop-Seite außer der Aktivierung des Webservice.

====Prüfung vor dem endgültigen Import====
Jede Ressource wird zunächst in eine Zwischentabelle (<code>llx_psimport_*</code>) abgerufen, in der die Daten vor dem eigentlichen Import in Dolibarr geprüft und korrigiert werden können. Das vermeidet einen erneuten Zugriff auf die PrestaShop-API im Fehlerfall.

====Gezielte Wiederholung nach Fehlerkorrektur====
Jede Zeile der Zwischentabelle trägt einen Status (<code>import_status</code>). Fehlerhafte Zeilen können auf "zu importieren" zurückgesetzt (Schaltfläche "Fehler zurücksetzen" oder eine SQL-Abfrage) und erneut verarbeitet werden, ohne alles von vorn zu importieren.

====Abruf herunterladbarer Moduldateien====
Die Webservice-API von PrestaShop stellt die an "virtuelle/herunterladbare Produkte" angehängten Dateien nicht bereit (eine durch das offizielle GitHub-Ticket PrestaShop/PrestaShop#27834 bestätigte Einschränkung). Ein mit psimport geliefertes "Bridge"-PrestaShop-Modul umgeht dies, rein lesend.

====Vollständige Produktbildergalerie====
Über das Titelbild hinaus (das zusammen mit dem Produkt abgerufen wird) kann psimport auch die vollständige Bildergalerie jedes Produkts über den API-Unterendpunkt <code>products/{id}/images</code> abrufen.

==Installation==

'''Anforderungen auf PrestaShop-Seite''':

#Webservice aktivieren: '''Erweiterte Parameter > Webservice > Webservice von PrestaShop aktivieren''' → Ja
#Einen API-Schlüssel erstellen ("Neuen Webservice-Schlüssel hinzufügen") mit GET-Berechtigungen für: <code>categories</code>, <code>customers</code>, <code>addresses</code>, <code>countries</code>, <code>products</code>, <code>images</code>, <code>tax_rule_groups</code>, <code>tax_rules</code>, <code>taxes</code>, <code>orders</code>, <code>order_details</code>
#Die Shop-URL und den erzeugten API-Schlüssel notieren

'''Anforderungen auf Dolibarr-Seite''':

#Aktivierte Module: Kunden/Lieferanten (Third parties), Produkte, Dienstleistungen, Kategorien, Bestellungen, Rechnungen
#Das Modul '''psimport''' in '''Startseite → Setup → Module/Anwendungen''' (Familie "Andere") aktivieren

Beim Aktivieren des Moduls werden die Zwischentabellen <code>llx_psimport_*</code> automatisch über den Standard-Aktivierungsmechanismus von Dolibarr angelegt — kein manueller SQL-Import nötig.

Das Modul psimport hat '''kein Menü und keine eigenen Berechtigungen'''. Die einzige Bildschirmseite ist die Konfigurationsseite (Setup > Module/Anwendungen > psimport > Schraubenschlüssel-Symbol), auf der die PrestaShop-Shop-URL und der Webservice-API-Schlüssel (Konstanten <code>PSIMPORT_API_URL</code> und <code>PSIMPORT_API_KEY</code>) eingetragen werden. Diese werden standardmäßig von den CLI-Skripten verwendet, wenn kein Parameter auf der Kommandozeile übergeben wird. Die gesamte Migration wird anschließend über die Skripte im Ordner <code>scripts/</code> von der Kommandozeile aus gesteuert.

==Konfiguration==

===Verbindung zur PrestaShop-API===

{| class="wikitable"
|-
!Konstante!!Beschreibung
|-
|<code>PSIMPORT_API_URL</code>||Basis-URL der PrestaShop-Webservice-API (z. B. <code>https://www.yourshop.com/api</code>)
|-
|<code>PSIMPORT_API_KEY</code>||API-Schlüssel des PrestaShop-Webservice
|}

===Fehlerbehebung: HTTP 403 bei der API (Hosting hinter Cloudflare)===

Wenn der Verbindungstest (oder ein <code>fetch-*</code>/<code>import-*</code>-Skript) mit einem Fehler wie <code>HTTP 403 Forbidden</code> '''mit leerem Antwortkörper''' und ohne erkannte Weiterleitung fehlschlägt, während derselbe Aufruf im Browser funktioniert, kommt die Sperre wahrscheinlich nicht von PrestaShop selbst, sondern von einer vorgelagerten Anwendungs-Firewall (Cloudflare, ModSecurity usw.), die die Anfrage abweist, bevor sie die Seite überhaupt erreicht.

Ein bestätigter Fall bei einem '''Cloudflare-Hosting (Free-Plan)''': Der kostenlose '''Bot Fight Mode''' von Cloudflare erkennt die cURL-Aufrufe des Moduls (kein Browser, kein JS, untypischer User-Agent) als Bot-Traffic und antwortet mit einer "Managed Challenge" — was auf Modulseite als leerer 403-Fehler erscheint.

Zur Bestätigung: im Cloudflare-Dashboard unter '''Security > Analytics > Events''' die letzten Minuten nach einem frischen Test filtern. Zeigt der geblockte Eintrag '''Service = "Bot fight mode"''' und '''Action = "Managed Challenge"''', liegt dieser Fall vor.

Im Free-Plan kann dieser Bot Fight Mode '''nicht selektiv pro URL-Pfad umgangen werden'''. Die einzige Option ist, den Schalter '''global''' zu deaktivieren: '''Security > Settings > "Bot fight mode"''' → Aus, während die Import-Skripte laufen, und danach bei Bedarf wieder zu aktivieren.

Bei einem kostenpflichtigen Cloudflare-Plan (Pro und höher) erlaubt Super Bot Fight Mode eine gezieltere Umgehung über eine "Skip"-Sicherheitsregel für <code>/api*</code>.

==Verwendung==

[[File:psimport_admin.png|center|thumb|800px|Importverwaltung]]

===Ausführungsreihenfolge===

<pre>
# 1. Kategorien
php scripts/fetch-categories.php https://www.yourshop.com/api ABCDEF... 0 0
php scripts/import-categories.php 0

# 2. Kunden + Adressen
php scripts/fetch-customers.php https://www.yourshop.com/api ABCDEF... 0 0
php scripts/import-customers.php 0

# 3. Produkte (MwSt. über tax_rules_groups aufgelöst, Titelbild heruntergeladen)
php scripts/fetch-products.php https://www.yourshop.com/api ABCDEF... 0 0
php scripts/import-products.php https://www.yourshop.com/api ABCDEF... 0

# 4. Herunterladbare Moduldateien (erfordert das PrestaShop-Modul "Psimport Bridge")
php scripts/fetch-product-files.php https://www.yourshop.com/api ABCDEF... 0 0
php scripts/import-product-files.php https://www.yourshop.com/api ABCDEF... 0

# 4b. Vollständige Produktbildergalerie
php scripts/fetch-product-images.php https://www.yourshop.com/api ABCDEF... 0 0
php scripts/import-product-images.php https://www.yourshop.com/api ABCDEF... 0

# 5. Bestellungen (vor dem ersten Lauf $importable_state_ids und $payment_module_map am Skriptanfang anpassen)
php scripts/fetch-orders.php https://www.yourshop.com/api ABCDEF... 0 0
php scripts/import-orders.php 0
</pre>

Gemeinsame Parameter:

*<code>limit</code> = 0, um alles abzurufen/zu importieren, oder eine Zahl für einen Test mit einer Stichprobe
*<code>clean_all_before_fetch</code> = 1, um die Zwischentabelle vor einem neuen Abruf zu leeren (Standard 0 = anreichern/aktualisieren)

===Import nach Fehlerkorrektur wiederholen===

Jede Zwischentabelle besitzt eine Spalte <code>import_status</code>:

*<code>0</code> = zu importieren
*<code>1</code> = erfolgreich importiert (<code>fk_dolibarr</code> enthält die ID des erzeugten Dolibarr-Objekts)
*<code>2</code> = fehlerhaft (Details in <code>import_error</code>)

Um nach der Korrektur nur die fehlerhaften Zeilen erneut zu verarbeiten, die Schaltfläche "Fehler zurücksetzen" im Reiter der Importverwaltung verwenden, oder:

<pre>
UPDATE llx_psimport_product SET import_status = 0 WHERE import_status = 2;
</pre>

und anschließend das passende Import-Skript erneut ausführen.

===Herunterladbare Moduldateien===

Die Webservice-API von PrestaShop '''stellt die Dateien "virtueller/herunterladbarer Produkte" nicht bereit''' (bestätigt durch das offizielle GitHub-Ticket PrestaShop/PrestaShop#27834 sowie mehrere Themen im PrestaShop-Forum). Dies wird durch ein einmalig im Shop installiertes "Bridge"-PrestaShop-Modul umgangen.

'''Empfohlen: Modul Psimport Bridge''' (ein Klick, wie jeder andere Import):

#Das in <code>bridge/psimportbridge/</code> mitgelieferte Modul im PrestaShop-Shop installieren (ZIP über das Backoffice hochladen oder per FTP/SFTP nach <code>modules/</code> kopieren und dann installieren)
#Keine zusätzliche Konfiguration nötig: es verwendet denselben bereits eingerichteten Webservice-API-Schlüssel (<code>PSIMPORT_API_KEY</code>)
#Im Reiter '''Importverwaltung''' die Schaltflächen '''↓ Abrufen''' und '''→ Importieren''' bei der Zeile "Produktdateien" verwenden, genau wie bei jeder anderen Ressource
#Nach Abschluss der Migration kann das Modul problemlos deinstalliert werden (rein lesend, keine Datenbank- oder Dateischreibvorgänge auf PrestaShop)

Dieses Modul erlaubt nur den Download bereits in <code>ps_product_download</code> referenzierter Dateien (Schutz vor beliebigen Dateizugriffen).

'''Alternative''' (falls das Bridge-Modul nicht installiert werden kann): ein manueller CSV-Export von <code>ps_product_download</code> aus phpMyAdmin/Adminer, zusammen mit einer lokalen Kopie des <code>download/</code>-Ordners von PrestaShop, dann <code>php scripts/import-product-files.php /path/to/export.csv /path/to/download/</code>.

===Vollständige Produktbildergalerie===

<code>fetch-product-images.php</code> / <code>import-product-images.php</code> rufen '''alle''' Bilder jedes PrestaShop-Produkts ab (nicht nur das Titelbild), über den Webservice-Unterendpunkt <code>products/{id}/images</code>, in eine eigene Zwischentabelle <code>llx_psimport_productimage</code>.

Beim ersten Lauf zu prüfen:

*Die Position jedes Bildes in der Dolibarr-Galerie ergibt sich aus der von der API zurückgegebenen Reihenfolge — nach dem Import die Reihenfolge visuell prüfen und bei Bedarf manuell anpassen
*Um dasselbe Bild nicht doppelt anzuzeigen (Titelbild + Galerie), werden exakte Duplikate erkannt und stillschweigend übersprungen
*Die genaue Form der JSON-Antwort kann je nach PrestaShop-Version variieren: zunächst mit <code>limit=5</code> an einer Stichprobe testen

===Prüfungen nach jedem Schritt===

#Inhalt der Tabellen <code>llx_psimport_*</code> prüfen (Datenkonsistenz, korrekt aufgelöste MwSt.)
#In der Dolibarr-Oberfläche prüfen: Kategoriebaum, Kundendatensätze (Adresse, Kontakt), Produktblätter (Preis netto/brutto, MwSt., Bild, angehängte Datei), Bestellungen (Positionen, Summen, Status)
#Anzahl (Kategorien/Kunden/Produkte/Bestellungen) zwischen PrestaShop, der Zwischentabelle und Dolibarr vergleichen

==FAQ==

===Benötige ich direkten Zugriff auf die MySQL-Datenbank von PrestaShop?===
Nein. Die gesamte Migration läuft über die REST-Webservice-API von PrestaShop, mit Ausnahme eines optionalen, einmaligen Schritts (manueller CSV-Export), falls das Bridge-Modul für herunterladbare Dateien nicht installiert werden kann.

===Welche PrestaShop-Versionen sind kompatibel?===
Von PrestaShop 1.6 bis 9.x, über die Standard-Webservice-API. Das Bridge-Modul (auf PrestaShop-Seite) gibt diesen Kompatibilitätsbereich selbst an.

===Was tun, wenn der Import einer Ressource teilweise fehlschlägt?===
Die zugrunde liegenden Daten korrigieren (in der Zwischentabelle oder auf PrestaShop-Seite), die fehlerhaften Zeilen auf <code>import_status = 0</code> zurücksetzen (Schaltfläche "Fehler zurücksetzen" oder eine SQL-Abfrage) und anschließend nur das passende Import-Skript erneut ausführen.

===Der Verbindungstest schlägt mit 403 fehl, obwohl die URL im Browser funktioniert===
Siehe den Abschnitt [[#Fehlerbehebung: HTTP 403 bei der API (Hosting hinter Cloudflare)|Fehlerbehebung HTTP 403]]: Dies ist meist eine Anwendungs-Firewall (Cloudflare Bot Fight Mode), die cURL-Aufrufe blockiert, nicht PrestaShop selbst.

===Verändert das Modul Psimport Bridge Daten auf PrestaShop?===
Nein, es arbeitet rein lesend: keine Datenbank- oder Dateischreibvorgänge auf PrestaShop, und es erlaubt nur den Download bereits in <code>ps_product_download</code> referenzierter Dateien.

==Siehe auch==

*[https://www.atoo-net.com Atoo-Net — Modul-Herausgeber]
*[https://framagit.org/grandoc/psimport Modul-Repository]
*[https://wiki.dolibarr.org/index.php/Module_UltimateMarketPlace_EN Module UltimateMarketPlace]

==Andere Sprachen==

* [[Module_psimport_FR|Documentation en français du module psimport]]
* [[Module_psimport_EN|English documentation for the psimport module]]

[[fr:Module_psimport_FR]]
[[en:Module_psimport_EN]]

Module psimport DE - Revision history

Grandoc: /* Andere Sprachen */

Grandoc: Created page with "Category:Modules Category:AtooNet =Modul psimport= ==Übersicht== '''psimport''' ist ein Modul für Dolibarr ERP/CRM, veröffentlicht von [https://www.atoo-net.com..."