SAMTEK Master Dashboard

👥

Kunden

🏥

Dienststellen

📦

Sendungen insgesamt

✅

Sendungen zugestellt

⏳

Sendungen ausstehend

🚚

Abholungen offen

📦 Sendungen

Datum	Source	Kunde / Absender	Absender Adresse	Empfänger	Tracking-Nr.	Service	Status

🚚 Abholungen

Abholdatum	Zeitfenster	Kunde	Adresse	Telefon	Dienststelle	Kunden-Nr.	Abholauftrag-Nr.	Tracking-Nr.	Status

🏥 Dienststellen-Adressbuch

Auswahl	Kunden-Nr. ▲	Firmenname	Name der Dienststelle ↕	Kategorie	Ansprechpartner	Straße & Nr.	PLZ / Ort	Telefon	E-Mail	Aktionen

📦

Gesamt

✅

Zugestellt

🚚

Unterwegs

⏳

Ausstehend

❌

Ausnahme

🚫

Storniert

🎫

Offene Tickets

🔍

Offene Nachforschungen

📦 Alle Versandlabels

Von

Bis

Datum ▼	Source ↕	Kunde / Absender	Absender Adresse	Empfänger	Tracking-Nr.	Service	Status	Abrechnung	Aktionen

👥 Kunden-Adressbuch

📥 Importieren

Auswahl	Kunden-Nr. ▲	Firmenname	Kategorie	Ansprechpartner	Straße & Nr.	PLZ / Ort	Telefon	E-Mail	Aktionen

🚚

Abholungen gesamt

⏳

Noch ausstehend

✅

Abgeholt

🚫

Storniert

🚚 Geplante Abholungen

Von

Bis

Abholdatum ▼	Zeitfenster	Kunde	Adresse	Telefon	Dienststelle	Kunden-Nr.	Abholauftrag-Nr.	Tracking-Nr.	Status	Aktionen

⭐ Special Service

Manuelle Sendungen für Rechnungsversand erfassen — werden bei Listenerstellung automatisch eingemergt

📋

Gesamt

📅

Aktueller Monat

💰

0 €

Umsatz Monat

📈

0 €

Gewinn Monat

0 %

Marge Monat

🌍

International (Monat)

Status

Datum

Kunde

Service

Tracking

Pakete

Gewicht

€ Gesamt

€ Einkauf

Empfänger

📦 Sendungen nach Status

🚚 Abholungen nach Status

📈 Sendungsverlauf

👥 Kunden – Aktuell vs. Vorjahr

Kunden-Nr.	Name	Aktuell ▼	Vorjahr	+/–	Trend	Aktion

👤 Kunden-Sicht — Dashboard pro Kunde

👤

Wähle einen Kunden um die Statistiken zu sehen

Du siehst dann genau das, was der Kunde im Portal-Dashboard sieht

Kunde

✅ Zustellquote (Durchschnitt)

—

📦 Sendungen gesamt

—

🚚 Abholungen gesamt

—

📊 Tägliche Zustell-Performance

📦 Sendungen nach Status

✓ Zugestellt

🚚 Unterwegs

⚠ Ausnahme

⏳ Ausstehend

✕ Storniert

↩ Retoure

🚚 Abholungen nach Status

✓ Abgeholt

⏳ Geplant

⚠ Ausnahme

✕ Storniert

📈 Vergleich — aktueller vs. vorheriger Zeitraum

📦 Sendungen

0 vs. 0

🚚 Abholungen

0 vs. 0

🎫 Tarif-Ausnahmen

Zuschläge pro Preisliste deaktivieren (✓ = kostenfrei)

Angehakte Zuschläge werden für diesen Tarif mit 0,00 € und grünem Badge angezeigt.
Beispiel: Dentalkunden zahlen keine Abhol-Gebühren.

🏷️ Preislisten

🏥 Dienststellen-Kategorien

👥 Kunden-Kategorien

🛠 Diagnose & Datenkorrektur

🔍Kundennummer-Konflikt-Diagnose

