TrackHound

DokumentationThis page in English

Otto Connect

Produktseiten: Otto Connect for Shopify, Otto Connect for Shopware

Otto Connect für Shopify und Otto Connect für Shopware nutzen dieselbe Engine. Diese Anleitung folgt den Seiten der App in der Reihenfolge, in der Sie sie verwenden: Einstellungen, Zuordnung, Prüflauf, Synchronisation, Handlungsbedarf, Belege, Preisnachlass.

Installation

Installieren Sie die App aus dem Shopify App Store. Sie fragt nach Produkten, Bestand, Standorten, Bestellungen, Fulfillments und Kunden: Produkte und Bestand für die Übertragung Ihres Sortiments, Bestellungen und Kunden, um OTTO-Bestellungen in Ihrem Shop anzulegen, Fulfillments für die Versandbestätigung.

Nach der Installation zeigt die Übersicht eine Checkliste mit fünf Schritten: OTTO verbinden, Versandprofil wählen, Zuordnung anlegen, Prüflauf starten, Auf Live umstellen. Jeder Schritt verlinkt die Seite, auf der Sie ihn erledigen.

Übersicht von Otto Connect im Shopify-Admin: Verbindung, Kennzahlen, automatische Aufgaben und die Checkliste für den Start
Übersicht von Otto Connect im Shopify-Admin: Verbindung, Kennzahlen, automatische Aufgaben und die Checkliste für den Start

OTTO verbinden

Sie brauchen ein aktives Verkäuferkonto bei OTTO Market. Öffnen Sie in der App die Einstellungen, wählen Sie die Umgebung (Sandbox zum Testen, Live für echte Bestellungen) und klicken Sie auf „Mit OTTO verbinden“. Sie landen in OTTO Partner Connect, melden sich dort an und geben Otto Connect frei; OTTO schickt Sie zurück auf die Einstellungsseite, die dann die Verbindung anzeigt. Zugangsdaten müssen Sie nicht kopieren.

Wenn Sie lieber einen eigenen API-Client nutzen: Legen Sie ihn in OTTO Partner Connect unter Einstellungen → API-Zugang an (OTTO zeigt das Client-Secret nur ein einziges Mal), öffnen Sie in den Einstellungen der App „Eigene API-Zugangsdaten verwenden“, fügen Sie Client-ID und Client-Secret ein und speichern Sie. Das Secret wird verschlüsselt gespeichert und nie wieder angezeigt; lassen Sie das Feld beim nächsten Speichern leer, um es zu behalten. Danach Verbindung testen: Die App liest die Marken- und Kategorielisten von OTTO und beweist so, dass die Zugangsdaten funktionieren.

Tragen Sie auf derselben Seite den Versandort ein (Ort, Postleitzahl, dreistelliger Ländercode wie DEU); OTTO verlangt ihn in jeder Versandbestätigung.

Versandprofil

OTTO verkauft einen Artikel erst, wenn er einem OTTO-Versandprofil zugeordnet ist. Das Profil legt Lieferart, Versandtage, Bestellannahmeschluss sowie Bearbeitungs- und Transportzeit fest.

Wählen Sie in den Einstellungen eines Ihrer OTTO-Versandprofile oder legen Sie in der App ein neues an: Lieferart (Paket oder eine der Spedition-Varianten), Versandtage, Bestellannahmeschluss in halbstündigen Schritten (MEZ), Bearbeitungs- und Transporttage, zusammen höchstens 72 Tage. Optional legen Sie eine Bearbeitungszeit von 1 bis 99 Tagen fest, die für alle Artikel gilt.

Die App ordnet jeden übertragenen Artikel automatisch diesem Profil zu. Wechseln Sie das Profil, werden alle Artikel neu zugeordnet. Solange kein Profil gewählt ist, steht ein Eintrag unter Handlungsbedarf; in Shopify hat die Checkliste der Übersicht den Schritt Versandprofil wählen.

Zuordnung

OTTO braucht für jedes Produkt eine EAN, eine bekannte Marke, eine OTTO-Kategorie mit ihren Pflichtattributen und Produktsicherheitsdaten. Die Seite Zuordnung übersetzt Ihre Shopify-Daten in diese Struktur.

Allgemein: woher die Marke kommt (ein Produktfeld wie vendor, ein fester Wert oder ein Metafeld), der Standard-Mehrwertsteuersatz und die Standardkategorie für Produkte, auf die keine Regel passt.

