Integratsioonid

Lehel „Integratsioonid” seob administraator Terakese teiste süsteemidega: telemeetria (näiteks Navirec, SkyFMS, John Deere, Wialon, Metrotec, Mapon, FleetComplete), tankimise (Alexela, Piusi B.Smart), raamatupidamise (Directo) ja Maksu- ja Tolliameti TTKI. Iga seos on eraldi integratsioon, mille jaoks sisestad partneri antud tunnused või annad partneri keskkonnas Terakesele loa andmeid lugeda.

Lehe ülesehitus

• Nupp „Lisa uus integratsioon” avab uue integratsiooni vormi.
• Tabelis on ettevõtte integratsioonid veergudega „ID” ja „Integratsioonipartner”. Sama partneriga võib olla mitu integratsiooni, näiteks kaks eri kontot.
• Tabeli kohal on otsinguväli ning nupud tabeli allalaadimiseks Exceli või PDF-failina ja veergude valimiseks.
• Integratsiooni avamiseks klõpsa selle real. Avaneb aken „Muuda integratsiooni”.

Kuidas integratsiooni lisada

1. Vajuta „Lisa uus integratsioon”.
2. Vali „Integratsioonipartner”. Vormile ilmuvad selle partneri väljad.
3. Täida partneri väljad või anna partneri keskkonnas luba, nagu allpool partneri juures kirjas.
4. Vajuta „Salvesta” või „Salvesta ja sule”.

Salvestatud integratsiooni partnerit muuta ei saa. Kui vajad teist partnerit, lisa uus integratsioon. Integratsiooni eemaldamiseks ava see ja vajuta „Kustuta”.

Partnerite seadistamine

Navirec

1. Vali partneriks Navirec. Vormil on väli „Apikey” ja võtme päringu aadress („Apikey päringu aadress”).
2. Sisesta Navireci antud võti väljale „Apikey”, või sisesta Navireci kasutajanimi ja salasõna vormi alumistesse väljadesse ja vajuta „Tee päring Navireci”. Päring kopeerib võtme automaatselt väljale „Apikey”. Kasutajanime ja salasõna Terake ei salvesta.
3. Salvesta integratsioon.

SkyFMS

1. Vali partneriks SkyFMS ja vajuta nuppu www.skyfms.com. Avaneb SkyFMS-i sisselogimise leht uues aknas.
2. Logi sisse SkyFMS-i kontoga ja luba Terakesel andmetele juurde pääseda. Kui loa andmine õnnestus, näed teadet „All done! Please close this browser window”. Sulge see aken.
3. Salvesta integratsioon Terakeses.

John Deere

1. Vali partneriks John Deere ja vajuta nuppu all tekstiga „Luba ligipääs John Deere keskkonnas”. Avaneb John Deere’i sisselogimise leht uues aknas.
2. Logi sisse John Deere’i kontoga ja anna Terakesele soovitud õigused.
3. Salvesta integratsioon Terakeses.

Wialon

1. Vali partneriks Wialon ja vajuta „Logi sisse Wialoni uue Apikey saamiseks”.
2. Avanevas aknas logi sisse Wialoni kontoga ja kinnita ligipääs.
3. Pärast sisselogimist aken sulgub, integratsioon salvestatakse ning vormile tulevad väljad „Apikey” ja „API url” ning Wialoni masinate nimekiri.

Metrotec ja Alexela

Sisesta partneri antud „Kasutajanimi” ja „Salasõna” ning salvesta. Alexela integratsiooniga tulevad Terakesse Alexela tankimised.

Piusi B.Smart

1. Logi sisse Piusi B.Smart keskkonda, vali „Settings” ja „API”, lülita sisse „Enable API for Export” ja vajuta „Generate”.
2. Kopeeri sealt saadud väärtused Terakese vormi väljadele „Client ID” ja „Client Secret” ning salvesta.

Piusi integratsiooniga tulevad Terakesse Piusi B.Smart süsteemi registreeritud tankimised. Tankimiste laadimisest loe lehelt Tankimised.

Directo

1. Vali partneriks Directo ja sisesta Directost saadud „Apikey” ning Directo aadress väljale „API url”.
2. Salvesta integratsioon.

Directost tuuakse Terakesse töötajad, projektid tööobjektide ja klientidena, puhkused ja muud puudumised graafikusse ning masinad. Terakesest saadetakse Directosse päeva kaupa kinnitatud tööde töötaja- ja masinatunnid. Saatmist juhid salvestatud integratsiooni vormi allosas tabelis „Interaction with Directo”:

