====== 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 [[fahrzeuge|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 [[disposition|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 [[fahrzeuge|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 |