Onboarding: neuer Lieferdienst
Vollständiger Go-Live-Plan — von der Registrierung bis zum produktiven Betrieb.
| Zielgruppe | Administrator |
| Dauer | ca. 3–7 Tage je nach Umfang |
| Vertiefung | Modul-Artikel unter Docs-Übersicht |
Diese Anleitung führt Sie durch die vollständige Einrichtung eines neuen Lieferdienstes in Fracht – von der Erstkonfiguration bis zum Go-Live. Für einzelne Module gibt es vertiefende Hilfe, z. B. Bestellungen, Liefertouren, Einstellungen.
Ziel und Ergebnis
Nach Abschluss dieser Schritte haben Sie:
- einen vollständig konfigurierten Lieferdienst-Betrieb,
- einen lauffähigen Shop (
/t/{slug}/shop), - produktive Bestell- und Tourprozesse,
- automatisierte Rechnungs- und Mahnprozesse,
- ein wartbares Rollen-, E-Mail- und Monitoring-Setup.
1) Navigationsübersicht (Lieferdienst)
Die Sidebar ist gruppiert. Sichtbarkeit hängt von Rolle und aktivierten Funktionen ab.
Kernbetrieb
Dashboard(/dashboard)Operations(/operations)Produkte(/products) – Funktion:productsBestellungen(/orders) – Funktion:ordersGebinde(/containers) – Funktion:containersLieferzonen(/delivery-zones) – Funktion:delivery_zonesAbonnements(/subscriptions) – Funktion:subscriptionsLiefertouren(/tours)Fahrer-Verdienst(/driver-earnings)
Kunden & Vertrieb
Kunden(/customers) – Funktion:customer_portalGutscheine(/gift-cards) – Funktion:gift_cardsSupport-Tickets(/support-tickets) – Funktion:support_ticketsVerlosung(/raffle) – Funktion:weekly_raffleAktionen(/sale-offers)Rundmail(/rundmail) – Funktion:rundmailPush Notifications(/push-notifications) – Funktion:push_notificationsWarenkorbabbrüche(/abandoned-carts) – Funktion:abandoned_cart_recoveryTagesabschluss(/tagesabschluss) – Funktion:tagesabschluss
Finanzen & Insights
Rechnungen(/invoices)Dokumente(/documents)Berichte(/reports) – Funktion:analyticsAnalytics(/analytics) – Funktion:analyticsAbonnement(/billing)
Verwaltung
Benutzer(/users)Audit-Log(/audit-log)E-Mail(/settings/email-management)Partnerprogramm(/settings/affiliate)Einstellungen(/settings)Migration(/settings/migration) – Funktion:migrationSupport(/saas-support)
Fahrerbereich (Rolle LIEFERFAHRER)
Liefertouren(/tours)Fahrer-Kalender(/tours/calendar)Rechnungen(/invoices)Dokumente(/documents)
2) Erstsetup nach der Registrierung
Schritt 1: Firmenzugang und Basisdaten
- Öffnen Sie
/register. - Wählen Sie Unternehmenstyp: Lieferdienst.
- Melden Sie sich an und prüfen Sie
/dashboard.
Schritt 2: Team und Rollen
- Öffnen Sie
/users. - Legen Sie Benutzer mit passenden Rollen an:
ADMINfür Gesamtverantwortung,PRODUKTIONSLEITERfür Produktion/Disposition,KUNDENSERVICEoderKUNDENSUPPORTfür Kundenbetreuung,LAGERVERWALTUNGfür Produkte/Gebinde,LIEFERFAHRERfür Tourbetrieb.
- Prüfen Sie die Sichtbarkeit je Rolle in der Sidebar.
Schritt 3: Funktionen aktivieren
- Öffnen Sie
/settings→ Abschnitt Allgemein → Funktionen. - Aktivieren Sie mindestens:
products,orders,delivery_zones,customer_portal.
- Aktivieren Sie optional:
subscriptions,gift_cards,support_tickets,rundmail,push_notifications,abandoned_cart_recovery,tagesabschluss,loyalty_points,business_customers,delivery_slot_capacity_limits.
3) Einstellungen vollständig aufsetzen
Öffnen Sie /settings und arbeiten Sie die Bereiche nacheinander durch.
A) Allgemein
- Steuersätze: Standard-MwSt, Liefer-/Trinkgeld-MwSt, B2B-MwSt.
- Sondertage: Feiertage/Ausnahmen für Betriebslogik.
- Tagesabschluss: Basisparameter prüfen (Detailseite:
/settings/tagesabschluss).
B) Abrechnung
- Rechnungsstellung: Intervall und Sammelrechnung konfigurieren.
- Rechnungsdaten: Firmendaten, Bankdaten, Kopf-/Fußtexte.
- Rechnungsdesign: Layout/Farben.
- Skonto: Aktivieren, Prozent und Frist in Tagen definieren.
- Zahlungsanbieter:
- direkt im Bereich oder detailiert unter
/settings/payments, - Stripe, PayPal, Überweisung aktivieren,
- Auto-Capture-Strategie prüfen.
- direkt im Bereich oder detailiert unter
- Mahnwesen:
- Mahnstufen, Gebührenmodell, Netto/Brutto-Basis,
- Fristen und Red-Flag-Regeln.
C) Betrieb
- Bestellungen:
- Lieferzonenpflicht,
- Vorbestellhorizont,
- Checkout-Wizard.
- Öffnungszeiten:
- Öffnungstage,
- Cutoff-Logik,
- Lieferfenster.
- Etiketten:
- Drucklayout, Inhalte, Formate.
- Fahrer-Vorlagen:
- Zustellnachweise,
- Problemtypen.
D) Shop
- Landing Page:
/landing(Branding, Inhalte, Darstellung). - Shop-Funktionen:
- Checkout-Defaults,
- Produktkarten/Listenlayout,
- Kategorienrouten,
- Bestellhinweise,
- Push-Banner und VAPID-Einstellungen,
- Treuepunkte,
- Probe-Tüte,
- Gutschein-Flows (Rechnung/PayPal/Instant/Admin-Freigabe).
E) Kommunikation
- SMTP:
/settings/smtpvollständig testen/verifizieren. - Vorlagen:
/settings/email-templatespflegen. - E-Mail-Management:
/settings/email-managementfür Queue/History. - Benachrichtigungen: Order-/Kunden-Events aktivieren.
- Rundmail: Tracking + Rate-Limit bei aktivierter Funktion.
F) Sicherheit
- Auto Sign-Out mit Warnzeit konfigurieren.
4) Operative Stammdaten anlegen
Schritt 1: Lieferzonen
- Öffnen Sie
/delivery-zones. - Legen Sie alle Zustellgebiete inkl. Regeln und Gebühren an.
- Testen Sie PLZ-Validierung im Shop mit einer Testadresse.
Schritt 2: Produkte
- Öffnen Sie
/products. - Legen Sie Kategorien, Preise, MwSt, Verfügbarkeiten, Bilder an.
- Prüfen Sie Produktlogik für:
- Einmalartikel,
- Bundles,
- verfügbare Wochentage.
Schritt 3: Kunden
- Öffnen Sie
/customers. - Legen Sie Testkunden an (Privat/Geschäftskunde).
- Konfigurieren Sie bei Bedarf Kunden-spezifisch:
- MwSt-Override,
- Gutschein-Overrides,
- Skonto-Overrides.
Schritt 4: Zusatzmodule (optional)
/containersfür Gebinde-Workflows./subscriptionsfür Wiederholbestellungen./gift-cardsfür Gutscheinportfolio.
5) Shop und Checkout live schalten
Schritt 1: Shop-URL prüfen
- Primäre Route:
/t/{slug}/shop - Alternative Legacy-Route:
/shop/{slug}
Schritt 2: Vollständiger Testlauf
- Öffnen Sie den Shop als Kunde.
- Legen Sie Produkte in den Warenkorb.
- Durchlaufen Sie Checkout mit realen Lieferdaten.
- Erstellen Sie Testbestellungen für:
- Stripe,
- PayPal,
- Überweisung.
Schritt 3: Backend-Validierung
- Prüfen Sie Eingang unter
/orders. - Planen Sie Touren unter
/tours. - Prüfen Sie Kundenansicht unter
/customers. - Prüfen Sie Rechnungsfluss unter
/invoices.
6) Rechnungen, Zahlung, Mahnung, Skonto
Zielprozess
- Bestellung erzeugt (direkt oder gesammelt) Rechnung.
- Kunde zahlt über konfigurierten Provider.
- Bei aktiver Skonto-Regel wird innerhalb Frist automatisch reduziert.
- Bei Verzug greifen Mahnstufen inkl. Gebührenmodell.
Prüfpunkte
/invoices:- Filter/Sortierung,
- Dry-Run Mahnung (Modal),
- Versand, Paid-Status, Audit.
/invoices/{id}:- Einzelprüfung von Zahlungs- und Mahnaktionen.
/t/{slug}/konto:- Kunden sieht offene Rechnungen, Skonto-Hinweise, Zahlmethoden.
/t/{slug}/zahlung/{invoiceId}:- Provider-Auswahl, Restriktionen (z. B. Gutschein-PayPal-only), Bankdaten.
7) Worker und Betriebsbetrieb
Für produktiven Betrieb starten Sie dauerhaft mindestens:
npm run worker:emailnpm run worker:securitynpm run worker:tagesabschluss(wenn genutzt)npm run worker:abandoned-carts(wenn genutzt)npm run worker:push-notifications(wenn genutzt)
Zusätzlich existiert ein Management-Worker (scripts/management-worker.ts)
für geplante Hintergrundprozesse (z. B. Invoicing-/Dunning-Automation).
8) Go-Live-Checkliste (kurz)
- Rollen/Benutzer vollständig und getestet
- Pflichtfunktionen aktiviert
- Lieferzonen und Öffnungszeiten final
- Produktkatalog vollständig und korrekt bepreist
- Shop-Branding + Landing final
- Zahlungsanbieter getestet (mind. 1 realer Durchlauf)
- SMTP verifiziert, Mailvorlagen geprüft
- Rechnung, Skonto, Mahnung im Testlauf validiert
- Tourplanung inkl. Fahrer-Workflow getestet
- Audit-/Monitoring-Prozesse definiert
9) Empfohlene Reihenfolge für die erste Woche
- Tag 1–2: Basis, Rollen, Funktionen, Steuern, Zahlungen.
- Tag 2–3: Lieferzonen + Produkte + Shop-Branding.
- Tag 3–4: Kundenanlage, Bestell- und Tourprozess testen.
- Tag 4–5: Rechnungen, Skonto, Mahnung, E-Mail-Flow finalisieren.
- Tag 5: Soft-Launch mit kleinem Kundenkreis, danach Go-Live.