So geht's: 1. Jedes beteiligte System einmal anlegen (Name + Adresse). 2.–5. In der Tabelle „Abläufe“ ankreuzen, welches System bei welchem Ereignis beteiligt ist. 6. „Verbindung testen“ drücken. Grüne Haken zeigen, was schon erledigt ist.
Ein „System“ ist ein anderes Programm, mit dem die Dispo Daten austauscht – z. B. das Kundendatensystem oder ein Störungssystem.
| System | Art | Adresse (Endpoint) | Anmeldung | Status | |
|---|---|---|---|---|---|
| Kundendatensystem Liefert Terminauftrags- und Service-Aufträge; bekommt Termine und Rückmeldungen zurück. |
Kundendaten-/Quellsystem | https://kundendaten.example.invalid/api | Bearer-Token | ● aktiv | bearbeiten |
| Störungssystem 1 Liefert Störungen; bekommt Termine und Rückmeldungen. |
Störungs-/Ticketsystem | https://stoerung1.example.invalid/api | Bearer-Token | ● aktiv | bearbeiten |
| Störungssystem 2 Zweites Ziel für Störungs-Rückmeldungen. |
Störungs-/Ticketsystem | https://stoerung2.example.invalid/api | Bearer-Token | ● aktiv | bearbeiten |
| Abrechnungssystem Bekommt berechnete Artikel (Endkunden-Rechnung). |
Abrechnung | https://abrechnung.example.invalid/api | Bearer-Token | ● aktiv | bearbeiten |
| Ticketsystem (Platzhalter) | Störungs-/Ticketsystem | https://ticket.example.invalid/api/tickets | Bearer-Token | ○ aus | bearbeiten |
| CRM (Platzhalter) | CRM | https://crm.example.invalid/api/notes | Bearer-Token | ○ aus | bearbeiten |
| Quellsystem (Platzhalter) | Kundendaten-/Quellsystem | https://quellsystem.example.invalid/api/status | Bearer-Token | ○ aus | bearbeiten |
✓ Keine fehlgeschlagenen Weitergaben.
Die Systeme schicken neue Aufträge an diese Adresse (JSON per POST):
https://<ihre-adresse>/software/dispo/demo/api/orders
Anmeldung mit dem API-Token im Kopf der Anfrage: Authorization: Bearer <Token> · Token: demo••••••••ffcc (vollständig unter Admin › API).
{"system":"Störungssystem 1","type":"MSTOE","customer_no":"K4100001","customer":"Max Muster",
"plz":"30159","city":"Hannover","street":"Musterweg 1","description":"Internet weg seit heute früh"}
„system“ = Name wie oben unter Systeme (optional – sonst gilt der Eingang laut Abläufe). Antwort: 201 + neue Auftrags-ID.
Rückmeldungen der Handwerker können automatisch an andere Systeme weitergegeben werden. Demo-Modus: Es werden keine Daten gesendet – jede Weitergabe wird nur im Protokoll abgelegt (Status „Demo – nicht gesendet“).
| Name | Typ | Endpoint (Platzhalter) | Modus | Regeln | Protokoll | Aktiv | |
|---|---|---|---|---|---|---|---|
| Ticketsystem (Platzhalter) | Störungs-/Ticketsystem | https://ticket.example.invalid/api/tickets | Demo (nur protokollieren) | 0 | 0 | nein | bearbeiten |
| CRM (Platzhalter) | CRM | https://crm.example.invalid/api/notes | Demo (nur protokollieren) | 1 | 0 | nein | bearbeiten |
| Quellsystem (Platzhalter) | Kundendaten-/Quellsystem | https://quellsystem.example.invalid/api/status | Demo (nur protokollieren) | 4 | 0 | nein | bearbeiten |
| Kundenbenachrichtigung SMS/E-Mail (Platzhalter) | Kunde (SMS/E-Mail) | https://notify.example.invalid/api/messages | Demo (nur protokollieren) | 2 | 0 | ja | bearbeiten |
| Kundendatensystem | Kundendaten-/Quellsystem | https://kundendaten.example.invalid/api | Demo (nur protokollieren) | 0 | 0 | ja | bearbeiten |
| Störungssystem 1 | Störungs-/Ticketsystem | https://stoerung1.example.invalid/api | Demo (nur protokollieren) | 0 | 0 | ja | bearbeiten |
| Störungssystem 2 | Störungs-/Ticketsystem | https://stoerung2.example.invalid/api | Demo (nur protokollieren) | 0 | 0 | ja | bearbeiten |
| Abrechnungssystem | Abrechnung | https://abrechnung.example.invalid/api | Demo (nur protokollieren) | 0 | 0 | ja | bearbeiten |
Je Rückmeldegrund sind mehrere Regeln möglich. Unterpunkt leer = gilt für alle Unterpunkte; Leistungsbereich leer = alle. Ereignisse: Rückmeldung (Handwerker), Termin vergeben (Disposition = Terminzusage), Termin geändert (Umplanung/Rücknahme). Platzhalter: {auftragsnummer} {kundennummer} {kunde} {adresse} {leistungsart} {grund} {unterpunkt} {notiz} {handwerker} {datum} {status} {artikel} {summe} {termin} {uhrzeit} {termin_alt} {fixtermin} {storno_grund} {info} {einsatzadresse} {email} {mobil} {kundenadresse} {rueckrufnummer} {ansprechpartner} {produkt} {objektbereich} {leistungsumfang} {einsatzstandort} {pt} {wt} {frist} {abteilung} {rueckmeldung} {quelle} {referenz}
| Ereignis | Rückmeldegrund | Unterpunkt | Leistungsbereich | Ziel | Aktion | Textvorlage | Aktiv | |
|---|---|---|---|---|---|---|---|---|
| Rückmeldung | alle Gründe nur mit Artikeln | alle Unterpunkte | alle | CRM (Platzhalter) | Berechnung an Kunde | Berechnung an Kunde {kunde} ({kundennummer}) zu Auftrag {auftragsnummer}: ⏎ {artikel} ⏎ Summe brutto: {summe} ⏎ {handwerker}, {datum} | ja | bearbeiten |
| Termin abgesagt (Kunde) | – | alle Unterpunkte | alle | Quellsystem (Platzhalter) | CRM-Bemerkung | Kunde {kunde} hat den Termin {termin} {uhrzeit} abgesagt (Auftrag {auftragsnummer}): {info} | ja | bearbeiten |
| Termin geändert | – | alle Unterpunkte | alle | Quellsystem (Platzhalter) | Termin melden | Terminänderung Auftrag {auftragsnummer}: neu {termin} {uhrzeit} (bisher {termin_alt}), Handwerker {handwerker}. | ja | bearbeiten |
| Termin geändert | – | alle Unterpunkte | alle | Kundenbenachrichtigung SMS/E-Mail (Platzhalter) | Kunde informieren | Guten Tag {kunde}, Ihr Termin wurde verschoben: neu am {termin}{uhrzeit_text} (bisher {termin_alt}). Auftrag {auftragsnummer}. | ja | bearbeiten |
| Termin vergeben | – | alle Unterpunkte | alle | Quellsystem (Platzhalter) | Termin melden | Termin für Auftrag {auftragsnummer}: {termin} {uhrzeit}, Handwerker {handwerker}.{fixhinweis} | ja | bearbeiten |
| Termin vergeben | – | alle Unterpunkte | alle | Kundenbenachrichtigung SMS/E-Mail (Platzhalter) | Kunde informieren | Guten Tag {kunde}, Ihr Handwerker kommt am {termin}{uhrzeit_text} zu Ihnen ({adresse}). Auftrag {auftragsnummer}. Bei Fragen: 0511 60 000 (Demo). | ja | bearbeiten |
| Storno | – | alle Unterpunkte | alle | Quellsystem (Platzhalter) | Status melden | Auftrag {auftragsnummer} storniert durch Kundenservice. Grund: {storno_grund}. | ja | bearbeiten |
Status: Aus · 0 Termine im Outlook gespiegelt · 0 Outlook-Blocker im Board · letzte Synchronisation: noch nie. Demo: es wird nichts an Microsoft gesendet – jede Anfrage steht unten im Protokoll, Outlook-Termine (z. B. Arzt, Urlaub) werden simuliert. Blocker werden in Board, Auto-Disposition, „Aufträge holen“ und beim Drag & Drop wie Abwesenheiten berücksichtigt; nur „Belegt“/„Abwesend“ wird übernommen, kein Betreff (Datenschutz).
| Zeitpunkt | Auftrag | Ziel | Aktion | Payload | Status | |
|---|---|---|---|---|---|---|
| Noch keine Weitergaben protokolliert. | ||||||
| Zeit | Richtung | Aktion | Postfach | Auftrag | Anfrage | Status |
|---|---|---|---|---|---|---|
| Noch keine Synchronisation. | ||||||