OTTO Products API v5 2026: GPSR-Rollenfelder migrieren

OTTO Products API v5: Warum die neuen GPSR-Rollenfelder Pflicht sind, wie Sie Distributor-Daten migrieren und Depublizierung 2026 vermeiden.

Die offizielle OTTO-API-Dokumentation führt 2026 nur noch Endpunkte unter /v5/ – Products API v4 taucht dort nicht mehr auf. Wer seine Artikel noch über eine alte v4-Anbindung oder einen nicht aktualisierten Middleware-Export pflegt, riskiert fehlschlagende Updates und im schlechtesten Fall depublizierte Artikel.

Der Kern der Umstellung: OTTO hat die GPSR-Pflichtangaben aus dem freien Textfeld in ein strukturiertes Rollenfeld verschoben. Mindestens eine Distributor-Rolle ist jetzt zwingend pro Artikel hinterlegt, Manufacturer-Angaben sind optional, und für Lebensmittel sowie Tierfutter gilt ein eigener Operator-Satz.

Lengow etwa migrierte seine Kunden am 2. Dezember 2025 und verlangte die korrekte Befüllung des neuen Attributs bis zum 10. Dezember 2025, "um Ihre Produkte veröffentlicht zu halten" – andere Anbieter wie PlentyONE übernahmen die Migration automatisch im Hintergrund. Genau diese Uneinheitlichkeit macht die OTTO Products API v5 2026 zur stillen Stolperfalle.

Niemand informiert Sie zuverlässig, ob Ihre eigene Anbindung die neuen Rollenfelder schon korrekt setzt. Dieser Leitfaden zeigt, was sich technisch geändert hat, wie Sie Ihren Status prüfen und wie Sie die Migration in sieben Schritten sauber abschließen.

Was sich von API v4 zu v5 technisch geändert hat

OTTO hat die Products API v5 im Oktober 2025 im Beta-Betrieb gestartet und seitdem schrittweise zur stabilen, einzig dokumentierten Version gemacht. Die alte v4 erhielt im November 2024 zuletzt ein größeres Update und ist in der aktuellen Entwicklerdokumentation von api.otto.market nicht mehr referenziert.

Der sichtbarste Unterschied betrifft den GPSR-Block im Artikel-Datensatz. In v4 lagen Herstellerangaben und die Angaben zur verantwortlichen Person meist als lose, teils redundante Einzelfelder vor. In v5 fasst OTTO sie in einem Array namens compliance.productSafety.addresses zusammen, in dem jede Adresse eine explizite Rolle trägt: Distributor, Manufacturer oder – für bestimmte Kategorien – ein eigener Operator-Typ.

Zusätzlich hat OTTO die Feldnamen innerhalb der bestehenden GPSR-Struktur umbenannt. Wer seine Produktdaten per eigenem Skript oder über eine ältere Middleware-Konfiguration generiert, die auf die alten Feldnamen verweist, bekommt bei einem Update entweder einen Validierungsfehler zurück oder – schlimmer – die Angaben werden stillschweigend nicht übernommen.

OTTO reagiert mit diesem Schritt letztlich auf eigene Durchsetzungslücken: Solange GPSR-Daten nur als freier Text vorlagen, ließen sich fehlende oder widersprüchliche Angaben kaum automatisiert prüfen. Ein strukturiertes Rollenfeld lässt sich dagegen pro Artikel maschinell validieren, bevor ein Update überhaupt live geht.

Für Sie als Otto-Händler bedeutet das: Die inhaltliche GPSR-Pflicht selbst ist nicht neu, sie gilt unverändert seit Dezember 2024. Was sich ändert, ist der technische Transportweg dieser Daten in die neue API-Struktur von OTTO.

Mehr zu den inhaltlichen GPSR-Pflichtangaben – Herstellerdaten, verantwortliche Person, Warnhinweise – lesen Sie im Beitrag Otto GPSR 2026. Dort steht, WAS Sie angeben müssen, hier geht es darum, WIE das technisch in der neuen API-Struktur ankommt – und was passiert, wenn es nicht ankommt.

Die neuen GPSR-Rollenfelder im Detail

