Fertiges Modul oder dedizierte PrestaShop-Integration? Wie bereitet man den Umfang für ein Angebot vor?

Ein fertiges Modul sollte dann gewählt werden, wenn es den erforderlichen Prozess und die Art des Datenaustauschs unterstützt. Eine individuelle Integration ist gerechtfertigt, wenn Regeln angepasst werden müssen, die von der verfügbaren Lösung nicht umgesetzt werden. Für die Kalkulation bereite eine Beschreibung der Systeme, die Flussrichtung, die Verantwortlichkeit für die Daten sowie messbare Abnahmekriterien vor.

Dieser Leitfaden hilft PrestaShop-Shopbetreibern und Personen, die Implementierungen koordinieren, den Gesprächsumfang mit dem Dienstleister vorzubereiten. Am Ende findest du ein ausgefülltes Demonstrationsbriefing, das als Vorlage für deine eigene Anfrage dienen kann.

1. Beschreibe das Geschäftsziel vor der Wahl der Technologie

„Integration mit ERP“ kann den Import des Katalogs, die Übergabe von Bestellungen, die Aktualisierung von Beständen, den Abruf von Rechnungen oder die Abwicklung von Rücksendungen bedeuten. Das sind unterschiedliche Aufgaben mit anderen Fehlerbildern und Abnahmekriterien. Die bloße Liste der Systemnamen definiert den Arbeitsumfang nicht.

Beginne mit einem Satz, der den Bedarf beschreibt: „Die Verfügbarkeit im Shop soll sich aus dem Lagerbestand ergeben, und das Team soll akzeptierte Bestellungen nicht in das ERP-System übertragen müssen.“ Zerlege dies anschließend in zwei Flüsse. Lege für jeden den Startpunkt, das Ergebnis sowie die Person fest, die im Fehlerfall die Entscheidung trifft.

Wenn du lediglich einen zyklischen Import des Lieferantenkatalogs benötigst, prüfe vorher die Möglichkeiten des Importers. Der Leitfaden zum XML-Import ohne Duplikate hilft dabei, Identifikatoren und den Aktualisierungsumfang zu ordnen. Eine umfangreiche Integration ist nicht die Voraussetzung, um jedes Problem mit einer Produktdatei zu lösen.

2. Vergleiche fertiges Modul, Anpassung und separate Umsetzung

Vergleiche den gesamten Prozess und nicht die Anzahl der Positionen in der Funktionsliste. Ein Modul kann Produkte unterstützen, aber ein bestimmtes Feld einer Kombination nicht aktualisieren. Es kann Bestellungen senden, aber den von deinem Checkout verwendeten Abholpunkt nicht übergeben. Diese Details sollten in den Eingabebeispielen und im erwarteten Ergebnis enthalten sein.

Eine Anpassung erfordert auch die Festlegung der Art der Wartung der Änderungen. Wenn sich die Modifikation direkt in den Dateien des gekauften Moduls befindet, lege fest, wie sie bei einem Update wiederhergestellt oder übertragen wird. Gehe nicht davon aus, dass die Installation der nächsten Version automatisch den eigenen Code beibehält.

3. Prüfe den Zugriff auf Daten und Operationen

Bitte um die API-Dokumentation oder die Dateispezifikation, die Systemversion, den Berechtigungsumfang, Limits und eine Testumgebung. Die Stichprobe sollte repräsentative Fälle enthalten: ein Produkt mit Varianten, unterschiedliche Steuersätze, eine Bestellung an einen Abholpunkt oder eine Stornierung. Kundendaten sollten durch Demodaten ersetzt werden.

Die offizielle PrestaShop-Dokumentation beschreibt den Webservice als CRUD-API, also als Schnittstelle für Operationen auf Shop-Ressourcen. Seine Verfügbarkeit bedeutet jedoch nicht, dass jeder beliebige Geschäftsprozess eine fertige Operation mit nur einer Anfrage ist. Es müssen die Ressourcen, Felder und die Art des Aufrufs in der konkreten Shop-Version sowie auf Seiten des zweiten Systems geprüft werden.

Halte im Umfang auch fest, wer den Zugriff bereitstellt und wer ihn erneuern kann. Ein separates Integrationskonto sollte die für die vereinbarten Aufgaben erforderlichen Berechtigungen haben. Schlüssel und Passwörter gehören nicht in das Briefing oder in Beispiel-Logs; übermittle sie über einen separaten, abgestimmten Kanal.

4. Jedes Feld sollte einen Verantwortlichen haben

Eine bidirektionale Synchronisierung ist eine unvollständige Beschreibung, solange nicht klar ist, was bei einer gleichzeitigen Änderung zu tun ist. Wenn ein Mitarbeiter den Preis im Shop korrigiert und das ERP einen älteren Wert sendet, welcher Eintrag soll gelten? Die Antwort sollte sich aus einer Regel ergeben, nicht aus der zufälligen Reihenfolge der Ausführungen.

