Zum Inhalt springen
SDXS

TikTok Shop für Odoo

Marktplatz-Connector · Odoo 19 lieferbar, Odoo 20 auf Anfrage · Community und Enterprise

TikTok-Shop-Bestellungen in Odoo, Bestand und Preise synchron.

Kern ist PflichtOhne den Sales Channel Connector – Kern läuft TikTok Shop Connector nicht. Der Kern ist die Grundlage für jedes Kanal-Modul und kostet einmal je Odoo-Instanz; weitere Module brauchen ihn dann nicht noch einmal.

Schnittstelle
TikTok Shop Open API 202309
Takt
Alle 15 Minuten, einstellbar von jeder Minute …
Odoo
19, Community und Enterprise
Lizenz
Kauf einmalig, OPL-1

Was das Modul macht

  • Bestellungen automatisch als Odoo-Verkaufsauftrag
  • Bestand senden
  • Preise senden
  • Tracking melden
  • Retouren werden erkannt

Aus dem Marktplatz-Kern, immer dabei

Das bringt der Sales Channel Connector – Kern mit. Sie kaufen ihn einmal, jedes Modul nutzt ihn.

  • Eine Eingangsliste für alle Kanäle, jede Bestellung wird automatisch ein Odoo-Verkaufsauftrag
  • Produkt-Zuordnung mit Vorschlägen über EAN und SKU, Platzhalter statt Blockade
  • Steuern aus Ihren Odoo-Regeln, Ausgleich auf den tatsächlich gezahlten Betrag
  • Rechnung je Kanal: aus, Entwurf, gebucht oder gebucht und bezahlt, mit Doppelsende-Schutz
  • Bestand nach jeder Änderung an alle Kanäle, mit Puffer je Kanal und Niedrigbestand-Alarm
  • Storno- und Retourenablauf nach Ihren Regeln, Sync-Protokoll mit Fehlerdetails, Wiederholung mit steigendem Abstand
  • Dashboard je Kanal: Umsatz heute und im Monat, offene Aufträge, versendet, Fehler
  • Zugangsdaten verschlüsselt, Rollen Benutzer und Manager, Multi-Company
  • Jeder Sendeschalter ist ab Werk aus

So arbeitet das Modul im Einzelnen

Geprüft am Modul selbst, Stand Oktober 2026. Was hier nicht steht, kann das Modul nicht.

  1. Der Auftrag entsteht bei „AWAITING_SHIPMENT“; „UNPAID“ gilt als unbezahlt, ohne Rechnung.
  2. Retouren nach Änderungszeit; am Beleg stehen Retourenart (Erstattung ohne Rücksendung, Rücksendung und Erstattung, Ersatz), Grund, Betrag, Rücksende-Tracking und Positionen.
  3. Positionen je Einheit werden je SKU zusammengefasst.
  4. Bestand je Produkt-ID und SKU-ID am Kanal-Lager; Preis je SKU in Kanalwährung.
  5. Sendungsnummer als Selbstversand mit Versanddienstleister (DHL, DPD, UPS, FedEx, GLS, Hermes, Deutsche Post).

So läuft eine TikTok Shop-Bestellung durch Odoo

Jeder Schritt als Beleg, mit erfundenen Beispielwerten. So sieht der Weg aus, den jede Bestellung nimmt.

  1. 01BestellungTikTok Shop · 09:41
    Bestellnummer…-4471
    2 × Artikel89,80 €
    Statusbezahlt

    Der Käufer bestellt und bezahlt auf TikTok Shop. Sie tun nichts.

  2. 02AbrufOdoo · bis 09:56
    KanalTikTok Shop
    Produkteüber EAN zugeordnet
    Kundeangelegt oder erkannt

    Das Modul holt neue Bestellungen im eingestellten Takt, ab Werk alle 15 Minuten. Doppelte Abrufe erzeugen keine doppelten Aufträge.

  3. 03VerkaufsauftragOdoo · 09:56
    AuftragS00412
    Steuernaus Ihren Regeln
    Rechnungje Einstellung

    Der Auftrag entsteht mit Kunde, Positionen, Steuern und Versandkosten, auf den Cent wie vom Käufer bezahlt. Die Lieferung ist angelegt.

  4. 04VersandLager · 11:05
    LieferungWH/OUT/00412
    Etikettaus der Versand-Suite
    SendungsnummerJJD 0000 1…

    Sie packen und versenden wie immer. Das Etikett kommt aus Odoo, wenn Sie die Versand-Suite nutzen.

  5. 05RückmeldungTikTok Shop · 11:06
    Sendungsnummergemeldet
    Rechnungin Odoo
    Bestandaktualisiert

    Was Sie eingeschaltet haben, geht automatisch zurück an TikTok Shop. Der Käufer sieht die Sendungsnummer.