Prüft welche Quellen (Code-Mappings, Firebase, Stammdaten) eine Kundennummer zuordnen — nützlich wenn Sendungen einer falschen Kundennummer zugeordnet sind.

📦Sendung-Inspektor (Tracking-Nr)

Zeigt für eine konkrete Tracking-Nr ALLE lokal gespeicherten Felder + welche Match-Regeln greifen würden. Ideal nach Test-Buchungen.

🔁Komplett Re-Mapping

Rechnet für ALLE nicht-bestätigten Sendungen die kundennr mit der neuen Logik neu durch (Firestore → Malteser-Portal → UPS-Account → Carrier → Abholadresse → Absender-Name → Empfänger-Dienststelle). 🔒 Abgerechnete + ✏️ bestätigte Sendungen geschützt. Sendungen ohne neue Quelle behalten ihre bestehende kundennr.

📊Legacy-Bereinigung per Excel

Für alte Bug-Casualties: exportiere mit automatischen Vorschlägen, korrigiere die kundennr-Spalte manuell, lade wieder hoch. 🔒 Abgerechnete geschützt.

📤 Korrekturen hochladen

🚑Malteser-Retoure Backfill

Repariert Malteser-Retouren (Carrier 8518): setzt malteser_retoure=True, kopiert referenz2 → dienststelle, leitet kundennr ab. Idempotent.

🔍0. Doppelte UIDs in kunden.json

Findet Kunden-Einträge die dieselbe Firebase-UID teilen aber verschiedene Kundennummern haben. Hilfreich bei historischen Doppel-Einträgen (alte + neue Kundennummer). Oder gezielter Vergleich von 2+ Kundennummern.

— oder Kundennummern direkt vergleichen:

📦0b. Access-Point falsche Ausnahmen bereinigen

UPS markiert Sendungen die über einen Access Point (Abgabestelle/Paketshop) laufen oft fälschlich als Exception. Dieses Tool durchsucht ALLE als "Ausnahme" markierten Sendungen + deren Firestore Tracking-Events nach Access-Point-Keywords und korrigiert den Status.

🔄 Bulk-Refresh: Live-Status aller Ausnahmen von UPS holen. Geht durch alle als "ausnahme" markierten Sendungen, ruft UPS Tracking-API an, korrigiert Status + erkennt Access-Point automatisch. Dauert ~1 Sekunde pro Sendung.

Einzelne Sendung debuggen: Zeigt alle Daten (lokal + Firestore + Tracking-Events).

🔄0c. Aktive Sendungen Status-Refresh (für Abrechnung)

Holt UPS Live-Status für ALLE Sendungen mit Status ausstehend / unterwegs / fehler direkt von UPS. Simuliert das, was passiert wenn man jeden Sendungs-Detail-Modal öffnet. Wichtig vor monatlichem Rechnungslauf — verhindert dass zugestellte Sendungen als "ausstehend" hängenbleiben.

Sync: User wartet auf Response (~0.5s/Sendung, max 120s = ~240 Sendungen). Async: Job läuft im Backend, du siehst nur "gestartet" — Fortschritt in Railway-Logs. Empfehlung: erst Dry-Run, dann Sync wenn <200 Sendungen, sonst Async.

💡 Typischer Workflow bei gelöschten Firebase-Usern:

Deep-Inspect per Email → Legacy-UID finden
UID Wiederherstellen → Auth-User mit alter UID neu anlegen
Collections finden → Adressbuch, parcels, pickups identifizieren
Migrieren → Sendungen + Sub-Collections auf neue UID
Passwort + Mail → Kunden Zugangsdaten zusenden

🔬1. Deep-Inspect (User + Sendungen + Subcollections)

Tiefen-Diagnose: zeigt das komplette users/<uid> Document, alle Subcollections, Anzahl Sendungen mit dieser user_uid, plus weitere User mit gleicher Email (mehrere UIDs möglich!).

🔐2. Firebase-User mit alter UID wiederherstellen

Wenn User in Auth gelöscht wurde aber Firestore-Document noch existiert: Auth-User mit der gleichen UID neu anlegen — alte Daten sind sofort wieder verknüpft.

📦2b. Firestore-Doc auf andere UID verschieben (UID-Mismatch fix)

