Trigon ühendamine Ukuga

Ettevõtte omanikud ja Ettevõtte peakasutajad saavad Trigoni integratsiooni seadistada. Sul peab olema ka juurdepääs oma Trigoni konto API seadetele — tavaliselt on selleks vaja Trigoni haldurõigustega kontot.

Tee: Seaded & Äpid → Trigon

Trigon on õige integratsioon Eesti raamatupidamisbüroodele, kes haldavad maksefaile ja tehinguandmeid Trigon Panga klientide jaoks.

Trigoni Ukuga ühendamiseks vajad esmalt Trigonis loodud ID tokenit ja API võtit. Mõlemad luuakse Trigonis, mitte Ukus.

1. Logi Trigoni sisse haldurõigustega kontoga.
2. Liigu Trigoni seadetes API juurdepääsu jaotisse.
3. Loo või leia kaks vajalikku väärtust:
   • ID token (mõnikord märgitud identity token) — tuvastab ühendava konto.
   • API võti — saladus, mida kasutatakse API päringute autentimiseks.
4. Kopeeri mõlemad väärtused turvalisse kohta.

Trigoni integratsioon tuleb enne klientide kaupa kasutamist lubada ettevõtte tasemel. Lubamine andmeid veel ei impordi — see teeb integratsiooni lihtsalt kättesaadavaks.

1. Ava Ukus Seaded & Äpid.
2. Leia integratsioonide jaotises kaart Trigon.
3. Klõpsa kaardil, et avada integratsioonidialoog.
4. Vahekaardil Ülevaade klõpsa Luba.

Pärast Trigoni lubamist kleebi ID token ja API võti integratsioonidialoogi ning vali sobiv keskkond.

1. Vaheta integratsioonidialoogis vahekaardile Ühenda (või Seaded).
2. Kleebi ID token vastavasse välja.
3. Kleebi API võti vastavasse välja.
4. Vali keskkond — production reaalseks kasutuseks, test/sandbox kui ühendad Trigoni testkontot.
5. Klõpsa Testi ühendust. Kui tunnused on kehtivad, vastab Trigon konto andmetega.
6. Klõpsa Salvesta.

Kui ühenduse test ebaõnnestub, vt allpool jaotist Tõrkeotsing.

Trigon on ühesuunaline sissetulev — Uku loeb andmeid Trigonist. Trigonisse midagi tagasi ei kirjutata.

Andmed	Suund	Märkused
Kliendid	Trigon → Uku	Imporditakse klientide loendi veergu Integratsioon.
Kontaktid	Trigon → Uku	Iga kliendiga seotud kontaktandmed.
Aadressid	Trigon → Uku	Sobitatakse Uku kliendi aadressiväljadega.
Töömahud	Trigon → Uku	Toidab kuiseid kokkuvõtteülesannete välju (tehingute arv ja maht perioodi kohta).

Pärast Trigoni ühendamist ava integratsioonidialoogis vahekaart Seaded, et määrata, kuidas Uku loob iga ühendatud kliendi jaoks kuiseid kokkuvõtteülesandeid.

Seade	Mida see teeb
Ülesande pealkiri	Iga kuu automaatselt loodava kokkuvõtteülesande nimi.
Teema	Teema, mille alla kokkuvõtteülesanne paigutatakse.
Korduvus	Alati igakuine.
Andmete import	Millal kuus andmed imporditakse — viimasel tööpäeval, viimasel kalendripäeval või järgmise kuu kindlal päeval (1.–28.).

Jaotises Seadista andmeväljad seo iga Trigoni andmeväli Uku kohandatud ülesande väljaga. Trigon pakub tehingupõhist statistikat:

• Tehingute arv perioodis
• Töömahud kategooriate kaupa
• Uued kliendid perioodi jooksul lisatud

Iga välja jaoks, mida soovid jälgida:

1. Vali väli vasakust veerust.
2. Vali paremal asuvast rippmenüüst sobiv Uku kohandatud ülesande väli.
3. Tühjaks jäetud välju ei impordita.
4. Klõpsa Näita rohkem, et kuvada täiendavaid harvemini kasutatavaid välju.
5. Kui sobivat lisavälja veel pole, kasuta rippmenüüs valikut Uus lisaväli, et see kohe luua.
6. Klõpsa Salvesta.

Trigoni integratsiooni lubamine registreerib selle vaid ettevõtte tasemel. Andmete liikumiseks tuleb iga Uku klient siduda ka oma vastava Trigoni kliendikirjega. Täielik kliendipõhine ühendamise töövoog on kirjeldatud artiklis Ühenda klient raamatupidamistarkvaraga. Lühidalt:

1. Klõpsa klientide loendis kliendi rea veerul Integratsioon.
2. Vali integratsiooni rippmenüüst Trigon.
3. Uku loeb sinu salvestatud tunnuste alusel Trigoni klientide loendi ja lubab sul valida vastava kliendi.
4. Klõpsa Salvesta.

Trigon kešib jõudluse huvides töömahud perioodi kaupa. Kui klient näib kirjeid kaotavat või oled muutnud välja seoseid või seadeid, käivita Impordi töömahud kohe.

1. Ava Seaded & Äpid → Trigon → Seaded.
2. Klõpsa dialoogi vasakus alaservas nupul Impordi töömahud kohe.
3. Kinnita. Uku impordib viimase 12 kuu andmed uuesti ja kirjutab olemasolevate kokkuvõtteülesannete väljaväärtused üle, seejärel teavitab sind, kui valmis.

Andmete uuesti import on õige tegevus alati, kui muudad andmevälja seoseid, taastud katkenud ühendusest või märkad, et kešitud töömahud tunduvad aegunud.

Trigoni ühenduse testimise tõrked on peaaegu alati üks järgmistest:

• Valitud on vale keskkond (production vs. test/sandbox) — testtunnused production’i vastu ei tööta ja vastupidi.
• ID tokenil või API võtmel on tühikuid alguses või lõpus. Kopeeri uuesti otse Trigonist.
• Token on aegunud. Trigoni tokenitel on aegumiskuupäev — loo Trigonis uus ja kleebi uus väärtus.
• Trigoni haldur on tunnused tühistanud.

Kui Trigoni ühendus läbib testi, kuid kokkuvõtteülesannetes statistikat ei ilmu, ei piisa ainult integratsiooni lubamisest. Vajad ka:

• Ühenda iga klient oma Trigoni kirjega — määra kliendi rea veerus Integratsioon Trigon.
• Seadista kokkuvõtteülesande seaded integratsiooni vahekaardil Seaded (ülesande pealkiri, teema, impordi päev, andmevälja seosed).
• Oota järgmist planeeritud impordi päeva või käivita Impordi töömahud kohe, et tuua viimase 12 kuu andmed.

Trigoni töömahud kešitakse Ukus jõudluse huvides. Kui mahud näivad aegunud, käivita integratsiooni vahekaardil Seaded Impordi töömahud kohe, et värskendada keši kõigi ühendatud klientide jaoks Trigonist.

Toiminud kuid katkenud Trigoni ühendus on tavaliselt tokeni probleem. Trigoni tokenitel on aegumiskuupäev — loo Trigonis uus ID token ja API võti, kleebi uued väärtused Ukusse ja klõpsa Testi ühendust, et kinnitada. Kui vead jäävad püsima, kontrolli, et keskkonna valik vastab tunnustele.

Kui mõni Trigoni väli jõuab Uku kokkuvõtteülesannetesse pidevalt tühjana, pole see suure tõenäosusega seotud Uku kohandatud ülesande väljaga. Ava integratsiooni vahekaart Seaded, leia väli jaotisest Seadista andmeväljad, määra kohandatud väli, seejärel klõpsa Impordi töömahud kohe, et tuua olemasolevad kuud tagantjärele.