So sieht es aus

Drei Bildschirme, die Sie nach der Einrichtung täglich sehen: die Liste, die Einstellungen und das Protokoll. Schematisch gezeichnet, damit Sie wissen, was Sie bekommen.

Marktplatz › Eingangheute 14 · offen 2
KanalBestellungKäuferBetragAuftragStatusTikTok Shop DE…-4471M. Huber89,80 €S00412neuTikTok Shop DE…-4470S. Keller249,00 €S00411gepacktTikTok Shop AT…-4468J. Novak34,50 €S00409versendetTikTok Shop DE…-4466L. Brandt118,20 €S00407Produkt zuordnenTikTok Shop DE…-4465A. Mayer61,90 €S00406versendet
Schematische Darstellung mit Beispieldaten, keine Abbildung der Odoo-Oberfläche.
Kanal › TikTok Shop DE › Einstellungen
Auftrag entsteht ab Statusbezahlt
Rechnunggebucht
LagerWH/Stock
Bestandspuffer2 Stück
Abrufalle 15 Min
Bestand sendennach jeder Änderung, mit Puffer
Preise sendenab Werk aus, Sie schalten ein
Sendungsnummern meldenbei jeder Lieferung
Rechnung hochladenbietet dieser Kanal nicht
Beispiel nach der Einrichtung. Ab Werk ist jeder Sendeschalter aus, Sie schalten ein, was laufen soll.
Kanal › TikTok Shop DE › Protokoll
  • 09:41:02Abruf TikTok Shop: 3 neue Bestellungen, 0 Änderungen
  • 09:41:03…-4471 → Verkaufsauftrag S00412, Kunde erkannt, 2 Positionen über EAN
  • 09:41:03…-4466 → wartet: Produkt 4006381… nicht zugeordnet, Vorschlag über EAN liegt vor
  • 09:42:10Bestand an TikTok Shop: 12 Artikel aktualisiert (Puffer 2)
  • 11:06:31Sendungsnummer JJD 0000 1… an TikTok Shop gemeldet, Bestellung …-4471
Jeder Schritt mit Zeit, Ergebnis und Fehlergrund. Nichts passiert still.

Was passiert, wenn …

Die Fälle, die im Alltag vorkommen, und was das Modul dann tut. Geprüft am Code, nicht am Prospekt.

Der Käufer storniert auf dem Marktplatz.
„CANCELLED“ stoppt den Auftrag in Odoo. Lieferung und Entwurfsrechnung werden abgebrochen, reservierter Bestand ist wieder frei, eine Gutschrift entsteht nach Ihrer Regel. Eine Notiz am Beleg sagt, warum.
Eine Retoure kommt.
Nur abgeschlossene Erstattungen und Rücksendungen lösen Rücklieferung und Gutschrift aus; beantragte, versendete oder abgelehnte sind Information. Genehmigen und Ablehnen bleibt im Seller Center.
Sie müssen erstatten.
Keine Erstattung aus Odoo. Genehmigen und Ablehnen erledigen Sie im Seller Center, das Modul spiegelt das Ergebnis.
Der Marktplatz ist gerade nicht erreichbar.
Wiederholung bei Überlastung und Serverfehlern; Fehlercodes von TikTok werden mit Meldung gezeigt. Schlägt die Lager-Ermittlung fehl, bleiben Zuordnungen zur Wiederholung vorgemerkt.
Eine Bestellung kommt doppelt an.
Jede Marktplatz-Bestellnummer wird je Kanal nur einmal zum Auftrag. Ein zweiter Abruf erkennt sie und legt nichts Neues an.
Ein Produkt ist in Odoo nicht zugeordnet.
Zuordnung über Produkt-ID, dann Seller-SKU. Sonst landet die Position auf dem Platzhalterprodukt des Kanals, mit Vorschlag.
Der Bestand geht auf null.
Der neue Bestand geht beim nächsten Lauf an TikTok Shop, abzüglich des Puffers, den Sie je Kanal setzen. 0 wird gesetzt. Der Niedrigbestand-Alarm meldet sich vorher.

Zugang und Voraussetzungen

Was Sie brauchen, bevor es losgeht, und was ausdrücklich nicht.