Wenn Doc-ID ≠ Auth-UID (z.B. App liest users/{authUid} direkt aber das Doc liegt unter einer anderen ID): verschiebt das komplette users-Doc + Subcollections von einer UID auf die andere. Erst Dry-Run!

Source (alte Doc-ID, wird gelöscht)

Target (neue Doc-ID = Auth-UID)

💡 Tipp: nach erfolgreichem Move ggf. auch Sendungen/Adressen via Tool 4 migrieren (falls deren user_uid-Feld auf Source zeigt).

🩺2c. Alle UID-Mismatches finden + Auto-Merge

Sucht über alle Users-Docs nach UID-Mismatches (Doc-ID ≠ Auth-UID + Legacy-Doc mit user_uid-Feld existiert). Auto-Merge ergänzt fehlende Felder ins aktive Doc, ohne bestehende zu überschreiben. Erst Dry-Run!

💡 Sicher: Auto-Merge mergt nur Paare mit gleicher Kundennummer. Unsichere Fälle (orphan/Kundennr-Mismatch) werden übersprungen und in der Liste gezeigt — die musst du manuell mit Tool 2/2b behandeln.

🔎3. Andere Collections für User finden (Adressbuch etc.)

Sucht in ALLEN Top-Level-Firestore-Collections nach Docs die auf eine bestimmte user_uid verweisen (Felder: user_uid, userId, owner, createdBy, etc.). Findet z.B. addresses, parcels, pickups.

🔄4. Sendungen auf neue user_uid migrieren

Für Sendungen in shipments-Collection mit Legacy user_uid: migriert auf neue Firebase-Auth-UID, plus aktualisiert das user_uid-Feld im users-Document. Erst Dry-Run!

💡 Achtung: in Firebase-UIDs sehen 0 (Null) und O (Großbuchstabe O) sehr ähnlich aus. Am besten via Deep-Inspect-Output mit „↓ alt" / „↓ neu" Buttons übernehmen.

🔑5. Firebase-Passwort zurücksetzen + per Mail senden

Setzt direkt ein neues Passwort via Admin SDK (umgeht alle Rate-Limits) und versendet eine Email an den Kunden. Optional CC an dich — du bekommst das Passwort auch im Tool angezeigt.

🔗6. Als Subaccount verknüpfen (Retouren / Sekundär-Login)

Verknüpft einen existierenden Login mit einem Hauptkunden. Sub-User wird beim Login automatisch auf Hauptkunden-Daten umgeleitet (Stammdaten, Sendungen, Rechnungen). Beispiel: audentic@sam-tek.com (Retouren) → fromm@audentic.ag (Hauptkunde).

💡 Nach Verknüpfung sieht der Sub-User beim Login automatisch die Stammdaten + Sendungen des Hauptkunden. Sendungen die er bucht werden unter Hauptkunde gespeichert → Abrechnung läuft automatisch über Hauptkundennummer.

📦7. Sendungen-Diagnose & Full-Resync

Statistik zu shippypro_sendungen.json: Total, Datumsrange, Carrier-Verteilung, Lücken. Plus Full-Resync mit konfigurierbarem Zeitraum für historische Daten.

— oder Full-Resync —

💡 Full-Resync läuft im Hintergrund (~5-15 Min je nach Range) und ergänzt fehlende Sendungen ohne die DB zu leeren. Mit Pagination — keine 100-Records-Limits mehr.

📦 Malteser Retourenpreis

Zapier

Fixpreis für automatisierte Malteser Retouren via Zapier → Excel-Export.

€ EUR

🌍 Import-Sendungen Aufschlag

Pauschalaufschlag für Sendungen mit nicht-DE Absenderland

Wird prozentual auf den Transportpreis aufgeschlagen wenn das Absenderland nicht Deutschland ist.

Aufschlag in %

Standard: 50%

💾 Datensicherung

Backup & Restore

Alle Daten exportieren: Sendungen, Kunden, Dienststellen, Kategorien und Preislisten als JSON.

⬆️ Einspielen

➕ Zuschläge & Zusatzleistungen