1. Vali periood ja vajuta „Näita”. Tabelis on iga päeva kohta „Töid”, „Kinnitatud”, „Kinnitamata”, „Aruande nimi”, „Saatmise aeg” ja „Tulemus”.
2. Kui päeva kõik tööd on kinnitatud, vajuta selle päeva real „Send”. Kui päeval on kinnitamata töid, on real tekst „Wait workdones to be approved”: kinnita need enne lehel Kinnitamine.
3. Juba saadetud päeva saad uuesti saata nupuga „Resend” ja saadetud faili alla laadida nupuga „.xml”. Õnnestunud saatmise korral on veerus „Tulemus” OK, muidu Directo veateade.

Maksuamet TTKI

TTKI integratsioon saadab ehitusobjektide (töömaade) sissepääsude ja tööaja andmed Maksu- ja Tolliameti töötajate registrisse. Päringud tehakse ettevõtte esindajana selle administraatori isikukoodiga, kes TTKI andmed esimest korda edukalt laadis, seega peab sinu töötajakaardil olema isikukood. Vali partneriks Maksuamet TTKI ja salvesta. Vormil on kolm vahelehte:

• „TTKI töötajad”: TTKI-s registreeritud töötajad. Vahelehe avamisel laaditakse nimekiri TTKI-st, puuduvad töötajad lisatakse Terakesse. Kui töötaja ei seostunud õige Terakese töötajaga, vajuta real „Muuda”, vali töötaja ja vajuta „Salvesta”. „Värskenda” laeb nimekirja uuesti.
• „TTKI töömaad”: ettevõtte töömaad TTKI-s. Seosta iga töömaa Terakese tööobjektiga: vajuta „Muuda”, vali „Töökoht” ja vajuta „Salvesta”. Töödest, mis on tehtud seotud tööobjektil, tekivad TTKI aruanded.
• „TTKI aruanded”: vali periood ja vaata iga päeva ja tööobjekti kohta „Kirjete arv”, „Eksporditavate kirjete arv”, „Saatmise aeg” ja „Tulemus”. „Kirjete arv” nupp avab päeva tööde aruande, „Eksporditavate kirjete arv” nupp saadetud kirjed. Möödunud päeva saatmata andmed saada nupuga „Send”, juba saadetud uuesti nupuga „Resend”.

Teised partnerid

Ülejäänud partnerite (näiteks Mapon, FleetComplete) puhul sisesta partneri antud võti väljale „Apikey” ja salvesta.

Kuidas kontrollida, kas masinad seostuvad

Telemeetria integratsioonist tulevad masinate asukohad, läbisõit ja mootoritunnid ning neist tekivad masinate tööd. Andmed seotakse Terakese masinaga registrinumbri, VIN-koodi või välja „Seose võti integratsioonideks (registrinumber tühikuteta)” järgi.

1. Ava salvestatud telemeetria integratsioon.
2. Vajuta „Vaata läbi API pakutavat masinate nimekirja”.
3. Tabelis „Masinate nimekiri API teenusepakkuja juures” on partneri masinad veergudega „Allikas”, „Reg nr”, „Nimi”, „Lisainfo”, „VIN kood” ja „Väline ID / ID 2”. Kui sama registrinumber või VIN-kood esineb mitu korda, on see punane ja märgitud „Viga: duplikaat”.
4. Kontrolli, et Terakese masinatel lehel Masinad ja seadmed oleksid samad registrinumbrid või VIN-koodid.

Kui partner tagastab vea (näiteks vale võti), näidatakse veateadet nimekirja asemel. Tankimise, Directo ja TTKI integratsioonil masinate nimekirja nuppu ei ole.

Kes näeb ja kes saab muuta

Lehte näeb ja integratsioone lisab, muudab ja kustutab „Administraator”. Directo ja TTKI andmeid saadab samuti administraator.

Nõuanded

• Hoia partneri võtmed ja salasõnad ainult integratsiooni vormil, ära jaga neid e-kirjas ega failides.
• Kui telemeetria andmed ei jõua masinani, vaata masinate nimekirjast, kas registrinumber on partneri juures ja Terakeses ühesugune. Telemeetria andmeid laaditakse mõneminutilise vahega, vt Automaatsed protsessid.
• Tankimised integratsioonidest näed lehel Tankimised, kütuse jääke ja tankla seadeid lehel Tankimise seaded.