Glossar

Die internen Akronyme und Begriffe, die in mokebo-Doku, Slack-Threads und n8n-Workflows ständig auftauchen. Wenn du irgendwo ein Wort siehst, das du nicht kennst — hier sollte es stehen. Wenn nicht, bitte Susi pingen und ergänze es selbst.

A

ADR (Architectural Decision Record)

Eine notierte Entscheidung mit Datum, Begründung und geprüften Alternativen. Liegt in Decisions. Format: YYYY-MM-DD-thema.md.

apoio

Plenty-Plugin, über das CS hauptsächlich arbeitet (Tickets, Retouren, Bestellungen). Eigene ownerId 67 in Plenty — daran erkennt man händisch über apoio angelegte Vorgänge.

Auto-Sync / DAILY mokebo-ops Sync

Geplanter n8n-Workflow, der nachts den Status aller Workflows aus n8n-API zieht und das Status-Dashboard hier auf der Site automatisch aktualisiert. Status: noch nicht gebaut, aber Vorbereitung in Workflow-Karten ist da (<!-- AUTO:STATUS --> Marker).

B

B2B-Rollout

Erweiterung der Workflows für Geschäftskunden. Siehe Decision 2026-05-06.

C

Carrier

Versanddienstleister. Bei mokebo aktiv: GLS, DHL, Hermes (in Phase 2 für RSA), DPD.

CS-Hold

Sub-Workflow SUB CS Hold. Wenn MOKI ein Ticket nicht klassifizieren oder lookupen kann, landet es hier mit Tag + Internal Note für CS-Mensch zur manuellen Bearbeitung.

D

Dispatcher

→ siehe MOKI Dispatcher.

Dropship

Versandmodell. Bei mokebo: Lager wird vom Lieferanten (z.B. procontour, MAGMA) geführt, nicht von mokebo selbst. Lager-IDs am Auftrag immer prüfen.

E

externalOrderId

ID, mit der ein Marketplace (Amazon, XXXLutz) seine Bestellnummer in PlentyOne speichert. Im Plenty unter orderItems[].properties mit typeId: 7.

F

Failed Execution

Ein n8n-Workflow-Lauf, der mitten in der Pipeline gestoppt hat (Error). In n8n unter Executions → Filter „Failed". Erste Diagnose-Anlaufstelle bei kaputten Workflows.

H

Handover

Strukturierte Übergabe einer Aufgabe oder eines Workflows an die nächste Person. Bei mokebo-ops aktuell: handover.md im Repo-Root.

Hermes Phase 2

Beim Auto-Anlegen einer Retoure aus Amazon-RSA wird Hermes-Tracking bewusst übersprungen (Phase 1). In Phase 2 wird Tracking + Regex + Carrier-Map nachgezogen. Bei Hermes-RSAs landet sub_action: retoure_amazon_rsa_skipped_hermes im Log.

I

Idempotency-Marker

Comment am Hauptauftrag im Format [n8n] Auto-Retoure für Amazon-RSA Ticket #<ticketId> angelegt: Retoure <retourenAuftragId>. Verhindert Doppel-Anlage in SUB Retoure. Plenty kann Children eines Parents nicht direkt finden — der Marker ersetzt den Reverse-Lookup.

Intent

Klassifikations-Output von MOKI Dispatcher v2. Beispiele: portalverweis, rechnung, sendungsstatus, cs_hold. Bestimmt, welcher Sub-Workflow gerufen wird.

Internal Note

Notiz im Zendesk-Ticket, nur intern sichtbar (nicht für Kunden). MOKI legt nach jedem Run eine Internal Note an mit lookup_status, intent, sub_action.

L

Lookup

Vorgang, bei dem ein Workflow versucht, zu einem Ticket den passenden Plenty-Auftrag zu finden — über Bestellnummer, externalOrderId oder Email. Ergebnis: lookup_status = found / not_found / skipped / error.

M