Feste Beträge in €

🤖 Automatisch (aus Maßen berechnet)

Handhabung nat.

€

Handhabung int.

€

Großpaket

€

Übergröße

€

Nicht Förderband

€

Nicht Stapelbar

€

Außengebiet nat.

€

Schwer zugängl.

€

✋ Manuell (in Preisanfrage wählbar)

Privatzustellung

€

Samstag nat.

€

Samstag int.

€

GB Grenzgebühr

€

Direktzustellung

€

Unterschrift

€

Unterschrift 18+

€

Servicepauschale/Woche

€

Abhol-Gebühren

€

Leerfahrt

€

Anschrift-Korrektur

€

Zollbeschau

€

Carbon nat.

€

Carbon int.

€

Frachtbrief

€

Papierrechnung

€

Zustellnachweis

€

⏰ Express-Service Zuschläge

12:00 Uhr Express International

€

Wird bei 12:00 Uhr Express auf int. Sendungen angewendet

🎄 Temporäre Peak-Season Zuschläge

Wird nur angewendet wenn der originale Zuschlag (Handhabung / Großpaket / Übergröße) ebenfalls angefallen ist.

🔵 Peak Season – zusätzliche Handhabung

Zusatzbetrag

€ zzgl.

Gültig von

Gültig bis

🟠 Peak Season – Großes Paket

Zusatzbetrag

€ zzgl.

Gültig von

Gültig bis

🔴 Peak Season – Übergrößenzuschlag

Zusatzbetrag

€ zzgl.

Gültig von

Gültig bis

📍 Außengebiet PLZ-Liste

Excel mit PLZ-Spalte hochladen → automatisch als Außengebiet behandelt

Excel (.xlsx) mit PLZ-Spalte hochladen

Aktuell gespeicherte PLZ-Anzahl

—

📋 SEPA-Mandate importieren

Kunden & Dienststellen

CSV aus DATEV/Zahlungsverkehr einlesen — IBAN, BIC, Mandatsdatum und Gläubiger-ID werden automatisch für alle Kunden und Dienststellen eingetragen.

📧 Rechnungs-E-Mail Vorlage

Platzhalter: [%RECHNUNGSNUMMER%] [%LEISTUNGSZEITRAUM%] [%BETRAG%] [%ZAHLUNGSZIEL%]

E-Mail Logo

Kein Logo

PNG, JPG — wird als Base64 gespeichert und in jede E-Mail eingebettet

Betreff

Nachricht

Platzhalter direkt eintippen: [%RECHNUNGSNUMMER%] [%LEISTUNGSZEITRAUM%] [%BETRAG%] [%ZAHLUNGSZIEL%]

🏥 Malteser E-Mail Signatur

Für Emails von malteser@sam-tek.com (Retourenformular)

Diese Signatur wird automatisch an alle Emails des Malteser Retourenformulars angehängt — sowohl an Kunden als auch an Dienststellen.

Signatur

⚖️ UPS Rechnungsabgleich

Workflow: 1. Mehrere UPS-CSV-Dateien hochladen → 2. Eine SAMTEK-Kundenliste (CSV/Excel mit allen Kunden) hochladen → 3. Abgleich starten → 4. Aktualisierte Liste nach Kundennummern exportieren

Schritt 1 · UPS-Rechnungen (CSV) — mehrere möglich

📁 UPS CSV-Dateien ablegen oder klicken Beliebig viele Dateien gleichzeitig möglich

Schritt 2 · SAMTEK Kundenliste (alle Kunden des Monats)

📊 CSV oder Excel ablegen oder klicken Eine Datei mit allen Kunden des Abrechnungsmonats

⛽ Treibstoffzuschlag

Wöchentlich erfassen — wird prozentual auf den Netto-Transportpreis aufgeschlagen. Jede Änderung wird mit Datum automatisch in der Verlaufstabelle gespeichert und historisch für die Preisberechnung genutzt.

🚀

Express

09:00 · 10:30 · 12:00 · Express

Letzter Wert wird geladen…

📦

Standard

Standardversand national & international

Letzter Wert wird geladen…

