Fahrzeugstatus (FMS)

Der Statuseingang ist von der Alarmierung getrennt. Er nutzt dasselbe Geheimnis, aber eine eigene Adresse:

POST https://manager.lorvis.de/api/v1/fahrzeugstatus

Nur POST: hier gibt es nichts abzuholen, und keine Leitstelle meldet Status über eine Adresszeile.

Der Rumpf

{
  "secret": "ihr-geheimnis",
  "fahrzeuge": [
    { "issi": "112233", "status": 3 },
    { "issi": "112234", "status": 1 }
  ]
}

Feld	Erkannte Namen
Liste	`fahrzeuge`, `vehicles`
Funkkennung	`issi`, `radio_id`, `funkkennung`
Status	`status`, `fms`, `status_nr`

Eine Einheit wird nicht angegeben, und das ist kein Versehen: ein Fahrzeug gehört einer Organisation, und über die ISSI ist es eindeutig. Eine Einheit anzugeben könnte nur widersprechen.

Die FMS-Stufen

Stufe	Kurz	Bedeutung
0	Notruf	Priorisierter Sprechwunsch
1	Funkfrei	Einsatzbereit über Funk
2	An Wache	Einsatzbereit an Wache
3	Anfahrt	Einsatz übernommen, Anfahrt
4	Vor Ort	Ankunft am Einsatzort
5	Sprechwunsch	Sprechwunsch
6	Nicht bereit	Nicht einsatzbereit
7	Gebunden	Einsatzgebunden
8	Am Ziel	Am Zielort
9	Fremdanmeldung	Fremdanmeldung

Was mit Status 3 und 4 passiert

Die beiden beziehen sich sehr wohl auf einen Einsatz — „Einsatz übernommen", „am Einsatzort". Sie werden dem laufenden Einsatz der Organisation zugeordnet, und das Fahrzeug wird sein Einsatzmittel.

Die Stufen 1, 2 und 6 haben mit keinem Einsatz zu tun. Sie beschreiben, ob das Fahrzeug bereit ist — und das gilt auch, wenn den ganzen Tag nichts los war.

Was der Eingang nicht tut

Er legt keine Fahrzeuge an. Eine unbekannte ISSI wird gezählt und übergangen. Sonst stünde nach dem ersten Zahlendreher ein Fahrzeug im Bestand, das es nicht gibt — und der Bestand ist die Grundlage der Einsatzmittelliste.

Wenn Status ankommen, aber kein Fahrzeug reagiert: prüfen Sie zuerst, ob die ISSI im Portal unter Fahrzeuge genau so hinterlegt ist.

Welche Quellen dürfen

Alle: webhook, alarmdispatcher, divera, feuersoftware, groupalarm. Bei DIVERA und Connect kommen die Status außerdem über deren API — dafür brauchen Sie dort den API-Schlüssel bzw. das Token.

Drosselung

600 Aufrufe je Minute und Absender, mit eigenem Zähler neben dem Alarmeingang: eine Leitstelle meldet Status häufiger als Alarme, und der eine soll den anderen nicht aussperren.