Kategorieregeln: eine Regel je Shopify-Produkttyp, zum Beispiel Produkttyp Jacke → OTTO-Kategorie Outdoorjacke. Jede Regel listet Attribute als Zeilen: OTTO-Attribut, Art der Quelle, Wert und ein Häkchen Pflicht. Ist OTTO verbunden, kommen die Attributnamen aus dem OTTO-Katalog, und ein Klick fügt alle Attribute hinzu, die OTTO für die Kategorie erwartet, Pflichtattribute schon angehakt.

OTTO-Kategorien sind Suchfelder: OTTO hat rund 14.500 Kategorien. Tippen Sie einen Teil des Namens (Umlaute gehen auch als ae, oe, ue) und wählen Sie einen Vorschlag. Ein Name, den OTTO nicht kennt, wird rot markiert.

Hersteller: Name und Adresse des Herstellers für die EU-Produktsicherheitsverordnung. Sie sind für jedes Produkt Pflicht und werden mit jeder Variante gesendet.

Erweitert: Als JSON bearbeiten zeigt das vollständige Schema inklusive Umwandlungen und Feldern, die das Formular nicht anzeigt. Speichern dort ersetzt die gesamte Zuordnung.

Art der Quelle: WertBedeutung
Variantenoption: FarbeDer Wert der Variante für die Option Farbe
Metafeld: custom.materialEin Produkt- oder Varianten-Metafeld als namespace.key
Produktfeld: titleEin Produkt- oder Variantenfeld: title, vendor, productType, handle, sku, barcode, price
Fester Wert: GanzjährigDerselbe feste Text für jede Variante
Vorlage: {{title}} {{option.Farbe}}Text aus Feldern und Optionen zusammengesetzt
Tag-Präfix: material:Der Rest eines Tags, der mit dem Präfix beginnt, z. B. material:Wolle → Wolle
Die Seite Zuordnung: Markenquelle, Standard-Mehrwertsteuersatz und eine Kategorieregel mit ihren Attributzeilen
Die Seite Zuordnung: Markenquelle, Standard-Mehrwertsteuersatz und eine Kategorieregel mit ihren Attributzeilen

Prüflauf

Der Prüflauf liest Ihre Produkte, wendet die Zuordnung an und prüft das Ergebnis gegen OTTOs Regeln und den aktuellen Kategoriekatalog, ohne etwas zu senden. Er zeigt eine Zeile pro Problem mit SKU, Feld, Erklärung und nächstem Schritt.

Mit einem Shopify-Suchfilter wie tag:otto prüfen Sie nur einen Teil. Korrigieren Sie die Daten in Shopify, starten Sie erneut und übertragen Sie, sobald keine Probleme mehr angezeigt werden.

CodeWas zu tun ist
MAPPING_SKU_MISSINGDie Variante hat in Shopify keine SKU. Geben Sie jeder Variante eine SKU; OTTO braucht sie als festen Schlüssel.
MAPPING_CATEGORY_UNMATCHEDKeine Kategorieregel passt zum Produkttyp und es gibt keine Standardkategorie. Legen Sie in der Zuordnung eine Regel oder eine Standardkategorie an.
MAPPING_BRAND_UNRESOLVEDDie Markenquelle ist für dieses Produkt leer. Füllen Sie das Feld Hersteller (oder die gewählte Quelle) mit einer Marke, die OTTO kennt.
MAPPING_ATTRIBUTE_MISSINGEin Pflichtattribut (mit * markiert) hat keinen Wert. Füllen Sie die Option, das Metafeld oder das Feld, auf das die Regel zeigt.
MAPPING_ATTRIBUTE_INVALIDEin Wert ließ sich nicht umwandeln (zum Beispiel Text, wo OTTO eine Zahl erwartet). Korrigieren Sie den Wert in Shopify.
SKU_INVALID / PRODUCT_REFERENCE_INVALIDSKU oder Produktreferenz ist zu lang oder enthält Steuerzeichen. Höchstens 50 druckbare Zeichen, keine Leerzeichen am Anfang oder Ende.
SKU_DUPLICATE / EAN_DUPLICATEZwei Varianten teilen sich eine SKU oder eine EAN. Beide müssen im gesamten Sortiment eindeutig sein.
EAN_INVALIDDer Barcode ist keine gültige GTIN (Länge oder Prüfziffer). Tragen Sie die EAN genau so ein, wie sie auf dem Produkt steht.
EAN_INTERNAL_RANGEDie EAN beginnt mit 2, also einem shopinternen Nummernkreis. OTTO akzeptiert nur offiziell vergebene EANs.
IMAGE_MISSING / IMAGE_TOO_SMALL / IMAGE_TOO_LARGE / IMAGE_URL_INVALIDOTTO braucht pro Produkt mindestens ein JPG oder PNG, mindestens 500 × 1000 px und höchstens 4500 px breit, erreichbar über https. Hängen Sie in Shopify ein passendes Bild an.
PRICE_INVALID / CURRENCY_UNSUPPORTEDDer Preis muss größer als 0 und in EUR sein. Stellen Sie die Shop-Währung auf EUR.
COMPLIANCE_MISSINGDie Herstelleradresse für die Produktsicherheit (GPSR) fehlt. Füllen Sie den Herstellerblock in der Zuordnung.
BRAND_UNKNOWN / CATEGORY_UNKNOWNOTTO kennt diesen Marken- oder Kategorienamen nicht. Verwenden Sie die Namen aus dem OTTO-Katalog; die Zuordnungsseite listet die Kategorien.
ATTRIBUTE_REQUIRED / ATTRIBUTE_VALUE_NOT_ALLOWEDDie OTTO-Kategorie verlangt ein Attribut oder erlaubt nur bestimmte Werte (zum Beispiel Größen XS bis XL). Ordnen Sie das Attribut zu und verwenden Sie einen erlaubten Wert.
IMMUTABLE_FIELD_CHANGEDProduktreferenz oder EAN einer SKU, die schon bei OTTO liegt, hat sich geändert. Das akzeptiert OTTO nie: alten Wert behalten oder neue SKU anlegen.
Die Seite Prüflauf mit dem gespeicherten Ergebnis: 75 von 76 Varianten bereit und die zwei Probleme mit dem nächsten Schritt
Die Seite Prüflauf mit dem gespeicherten Ergebnis: 75 von 76 Varianten bereit und die zwei Probleme mit dem nächsten Schritt

