Integracje
Integracje, które działają już dziś: lokalizatory, wyciągi bankowe, kursy walut i webhooki
Office Hero odczytuje dane z lokalizatorów GPS Teltonika, importuje wyciągi bankowe MT940 i CAMT.053, pobiera codzienne kursy walut z EBC i NBRM, wyświetla warstwy Google Maps i OpenStreetMap, a alerty floty wysyła do Państwa własnych systemów jako podpisane webhooki.
Wszystko na tej stronie działa już dziś, a ograniczenia są opisane. Planowane połączenia wymieniamy osobno jako dostępne wkrótce.
01Połączenia
Co łączy się z Office Hero
Pięć połączeń używanych już dziś – przy każdym opisujemy, co robi i gdzie kończą się jego możliwości.
Lokalizatory GPS
Lokalizatory Teltonika odczytywane w pełni
Fleet Hero odczytuje lokalizatory Teltonika w protokołach Codec 8, 8 Extended i 16, a każdy numerowany odczyt zamienia na nazwaną wartość z właściwą jednostką: paliwo, AdBlue, napięcia, kontrolki ostrzegawcze i kody usterek. Lokalizatory podłączone do tachografu przesyłają też karty kierowców i bieżącą czynność, a gdy odczytują tachograf bezpośrednio – także czasy jazdy. Nasz zespół montuje i konfiguruje urządzenia, a karta SIM i transmisja danych są wliczone w każdy pakiet Fleet Hero.
- W użyciu: FMC003 do samochodów osobowych i dostawczych oraz FMC650 do ciężarówek
- Dane z tachografu przez połączenie TachoCAN, K-Line, ALL-CAN300 lub FMS
- Akceptowane są wyłącznie lokalizatory zarejestrowane na Państwa firmę
- Zdalna konfiguracja 9 modeli Teltonika przez nasz zespół
- Lokalizatory innych marek na zapytanie
Wyciągi bankowe
Wyciągi MT940 i CAMT.053 dopasowywane do faktur
Wystarczy pobrać wyciągi z bankowości elektronicznej w formacie MT940 lub CAMT.053 i przesłać je do Finance Hero. Pozycje zaimportowane wcześniej są pomijane, a automatyczne dopasowanie łączy płatności z fakturami na podstawie kwoty i numeru faktury, przypisując każdej sugestii poziom pewności: wysoki, średni lub niski.
- SWIFT MT940 i ISO 20022 CAMT.053
- Zduplikowane pozycje pomijane przy każdym imporcie
- Jedno kliknięcie księguje płatność, jej rozliczenie i zapis księgowy
- Wyciągi przesyła się jako pliki: nie ma bezpośredniego połączenia z bankiem
Kursy walut
Codzienne kursy z EBC i NBRM
Finance Hero pobiera referencyjne kursy euro Europejskiego Banku Centralnego w każdy dzień roboczy systemu TARGET, a kursy denara Narodowego Banku Republiki Macedonii Północnej – codziennie, także w weekendy. Każdy kurs zachowuje swoje źródło, a kursy wprowadzone ręcznie nigdy nie są nadpisywane.
- Kursy EBC i NBRM pobierane automatycznie
- Źródło przy każdym kursie: EBC, NBRM lub wprowadzenie ręczne
- Zrealizowane i niezrealizowane różnice kursowe z tych samych kursów
- Ostrzeżenie o nieaktualnym kursie zamiast błędnej sumy
Mapy
Warstwy Google Maps i OpenStreetMap
Mapa na żywo oferuje trzy podkłady: OpenStreetMap, mapę drogową Google i mapę satelitarną Google, z warstwą ruchu drogowego na żywo i Państwa geostrefami narysowanymi na wierzchu. Kafelki map i ruchu drogowego Google docierają do przeglądarki przez własne serwery Office Hero, a kafelki OpenStreetMap pochodzą z serwerów OpenStreetMap. Pozycję każdego pojazdu można otworzyć w Google Maps, Apple Maps lub OpenStreetMap.
- Trzy podkłady mapowe i warstwa ruchu drogowego
- Ustawienia mapy zapisane na Państwa koncie, na każdym urządzeniu
- Jedno kliknięcie od pojazdu do jego pozycji w aplikacji z mapami
Webhooki
Alerty floty wysyłane do Państwa własnych systemów
Wystarczy dodać punkt końcowy w Ustawieniach i włączyć dla niego subskrypcję zdarzeń alertów floty albo wybrać go w regule alertu Fleet Hero. Gdy alert zostanie wywołany, Office Hero wysyła wiadomość JSON z typem alertu, ważnością, regułą, numerem rejestracyjnym pojazdu, kierowcą, pozycją i linkiem do alertu. Każde wywołanie jest podpisane HMAC-SHA256, dzięki czemu Państwa system może sprawdzić, że pochodzi od Office Hero.
- Zdarzenia: alert.fired, wysyłane ponownie z oznaczeniem eskalacji, gdy alert się pogarsza, oraz alert.cleared
- Nagłówki X-Officehero-Signature, X-Officehero-Timestamp i X-Officehero-Event
- Tylko adresy HTTPS, a do tego własne nagłówki i przełącznik aktywny/nieaktywny
- Alerty floty to obecnie jedyne wysyłane zdarzenia; webhooki są dostępne w pakiecie Business Fleet Hero
- Ustawienia nie pokazują jeszcze sekretu do podpisu – udostępnia go nasz zespół na prośbę
02Więcej
Mniejsze połączenia i kolejne plany
Inne połączenia
Standardy i formaty plików, z którymi Office Hero współpracuje już dziś.
Aplikacje uwierzytelniające
Logowanie dwuetapowe z aplikacją uwierzytelniającą (obecnie użytkownicy portalu, personel – wraz z aplikacją Manager) w standardzie TOTP, z którego korzystają popularne aplikacje uwierzytelniające.
SCIM dla kont w portalu
System tożsamości może przez SCIM 2.0 pobierać listę kont Office Hero Connect, wyszukiwać je, dezaktywować i usuwać.
Tylko konta w portalu, nie konta personelu; nowe konto musi odpowiadać istniejącemu rekordowi pracownika, klienta lub dostawcy, grupy są tylko do odczytu, a token wydaje nasz zespół.
Import pojazdów z pliku CSV
Wystarczy wkleić plik CSV z maksymalnie 500 pojazdami. Wiersze z błędami są zgłaszane pojedynczo, a poprawne wiersze i tak zostają utworzone.
Eksport do PDF, Excel i CSV
Raporty floty można eksportować do PDF, Excel lub CSV, raporty finansowe do CSV lub PDF, a z list w HR Hero i Finance Hero – wybrane wiersze do CSV.
Między aplikacjami Office Hero
Bez eksportowania: aplikacje współdzielą dane.
Jeden rekord osoby
Kierowca w Fleet Hero jest pracownikiem w HR Hero, a ta sama osoba loguje się do Office Hero Connect.
Klienci i dostawcy w portalu
Klienci widzą swoje saldo i ostatnie faktury, a dostawcy – ile są im Państwo winni, prosto z Finance Hero.
Jedno konto do wszystkich aplikacji
Personel loguje się raz i przechodzi między Fleet Hero, HR Hero i Finance Hero za pomocą przełącznika aplikacji.
Czas pracy kierowców z kart czasu pracy
Wyniki kontroli czasu pracy kierowców pochodzą z kart czasu pracy w HR Hero i pojawiają się w sekcji tachografu Fleet Hero.
Wkrótce
Planowane, jeszcze niedostępne.
Publiczne API i portal dla deweloperów
Udokumentowany interfejs i portal dla deweloperów pozwolą Państwa własnemu oprogramowaniu i integratorom łączyć się z Office Hero.
Wkrótce
Logowanie jednokrotne (SSO)
Będą Państwo mogli logować się za pomocą własnego systemu tożsamości firmy.
Wkrótce
Powiadomienia SMS
Alerty floty będą wysyłane także jako wiadomości SMS, obok powiadomień w aplikacji i e-maili.
Wkrótce
Office Hero Track w Google Play
Office Hero Track pokaże mapę Państwa floty na żywo na telewizorze z Android TV, sparowanym z Fleet Hero za pomocą krótkiego kodu.
Wkrótce
Czego jeszcze nie można połączyć
Nie ma jeszcze publicznego interfejsu dla Państwa własnego oprogramowania, a Office Hero nie wymienia danych z innymi systemami księgowymi ani kadrowymi. Dane opuszczają Office Hero jako pliki PDF, Excel i CSV, wyciągi bankowe trafiają do systemu jako pliki, a webhooki przenoszą wyłącznie alerty floty.
04Webhooki
Od alertu floty do Państwa systemu w czterech krokach
-
Krok 1 Dodanie punktu końcowego
W sekcji Ustawienia, Webhooki wpisują Państwo adres HTTPS swojego systemu, subskrybują zdarzenia alert.fired i alert.cleared oraz dodają nagłówki, których oczekuje Państwa system.
-
Krok 2 Wybór alertów, które otrzyma
Punkt końcowy z subskrypcją tych zdarzeń otrzymuje każdy alert floty. Punkt końcowy można też wybrać w regule alertu, na kroku, w którym ustala się, kto i jak jest powiadamiany; alerty z tej reguły docierają do niego wtedy nawet bez subskrypcji.
-
Krok 3 Sprawdzenie podpisu
Za pomocą sekretu do podpisu należy obliczyć HMAC-SHA256 z wartości X-Officehero-Timestamp, kropki i surowej treści żądania, a wynik w zapisie szesnastkowym porównać z X-Officehero-Signature.
-
Krok 4 Reakcja na zdarzenie
Gdy nadejdzie alert.fired, można otworzyć zgłoszenie lub powiadomić zespół, a gdy nadejdzie alert.cleared – ponownie je zamknąć.
05Pytania
Pytania o integracje
Nie znaleźli Państwo odpowiedzi? Prosimy napisać na adres [email protected]. Odpowie osoba z naszego zespołu w Skopje, od poniedziałku do piątku w godz. 09:00–17:00 czasu środkowoeuropejskiego.
Jakie lokalizatory GPS współpracują z Fleet Hero?
Lokalizatory Teltonika, takie jak FMC003 do samochodów osobowych i dostawczych oraz FMC650 do ciężarówek z tachografem. Dostarczamy je, montujemy i konfigurujemy: lokalizatory kosztują od 65 €, a montaż od 49 € za pojazd. Przed zakupem innego sprzętu prosimy o kontakt.
Czy Office Hero może połączyć się bezpośrednio z naszym bankiem?
Jeszcze nie. Przesyłają Państwo wyciągi MT940 lub CAMT.053 z bankowości elektronicznej, a Finance Hero proponuje dopasowania do Państwa faktur.
Czy nasze własne oprogramowanie może odczytywać dane z Office Hero?
Jeszcze nie bezpośrednio: publiczny interfejs dla deweloperów pojawi się wkrótce. Obecnie dane opuszczają Office Hero jako eksporty PDF, Excel i CSV, a alerty floty docierają do Państwa systemów jako podpisane webhooki.
Jak sprawdzić, że webhook pochodzi od Office Hero?
Należy ponownie obliczyć HMAC-SHA256 z X-Officehero-Timestamp, kropki i surowej treści żądania, używając sekretu do podpisu danego punktu końcowego, i porównać wynik z X-Officehero-Signature w stałym czasie. Sekret udostępnia nasz zespół, ponieważ Ustawienia jeszcze go nie wyświetlają.
Skąd pochodzą kursy walut?
Z Europejskiego Banku Centralnego i Narodowego Banku Republiki Macedonii Północnej – są pobierane automatycznie. Kursy wprowadzone ręcznie nigdy nie są nadpisywane.
Czy możemy zaimportować dane z obecnego systemu?
Pojazdy importuje się z pliku CSV liczącego do 500 wierszy, a wyciągi bankowe z plików MT940 lub CAMT.053. Inne dane może przenieść nasz zespół podczas wdrożenia, w ramach prac na zamówienie.
Czy personel może logować się przez system tożsamości naszej firmy?
Jeszcze nie: ta funkcja pojawi się wkrótce. Obecnie system tożsamości może wyszukiwać, dezaktywować i usuwać konta Office Hero Connect przez SCIM 2.0, w granicach opisanych na tej stronie.
Co chcą Państwo połączyć z Office Hero?
Prosimy przesłać listę używanych systemów i urządzeń, a jasno odpowiemy, co już dziś działa z Office Hero.