Integrationen
EinsatzHUB unterstuetzt die Anbindung an externe Systeme. Aktuell stehen Divera 24/7 und Stein.APP zur Verfuegung.
Integrations-Verwaltung
Integrationen werden in der Admin-Ansicht unter Integrationen verwaltet. Jede Integration hat:
| Feld | Beschreibung |
|---|---|
| Typ | divera oder stein |
| Name | Frei waehlbarer Name |
| Aktiviert | Integration ein-/ausschalten |
| Position | Reihenfolge in der Anzeige |
Es koennen mehrere Integrationen desselben Typs angelegt werden (z.B. fuer verschiedene Divera-Organisationen).
Divera 24/7
Konfiguration
| Feld | Beschreibung |
|---|---|
| API-Key | Benutzerzugangscode (nicht der Alarm-Key!) aus Divera |
| Webhook-Secret | Geheimschluessel fuer eingehende Webhooks |
<note tip> Den Benutzerzugangscode finden Sie in Divera unter: Verwaltung → Schnittstellen → Benutzerzugangscode. </note>
Fahrzeug-Mapping
Jedes lokale Fahrzeug kann einem Divera-Fahrzeug zugeordnet werden:
- Integration oeffnen
- Reiter „Fahrzeug-Mapping“ waehlen
- Lokales Fahrzeug auswaehlen
- Entsprechendes Divera-Fahrzeug zuordnen
Alternativ kann das Mapping auch direkt im Fahrzeug-Bearbeiten-Dialog gesetzt werden.
Status-Synchronisation
Die Synchronisation laeuft in beide Richtungen:
Divera -> EinsatzHUB
Alle 30 Sekunden wird der Fahrzeugstatus ueber die Divera-API abgefragt. Bei Aenderungen wird der lokale Status aktualisiert.
EinsatzHUB -> Divera
Statusaenderungen in EinsatzHUB werden sofort an die Divera-API gesendet.
Alarm
Aus der Dispositionsansicht kann ein Divera-Alarm ausgeloest werden:
- Auf den Divera-Alarm-Button klicken
- Zielgruppen und/oder Fahrzeuge auswaehlen
- Alarm absenden
Webhook (Alarm-Import)
Divera kann bei eingehenden Alarmen einen Webhook an EinsatzHUB senden. Bei Empfang wird automatisch ein neuer Einsatz angelegt. Doppelte Importe werden verhindert.
Die Webhook-URL finden Sie in der Integrations-Ansicht und tragen sie in Divera ein.
Stein.APP
Konfiguration
| Feld | Beschreibung |
|---|---|
| BU-ID | Business-Unit-ID aus Stein.APP |
| API-Key | API-Schluessel von Stein.APP |
Asset-Mapping
Lokale Fahrzeuge werden Stein-Assets zugeordnet:
- Integration oeffnen
- Reiter „Stein-Mapping“ waehlen
- Verfuegbare Stein-Assets werden abgerufen
- Lokales Fahrzeug dem entsprechenden Stein-Asset zuordnen
Alternativ ueber den Fahrzeug-Bearbeiten-Dialog.
Bidirektionale Synchronisation
EinsatzHUB -> Stein.APP
Bei Statusaenderungen in EinsatzHUB wird der Status direkt an Stein.APP uebertragen.
Stein.APP -> EinsatzHUB
Alle 30 Sekunden wird der Status abgefragt. Um Ping-Pong-Effekte zu vermeiden:
- Der Stein-Status muss mindestens 5 Sekunden neuer sein als der lokale Status
- Gleiche Status werden ignoriert
- Rate-Limit: max. 20 Abfragen pro Minute (Stein-Vorgabe)
Status-Uebersetzung
| BOS-FMS | Stein-Status | Beschreibung |
|---|---|---|
| 0 | notready | Nicht einsatzbereit |
| 1, 2 | ready | Einsatzbereit |
| 3, 4, 5, 7, 9 | inuse | Im Einsatz |
| 6 | notready | Ausser Dienst |
| 8 | semiready | Bedingt einsatzbereit |