Das zentrale neue Pflichtfeld heißt in der API-Dokumentation compliance.productSafety.addresses.roles. OTTO verlangt, dass jedem Artikel mindestens eine Adresse mit der Rolle Distributor zugeordnet ist – ohne dieses Feld akzeptiert die API den Artikel-Datensatz nicht oder markiert ihn als unvollständig.

Die Distributor-Rolle entspricht im Kern der "verantwortlichen Person", die GPSR bereits seit 2024 verlangt: Name, Anschrift und Kontaktdaten einer in der EU ansässigen Stelle, die für Produktsicherheitsfragen erreichbar ist. Sind Sie als Händler selbst Hersteller oder haben Sie diese Rolle vertraglich übernommen, tragen Sie Ihre eigenen Daten ein.

Die Manufacturer-Rolle ist optional und ergänzt die Distributor-Angabe um die tatsächlichen Herstellerdaten, falls diese von Ihren eigenen abweichen. Wenn Hersteller und verantwortliche Person identisch sind, tragen Sie laut PlentyONE-Dokumentation dieselben Angaben in beiden Rollen ein – ein doppelter Eintrag, kein Fehler.

Für Lebensmittel und Tierfutter ersetzt OTTO beide Rollen durch einen eigenen Operator-Satz: Hier reicht laut offizieller Spezifikation die Adresse des Lebensmittel- oder Futtermittelunternehmers, mindestens ein Adressfeld muss befüllt sein. Distributor- und Manufacturer-Felder werden in diesen Kategorien schlicht ignoriert, selbst wenn Sie sie weiterhin senden.

Wichtig für die Praxis: Das neue Rollenfeld ersetzt keine der inhaltlichen GPSR-Pflichten aus der Verordnung 2023/988. Es ist lediglich der strukturierte Container, in dem OTTO diese Pflichtangaben jetzt technisch erwartet. Wer die Inhalte schon korrekt pflegt, aber über eine veraltete Feldstruktur sendet, erfüllt das Gesetz – aber nicht die aktuelle API-Erwartung von OTTO.

Warum Ihre Middleware-Anbindung zur Stolperfalle wird

Die meisten OTTO-Händler pflegen ihre Artikel nicht direkt über die OTTO Products API v5, sondern über ein ERP-System, eine Multichannel-Middleware oder eine Agentur-Anbindung. Genau hier liegt das eigentliche Risiko der Umstellung: Jeder Anbieter hat die Migration zu einem anderen Zeitpunkt und mit einer anderen Strategie vollzogen.

Lengow migrierte seine Kunden am 2. Dezember 2025 auf v5 und kommunizierte eine harte Frist: Das neue Rollenfeld musste bis zum 10. Dezember 2025 manuell befüllt werden, sonst drohte laut eigener Ankündigung, dass Produkte nicht mehr veröffentlicht werden.

PlentyONE dagegen beschreibt in der eigenen Dokumentation, dass für die meisten Nutzer "keine Aktion erforderlich" war, weil die bestehenden Distributor-Daten automatisch in die neue Rollenstruktur übernommen wurden.

Diese beiden Beispiele zeigen das Grundproblem: Es gibt keinen einheitlichen, für alle Händler gültigen Stichtag. Ob Sie betroffen sind, hängt davon ab, welches System Sie nutzen, seit wann Sie es nutzen und ob Ihr Anbieter die Migration automatisch oder manuell gestaltet hat. Wenn Sie sich auf eine Information verlassen, die für ein anderes System galt, bleiben Sie im Unklaren über Ihren eigenen Status.

Weitere Multichannel-Anbieter und ERP-Konnektoren kommunizieren ihre jeweilige Migration ausschließlich über die eigene Hilfe-Dokumentation, nicht zentral über OTTO selbst. Wer mehrere Tools parallel einsetzt – etwa eine Middleware für den Feed-Export und ein separates Preistool –, muss im Zweifel bei jedem Anbieter einzeln nachfragen.

Besonders riskant ist die Situation für Händler mit einer selbst gebauten oder vor Jahren eingerichteten Direktanbindung an die OTTO Partner Connect API. Hier gibt es keinen Anbieter, der Sie proaktiv informiert. Fehlt das Rollenfeld, kann OTTO einzelne Artikel-Updates zurückweisen, ohne dass dies in Ihrem gewohnten Reporting auffällt – bis die Sichtbarkeit oder die Buy-Box-Chance des betroffenen Artikels spürbar sinkt.

