Integrationen
Integrationen, die heute funktionieren: Tracker, Kontoauszüge, Kurse und Webhooks
Office Hero empfängt die Daten von Teltonika-GPS-Trackern, importiert Kontoauszüge im Format MT940 und CAMT.053, übernimmt tägliche Wechselkurse von der EZB und der NBRM, zeigt Kartenebenen von Google Maps und OpenStreetMap und sendet Fuhrpark-Alarme als signierte Webhooks an Ihre eigenen Systeme.
Alles auf dieser Seite funktioniert heute, mit den jeweils genannten Einschränkungen. Geplante Anbindungen sind gesondert als „demnächst“ aufgeführt.
01Anbindungen
Was sich mit Office Hero verbinden lässt
Fünf Anbindungen, die heute im Einsatz sind, jeweils mit ihrem Leistungsumfang und ihren Grenzen.
GPS-Tracker
Teltonika-Tracker, vollständig ausgewertet
Fleet Hero verarbeitet die Daten von Teltonika-Trackern in Codec 8, 8 Extended und 16 und macht aus jedem nummerierten Messwert einen benannten Wert mit der richtigen Einheit: Kraftstoff, AdBlue, Spannungen, Warnleuchten und Fehlercodes. An den Tachographen angeschlossene Tracker melden außerdem die Fahrerkarten und die aktuelle Tätigkeit und, wenn sie den Tachographen direkt lesen, auch die Lenkzeiten. Unser Team baut die Geräte ein und richtet sie ein, und SIM-Karte und mobile Daten sind in jedem Paket von Fleet Hero enthalten.
- Im Einsatz: der FMC003 für Pkw und Transporter und der FMC650 für Lkw
- Tachographendaten über TachoCAN, K-Line, ALL-CAN300 oder FMS-Anschluss
- Nur Tracker, die für Ihr Unternehmen registriert sind, werden angenommen
- Fernkonfiguration von 9 Teltonika-Modellen durch unser Team
- Tracker anderer Marken auf Anfrage
Kontoauszüge
Kontoauszüge im Format MT940 und CAMT.053, mit Rechnungen abgeglichen
Laden Sie Kontoauszüge im Format MT940 oder CAMT.053 aus Ihrem Onlinebanking herunter und in Finance Hero hoch. Bereits importierte Umsätze werden übersprungen, und der automatische Abgleich ordnet Zahlungen anhand von Betrag und Rechnungsnummer den Rechnungen zu, wobei jeder Vorschlag die Konfidenz „Hoch“, „Mittel“ oder „Niedrig“ erhält.
- SWIFT MT940 und ISO 20022 CAMT.053
- Doppelte Umsätze werden bei jedem Import übersprungen
- Ein Klick erfasst die Zahlung, ihre Zuordnung und die Buchung
- Kontoauszüge werden als Dateien hochgeladen: Eine direkte Verbindung zur Bank gibt es nicht
Wechselkurse
Tageskurse von der EZB und der NBRM
Finance Hero ruft die Euro-Referenzkurse der Europäischen Zentralbank an jedem TARGET-Geschäftstag ab und die Denar-Kurse der Nationalbank der Republik Nordmazedonien jeden Tag, auch am Wochenende. Jeder Kurs behält seine Quelle, und von Hand erfasste Kurse werden nie überschrieben.
- Kurse von EZB und NBRM, automatisch abgerufen
- Die Quelle bei jedem Kurs: EZB, NBRM oder manuell
- Realisierte und nicht realisierte Kursdifferenzen aus denselben Kursen
- Eine Warnung bei einem veralteten Kurs statt einer falschen Summe
Karten
Kartenebenen von Google Maps und OpenStreetMap
Die Live-Karte bietet als Basiskarten OpenStreetMap sowie die Straßen- und die Satellitenkarte von Google, darüber eine Live-Verkehrsebene und Ihre Geozonen. Karten- und Verkehrskacheln von Google erreichen den Browser über die eigenen Server von Office Hero, die Kacheln von OpenStreetMap kommen von den Servern von OpenStreetMap. Von jedem Fahrzeug aus öffnen Sie seine Position in Google Maps, Apple Maps oder OpenStreetMap.
- Drei Basiskarten und eine Verkehrsebene
- Karteneinstellungen in Ihrem Konto gespeichert, auf jedem Gerät
- Ein Klick vom Fahrzeug zu seiner Position in einer Karten-App
Webhooks
Fuhrpark-Alarme an Ihre eigenen Systeme
Legen Sie in den Einstellungen einen Endpunkt an und abonnieren Sie damit die Ereignisse von Fuhrpark-Alarmen, oder wählen Sie ihn in einer Alarmregel von Fleet Hero. Wird ein Alarm ausgelöst, sendet Office Hero eine JSON-Nachricht mit Alarmtyp, Schweregrad, Regel, Kennzeichen, Fahrer, Position und einem Link zurück zum Alarm. Jeder Aufruf ist mit HMAC-SHA256 signiert, sodass Ihr System prüfen kann, dass er von Office Hero stammt.
- Ereignisse: alert.fired, das als eskaliert markiert erneut gesendet wird, wenn sich ein Alarm verschärft, und alert.cleared
- Header X-Officehero-Signature, X-Officehero-Timestamp und X-Officehero-Event
- Nur HTTPS-Adressen, dazu benutzerdefinierte Header und ein Ein/Aus-Schalter
- Fuhrpark-Alarme sind derzeit die einzigen gesendeten Ereignisse, im Paket Business von Fleet Hero
- Die Einstellungen zeigen das Signaturgeheimnis noch nicht an: Fragen Sie unser Team danach
02Mehr
Kleinere Anbindungen und was als Nächstes kommt
Ebenfalls angebunden
Standards und Dateiformate, mit denen Office Hero heute arbeitet.
Authenticator-Apps
Zweistufige Anmeldung mit einer Authenticator-App (heute für Portalbenutzer, für Mitarbeiter mit der Manager-App), nach dem TOTP-Standard, dem gängige Authenticator-Apps folgen.
SCIM für Portalkonten
Ein Identitätssystem kann Konten von Office Hero Connect über SCIM 2.0 auflisten, abfragen, deaktivieren und entfernen.
Nur Portalkonten, nicht die Konten Ihrer Teammitglieder in den Web-Apps; ein neues Konto muss zu einem bestehenden Mitarbeiter-, Kunden- oder Lieferantendatensatz passen, Gruppen sind schreibgeschützt, und unser Team stellt das Token aus.
Fahrzeugimport aus CSV
Fügen Sie eine CSV-Datei mit bis zu 500 Fahrzeugen ein. Fehlerhafte Zeilen werden einzeln gemeldet, und die fehlerfreien Zeilen werden trotzdem angelegt.
Exporte als PDF, Excel und CSV
Fuhrparkberichte lassen sich als PDF, Excel oder CSV exportieren, Finanzberichte als CSV oder PDF, und Listen in HR Hero und Finance Hero exportieren die ausgewählten Zeilen als CSV.
Zwischen den Apps von Office Hero
Keine Exporte nötig: Die Apps teilen ihre Datensätze.
Ein Datensatz pro Person
Ein Fahrer in Fleet Hero ist ein Mitarbeiter in HR Hero, und dieselbe Person meldet sich bei Office Hero Connect an.
Kunden und Lieferanten im Portal
Kunden sehen ihren Saldo und ihre letzten Rechnungen, Lieferanten sehen, was Sie ihnen schulden, direkt aus Finance Hero.
Ein Konto für alle Apps
Mitarbeiter melden sich einmal an und wechseln mit dem App-Umschalter zwischen Fleet Hero, HR Hero und Finance Hero.
Stundenzettel liefern die Arbeitszeit der Fahrer
Arbeitszeitbefunde für Fahrer stammen aus den Stundenzetteln in HR Hero und erscheinen im Tachographen-Bereich von Fleet Hero.
Demnächst
Geplant und noch nicht verfügbar.
Öffentliche API und Entwicklerportal
Eine dokumentierte Schnittstelle und ein Entwicklerportal werden es Ihrer eigenen Software und Integratoren ermöglichen, sich mit Office Hero zu verbinden.
Demnächst
Single Sign-on
Sie werden sich über das eigene Identitätssystem Ihres Unternehmens anmelden können.
Demnächst
SMS-Benachrichtigungen
Fuhrpark-Alarme werden künftig auch als SMS versendet, zusätzlich zu den Benachrichtigungen in der App und per E-Mail.
Demnächst
Office Hero Track bei Google Play
Office Hero Track wird die Live-Karte Ihres Fuhrparks auf einem Android TV anzeigen, gekoppelt mit Fleet Hero über einen kurzen Code.
Demnächst
Was sich noch nicht anbinden lässt
Es gibt noch keine öffentliche Schnittstelle für Ihre eigene Software, und Office Hero tauscht keine Daten mit anderen Buchhaltungs- oder HR-Systemen aus. Daten verlassen Office Hero als PDF-, Excel- und CSV-Dateien, Kontoauszüge kommen als Dateien herein, und Webhooks übertragen nur Fuhrpark-Alarme.
04Webhooks
In vier Schritten vom Fuhrpark-Alarm zu Ihrem System
-
Schritt 1 Endpunkt anlegen
Geben Sie unter Einstellungen, Webhooks die HTTPS-Adresse Ihres Systems ein, abonnieren Sie alert.fired und alert.cleared, und fügen Sie die Header hinzu, die Ihr System erwartet.
-
Schritt 2 Alarme für den Endpunkt wählen
Ein Endpunkt, der diese Ereignisse abonniert hat, erhält jeden Fuhrpark-Alarm. Sie können den Endpunkt auch in einer Alarmregel wählen, im Schritt, der festlegt, wer wie benachrichtigt wird; die Alarme dieser Regel erreichen ihn dann auch ohne Abonnement.
-
Schritt 3 Signatur prüfen
Berechnen Sie mit dem Signaturgeheimnis HMAC-SHA256 über den Wert von X-Officehero-Timestamp, einen Punkt und den unveränderten Request-Body, und vergleichen Sie das hexadezimale Ergebnis mit X-Officehero-Signature.
-
Schritt 4 Auf das Ereignis reagieren
Eröffnen Sie ein Ticket oder benachrichtigen Sie ein Team, wenn alert.fired eintrifft, und schließen Sie es wieder, wenn alert.cleared folgt.
05Fragen
Fragen zu Integrationen
Ihre Frage ist nicht dabei? Schreiben Sie an [email protected]. Es antwortet ein Mensch aus unserem Team in Skopje, montags bis freitags, 09:00–17:00 Uhr MEZ.
Welche GPS-Tracker funktionieren mit Fleet Hero?
Tracker von Teltonika, etwa der FMC003 für Pkw und Transporter und der FMC650 für Lkw mit Tachograph. Wir liefern sie, bauen sie ein und richten sie ein: Tracker gibt es ab 65 €, der Einbau beginnt bei 49 € pro Fahrzeug. Fragen Sie uns, bevor Sie andere Hardware kaufen.
Kann sich Office Hero direkt mit unserer Bank verbinden?
Noch nicht. Sie laden Kontoauszüge im Format MT940 oder CAMT.053 aus Ihrem Onlinebanking hoch, und Finance Hero schlägt Zuordnungen zu Ihren Rechnungen vor.
Kann unsere eigene Software Daten aus Office Hero lesen?
Direkt noch nicht: Eine öffentliche Schnittstelle für Entwickler kommt demnächst. Heute verlassen Daten Office Hero als Exporte im Format PDF, Excel und CSV, und Fuhrpark-Alarme erreichen Ihre Systeme als signierte Webhooks.
Wie prüfen wir, dass ein Webhook von Office Hero stammt?
Berechnen Sie den HMAC-SHA256 aus X-Officehero-Timestamp, einem Punkt und dem unveränderten Request-Body mit dem Signaturgeheimnis des Endpunkts neu, und vergleichen Sie ihn in konstanter Zeit mit X-Officehero-Signature. Fragen Sie unser Team nach dem Geheimnis, da die Einstellungen es noch nicht anzeigen.
Woher kommen die Wechselkurse?
Von der Europäischen Zentralbank und der Nationalbank der Republik Nordmazedonien, automatisch abgerufen. Von Hand erfasste Kurse werden nie überschrieben.
Können wir Daten aus unserem bisherigen System importieren?
Fahrzeuge lassen sich aus einer CSV-Datei mit bis zu 500 Zeilen importieren, Kontoauszüge aus Dateien im Format MT940 oder CAMT.053. Andere Daten kann unser Team bei der Einführung als Individualentwicklung übernehmen.
Können sich Mitarbeiter über das Identitätssystem unseres Unternehmens anmelden?
Noch nicht: Das kommt demnächst. Heute kann ein Identitätssystem Konten von Office Hero Connect über SCIM 2.0 abfragen, deaktivieren und entfernen, innerhalb der auf dieser Seite genannten Grenzen.
Sagen Sie uns, was Sie anbinden möchten
Nennen Sie uns die Systeme und Geräte, die Sie verwenden, und wir sagen Ihnen offen, was heute mit Office Hero funktioniert.