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: products
  • Bestellungen (/orders) – Funktion: orders
  • Gebinde (/containers) – Funktion: containers
  • Lieferzonen (/delivery-zones) – Funktion: delivery_zones
  • Abonnements (/subscriptions) – Funktion: subscriptions
  • Liefertouren (/tours)
  • Fahrer-Verdienst (/driver-earnings)

Kunden & Vertrieb

  • Kunden (/customers) – Funktion: customer_portal
  • Gutscheine (/gift-cards) – Funktion: gift_cards
  • Support-Tickets (/support-tickets) – Funktion: support_tickets
  • Verlosung (/raffle) – Funktion: weekly_raffle
  • Aktionen (/sale-offers)
  • Rundmail (/rundmail) – Funktion: rundmail
  • Push Notifications (/push-notifications) – Funktion: push_notifications
  • Warenkorbabbrüche (/abandoned-carts) – Funktion: abandoned_cart_recovery
  • Tagesabschluss (/tagesabschluss) – Funktion: tagesabschluss

Finanzen & Insights

  • Rechnungen (/invoices)
  • Dokumente (/documents)
  • Berichte (/reports) – Funktion: analytics
  • Analytics (/analytics) – Funktion: analytics
  • Abonnement (/billing)

Verwaltung

  • Benutzer (/users)
  • Audit-Log (/audit-log)
  • E-Mail (/settings/email-management)
  • Partnerprogramm (/settings/affiliate)
  • Einstellungen (/settings)
  • Migration (/settings/migration) – Funktion: migration
  • Support (/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

  1. Öffnen Sie /register.
  2. Wählen Sie Unternehmenstyp: Lieferdienst.
  3. Melden Sie sich an und prüfen Sie /dashboard.

Schritt 2: Team und Rollen

  1. Öffnen Sie /users.
  2. Legen Sie Benutzer mit passenden Rollen an:
    • ADMIN für Gesamtverantwortung,
    • PRODUKTIONSLEITER für Produktion/Disposition,
    • KUNDENSERVICE oder KUNDENSUPPORT für Kundenbetreuung,
    • LAGERVERWALTUNG für Produkte/Gebinde,
    • LIEFERFAHRER für Tourbetrieb.
  3. Prüfen Sie die Sichtbarkeit je Rolle in der Sidebar.

Schritt 3: Funktionen aktivieren

  1. Öffnen Sie /settings → Abschnitt AllgemeinFunktionen.
  2. Aktivieren Sie mindestens:
    • products, orders, delivery_zones, customer_portal.
  3. 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.
  • 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/smtp vollständig testen/verifizieren.
  • Vorlagen: /settings/email-templates pflegen.
  • E-Mail-Management: /settings/email-management fü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

  1. Öffnen Sie /delivery-zones.
  2. Legen Sie alle Zustellgebiete inkl. Regeln und Gebühren an.
  3. Testen Sie PLZ-Validierung im Shop mit einer Testadresse.

Schritt 2: Produkte

  1. Öffnen Sie /products.
  2. Legen Sie Kategorien, Preise, MwSt, Verfügbarkeiten, Bilder an.
  3. Prüfen Sie Produktlogik für:
    • Einmalartikel,
    • Bundles,
    • verfügbare Wochentage.

Schritt 3: Kunden

  1. Öffnen Sie /customers.
  2. Legen Sie Testkunden an (Privat/Geschäftskunde).
  3. Konfigurieren Sie bei Bedarf Kunden-spezifisch:
    • MwSt-Override,
    • Gutschein-Overrides,
    • Skonto-Overrides.

Schritt 4: Zusatzmodule (optional)

  • /containers für Gebinde-Workflows.
  • /subscriptions für Wiederholbestellungen.
  • /gift-cards fü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

  1. Öffnen Sie den Shop als Kunde.
  2. Legen Sie Produkte in den Warenkorb.
  3. Durchlaufen Sie Checkout mit realen Lieferdaten.
  4. Erstellen Sie Testbestellungen für:
    • Stripe,
    • PayPal,
    • Überweisung.

Schritt 3: Backend-Validierung

  1. Prüfen Sie Eingang unter /orders.
  2. Planen Sie Touren unter /tours.
  3. Prüfen Sie Kundenansicht unter /customers.
  4. Prüfen Sie Rechnungsfluss unter /invoices.

6) Rechnungen, Zahlung, Mahnung, Skonto

Zielprozess

  1. Bestellung erzeugt (direkt oder gesammelt) Rechnung.
  2. Kunde zahlt über konfigurierten Provider.
  3. Bei aktiver Skonto-Regel wird innerhalb Frist automatisch reduziert.
  4. 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:email
  • npm run worker:security
  • npm 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

  1. Tag 1–2: Basis, Rollen, Funktionen, Steuern, Zahlungen.
  2. Tag 2–3: Lieferzonen + Produkte + Shop-Branding.
  3. Tag 3–4: Kundenanlage, Bestell- und Tourprozess testen.
  4. Tag 4–5: Rechnungen, Skonto, Mahnung, E-Mail-Flow finalisieren.
  5. Tag 5: Soft-Launch mit kleinem Kundenkreis, danach Go-Live.