Marker-Comment / [n8n Amazon-RSA-Prefix

Spezielles Comment-Format am Retouren-Auftrag, das SUB Retoure schreibt: [n8n Amazon-RSA #<ticketId>] Retourensendung angemeldet: DHL, Sendungsnummer: <number>. Triggert in 01 Retouren-Erfassung eine Priorisierungs-Logik: bei Marker-Vorhandensein wird der Plenty-Auto-Comment ignoriert, nur der Amazon-Comment landet im Tracking-Sheet (Carrier wird zu DHL-Prime / GLS-Prime).

Marketplace-Forwarder

Email-Adressen wie marketplace@…, donotreply@…, reply+…, die NICHT die echte Kunden-Email sind. Wichtig: für solche Emails KEINEN Email-Lookup machen → falsche Customer-Matches.

MKB-…

mokebo-Internes Format für externe Bestellnummern (z.B. MKB-12345). Wird vom Regex-Extraktor in SUB PlentyOne Lookup als Pattern #1 erkannt.

MOKI / MOKI Dispatcher

KI-gestützter Triage-Dispatcher für Zendesk-Tickets. Klassifiziert Intent, ruft Sub-Workflows auf, schreibt Internal Notes, draftet Antworten. Aktuell v2 (Karte). Aktuell auf Whitelist-Rollout.

Mokebo Gang

Eines der zwei n8n-Projekte (Personal-Projekt, ID Y6M7vNhKKlTBOBX3). Default-Ablage neuer Workflows ist aber Susi Projects.

N

n8n

Open-Source Workflow-Automatisierungs-Tool. Mokebo nutzt n8n Cloud EU (Starter-Plan): https://ai-mokebo.app.n8n.cloud/.

n8n-api (User in PlentyOne)

Der dedizierte API-User in PlentyOne, mit dem alle n8n-Workflows authentifizieren. User ID 78. Nicht für manuelle Tests verwenden — sonst Login-Lock.

O

Output-Convention

Standard-Format, das alle Sub-Workflows zurückgeben sollen: { ticketId, sub_action, sub_status, sub_reason, sub_macro_id, sub_message }. Vorlage: SUB Sendungsstatus. SUB Portalverweis hält sich aktuell noch nicht dran (offener Bug).

ownerId

User-ID in PlentyOne, die anzeigt, wer einen Vorgang angelegt hat. Mokebo-Werte: 78 = n8n, 67 = apoio, 2 = System-Import.

P

PlentyOne / Plenty

Mokebos Warenwirtschaftssystem. Instanz p38991.my.plentysystems.com. Speichert Aufträge, Retouren, Kunden, Artikel.

Procontour

Möbel-Lieferant + Lager (Dropship). Eigener Stock-Import-Workflow (Apps Script).

R

Referrer / Auftragsherkunft

Wo eine Bestellung herkommt. Mokebo-Custom-IDs (NICHT Plenty-Standard!): 4.01 = Amazon Germany. Vor jeder Integration via GET /rest/orders/referrers validieren.

RSA (Return Shipping Authorization)

Amazon-spezifischer Retoureschein-Vorgang. Wenn ein Amazon-Kunde retourniert, kommt ein RSA-Event rein, wir legen daraus automatisch eine Retoure in Plenty an. Hermes-Tracking siehe „Hermes Phase 2".

Runbook

Schritt-für-Schritt-Anleitung für CS, prozedural geschrieben (Wenn-Dann). Liegt unter Runbooks.

S

SOR (System of Record) / Single Source of Truth

Diese Doku-Site. Alles, was Susi baut, soll genau einmal dokumentiert sein, mit klarem Owner.

Stolperstein

Wiederkehrender Bug oder Edge-Case, den man kennen muss. Steht in jeder Workflow-Karte unter „Bekannte Stolpersteine".

SUB / [SUB] xyz

Sub-Workflow in n8n. Wird aus einem Parent-Workflow per „Execute Workflow"-Node gerufen. Naming-Convention bei mokebo: [SUB] PlentyOne Lookup, [SUB] Sendungsstatus, etc.

SUB Retoure

Production-Sub seit 13.05.2026 (Karte, ID EwGhdDQ7rZfpvPum). Zwei Pfade: Amazon-RSA-Auto-Anlage (Plenty-Retoure + Marker-Comment + Tracking-Comment) und Portalverweis (Internal Note + Loop-Schutz-Tags). Ersetzt zunehmend SUB Portalverweis (legacy).

Susi Projects

Eines der zwei n8n-Projekte (Team-Projekt, ID uK9eJgH0LF2SK87i). Default-Ablage für alle neuen Workflows + Credentials.

T

Ticket Log v2

Google Sheet (1bB1ZK21M1-sRGsqgcAFoWMNxL9ZnkJrm5R1b5Nm7chg, gid 59404923), in das MOKI Dispatcher pro Run eine Zeile schreibt: Ticket-ID, Intent, Sub-Action, Status, Macro, etc. Erste Diagnose-Anlaufstelle.

W

Whitelist-Rollout

Einführungsstrategie für MOKI: nicht alle Tickets sofort, sondern nur Absender-Emails auf einer Whitelist. Reduziert Schaden falls etwas schiefgeht.

X

XXXLutz

Marketplace, über den mokebo Möbel verkauft. Eigene Bestellnummer-Patterns (5xxx…), die im Regex-Extraktor noch nicht vollständig erkannt werden — siehe Karte SUB PlentyOne Lookup.

Z

Zendesk

Mokebos Customer-Support-System. Suite Professional, Subdomain mokebo.zendesk.com. Tickets, Tags, Internal Notes — die Bühne, auf der CS arbeitet. (Macros sind in Zendesk verfügbar, werden bei mokebo aktuell aber nicht systematisch genutzt.)