Ihren Shop per API mit einem Lieferanten verbinden: Bestand, Tarife und Bilder aktuell

Den Katalog eines Lieferanten einmal zu importieren ist Arbeit für einige Tage. Ihn aktuell zu halten ist Arbeit, die nie endet: Preise ändern sich, Bestand geht aus, neue Farben kommen, Artikel werden eingestellt. Machen Sie das von Hand, hinkt Ihr Shop immer hinterher, und Sie verkaufen, was es nicht mehr gibt, oder zu einem Preis, der nicht mehr gilt.

Bietet der Lieferant eine API an, kann der Shop sie fortlaufend abfragen. Dieser Artikel behandelt diese dauerhafte Synchronisierung; wenn Ihr Lieferant nur CSV- oder XML-Dateien liefert, haben wir für diesen Fall einen eigenen Leitfaden.

Was sich mit einer API gegenüber einer Datei ändert

• Daten in Echtzeit: Der Bestand wird abgefragt, wenn er gebraucht wird, nicht wenn der Lieferant die Datei erzeugt.
• Teilabfragen: Man kann nur den Bestand oder nur die Preise abfragen, ohne den ganzen Katalog herunterzuladen.
• Reichhaltige Daten: Viele Lieferanten veröffentlichen in der API Dinge, die nicht in eine CSV passen: Staffeltarife, Veredelungstechniken, Bilder pro Farbe, Texte in mehreren Sprachen.
• Anspruchsvoller: Authentifizierung, Anfragelimits, Netzwerkfehler und Versionswechsel der API müssen beherrscht werden.

Was Sie wie oft synchronisieren

Was keinen Sinn ergibt, ist, jede Stunde den ganzen Katalog herunterzuladen: Sie belasten den Server des Lieferanten und Ihren eigenen und riskieren, seine Limits zu überschreiten.

Einkaufspreis ist nicht Verkaufspreis

Der Lieferant gibt Ihnen seinen Tarif; Sie entscheiden über Ihren Preis. Die Verbindung braucht klare Regeln:

• Marge nach Kategorie, Marke oder Preisstufe, nicht eine einzige für alles.
• Mengenstaffeln: In Branchen wie Textil oder Werbeartikel sinken die Kosten ab einem bestimmten Volumen stark. Diese Staffeln müssen in Ihrem Shop zu Mengenpreisen werden.
• Rundungen, die keine Preise wie 12,37 € hinterlassen.
• Preise, die nicht angefasst werden: Haben Sie ein Produkt für eine Kampagne von Hand reduziert, sollte die Synchronisierung es nicht ohne Hinweis überschreiben.

Bestand: Ihrer und der des Lieferanten

Haben Sie zusätzlich Ware im eigenen Lager, täuscht es den Kunden, wenn Ihr Bestand und der des Lieferanten zu einer Zahl vermischt werden: „Ich habe es, und es geht heute raus“ ist nicht dasselbe wie „ich bestelle es beim Hersteller, und es dauert eine Woche“. Richtig ist, sie zu trennen und je nachdem, woher jedes Stück kommt, eine andere Lieferzeit anzuzeigen. Und zu entscheiden, was passiert, wenn mehr bestellt wird, als beide zusammen ergeben: den Verkauf sperren oder um Kontaktaufnahme für ein Angebot bitten.

Kombinationen, Sprachen und Bilder

• Farben und Größen müssen zu PrestaShop-Kombinationen werden, abgeglichen mit den Attributen, die Sie bereits haben, nicht zu neuen doppelten Attributen („Rot“, „rot“, „ROT“).
• Bilder pro Farbe, ihrer Kombination zugeordnet.
• Texte in jeder aktiven Sprache Ihres Shops, wenn der Lieferant sie veröffentlicht.
• Kategorien: Der Baum des Lieferanten ist nicht Ihrer. Seine Kategorien müssen mit Ihren abgeglichen werden.
• Merkmale (Material, Maße) als PrestaShop-Merkmale, damit sie in den Filtern funktionieren.

Veredelung

Bei Werbeartikeln oder personalisierter Textilware wird das Produkt nicht allein verkauft: Es wird mit einer Veredelung verkauft. Der Lieferant veröffentlicht Techniken, Druckflächen, Anzahl der Farben und Kosten (oft mit festen Einrichtungskosten). Das in den Shop zu bringen ermöglicht dem Kunden, die Technik zu wählen und den berechneten Endpreis zu sehen, statt für alles ein Angebot anzufragen.

Häufige Fehler

1. Überschreiben, was Sie verbessert haben: SEO-Texte oder eigene Fotos, die die Synchronisierung wieder durch die des Lieferanten ersetzt.
2. Nicht protokollieren, was sich ändert: Ohne Verlauf wissen Sie nicht, warum ein Preis gestiegen ist.
3. Zu Stoßzeiten synchronisieren und den Shop verlangsamen.
4. Nicht warnen, wenn die API ausfällt: Die Synchronisierung stoppt, und niemand merkt es, bis etwas Ausverkauftes verkauft wird.
5. Zugangsdaten im Code: Die API-Schlüssel gehören in die Konfiguration, nie in Dateien, die kopiert oder in ein Repository hochgeladen werden.

Checkliste

1. Sie wissen genau, welche Daten die API liefert und mit welchen Limits.
2. Preisregeln nach Kategorie und Mengenstaffeln.
3. Eigener Bestand und Lieferantenbestand getrennt, mit unterschiedlichen Lieferzeiten.
4. Eingestellte Produkte werden deaktiviert, nicht gelöscht.
5. Attribute und Kategorien mit Ihren abgeglichen.
6. Änderungsverlauf und Hinweis, wenn die Synchronisierung fehlschlägt.

Die Umsetzung in PrestaShop

RKR Conector Makito ist ein Beispiel für diese Art von Verbindung: ein Paket mit einem Hub, der vergleicht und in den Shop schreibt, dem Konnektor zur Makito-API, einem optionalen Modul für Verkaufsmultiplikatoren und RKR Supplier Stock (optional, PrestaShop 9). Es bringt die vier Tarifstufen des Lieferanten (pro Stück und ab 500, 2.000 und 5.000 Stück) mit, umgerechnet in Verkaufspreise nach Ihren Regeln und in Mengenpreise, dazu Texte, Farben und Merkmale in den sieben Sprachen, die Makito veröffentlicht, und ermöglicht dem Kunden, das Produkt mit seiner Veredelung und bereits berechnetem Preis in den Warenkorb zu legen. Mit RKR Supplier Stock werden Ihr Bestand und der von Makito getrennt gespeichert, pro Kombination, mit unterschiedlichen Meldungen und Lieferzeiten für jeden Fall, und standardmäßig wird nicht mehr verkauft, als beide zusammen ergeben. Ohne dieses Modul funktioniert der Konnektor mit PrestaShop 1.7.6 bis 9.x. Für andere Lieferanten folgen die individuellen Konnektoren, die diesen Artikel begleiten, demselben Ansatz.