Synchronisation

Bestellungen und Retouren werden automatisch abgeholt, weil OTTO keine Webhooks hat: neue Bestellungen alle 2 Minuten, Retouren alle 10 Minuten, Belege alle 30 Minuten. Produkte, Bestand und Preise werden übertragen, wenn sie sich in Shopify ändern (über Shopifys Webhooks) oder wenn Sie auf der Seite Synchronisation eine Aufgabe starten. Mit jeder Produktübertragung ordnet die App die Artikel auch Ihrem OTTO-Versandprofil zu.

Jeder Lauf sendet nur, was sich seit dem letzten erfolgreichen Lauf geändert hat; wiederholte Läufe sind daher günstig und sicher. Das Protokoll am Seitenende listet jeden Lauf mit Ergebnis.

Der Sicherheitsmodus hält einen Bestandsabgleich an, der einen ungewöhnlich großen Teil Ihres OTTO-Bestands auf 0 setzen würde, typisch nach einem fehlerhaften Import in Shopify. Die Schwellen stehen in den Einstellungen; sind die Nullen korrekt, aktivieren Sie „In diesem Lauf viele Artikel auf 0 setzen erlauben“ und starten erneut.

AufgabeAuslöser
ProduktübertragungProdukt in Shopify angelegt oder geändert; Produkte an OTTO übertragen
PreisabgleichProdukt geändert; Preise abgleichen
BestandsabgleichProdukt geändert; Bestand abgleichen (Sicherheitsmodus greift)
BestellimportAlle 2 Minuten; Bestellungen abrufen
RetourenimportAlle 10 Minuten
BelegimportAlle 30 Minuten
Versandprofil-ZuordnungMit jeder Produktübertragung; ein Profilwechsel ordnet alle Artikel neu zu
Die Seite Synchronisation: Schaltflächen zum Ausführen, Aufgabenfilter und das Protokoll der letzten Bestell-, Retouren-, Bestands- und Preisläufe
Die Seite Synchronisation: Schaltflächen zum Ausführen, Aufgabenfilter und das Protokoll der letzten Bestell-, Retouren-, Bestands- und Preisläufe

Bestellungen

Eine OTTO-Bestellung erscheint in Shopify als bezahlte Bestellung aus dem Kanal Otto Connect. Die Lieferadresse ist die von OTTO übermittelte; die E-Mail ist OTTOs Relay-Adresse für diesen Kunden, damit Antworten in OTTOs System bleiben.

Positionen tragen die OTTO-Positions-ID und die EAN als Eigenschaften, Preise sind brutto mit dem Steuersatz je Position, und die Bestellung ist mit OTTO und otto:<Bestellnummer> getaggt. Eine Notiz nennt OTTO-Bestellnummer und Zahlungsart.

OTTO stellt die Kundenrechnung selbst aus. Schicken Sie für OTTO-Bestellungen keine eigene Rechnung; die App importiert OTTOs Belege (siehe Belege).

