Tripletex ühendamine Ukuga

Ettevõtte peakasutaja või Ettevõtte omanik rollis Team või Elite Uku paketil. Vajad ka Tripletexi sisselogimist õigusega API-juurdepääsu hallata — tavaliselt Tripletexi ettevõtte administraator.

Tripletex on õige integratsioon Norra büroodele.

Tripletexi API kasutab koos kahte tunnust:

• Consumer token identifitseerib integreeriva partneri (antud juhul Uku). Uku haldab seda ise — sina ei pea seda andma.
• Töötaja ligipääsutunnus (employee token) identifitseerib kasutajakontot, mille all andmeid sünkroniseeritakse. Selle pead Tripletexis ise looma ja Ukusse kleepima.

Töötaja ligipääsutunnustel on kehtivuse lõppkuupäev, mille määrad tunnuse loomisel. Kui tunnus aegub, ühendus lakkab töötamast ja pead looma uue tunnuse.

Tripletexi Ukuga ühendamiseks vajad Tripletexis loodud töötaja ligipääsutunnust. Tunnus luuakse Tripletexis, mitte Ukus.

1. Logi Tripletexi sisse administraatori kontoga.
2. Mine asukohta Selskap → API-tilgang (Ettevõte → API-juurdepääs).
3. Loo uus töötaja ligipääsutunnus (employee token), mis on seotud kasutajakontoga, mille all andmeid sünkroniseerida — võimalusel vali teenuse- või integratsioonikasutaja, mitte tegeliku töötaja konto, mis võib hiljem deaktiveeritud saada.
4. Määra kehtivuse lõppkuupäev vastavalt sinu büroo poliitikale. Pane kuupäev kirja, et saaksid tunnuse enne aegumist välja vahetada.
5. Kopeeri tunnuse väärtus. Tripletex kuvab tunnuse loomisel ainult ühe korra.

Tee: Seaded & Äpid → Tripletex

Tripletexi integratsioon tuleb kõigepealt lubada ettevõtte tasemel, enne kui seda saab klientide kaupa kasutada. Lubamine ei too veel andmeid sisse — see teeb integratsiooni lihtsalt kättesaadavaks.

1. Ava Ukus Seaded & Äpid.
2. Leia integratsioonide jaotisest kaart Tripletex.
3. Klõpsa kaardil, et avada integratsiooni dialoog.
4. Vahekaardil Ülevaade klõpsa Luba, et integratsioon sisse lülitada. Tripletex ilmub nüüd valikuna klientide loendi veerus Integratsioon.

Pärast Tripletexi lubamist kleebi töötaja ligipääsutunnus integratsiooni dialoogi ja vali sobiv keskkond.

1. Vaheta integratsiooni dialoogis vahekaardile Ühenda (või Seaded).
2. Kleebi töötaja ligipääsutunnus vastavasse välja.
3. Vali keskkond:
   • Production päris Tripletexi ettevõtetele.
   • Test kui ühendad Tripletexi liivakasti konto.
4. Klõpsa Testi ühendust. Tripletex tagastab ettevõtte nime, kui tunnus on kehtiv.
5. Klõpsa Salvesta.

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

Tripletex sünkroniseerib nii sissetulevaid (kliendid, tooted, käibemaksu tüübid, tööstatistika) kui ka väljaminevaid (arvete eksport) andmeid.

Andmed	Suund	Märkused
Kliendid (Tripletexi kliendid)	Tripletex → Uku	Imporditakse klientide loendi veergu Integratsioon; sobitamine toimub kontaktandmete alusel.
Tooted	Tripletex → Uku	Saadaval Ukus arveldamise toodete konfigureerimisel.
Käibemaksu tüübid	Tripletex → Uku	Norra käibemaksukoodid; kasutatakse arvete saatmisel Tripletexisse.
Arved	Uku → Tripletex	Uku arveid saab Tripletexisse eksportida nende väljastamisel.
Tööstatistika	Tripletex → Uku	Toidab kuiste kokkuvõtteülesannete välju.

Kui Tripletex on ühendatud, ava integratsiooni dialoogis vahekaart Seaded, et seadistada, kuidas Uku loob igale ühendatud kliendile kuiseid kokkuvõtteülesandeid.

Säte	Mida teeb
Ülesande pealkiri	Nimi, mida kasutatakse iga kuu automaatselt loodava kokkuvõtteülesande jaoks.
Teema	Mille teema alla kokkuvõtteülesanne paigutub.
Korduvus	Alati igakuine.
Andmete import	Millal kuus andmeid imporditakse — viimane tööpäev, viimane kalendripäev või kindel päev järgmises kuus (1.–28.).