Einen Überblick über die gängigen Anbindungswege – direkte API, Middleware oder ERP-Konnektor – und wie Sie die passende Variante für Ihr Geschäftsmodell wählen, finden Sie im Beitrag OTTO Schnittstelle & Anbindung 2026. MarketplAIce greift unabhängig vom gewählten Anbindungsweg auf die aktuelle OTTO-Artikel-API zu und gleicht Ihre Artikeldaten laufend gegen die gültige Feldstruktur ab.

In 7 Schritten zur GPSR-konformen API-v5-Migration

1. Anbindungsweg identifizieren. Klären Sie, ob Sie direkt über die OTTO Partner Connect API, über eine Middleware wie Lengow oder Channable oder über ein ERP mit OTTO-Konnektor arbeiten.

2. Versionsstand abfragen. Fragen Sie bei Ihrem Anbieter oder in dessen Changelog konkret nach dem Migrationsdatum auf die neue Schnittstellenversion – nicht nach einer allgemeinen Aussage zu "GPSR-Unterstützung".

3. Stichprobe im Partner Connect ziehen. Öffnen Sie fünf bis zehn Artikel verschiedener Kategorien im OTTO Partner Connect und prüfen Sie, ob eine Distributor-Adresse hinterlegt ist und ob der zuletzt übertragene Datensatz fehlerfrei verarbeitet wurde.

4. Lebensmittel- und Tierfutter-Artikel separat prüfen. Diese Kategorien brauchen den Operator-Satz statt Distributor/Manufacturer – kontrollieren Sie sie getrennt von Ihrem übrigen Sortiment.

5. Testartikel aktualisieren. Lösen Sie bei einem unkritischen Artikel bewusst ein Update aus und beobachten Sie die Rückmeldung Ihres Systems auf Validierungsfehler im GPSR-Block.

6. Fehlerprotokolle der letzten 30 Tage durchsehen. Viele Middleware-Systeme protokollieren zurückgewiesene Updates, ohne aktiv zu warnen – suchen Sie gezielt nach Fehlercodes rund um productSafety oder compliance.

7. Monitoring dauerhaft einrichten. Ein einmaliger Check reicht nicht, weil OTTO die Validierungsregeln weiter verschärfen kann. MarketplAIce überwacht Ihre Otto-Listings fortlaufend auf fehlende oder fehlerhaft strukturierte GPSR-Rollenfelder und meldet Abweichungen, bevor sie Umsatz kosten.

Food- und Feed-Kategorien: der Sonderfall

Wenn Sie auf OTTO Lebensmittel, Feinkost oder Tierfutter verkaufen, greift die allgemeine Distributor/Manufacturer-Logik der GPSR-Rollenfelder nicht. OTTO verlangt hier stattdessen Angaben zum Lebensmittel- oder Futtermittelunternehmer nach der einschlägigen EU-Lebensmittelrecht-Systematik, umgesetzt als eigener Operator-Block in der API v5.

Praktisch bedeutet das: Senden Sie für diese Artikel weiterhin Distributor- oder Manufacturer-Daten, ignoriert OTTO diese Felder und erwartet stattdessen mindestens ein befülltes Adressfeld im Operator-Satz. Wer sein Sortiment aus Nicht-Lebensmitteln auf diese Kategorien ausweitet, muss die Feldzuordnung in seiner Anbindung also gesondert konfigurieren – eine Kopieranweisung aus dem restlichen Sortiment reicht nicht.

Dieser Sonderfall betrifft tendenziell eine kleinere Gruppe von Otto-Händlern, aber gerade bei wachsenden Sortimenten mit Nahrungsergänzung oder Snack-Produkten taucht er häufiger auf, als Händler erwarten. Eine einzelne falsch zugeordnete Kategorie reicht, damit OTTO die betroffenen Artikel als unvollständig markiert.

Was Sie heute konkret prüfen sollten

Die OTTO Products API v5 ist 2026 keine Ankündigung mehr, sondern die einzige aktuell dokumentierte Schnittstelle – die alte v4 taucht in der offiziellen Referenz nicht mehr auf. Das eigentliche Risiko liegt nicht in der Migration selbst, sondern in der fehlenden einheitlichen Kommunikation darüber, wer wann wirklich handeln musste.