🚚

Fracht / Palette

LTL · FTL · Palettenversand

Letzter Wert wird geladen…

📋 Verlauf

Automatisch beim Speichern eingetragen · Max. 36 Einträge

0 Einträge

Gültig ab	Express %	Standard %	Fracht %	Aktion
Noch keine Einträge

🏖️ Mitarbeiterbereich

Urlaubsplanung & Jahresübersicht

2026

🇩🇪 Feiertage:

🗂️ Rechnungsübersicht

⏳ Lade Archiv…

🏦 Bankabgleich — HypoVereinsbank

Klicke auf "Konto abrufen" um Transaktionen zu laden.

📬 Mahnwesen

Überfällige Rechnungen nach Mahnstufe — Mahnung senden verschiebt die Rechnung nach 7 Tagen in die nächste Stufe

⚠️

Mahnstufe I — Erste Zahlungserinnerung

Rechnungen die das Fälligkeitsdatum überschritten haben, noch keine Mahnung gesendet

0 ▶

🔔

Mahnstufe II — Zweite Mahnung

Mahnstufe I vor >7 Tagen gesendet, noch unbezahlt

0 ▶

🚨

Mahnstufe III — Letzte Mahnung vor Inkasso

Mahnstufe II vor >7 Tagen gesendet, noch unbezahlt

0 ▶

⛔

Inkasso — Übergabe

Mahnstufe III abgelaufen — bleibt bis manuell als bezahlt markiert

0 ▶

🧾 Rechnungsversand

Schritt für Schritt — Listen erstellen, abgleichen und Rechnungen versenden

Referenzlisten importieren

Excel-ZIP aus app.sam-tek.com — einmal pro Monat nach Monatsabschluss. Enthält alle Kundenlisten inkl. Unterwegs, Verzögert & Ausnahme, damit diese Sendungen des alten Systems sicher in die Abrechnung einfließen.

📂 ZIP / XLSX wählen Keine Datei gewählt

Externe SPS-Listen importieren (optional)