Trenne die Verantwortlichen für Daten auf Feldebene. Das Lager kann über die Menge entscheiden, PrestaShop über Beschreibungen und SEO und eine separate Preisliste über den Preis für eine ausgewählte Gruppe. Lege auch die Bedeutung eines fehlenden Feldes, eines leeren Werts und einer Null fest. Beim Lagerbestand können diese drei Fälle ein völlig unterschiedliches Verhalten erfordern.

Erforderlich ist ein stabiler Schlüssel zur Verknüpfung von Produkt und Kombination. Der Name allein reicht nicht aus, und die SKU muss im vereinbarten Umfang tatsächlich eindeutig sein. Beschreibe, was bei einer Codeänderung, beim Verschwinden eines Produkts aus der Quelle und bei seiner erneuten Hinzufügung nach einer Unterbrechung geschieht.

5. Trenne das Senden von Daten von ihrer Verarbeitung

Die Bestätigung der Annahme einer Anfrage kann ausschließlich bedeuten, dass sie in die Warteschlange des zweiten Systems gestellt wurde. Vereinbare, woran du erkennst, dass die Bestellung dort tatsächlich angelegt wurde: an der Dokument-ID, am Auslesen des Status oder an einer Rückmeldung. Jede Lösung erfordert die Definition eines Wartezustands und einer weiteren Kontrolle.

Besonders wichtig ist ein Timeout nach dem Versand. Eine ausbleibende Antwort beweist nicht, dass der Empfänger nichts gespeichert hat. Vor einer Wiederholung muss das Ergebnis anhand eines stabilen Identifikators geprüft oder ein vereinbarter Mechanismus verwendet werden, der die mehrfache Ausführung derselben Operation verhindert.

Lege im Briefing eine begrenzte Anzahl von Wiederholungen, Verzögerungen entsprechend den Limits der Quelle, den Ort der Fehlerinformation sowie eine manuelle Wiederaufnahme fest. Nicht jeder Fehler eignet sich zur Wiederholung: Ein fehlender Pflichtwert muss korrigiert werden, und eine vorübergehende Nichtverfügbarkeit des Dienstes kann gemäß der festgelegten Richtlinie behandelt werden.

6. Ein einseitiges Briefing — Beispiel zum Ausfüllen

Das folgende Beispiel betrifft das fiktive „Lager A“. Die Zahlen beschreiben Demonstrationsanforderungen, keine Leistungsmessung und keine Garantie der Möglichkeiten eines konkreten Moduls. Vor der Kalkulation müssen die Dokumentation und die Verfügbarkeit der Operationen im realen System bestätigt werden.

7. Trage die Abnahmekriterien vor der Kalkulation in den Umfang ein

Eine gute Abnahme umfasst den erfolgreichen Ablauf und Situationen, die eine Entscheidung erfordern. Prüfe die doppelte Zustellung derselben Nachricht, Timeout nach dem Speichern, eine unbekannte Kombination, eine fehlende Adresse, eine ältere Bestandsaktualisierung sowie die Wiederaufnahme nach einer Unterbrechung. Lege für jeden Fall das Ergebnis und die Art seiner Bestätigung in beiden Systemen fest.

Lege separat den ersten Start fest: die Verknüpfung des bestehenden Katalogs, die Migration der Identifikatoren, den ersten vollständigen Durchlauf sowie den Zeitpunkt der Umschaltung. Eine Integration, die mit neuen Daten funktioniert, löst nicht automatisch die Probleme historischer Datensätze.

Trenne in der Kalkulation API-Analyse, Implementierung, Datenbereinigung, Umsetzung und Wartung. Halte fest, wer auf eine Versionsänderung des externen Systems, abgelaufene Zugänge und operative Fehler reagiert. Wenn das Projekt auch eine Änderung der Shop-Version umfasst, bereite separat den Umfang des PrestaShop-Updates vor.

Nächster Schritt: Sende das Briefing im Rahmen von PrestaShop-Programmierung und -Integrationen. Beschreibe die Systeme, die Austauschrichtung und das erwartete Ergebnis. Auf dieser Grundlage kann die Eignung einer fertigen Lösung geprüft und der Umfang festgelegt werden, der eine separate Umsetzung erfordert.

Erstellt am 13.09.2026. Technische Grundlage: offizielle Webservice-Dokumentation von PrestaShop 9. Das Briefing ist ein Demonstrationsbeispiel für einen Shop 8.2.8; konkrete API-Ressourcen, Versionen und Limits müssen in der Zielumgebung bestätigt werden. Die angegebenen Volumina sind nicht das Ergebnis eines Leistungstests.