Nehmen Sie sich deshalb unabhängig von Ihrem Anbieter die Zeit für einen eigenen Check der GPSR-Rollenfelder, statt sich auf eine pauschale "hat sich automatisch erledigt"-Aussage zu verlassen. Gerade Agenturen, die mehrere Mandanten mit unterschiedlichen Anbindungen betreuen, sollten diesen Check für jeden Account einzeln durchführen.

Wenn Sie Ihre Otto-Listings nicht manuell durchgehen wollen, testen Sie, wie MarketplAIce Ihre Artikeldaten automatisiert gegen die aktuelle OTTO-Schnittstelle abgleicht: Jetzt kostenlos registrieren. Welches Paket für Ihre Sortimentsgröße passt, sehen Sie auf der Preise-Seite.

FAQ

Was ist die OTTO Products API v5 genau?

Die Products API v5 ist die aktuelle, seit Oktober 2025 schrittweise eingeführte Version der Artikel-Schnittstelle von OTTO Market. Sie strukturiert unter anderem die GPSR-Pflichtangaben neu in einem Rollenfeld mit Distributor-, Manufacturer- und Operator-Typen. Seit 2026 ist sie die einzig dokumentierte Version in der offiziellen API-Referenz.

Muss ich als Otto-Händler selbst etwas an der API ändern?

Das hängt von Ihrer Anbindung ab. Nutzen Sie eine Middleware oder ein ERP mit OTTO-Konnektor, hat Ihr Anbieter die technische Migration meist bereits übernommen – ob automatisch oder mit nötiger manueller Nacharbeit, unterscheidet sich je Anbieter. Bei einer Eigenentwicklung oder Direktanbindung müssen Sie die neuen Rollenfelder selbst prüfen und gegebenenfalls nachrüsten.

Was passiert, wenn das Distributor-Feld fehlt?

OTTO kann den betroffenen Artikel-Datensatz zurückweisen oder als unvollständig markieren, abhängig von der jeweiligen Validierungsregel und Kategorie. In der Praxis äußert sich das oft als fehlgeschlagenes Update, ohne dass eine auffällige Fehlermeldung in Ihrem gewohnten System erscheint.

Gilt die gleiche Rollenstruktur auch für Lebensmittel und Tierfutter?

Nein. Für diese Kategorien ersetzt OTTO Distributor und Manufacturer durch einen eigenen Operator-Satz nach lebensmittelrechtlicher Logik. Mindestens ein Adressfeld in diesem Operator-Block muss befüllt sein, Distributor- oder Manufacturer-Angaben werden dort nicht berücksichtigt.

Woran erkenne ich, ob mein Anbieter die Migration schon vollzogen hat?

Prüfen Sie das Changelog oder die Hilfe-Dokumentation Ihres Middleware- oder ERP-Anbieters gezielt nach "OTTO Products API v5" oder "GPSR-Rollenfeld". Ergänzend hilft eine Stichprobe im OTTO Partner Connect: Ist bei aktuell gepflegten Artikeln eine Distributor-Adresse sichtbar hinterlegt, ist die Migration auf Ihrer Seite vermutlich bereits aktiv.

Ändert die API v5 auch die inhaltlichen GPSR-Pflichten selbst?

Nein. Die inhaltliche Pflicht zu Herstellerangaben, verantwortlicher Person und Sicherheitshinweisen gilt unverändert seit Dezember 2024 nach der EU-Produktsicherheitsverordnung. Die API v5 ändert nur, in welcher technischen Struktur OTTO diese Angaben erwartet.

Hilft MarketplAIce bei der Prüfung der GPSR-Rollenfelder?

Ja. MarketplAIce gleicht Ihre Otto-Artikeldaten laufend gegen die aktuelle Feldstruktur der OTTO Products API v5 ab und meldet fehlende oder fehlerhaft zugeordnete Distributor-, Manufacturer- oder Operator-Angaben, bevor daraus ein Sichtbarkeitsproblem wird.

Über den Autor

Jorginho Engelmeyer ist Gründer von MarketplAIce und seit über acht Jahren im Bereich Amazon- und Marktplatz-Advertising tätig. Er beschäftigt sich seit Jahren mit der technischen Anbindung von Marktplatz-Schnittstellen und deren Compliance-Anforderungen. → Mehr erfahren