Architektur — High-Level¶

Wie Workflows, Sheets, externe Systeme und APIs bei mokebo zusammenhängen. Stand 2026-05-12 nach SUB-Retoure-Go-Live.

Detail-Diagramme: CS-Automatisierung, Ops-Integrationen, Datenflüsse.

Stack-Karte¶

flowchart TB
  subgraph External [Externe Systeme]
    ZD[Zendesk
mokebo.zendesk.com]
    PL[PlentyOne
p38991]
    SH[Shopify]
    GLS[GLS API]
    DHL[DHL API]
    R8[8returns]
    AMZN[Amazon-RSA
donotreply@amazon.com]
  end

  subgraph N8N [n8n Cloud EU]
    direction TB
    MOKI["MOKI Dispatcher v2
zikmLDiFPNI4bLmr
Cron 7:00"]
    R01["01 Retouren-Erfassung
BnHOfJJ0uOvnntSY
Cron 8:30"]
    R02["02 Retouren-Check
9qzWLsxK4GhEgrTN
Cron 9:00"]
    HB["Stack Heartbeat
IxIb56GHsq4VZ6ex
manuell"]
  end

  subgraph SUBS [Subworkflows in MOKI]
    SLU[SUB PlentyOne Lookup
MP2Qehccz0sNPdZ0]
    SSE[SUB Sendungsstatus
FeYVYMW0LzpcTpPJ]
    SRE["SUB Retoure ⭐
EwGhdDQ7rZfpvPum"]
    SRC[SUB Rechnung]
    SCS[SUB CS Hold]
  end

  subgraph G [Google]
    SHEETS[Sheets:
Ticket Log v2,
Retouren-Tracking,
MOKI Config]
    APPS[Apps Script:
UGC Intake,
Procontour Stock]
  end

  subgraph LLM
    CL[Claude API
Intent-Klassifikation]
    GE[Gemini API]
  end

  AMZN --> ZD
  ZD --> MOKI
  MOKI --> SLU
  MOKI --> SSE
  MOKI --> SRE
  MOKI --> SRC
  MOKI --> SCS
  MOKI --> CL
  MOKI --> SHEETS
  SLU --> PL
  SRE --> PL
  PL --> R01
  R01 --> SHEETS
  SHEETS --> R02
  R02 --> GLS
  R02 --> DHL
  R02 --> ZD
  HB --> PL
  HB --> ZD
  HB --> SH
  APPS --> SHEETS
  APPS --> PL
  R8 -.-> PL

Tagesrhythmus (Cron-Workflows)¶

Datenflüsse — kritische Pfade¶

Eingehende Retouren-Anfrage (CS-Pfad)¶

1. Kunde mailt → Zendesk-Ticket
2. Am nächsten Morgen 7:00 Uhr: MOKI Dispatcher klassifiziert Intent
3. Bei Intent retoure → SUB Retoure:
4. Amazon-RSA-Mail (Subject + donotreply@amazon.com) → Plenty-Retoure auto anlegen + Marker-Comment + Tracking-Comment mit [n8n Amazon-RSA #<ticketId>]-Prefix
5. Sonst → Internal Note mit Portalverweis-Link + Loop-Schutz-Tag portalverweis-gesendet
6. Plenty-Retoure ist live → am nächsten Tag 8:30 holt 01 Retouren-Erfassung sie ins Tracking-Sheet (Marker-Priorisierung greift!)
7. 02 Retouren-Check (9:00) trackt Sendung bei GLS/DHL bis Endstatus
8. Bei Endstatus → automatisches Zendesk-Ticket für CS (Gutschrift / Carrier-Nachfrage / 21d-Abschluss)

Standard-Anfrage (nicht Retoure)¶

1. Kunde mailt → Zendesk-Ticket
2. MOKI Dispatcher (7:00) klassifiziert Intent
3. Je nach Intent → SUB PlentyOne Lookup → SUB Sendungsstatus / SUB Rechnung / SUB CS Hold
4. Internal Note + Antwort-Vorschlag im Ticket → CS bearbeitet final

Wichtige Speicher-Orte¶