⭐ Special Services aus dem System (Menü „Special Service") werden automatisch gemerged. Dieser Upload nur noch für externe Excel-Listen — z.B. Nachberechnungen außerhalb des Systems. Format muss 1:1 der SAMTEK Versandliste entsprechen.

Von

Bis

📂 SPS-Datei wählen Keine Datei gewählt

Versandlisten erstellen

Je eine Excel-Liste pro Kunde mit individuellen Preisen für den gewählten Zeitraum — für alle Kunden die das neue SAMTEK Portal genutzt haben. Sendungen aus Schritt 2 mit passender Kundennummer werden automatisch eingebunden und gemeinsam in einer Kundenliste angezeigt.

VON

BIS

Alle Nur Kunden Nur Malteser

STATUS FILTER

✅ Zugestellt 🚚 Unterwegs ⏳ Ausstehend 🔄 Retourniert ⚠️ Ausnahmen Alle

EINZELNER KUNDE / DIENSTSTELLE

Rechnungen erstellen & versenden

Listen auswählen → UPS-CSV hochladen & Abgleich → Zuschläge & Gewichte übernehmen → Listen neu erstellen → Rechnungsdatum wählen → Rechnungen in sevdesk anlegen & per E-Mail versenden

Rechnungsdatum & Versand → nach UPS-Abgleich unten ↓

Kunde / DienststelleZeitraumRechnungs-E-MailCCSdg.NettoStatusAktionen

📧 Newsletter

Empfängerlisten, Kampagnen und Versand-Statistiken

	Email	Name	Tags	Status	Erstellt	Aktionen
Laden...

Zeige pro Seite

1 / 1

📝 Kampagne erstellen

📋 Vorlage übernehmen (optional)

Betreff * Absender Name Absender Email Reply-To Empfänger-Tags (leer = alle aktive Subscribers)

Bitte Tags auswählen für Empfänger-Vorschau

HTML-Inhalt *

Versendung in Echtzeit — kein Abbruch möglich

📱 Live-Vorschau

📊 Performance pro Kampagne

Letzte 10 Kampagnen — Versendet / Geöffnet / Geklickt

🎯 Gesamt-Verteilung

Über alle Kampagnen aggregiert

Betreff	Gesendet	Empfänger	Zugestellt	Geöffnet	Geklickt	Bounces	Abmeldungen	Aktionen
Laden...

📝 Newsletter-Footer bearbeiten

Dieser Footer wird automatisch unter jeden Newsletter gehängt — DSGVO-konform mit Abmelde-Link.

⚠️ Pflicht-Platzhalter: {{unsubscribe_url}} muss vorkommen — wird durch den individuellen Abmelde-Link ersetzt. Optional: {{email}} für die Empfänger-Adresse.

HTML-Quelltext

Live-Vorschau

📋 Newsletter-Vorlagen

Wiederverwendbare Templates für Wartungen, Incidents oder normale Newsletter.

Name	Betreff	Kategorie	Geändert	Aktionen
Laden...

🚨 System-Incidents

Active Incidents werden in der Customer-App als Banner und auf der Status-Page angezeigt.

Severity	Title / Message	Sichtbar in	Status	Erstellt	Aktionen
Laden...

📦 Sendungen

🚚 Abholungen

🏥 Dienststellen-Adressbuch

📦 Alle Versandlabels

👥 Kunden-Adressbuch

🚚 Geplante Abholungen

⭐ Special Service

⭐ SPS-Sendung erstellen

📦 Sendungen nach Status

🚚 Abholungen nach Status

📈 Sendungsverlauf

👥 Kunden – Aktuell vs. Vorjahr

👤 Kunden-Sicht — Dashboard pro Kunde

📊 Tägliche Zustell-Performance

📦 Sendungen nach Status

🚚 Abholungen nach Status

📈 Vergleich — aktueller vs. vorheriger Zeitraum

🧮 Preisanfrage

🚛 Sendungsart

📦 Paketmaße & Gewicht

🏗️ Palettenmaße & Gewicht

🛡️ Versicherung (optional)

🔧 Zusatzleistungen (optional)

🗺️ Route

✅ Preisberechnung

🎫 Tarif-Ausnahmen

🏷️ Preislisten

🏥 Dienststellen-Kategorien

👥 Kunden-Kategorien

Neue Kategorie

🛠 Diagnose & Datenkorrektur

✏️ Kundennr korrigieren

📦 Malteser Retourenpreis

🌍 Import-Sendungen Aufschlag

💾 Datensicherung

➕ Zuschläge & Zusatzleistungen

📍 Außengebiet PLZ-Liste

📋 SEPA-Mandate importieren

📧 Rechnungs-E-Mail Vorlage

🏥 Malteser E-Mail Signatur

⚖️ UPS Rechnungsabgleich

📅 Datumsbereich (Erstellungsdatum)

📦 Alle Malteser-Dienststellen exportieren (ZIP, eine Datei pro Kundennummer)

🔍 Einzelne Malteser-Dienststelle exportieren

📊 Malteser Gesamtübersicht Versandaktivität

🔍 Einzelnen Kunden exportieren

📋 Alle Sendungen exportieren

⛽ Treibstoffzuschlag

🏖️ Mitarbeiterbereich

🗂️ Rechnungsübersicht

🏦 Bankabgleich — HypoVereinsbank

📬 Mahnwesen

🧾 Rechnungsversand

📧 Newsletter

📝 Kampagne erstellen

📊 Performance pro Kampagne

🎯 Gesamt-Verteilung

📝 Newsletter-Footer bearbeiten

📋 Newsletter-Vorlagen

🚨 System-Incidents

➕ Neue Vorlage

🚨 Neuer Incident

Neue Dienststelle

Neuer Kunde

➕ Subscriber hinzufügen

✏️ Subscriber bearbeiten

📥 CSV-Upload

📥 Import Vorschau

📧 Label erneut versenden

📬 Zustellbestätigung versenden

📧 Rechnung erneut versenden

📋 Positionen bearbeiten

📦 Sendungsdetails

📦 Abholung buchen

👤 Mitarbeiter anlegen

🏖️ Urlaub eintragen

📬 Mahnung senden