OXOMI hat die Frontend-1.0-Integrationen abgekündigt. In der eigenen Dokumentation steht es so:
„Es handelt sich bei der beschriebenen Funktionalität um eine veraltete Frontend-1.0-Integration. Die Unterstützung für diese endet am 31. Dezember 2026.“
Wenn dein Shop Kataloge, Datenblätter oder Produktvideos aus OXOMI zieht, betrifft dich das möglicherweise, ohne dass es bisher jemand auf dem Schirm hatte. Viele Einbindungen wurden vor Jahren einmal eingerichtet und seitdem nicht angefasst, weil sie einfach funktionieren.
Das ist kein Drama. Es ist ein Termin. Diese Seite hilft dir, in fünf Minuten selbst herauszufinden, ob du ihn dir eintragen musst.
Stand: September 2026. Quelle ist die OXOMI-Dokumentation; prüfe vor der Umsetzung den aktuellen Stand dort.
Der Fünf-Minuten-Check
Du brauchst niemanden dafür. Lass jemanden im Shop-Template, im Theme oder in den eingebundenen Skripten nach den folgenden Begriffen suchen. Findest du einen davon, läuft diese Einbindung noch auf Frontend 1.0.
Am schnellsten geht es mit einer Volltextsuche über das Projekt nach oxomi. — dann siehst du
alle Aufrufe auf einmal und kannst sie gegen die Liste halten.
Diese Funktionsnamen wurden umbenannt
| Alt (Frontend 1.0) | Neu (Frontend 2.0) |
|---|---|
oxomi.portalSearch |
oxomi.universalSearch |
oxomi.openPortalSearch |
oxomi.openUniversalSearch |
oxomi.catalogs |
oxomi.documents |
oxomi.embedCatalog |
oxomi.embedDocument |
oxomi.openCatalog |
oxomi.openDocument |
oxomi.downloadCatalog |
oxomi.downloadDocument |
oxomi.itemDatasheet |
oxomi.productDatasheet |
oxomi.item3dViewer |
oxomi.product3dViewer |
oxomi.item3dExists |
oxomi.product3dExists |
oxomi.checkAvailability |
oxomi.productAvailability |
oxomi.withConfig |
oxomi.requestConfig |
Diese Integrationen wurden ganz ersetzt
Hier reicht kein Umbenennen, die Aufrufe müssen umgebaut werden:
| Alt | Neu |
|---|---|
oxomi.catalogBrands |
oxomi.universalSearch mit displayedResults: documents |
oxomi.videoBrands |
oxomi.universalSearch mit displayedResults: videos |
oxomi.galleryBrands |
oxomi.universalSearch mit displayedResults: galleries |
oxomi.catalogsWithDownload |
oxomi.documents mit showActions: true |
oxomi.embedCatalogWithDownload |
oxomi.embedDocument mit showActions: true |
Und diese Parameter heißen jetzt anders
Das ist die Stelle, an der eine Umstellung stillschweigend halb funktioniert: Der Aufruf läuft, aber die Filterung greift nicht mehr.
| Alt | Neu |
|---|---|
catalog |
document |
supplierNumber |
supplierNumbers |
brand / brandId |
brands / brandIds |
tag |
tags |
category / categoryId |
categories / categoryIds |
type |
types |
lang |
filterLanguages |
country |
filterCountries |
languages |
additionalLanguages |
order |
orderHandler |
page |
pageNumber |
showDetails (Videos) |
showName |
paused (Videos) |
autoplay |
mode (Galerien) |
inline |
Dazu ein Punkt, der leicht übersehen wird: Handler wie completionHandler und
emptyResultHandler geben jetzt Promises zurück. Wer dort eigene Logik angehängt hat, muss
sie anpassen, sonst läuft sie ins Leere.
Dein Ergebnis
Kein Treffer. Entweder ihr seid schon auf Frontend 2.0, oder OXOMI ist bei euch nur verlinkt statt eingebettet. Dann betrifft dich der Termin nicht. Gut, Haken dran.
Ein oder zwei Treffer. Überschaubar. Meist sind es Katalogansicht und Datenblatt am Artikel. Ein halber bis ein Tag Arbeit inklusive Test, wenn die Einbindung sauber an einer Stelle liegt.
Treffer über das ganze Template verstreut. Dann ist die Einbindung über Jahre gewachsen, und die Umstellung ist weniger Programmierarbeit als Inventur: Welche Aufrufe gibt es überhaupt, welche werden noch benutzt, und bei welchen weiß niemand mehr, warum sie da sind. Erfahrungsgemäß ist das der häufigste Fall.
Warum es sich lohnt, das früh anzugehen
Nicht wegen des Datums an sich. Sondern weil eine Umstellung, die vorbereitet ist, in einem ruhigen Wartungsfenster stattfindet und nicht zwischen Weihnachten und Neujahr.
Dazu kommt ein angenehmer Nebeneffekt: Wer die Einbindung ohnehin anfasst, kann bei der Gelegenheit prüfen, ob sie noch an den richtigen Stellen sitzt. Häufig sind über die Jahre Kataloge an Artikeln gelandet, zu denen sie nicht mehr passen, oder es werden Inhalte geladen, die im Shop gar nicht mehr sichtbar sind. Das kostet Ladezeit, ohne dass jemand etwas davon hat.
Was zu tun ist, der Reihe nach
- Inventur. Alle
oxomi.-Aufrufe im Projekt finden und notieren, wo sie sitzen und was sie ausspielen. - Aussortieren. Was wird tatsächlich benutzt? Aufrufe, die niemand mehr sieht, werden nicht migriert, sondern entfernt.
- Umbenennen und umbauen. Die reinen Umbenennungen sind mechanisch. Die ersetzten Integrationen und die Parameter brauchen eine bewusste Entscheidung.
- An echten Artikeln prüfen. Nicht an einem Testartikel, sondern an Artikeln verschiedener Hersteller, denn die Datenlage unterscheidet sich.
- Ladezeiten gegenprüfen. Wenn ohnehin angefasst wird, lohnt der Blick, ob die Inhalte im richtigen Moment nachgeladen werden.
Die offizielle Migrationsanleitung mit allen Details führt OXOMI in der eigenen Knowledge Base. Die Liste oben ist der Auszug, der für die Selbstprüfung reicht.
Wenn du es nicht selbst machen willst
Wir übernehmen die Umstellung: Inventur, Umbau, Test an echten Artikeln und die Prüfung, ob die Einbindung danach an den richtigen Stellen sitzt. Plattformoffen, also auch dann, wenn dein Shop keine Standardplattform ist.
Wenn du vorher wissen willst, woran du bist: Schick uns das Ergebnis deiner Suche nach
oxomi., und wir sagen dir, in welche der drei Kategorien oben ihr fallt und was das
ungefähr bedeutet. Dafür brauchst du keinen Termin.
Häufige Fragen
Passiert am 1. Januar 2027 etwas Schlimmes? OXOMI spricht vom Ende der Unterstützung, nicht von einer Abschaltung zu einem bestimmten Zeitpunkt. Trotzdem gilt: Ab dann gibt es für die alte Einbindung keine Hilfe mehr, wenn etwas klemmt. Genau deshalb ist ein geplanter Termin besser als ein ungeplanter.
Wir haben die Einbindung nie selbst gebaut, das war eine Agentur. Das ist der Normalfall. Für die Prüfung brauchst du niemanden, der dabei war, nur Zugriff auf das Shop-Template oder jemanden, der die Volltextsuche laufen lässt.
Wir nutzen OXOMI nur über die öffentliche API, nicht per JavaScript. Dann betrifft dich diese Abkündigung nicht; sie gilt den Frontend-Integrationen. Ein Blick lohnt trotzdem, weil in vielen Shops beides parallel läuft.
Können wir das mit einem Relaunch verbinden? Kann man, sollte man aber nicht davon abhängig machen. Relaunches verschieben sich, der Termin nicht.
