OTTO Market an Odoo anbinden: Partner Connect, Retouren, Auszahlungen

Was OTTO Market besonders macht

OTTO Market setzt ein freigeschaltetes Verkäuferkonto voraus. Verkauft wird auf OTTO.de in Euro, technisch über die OTTO Partner Connect API. Sie umfasst Bestellungen v4, Sendungen v1, Verfügbarkeit v1, Produkte v5 für Preise, Retouren v3 und Belege v3, alle über OAuth2 mit einem API-Benutzer.

Drei Dinge unterscheiden OTTO von Amazon oder eBay. OTTO zieht das Geld beim Käufer ein, deshalb gilt jede importierte Bestellung als bezahlt. OTTO bietet keinen Rechnungs-Upload. Und OTTO prüft Preisänderungen und Produktdaten asynchron, die Details dazu stehen nur im Portal.

Für Odoo heißt das: Der Auftrag entsteht sofort, die Rechnung entsteht in Odoo und bleibt dort, und Preis- oder Produktfehler sehen Sie zuerst im Sync-Protokoll und dann im Detail in Partner Connect.

Zugang über Partner Connect

Nach der Freischaltung Ihres Verkäuferkontos schickt OTTO den API-Benutzernamen und einen Link zum Setzen des API-Passworts. In Partner Connect vergeben Sie das Recht „API-Zugang“. In den Odoo-Kanal tragen Sie den API-Benutzernamen, der mit „api_“ beginnt, und das API-Passwort ein, nicht das Passwort fürs Portal.

Mehr ist nicht nötig: keine App-Registrierung, keine Token-Pflege. Zugangs- und Erneuerungstoken verwaltet das Modul selbst, ein abgelaufenes Token wird einmal erneuert, sonst meldet sich das Modul neu an. OTTO bietet eine Sandbox, die Sie im Kanal mit einem Schalter aktivieren und so gefahrlos testen, bevor der Live-Betrieb startet.

Wie OTTO-Bestellungen zu Odoo-Aufträgen werden

Bestellungen werden alle 15 Minuten geholt, einstellbar von jeder Minute bis täglich, neue Bestellungen drei Tage rückblickend, der Statusabgleich 14 Tage. Der Auftrag entsteht beim Status „PROCESSABLE“ und gilt als bezahlt, weil OTTO das Geld einzieht. Die Summe ergibt sich aus den Positionswerten brutto plus Liefergebühren; Rechnungs- und Lieferadresse kommen getrennt an.

Produkte werden über die SKU zugeordnet, danach über die EAN. Ohne Zuordnung landet die Position auf dem Platzhalterprodukt des Kanals mit einem Vorschlag, Sie bestätigen mit einem Klick. Bruttopreise rechnet der Kern über Ihre Produktsteuern in Nettopreise um, sodass der Auftrag dem vom Käufer bezahlten Betrag entspricht.

Ein Storno durch Käufer, Partner oder Marktplatz stoppt den Auftrag in Odoo: Lieferung und Entwurfsrechnung werden abgebrochen, reservierter Bestand ist wieder frei, eine Gutschrift entsteht nach Ihrer Regel, und eine Notiz am Beleg sagt, warum.

Bestand, Preise und Sendungsnummern

Die Übersicht zeigt, welche Schnittstelle das Modul je Datenart nutzt und wie OTTO darauf antwortet.

Was bei Bestand und Preisen zu beachten ist

Der Bestand geht als Sammelmeldung je SKU an OTTO: die freie Menge im Kanal-Lager minus Sicherheitspuffer, nie unter null, oder eine feste Menge je Zuordnung. OTTO antwortet je SKU; fehlerhafte SKUs bleiben zur Wiederholung vorgemerkt und werden beim nächsten Lauf erneut gemeldet. Menge 0 wird gemeldet, wenn nichts mehr da ist.

Preise gehen je SKU in Euro. OTTO prüft sie asynchron, eine Ablehnung sehen Sie im Portal. Ab Werk sind beide Schalter aus, damit die Anbindung am ersten Tag keine gepflegten Angebote überschreibt. Sendungsnummern gehen als Sendung mit Positionen und Zusteller, sobald Sie den Schalter „Sendungsnummer an OTTO senden“ einschalten.

Retouren: Entscheidung in Odoo, Erstattung durch OTTO

Retouren werden bei jedem Lauf mitgeholt, sobald eine Retouren-Regel aktiv ist: angekündigt mit Rücksende-Tracking, angenommen, abgelehnt oder fehlgeleitet. Nur angenommene Retouren und Bestellungen im Status „RETURNED“ lösen Rücklieferung und Gutschrift nach Ihrer Regel aus; angekündigte, abgelehnte und fehlgeleitete Retouren sind Information. Teilretouren stehen mit „1 von 2 Positionen“ am Beleg, die Entwürfe passen Sie an.

Die Entscheidung treffen Sie mit dem Knopf „OTTO-Retourenentscheidung“ auf der Bestellung. Annahme und Ablehnung laufen nur per Dialog, nie automatisch. Einen Erstattungsknopf gibt es nicht, weil OTTO bei angenommener Retoure selbst erstattet. Sie entscheiden, OTTO zahlt, Odoo spiegelt die Gutschrift.

Produkte einreichen und Belege verbuchen

Der OTTO Product Launcher legt Produkte über die Products API v5 je SKU mit Varianten an und aktualisiert sie. Pflicht sind EAN, Marke und Kategorie-Attribute. Dazu kommen Standardpreis, USt-Klasse, UVP, Aktionspreis mit Zeitfenster und Grundpreis, Höchstbestellmenge, Verpackungseinheiten und -maße sowie der GPSR-Sicherheitskontakt. Bilder kommen als öffentliche URLs im Format JPG oder PNG mit mindestens 500 mal 1000 Pixeln. OTTO moderiert asynchron, der Launcher verfolgt den Status.

Ein Titelfeld gibt es bei OTTO nicht, otto.de baut den Titel aus Kategorie, Marke und Attributen. Lieferart und Lieferzeit kommen aus der Verfügbarkeitsmeldung, nicht aus den Produktdaten.

Einen Auszahlungsbericht liefert OTTO nicht. Das Settlement-Modul holt stattdessen über Belege v3 die Kaufbelege, Erstattungen und Teilerstattungen und bildet je Kalendermonat eine Abrechnung: Kaufbelege als Umsatz, Erstattungen negativ, 90 Tage rückblickend. Auszahlungsstatus und Auszahlungssumme fehlen; die Überweisung stimmen Sie mit Partner Connect ab. Settlement Accounting macht daraus einen Buchungssatz gegen ein Verrechnungskonto.

Was kostet die OTTO-Anbindung?

Alle Preise netto, einmalig je Odoo-Version, erstes Jahr Updates enthalten, danach Update-Plan 25 % des Kaufpreises im Jahr. Die Einrichtung mit einem Kanal, Versand, Druck und zwei Stunden Schulung gibt es ab 990 €.

• Marktplatz-Kern: 249 €, einmal je Odoo-Instanz, Voraussetzung für jeden Kanal.
• OTTO Connector: 349 €, zusammen mit dem Kern 598 €.
• OTTO Product Launcher: 149 € plus Launcher-Basis 199 €.
• OTTO Settlements: 149 € plus Settlement-Basis 149 €; Settlement Accounting 199 €.
• Paket Start mit einem Kanal nach Wahl, Druck und Sendungsverfolgung: 649 €. Paket Multichannel mit drei Kanälen, Launcher und Settlement: 2.190 €.

Dazu oft gefragt