API-võtmega raamatupidamise integratsioonid

Ettevõtte peakasutaja või Ettevõtte omanik. Saadaval alates Team paketist. Sul on vaja ka õigust raamatupidamistarkvaras API-mandaate genereerida või vaadata — tavaliselt on seal vaja samuti administraatori õigusi.

Tee: Seaded & Äpid → integratsioonide kaart → Aktiveeri

Kõigi API-võtmega integratsioonide voog on ühesugune:

1. Logi raamatupidamistarkvarasse sisse ja leia selle API-mandaatide jaotis.
2. Genereeri või kopeeri mandaadid (võti, saladus, token, ettevõtte ID — varieerub teenusepakkuja kaupa).
3. Ukus mine Seaded & Äpid juurde, leia integratsioonikaar ja klõpsa Aktiveeri, kui see pole veel sisse lülitatud.
4. Ava integratsioonidialoog ja mine vahekaardile Ühenda või Seaded.
5. Kleebi iga mandaat oma sildistatud väljale.
6. Klõpsa Testi ühendust, et enne salvestamist kontrollida.
7. Klõpsa Salvesta.

Kui test nurjub, vaata allpool jaotist Tõrkeotsing. Pärast edukat salvestamist ilmub integratsioon kliendiloendis veergu Integratsioon ja seda saab klientide kaupa lubada.

Kokkuvõtteülesannete seadistamise ja andmeväljade vastendamise kohta (kehtib kõigile integratsioonidele ühtmoodi) vaata artiklit Raamatupidamistarkvara integratsioonide seadistamine.

Täielik seadistusartikkel: Tripletex ühendamine Ukuga.

Piirkond: Norra. Tripletex kasutab ühe API-võtme asemel kahte tokenit.

1. Logi Tripletexis sisse ja mine jaotisse Selskap → API-tilgang (Ettevõte → API-juurdepääs).
2. Genereeri töötaja token, mis on seotud kasutajakontoga, mis peaks andmeid sünkroonima.
3. Tarbija tokenit hoiab Uku integreeriva partnerina — seda pole vaja ise sisestada.
4. Ukus kleebi töötaja token ja vali tootmine (või test, kui ühendad liivakasti).
5. Klõpsa Testi ühendust, seejärel Salvesta.

Mida sünkroonitakse: kliendid, tooted, käibemaksutüübid, arvete väljastamine. Lugemine on ühesuunaline; arvete eksport saadab arved Tripletexisse.

Täielik seadistusartikkel: Scoro ühendamine Ukuga.

Piirkond: Eesti, Ühendkuningriik, globaalne.

1. Logi Scoros sisse ja mine jaotisse Settings → API.
2. Kopeeri oma ettevõtte konto ID, API-võti ja alamdomeen (sinu Scoro URL-i osa enne .scoro.com).
3. Ukus kleebi kõik kolm väärtust integratsioonidialoogi.
4. Vali arvete eksportimiseks kasutatav keel (eesti keel, inglise keel).
5. Klõpsa Testi ühendust, seejärel Salvesta.

Mida sünkroonitakse: maksumäärad, arvete eksport Scorosse. Ühesuunaline väljapoole — Uku saadab arved Scorosse; kliente ei impordita.

Täielik seadistusartikkel: Merit Aktiva ühendamine Ukuga.

Piirkond: Eesti, Soome, Poola (Poolas müüakse nime all 360 Księgowość). Uku integratsioon kasutab Merit Aktiva v1 — v2 API pole veel ühendatud.

1. Logi Merit Aktivas sisse ja mine jaotisse Company settings → Integrations.
2. Genereeri API ID ja API võti.
3. Ukus kleebi API ID, API võti ja vali õige riik (Eesti, Soome või Poola — need on eraldi Merit Aktiva instantsid ja mandaadid ei tööta risttäitmise teel).
4. Klõpsa Testi ühendust, seejärel Salvesta.

Mida sünkroonitakse: maksumäärad, tooted, kokkuvõttestatistika (kirjed, käibemaksukirjed, dokumendid) igakuiste kokkuvõtteülesannete jaoks, arvete eksport, tasutud arvete olekuuuendused tagasi Ukusse.

Täielik seadistusartikkel: SmartAccounts ühendamine Ukuga.

Piirkond: Eesti.

1. Logi SmartAccountsis sisse ja mine API-juurdepääsu jaoks jaotisse Settings.
2. Genereeri API võti ja API saladus.
3. Ukus kleebi mõlemad väärtused integratsioonidialoogi.
4. Klõpsa Testi ühendust, seejärel Salvesta.

Mida sünkroonitakse: käibemaksutüübid, kokkuvõttestatistika (müügikirjed, ostukirjed, panga kirjed, dokumendid) igakuiste kokkuvõtteülesannete jaoks, arvete eksport.

Piirkond: Eesti, Läti.

1. Logi Directosse sisse ja palu oma Directo administraatoril genereerida integratsioonikasutajaga seotud isiklik juurdepääsutoken.
2. Ukus kleebi juurdepääsutoken integratsioonidialoogi.
3. Klõpsa Testi ühendust, seejärel Salvesta.

Mida sünkroonitakse: artiklid (tooted), klientide lugemine, kokkuvõttestatistika, arvete eksport Directosse.

Piirkond: Eesti (Trigon Pank — kasutavad raamatupidamisbürood, kes haldavad Eesti klientide maksefaile).

1. Logi Trigonis sisse ja mine API-juurdepääsu jaotisse.
2. Genereeri või hangi ID-token (mõnikord nimetatakse identiteedi tokeniks) ja API-võti.
3. Ukus kleebi mõlemad väärtused ja vali õige keskkond (tootmine, välja arvatud testimisel).
4. Klõpsa Testi ühendust, seejärel Salvesta.

Mida sünkroonitakse: kliendid, kontaktid, aadressid, tehingumahud (kasutatakse igakuiste kokkuvõtteülesande statistika täitmiseks).

Levinumad põhjused:

• Mandaat kopeeriti ees- või lõputühikutega. Kopeeri uuesti otse lähteväljalt.
• Vale piirkond või riik on valitud (eriti Merit Aktiva puhul).
• Token on raamatupidamistarkvaras tühistatud või aegunud. Genereeri uuesti ja kleebi uuesti.
• Scoro puhul: alamdomeeniväljale on kleebitud täielik URL, mitte ainult eesliide.

Integratsiooni aktiveerimine võimaldab selle kasutamist. Andmed hakkavad liikuma alles siis, kui sa:

• Lubad integratsiooni konkreetsel kliendil (kliendivaates seadista veerg Integratsioon sellele teenusepakkujale).
• Seadistad kokkuvõtteülesande sätted integratsiooni Seaded vahekaardil — vaata artiklit Raamatupidamistarkvara integratsioonide seadistamine.
• Ootad järgmist planeeritud impordi päeva või käivitad Impordi töömahud kohe, et täita viimased 12 kuud tagasiulatuvalt.

Enamikul tokenipõhistel teenusepakkujatel (Tripletex, Trigon) on tokenitel aegumiskuupäev. Genereeri token raamatupidamistarkvaras uuesti, kleebi uus väärtus Ukusse ja testi ühendust uuesti. SmartAccountsi ja Merit Aktiva võtmed ei aegu automaatselt, kuid administraator saab need tühistada, kui vahetab mandaate.

Uku hakkab järgmisel sünkroonimiskatsel nurjuma ja kuvab integratsioonil veaindikaatori. Klientide andmeid ei kaota; kui kleebid värske mandaadi ja test õnnestub, jätkuvad planeeritud sünkroonimised.