Jaotises Seadista andmeväljad seosta iga Tripletexi andmeväli Uku kohandatud ülesande väljaga. Tripletexi tüüpilised väljad on müügikanded, ostukanded, panga liikumised ja perioodi dokumentide arvud.

Iga jälgitava välja kohta:

1. Vali väli vasakus veerus.
2. Vali paremalt rippmenüüst sobiv Uku kohandatud ülesande väli.
3. Tühjaks jäetud välju ei impordita.
4. Klõpsa Näita rohkem, et avada lisaks vähem levinud välju.
5. Kasuta rippmenüüs Uus lisaväli, et luua kohandatud väli kohapeal, kui seda veel pole.
6. Lõpetuseks klõpsa Salvesta.

Tripletexi integratsiooni lubamine registreerib selle ainult ettevõtte tasemel. Andmed liiguvad alles siis, kui iga Uku klient on seotud ka oma vastava Tripletexi kliendiga. Täielik kliendipõhise ühendamise töövoog on kirjeldatud artiklis Ühenda klient raamatupidamistarkvaraga. Lühidalt:

1. Klikka klientide loendis kliendi rea veergu Integratsioon.
2. Vali integratsioonide rippmenüüst Tripletex.
3. Uku loeb sinu salvestatud tunnusega Tripletexi klientide loendi ja laseb sul valida sobiva kliendi.
4. Salvesta. Alates järgmisest planeeritud impordipäevast tõmbab Uku sellele kliendile andmeid.

Et täita ühenduse loomise järel kohe ka eelnevad kuud, kasuta integratsiooni vahekaardil Seaded valikut Impordi töömahud kohe.

Et reimportida Tripletexi andmed kõikidele ühendatud klientidele (täidab eelmised 12 kuud ja kirjutab olemasolevad kokkuvõtteülesannete väärtused üle):

1. Ava Seaded & Äpid → Tripletex → Seaded.
2. Klõpsa dialoogi all vasakul nupul Impordi töömahud kohe.
3. Kinnita. Uku töötleb uuesti laadimist taustal ja teavitab sind, kui see on valmis.

Et integratsioon ei katkeks aegumispäeval märkamatult:

1. Mõni päev enne aegumist loo Selskap → API-tilgang all uus töötaja ligipääsutunnus.
2. Ukus ava Seaded & Äpid → Tripletex → Ühenda, kleebi uus tunnus, klõpsa Testi ühendust ja seejärel Salvesta.
3. (Vabatahtlik) Tühista vana tunnus Tripletexis, kui oled veendunud, et uus töötab.

Tripletexi ühendustesti tõrked on peaaegu alati üks järgmistest:

• Tunnus on Tripletexis aegunud. Loo uus töötaja ligipääsutunnus ja kleebi uus väärtus.
• Valitud on vale keskkond (production vs. test) — testitunnused ei tööta production-keskkonna vastu ja vastupidi.
• Tunnusel on alguses või lõpus tühikud. Kopeeri see otse Tripletexi API-tilgang paneelilt uuesti.
• Tunnuse omanikuks olev töötaja konto on Tripletexis deaktiveeritud.

Kui Tripletexi ühendus läbib testi, kuid kokkuvõtteülesannetesse statistikat ei ilmu, siis ainult integratsiooni lubamisest ei piisa. Pead lisaks:

• Ühendama iga kliendi tema Tripletexi kliendiga — määra kliendi rea veerg Integratsioon Tripletexile.
• Seadistama kokkuvõtteülesande sätted integratsiooni vahekaardil Seaded (ülesande pealkiri, teema, impordi päev, andmeväljade kaardistus).
• Ootama järgmist planeeritud impordipäeva või käivitama Impordi töömahud kohe, et eelmise 12 kuu andmed sisse tuua.

Kindlal kuupäeval lakkav Tripletexi ühendus on peaaegu alati tunnuse aegumine. Tripletexi töötaja ligipääsutunnustel on loomisel määratud fikseeritud aegumiskuupäev. Loo värske tunnus ja kleebi see Ukusse — vt eespool jaotist Tripletexi tokeni vahetus.

Kui Uku kliendile on ühendatud vale Tripletexi klient, paranda see klientide loendis. Klõpsa selle kliendi veergu Integratsioon ja vali rippmenüüst õige Tripletexi klient. Seejärel käivita Impordi töömahud kohe, et värskendada ajaloolist statistikat.

Kui mõni Tripletexi väli jõuab Uku kokkuvõtteülesannetesse järjepidevalt tühjana, siis tõenäoliselt pole see seotud ühegi Uku kohandatud ülesande väljaga. Ava integratsiooni vahekaart Seaded, leia väli jaotisest Seadista andmeväljad, määra sellele kohandatud väli ja klõpsa Impordi töömahud kohe, et olemasolevad kuud uuesti täita.