Was eine Anbindung ist und wo es schiefgeht
Eine Anbindung ist Software, die Daten zwischen zwei Systemen hin und her bringt, meist über eine API: eine feste Art, wie Programme miteinander sprechen. Wenn es funktioniert, merkst du nichts. Wenn es schiefgeht, merkst du es am Umsatz.
- Preise laufen auseinander: Der Shop zeigt einen anderen Preis als das System, aus dem der Preis kommt.
- Eine Bestellung kommt nicht in dem System an, das sie verarbeiten soll, und niemand sieht es.
- Fehlermeldungen verschwinden still in einer Logdatei, die niemand liest.
- Produktdaten kommen im falschen Format an und zerstören Seiten.
- Eine Anbindung läuft so schwer, dass Besucher es spüren.
Fast alle diese Probleme lassen sich mit Prüfungen und sichtbaren Fehlermeldungen vermeiden. Damit fange ich an, nicht mit der Anbindung selbst.
Wie ich eine Anbindung baue
Ich fange mit Lesen an: wie der Magento-Shop aufgebaut ist, welche Module denselben Bereich berühren und was das andere System genau erwartet. Erst dann schreibe ich Code.
Jede Anbindung bekommt eine Prüfung dessen, was hereinkommt. Stimmt ein Wert nicht, gelangt er nicht in den Shop. Fehler tauchen dort auf, wo jemand sie sieht.
Änderungen gehen zuerst auf eine Testumgebung. Das Ausrollen passiert, ohne den Shop lahmzulegen, und in der Produktion führe ich keinen vollständigen Cache-Flush aus, denn der wirft alle gespeicherten Seiten weg und macht den Shop vorübergehend langsam.
Anbindungen, an denen ich gearbeitet habe
Diese stammen aus dem Magento-Shop, in dem ich selbst arbeite. Die Namen der Beteiligten lasse ich weg, die Arten von Arbeit sind echt.
- Eine Marktplatz-Anbindung: Produkte und Bestellungen laufen zwischen dem Shop und einem Marktplatz.
- Eine Versand-Anbindung mit Abholpunkten über einen Logistikpartner: Kunden wählen beim Bezahlen einen Abholpunkt, die Versanddaten gehen automatisch weiter.
- Preissynchronisation zwischen zwei Systemen, mit einer Prüfung, die falsche Preise stoppt, bevor sie in den Shop gelangen.
- Eine Anbindung zwischen Magento und einem separaten Next.js-Webshop, bei der Bestellungen über die API in Magento landen. Bestand und Verwaltung bleiben so an einem Ort.
Jede dieser Anbindungen hat ihre eigene Falle. Bei Preisen ist es eine falsche Zahl, beim Versand eine fehlende Adresse, bei einem zweiten Shop doppelte oder verlorene Bestellungen.
Produktdaten: reparieren und neu schreiben
Nicht jede Anbindung geht zu einer anderen Firma. Manchmal verbinde ich deine Produktdaten mit Google oder mit einem KI-Schritt, der Texte schreibt.
- Reparatur der Produktdaten für Google: Im Shop, in dem ich arbeite, war 97 Prozent des Produkt-JSON-LD defekt. JSON-LD sind die strukturierten Daten in einer Seite, aus denen Google Preis und Bestand liest. Ich habe es repariert.
- Eine KI-Pipeline, die über 2.000 Produktseiten in drei Sprachen neu geschrieben hat. Eine Pipeline ist eine feste Abfolge von Schritten, die bei jeder Seite dieselben Prüfungen durchläuft.
Auch hier gilt: erst die vorhandenen Daten lesen, dann auf einer Testumgebung ändern und erst danach in der Produktion.
Aus der Praxis
Ein Magento-2-Shop mit Anbindungen in alle Richtungen
Das ist der Shop, in dem ich selbst arbeite: Magento 2.4.7 mit über 3.400 Produkten, rund 13.600 Produktseiten in vier Sprachversionen und 328 aktiven Modulen. Der Kunde bleibt anonym, die Zahlen sind echt.
In so einem Shop hängt vieles zusammen: ein Marktplatz, ein Versanddienstleister, ein Preissystem und ein zweiter Webshop. Ein Fehler in einer Anbindung kann auf Hunderten von Seiten sichtbar werden.
Der Shop erreicht bei echten Besuchern eine mobile Ladezeit (LCP) von 2,14 Sekunden, davor waren es 14 bis 16 Sekunden. Anbindungen dürfen einen Shop nicht langsam oder unzuverlässig machen. Mit Prüfungen und einer Testumgebung wird er keins von beidem.
Was ich nicht mache
Eine Anbindung läuft Tag und Nacht, ohne dass jemand hinsieht. Deshalb halte ich mich an ein paar Grenzen.
- Daten weiterreichen, ohne zu prüfen, was hereinkommt.
- Eine Anbindung zuerst in der Produktion ausprobieren.
- Einen vollständigen Cache-Flush in der Produktion ausführen.
- Eine Anbindung bauen, obwohl es schon eine gute gibt, die passt. Dann empfehle ich diese.
- Fehler in einer Logdatei verstecken, die niemand liest.
Ich sage auch ehrlich, wenn eine Anbindung mehr Pflege kostet, als sie bringt.
Umfang und Preis
Was eine Anbindung kostet, hängt vom anderen System ab (hat es eine gute API?), davon, wie viele Daten hin und her gehen, und davon, wie viele Prüfungen nötig sind.
Für Magento-Arbeit gibt es bei mir keine festen Pakete. Nach einem ersten Gespräch weiß ich, was die Anbindung leisten muss, und wir legen den Umfang fest. Mehr dazu, wie ich Preise gestalte, steht auf der Preisseite.