Auf dieser Seite
Zugang & Registrierung
Seite: /partner/register und /partner/login
- Registrierung mit: Firmenname, E-Mail, Passwort, Ansprechpartner, Telefon
- Nach Registrierung: Account-Status Wird geprüft — Partner sieht Warte-Screen bis zur manuellen Freigabe durch NODIKA-Admin
- Nach Freigabe: Zugang zum vollständigen Dashboard
Unverifizierter Partner sieht nach Login nur: „⏳ Account wird geprüft — Unser Team prüft Ihre Angaben." Kein Zugang zu Dashboard-Funktionen bis zur Freigabe.
Dashboard-Tabs
Seite: /partner — Das Partner-Dashboard hat 6 Tabs:
| Tab | URL-Anker | Inhalt |
|---|---|---|
| Übersicht | Standard | Kontostand-Banner, KPI-Karten, Schnellzugriffe, Interner Auftrags-Widget |
| Finanzen | — | Saldo, Auszahlung beantragen, Buchungshistorie mit Filter |
| Ref-Links | — | Affiliate-Links verwalten (Typen A/B/C), Embed-Code |
| Dokumente | — | Pflichtdokumente hochladen (z. B. Handwerkskarte, Gewerbeschein) |
| 🏢 Interne Aufträge | — | Direkte Aufträge an eigene Monteure vergeben |
| 📞 Telefonkanal | — | KI-Telefon-Agenten via MCP anbinden |
Tab: Übersicht
Kontostand-Banner
Zeigt den aktuellen Saldo (Bargeldzahlungen) mit farblicher Schwellenwert-Anzeige:
| Saldo | Farbe | Symbol | Hinweis |
|---|---|---|---|
| ≥ 0 € | Grün | ✅ | Kein offener Betrag |
| -50 € bis 0 € | Orange | ⚠️ | Kleine Schulden aus Bargeldzahlungen |
| -150 € bis -50 € | Gelb | ⚠️ | Bitte bald begleichen |
| -200 € bis -150 € | Rot | 🔴 | Kritisch — Sperrung droht bei < -200 € |
| < -200 € | Dunkelrot | 🚫 | Konto gesperrt — alle Monteure werden OFFLINE gesetzt |
KPI-Karten (8 Stück)
| Karte | Wert |
|---|---|
| Aufträge gesamt | Zahl (alle Status) |
| Aktiv | Blau — EN_ROUTE + IN_PROGRESS + ARRIVED |
| Abgeschlossen | Grün |
| Storniert | Rot |
| Umsatz (gesamt) | € aller COMPLETED-Aufträge |
| Dein Anteil | Grün — partnerShare aller COMPLETED |
| Monteure | Gesamt + „X online" |
| Ausstehend | Gelb — PENDING-Aufträge |
Schnellzugriffe
- 👷 Monteure verwalten →
/partner/monteurs - 💶 Preise verwalten →
/partner/service-prices - 📋 Aufträge →
/partner/orders - 🧾 Kontoauszug →
/partner/billing - 💳 Zahlungsmethoden →
/partner/payment-methods
Tab: Finanzen
Saldo-Card
- Großer Betrag mit Farb-Logik (wie Kontostand-Banner oben)
- Account-Status-Badge: Aktiv / Zahlung ausstehend / Gesperrt
- Anzahl offener Buchungen
- Hinweis: „Ab -200 € wird automatisch abgebucht"
Auszahlung beantragen
- Button: Auszahlung beantragen → öffnet Modal
- Modal-Felder: Betrag (€) + Auszahlungsrhythmus (Täglich / Wöchentlich / Monatlich — nur Hinweis, nicht automatisch)
- Tabelle: letzte Auszahlungsanträge mit Status Ausgezahlt / Ausstehend + Referenznummer
Buchungshistorie
Filter: Status-Dropdown + Von-Datum + Bis-Datum + Filter anwenden + Zurücksetzen
| Buchungstyp | Label | Vorzeichen |
|---|---|---|
| service_fee | Service-Fee | Negativ (Schuld) |
| affiliate_commission | Provisions-Gutschrift | Positiv (Einnahme) |
| partner_payout | Auszahlung | Negativ |
| storno | Storno | Positiv (Rückbuchung) |
| manual_adjustment | Manuelle Korrektur | Beides möglich |
| settlement_transfer | Abrechnung | Negativ |
Buchungsstatus:
Offen Abgerechnet Bezahlt Fehlgeschlagen Storniert
Tab: Ref-Links
Partner können Affiliate-Links erstellen und an Kunden / auf eigenen Websites verwenden:
| Typ | Label | Routing | Gebühr |
|---|---|---|---|
| EXCLUSIVE | Option A – Exklusiv | Nur eigene Monteure. Kein Fallback. | Flat-Fee |
| HYBRID | Option B – Hybrid | Eigene zuerst, dann alle (Fallback) | Flat-Fee eigene / 20% + Provision fremd |
| AFFILIATE | Option C – Marktplatz | Alle NODIKA-Monteure im Wettbewerb | 20% Gebühr |
Link erstellen
- Button: + Link erstellen → klappt Formular auf
- Felder: Link-Typ (Dropdown) + Kategorie (optional, pre-selektiert im Bestellflow) + bei HYBRID: Checkbox „Fallback transparent anzeigen"
- URL-Schema:
https://nodika.de/?ref={code}<={A|B|C}&c={categoryId}
Aktionen pro Link
- Kopieren — URL in Zwischenablage, wechselt kurz zu ✓ Kopiert
- </> Embed — öffnet Modal mit fertigem iFrame + postMessage-Script
- Deaktivieren / Aktivieren
- Löschen (mit Bestätigungs-Dialog)
Tab: Dokumente
- Upload-Widget für Pflichtdokumente (Handwerkskarte, Gewerbeschein, etc.)
- Ausstehende Dokumente zeigen Badge im Tab-Label: Dokumente (2)
- Dokumente werden von NODIKA-Admin geprüft und freigegeben/abgelehnt
Tab: Interne Aufträge
Partner können Aufträge direkt an eigene Monteure vergeben (ohne Kunden-Bestellflow):
- Auftrag anlegen: Monteur auswählen, Service, Adresse, Notizen
- Monteur erhält Push/App-Benachrichtigung
- Status: PENDING → EN_ROUTE → COMPLETED / REJECTED
- Statistik-Widget auf Übersichts-Tab: Aufträge dieses Monats + Top-Monteure
Tab: Telefonkanal
Verbindet einen KI-Telefon-Agenten (z. B. sipgate AI) mit NODIKA über das MCP-Protokoll:
Routing-Modi
| Modus | Beschreibung | Gebühr |
|---|---|---|
| EXCLUSIVE | KI nennt nur eigene Monteure | Flat-Fee |
| HYBRID (empfohlen) | Eigene zuerst, Fallback auf alle | Gemischt |
| AFFILIATE | Alle NODIKA-Monteure | 20% Provision |
API-Endpunkte (MCP)
| Zweck | URL | Auth |
|---|---|---|
| Tool-Beschreibungen | https://api.nodika.de/api/mcp/manifest | Öffentlich |
| Tool-Aufruf | https://api.nodika.de/api/mcp/call (POST) | x-phone-api-key Header |
Verfügbare MCP-Tools: get_available_monteurs und create_order
API-Key: Nie weitergeben. Jederzeit über „🔄 Neu generieren" rotierbar — der alte Key wird sofort ungültig.
Monteure verwalten
Seite: /partner/monteurs
- Monteur anlegen: Vorname, Nachname, E-Mail, Telefon, Passwort
- Status-Anzeige: Online / Offline
- Zugewiesene Services pro Monteur einsehen
- Monteur deaktivieren / löschen
Preise verwalten
Seite: /partner/service-prices
- Pro Service: Servicepreis (€) + km-Preis (€/km)
- Preise gelten für alle Monteure des Partners
- Bei Festpreis+ Diensten: zusätzliche Zusatzpreise pro Zusatzdefinition
- Min/Max-Vorgaben vom Admin werden als Validierungsregeln angezeigt
Selbstständigen-Modus
Ein Partner kann sich selbst als Monteur aktivieren (Einzelunternehmer ohne eigenes Team):
- Button auf Übersichts-Tab: Als Monteur aktivieren
- Modal: Vorname, Nachname, Telefon eingeben
- Nach Aktivierung: Partner hat zusätzlich die Monteur-Rolle — kann ONLINE/OFFLINE gehen
- Deaktivierung: Deaktivieren — nur möglich wenn kein aktiver Auftrag läuft
Kontostand & Schwellenwerte
| Schwelle | Aktion |
|---|---|
| 0 € | Normalbetrieb |
| -50 € | Warnung im Dashboard |
| -150 € | Kritische Warnung — Sperrung droht |
| -200 € | Automatische Abbuchung ausgelöst — alle Monteure werden OFFLINE gesetzt |
Screenshots
📸 nodika.de/partner/login — Anmeldung für Partner