Testen in der Sandbox: „Testbestellungen anlegen“ auf der Übersicht lässt OTTO Testbestellungen für Ihre Produkte anlegen. Sie werden mit dem nächsten Bestellabruf importiert, spätestens nach wenigen Minuten. Die Schaltfläche gibt es nur in der Sandbox.

Eine aus einer OTTO-Market-Bestellung erzeugte Shopify-Bestellung mit OTTO-Positions-IDs, Mehrwertsteuer und Tags
Eine aus einer OTTO-Market-Bestellung erzeugte Shopify-Bestellung mit OTTO-Positions-IDs, Mehrwertsteuer und Tags

Belege

OTTO stellt Rechnungen und Gutschriften in Ihrem Namen an Ihre Kunden aus. Die App importiert sie alle 30 Minuten.

In Shopify werden Belegnummern und Beträge an der Shopify-Bestellung im Metafeld otto_connect.receipts gespeichert, und die Seite Belege listet die Belege der letzten 90 Tage mit PDF-Download.

In Shopware wird OTTOs PDF als Dokument an der Shopware-Bestellung abgelegt: eine Rechnung für Käufe, eine Gutschrift für Erstattungen.

Versand

Erledigen Sie die Bestellung in Shopify wie gewohnt und tragen Sie Sendungsnummer und Versanddienstleister ein. Die App bestätigt den Versand innerhalb von Sekunden an OTTO; OTTO setzt die Positionen auf versendet und benachrichtigt den Kunden.

Der Versanddienstleister ergibt sich aus dem in Shopify gewählten Namen; mit der Zuordnung der Versanddienstleister in den Einstellungen ordnen Sie eigene Namen zu. Passt kein Name, erkennt die App den Dienstleister am Format der Sendungsnummer.

Format der SendungsnummerVersanddienstleister
1Z + 16 ZeichenUPS
00, JD oder JJD + mindestens 18 Ziffern, oder 20 Ziffern, oder 12 ZiffernDHL
H + 19 ZiffernHermes
14 ZiffernDPD
11 ZiffernGLS

Retouren und Stornierungen

Storniert OTTO Positionen (etwa weil der Kunde vor dem Versand widerruft), storniert die App dieselben Positionen in Shopify; eine Teilstornierung wird auf der Bestellung vermerkt und mit otto:teilstorno getaggt. Stornieren Sie eine OTTO-Bestellung vor dem Versand in Shopify, storniert die App die Positionen bei OTTO.

Von OTTO angekündigte Retouren werden als Retourenereignisse in Ihren Shop importiert. OTTO erstattet dem Kunden selbst; Ihre Aufgabe ist, die Retoure nach Eingang des Pakets anzunehmen oder abzulehnen.

Preisnachlass

Um einem Kunden einen Teil des Preises für einen versendeten, nicht retournierten Artikel zu erstatten, etwa bei einem kleinen Mangel, öffnen Sie die Seite Preisnachlass und laden die OTTO-Bestellung über ihre Nummer. Die Seite zeigt den Rechnungsbetrag, die bisherigen Erstattungen und den höchstens noch möglichen Betrag. Geben Sie den Betrag ein und bestätigen Sie; OTTO zahlt ihn aus und stellt eine Teilgutschrift aus.

Ein Preisnachlass ist eine bewusste manuelle Aktion. Erstattungen in Shopify oder Shopware werden nicht an OTTO weitergegeben, damit nichts doppelt erstattet wird. Vor dem Versand stornieren Sie stattdessen; retournierte Artikel werden über die Retoure erstattet.

Handlungsbedarf

Jeder Fehler, der eine Entscheidung von Ihnen braucht, landet hier genau einmal, mit SKU, Erklärung und nächstem Schritt: Daten korrigieren, Später erneut versuchen, OTTO neu verbinden oder Support kontaktieren. Nach dem Beheben der Ursache drücken Sie Erneut versuchen; Einträge schließen sich automatisch, sobald der nächste Lauf dieser SKU gelingt, oder Sie markieren sie als erledigt.

Die Übersicht zeigt die Anzahl und den Zustand jeder Aufgabe (letzter Lauf, letzter Erfolg), damit Sie auf einen Blick sehen, wenn etwas hängt.

Die Seite Handlungsbedarf mit jedem Problem, seiner Erklärung, dem nächsten Schritt, Erneut versuchen und Als erledigt markieren
Die Seite Handlungsbedarf mit jedem Problem, seiner Erklärung, dem nächsten Schritt, Erneut versuchen und Als erledigt markieren