Schnittstelle
TikTok Shop Open API 202309: Bestellsuche, Produkt-Inventar und -Preise, Paket versenden, Logistik, Retouren-Suche; jede Anfrage HMAC-SHA256-signiert, der Zugriffstoken erneuert sich automatisch
Konto beim Anbieter
TikTok-Shop-Händlerkonto und eine Partner-App im TikTok Shop Partner Center, die Sie als Händler autorisieren (Scopes seller.return_refund.basic für Retouren, seller.finance.info für Abrechnungen)
Was eingetragen wird
App Key, App Secret, Refresh Token und Shop Cipher des autorisierten Shops
In Odoo
Verkauf, Lager, Rechnungen (Standard-Apps von Odoo)
Takt
Alle 15 Minuten, einstellbar von jeder Minute bis täglich; neue Bestellungen rückblickend 3 Tage, Statusabgleich 14 Tage
Sofortmeldung
Keine Sofortmeldung vom Anbieter, Bestellungen werden nach Zeitplan geholt. Nach außen: signierte Webhooks für Bestellung, Sendungsnummer und Rechnung, zum Beispiel für n8n.
Im Formular
  • App Key, App Secret, Refresh Token, Shop Cipher
  • Währung: EUR, USD, GBP, IDR, MYR, THB, VND, PHP, SGD
  • Sendungsnummer an TikTok Shop senden
  • Retouren-Regeln: schalten die Retouren-Suche frei
Nicht nötig
  • Kein Sandbox-Schalter
  • Keine Lager-ID von Hand, sie wird automatisch ermittelt
  • Kein Odoo Enterprise

Gut zu wissen

Grenzen, die wir lieber vorher sagen.

  • Retouren annehmen oder ablehnen erfolgt im TikTok-Seller-Center
  • Kein Rechnungs-Upload
  • Kein Zurücklesen des Marktplatzbestands
  • Retouren genehmigen oder ablehnen bleibt im Seller Center
  • Das Verhalten ist regionsabhängig; wir prüfen es bei der Einrichtung im Sandbox des Partner Centers

Passt dazu

Fragen dazu

Brauche ich Odoo Enterprise?

Nein. Alle Module laufen auf Odoo 19, Community und Enterprise; Odoo 20 folgt auf Anfrage. Einzige Ausnahme: Die Amazon-Enterprise-Brücke ergänzt Odoos eigenen Amazon-Connector und setzt deshalb Enterprise voraus. Für Amazon ohne Enterprise nutzen Sie das Modul Amazon SP-API.

Werden Bestellungen automatisch zu Verkaufsaufträgen?

Ja. Sie stellen je Kanal ein, ab welchem Marktplatz-Status ein Auftrag entsteht, zum Beispiel erst nach Zahlungseingang. Steuern und Steuerposition kommen aus Ihren Odoo-Steuerregeln; der Auftrag wird auf den tatsächlich gezahlten Bruttobetrag abgestimmt.

Wie funktioniert der Bestandsabgleich?

Bei jeder Bestandsänderung in Odoo wird der neue Wert sofort an den Kanal gesendet. Je Produkt und Kanal entscheiden Sie: Odoo-Bestand folgen oder fester Kanalbestand. Ein Sicherheitspuffer je Kanal verhindert Überverkauf. Sie können außerdem den Bestand vom Marktplatz lesen und mit Ihrem vergleichen.

Was passiert bei Stornos und Retouren?

Stornos vom Marktplatz kommen automatisch an und laufen über denselben Ablauf wie ein Storno in Odoo. Für Retouren legen Sie je Kanal Regeln fest: Rücklieferung als Entwurf oder validiert, Gutschrift ja oder nein, Frist. Bei Kaufland und OTTO entscheiden Sie Retouren direkt aus Odoo. Erstattungen aus Odoo heraus sind bei Kaufland, Shopify, WooCommerce, Medusa, Temu und Stripe möglich; Amazon erstattet dem Käufer selbst.

Was passiert, wenn der Marktplatz nicht erreichbar ist?

Nichts geht verloren. Fehlgeschlagene Übertragungen landen in einer Wiederhol-Warteschlange mit steigendem Abstand. Jeder Versuch steht im Sync-Protokoll mit der Antwort des Marktplatzes, und am Beleg erscheint eine Notiz.

Wie funktionieren Updates nach dem ersten Jahr?

Mit dem Update-Plan: 25 % des Kaufpreises im Jahr. Darin sind alle neuen Versionen des Moduls, Anpassungen, wenn ein Marktplatz seine Schnittstelle ändert, und Fehlerbehebungen. Ohne Update-Plan läuft das Modul weiter, bekommt aber keine neuen Versionen. Der Plan ist jährlich kündbar.

TikTok Shop Connector: Passt das zu Ihrem Odoo?

Sagen Sie uns Ihre Odoo-Version und wie Sie heute arbeiten. Wir prüfen, ob das Modul passt, und schicken ein Angebot mit Installation, wenn Sie wollen.

Angebot anfragenPakete und Preise
FestpreisAntwort innerhalb von drei Werktagen · Festpreis statt Stundenabrechnung · Angebote für Unternehmer