API-võtmega raamatupidamise integratsioonid

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

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 tarnija kaupa).
3. Ukus mine Seaded & Äpid juurde, leia integratsioonikaarti 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.

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 Tripletexis.

Tähelepanu: töötaja tokenitel on aegumiskuupäev. Kui sünkroonimine peatub, genereeri Tripletexis token uuesti ja kleebi uus väärtus.

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. Väljastav — Uku saadab arved Scorosse; kliente ei impordita.

Tähelepanu: alamdomeen on lihtsalt eesliide (nt acme), mitte täielik URL. Täieliku URL-i kleepimine nurjab ühenduse testi.

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 Ukuks.

Tähelepanu: kui riik on vale, nurjub test autentimistõrkega, isegi kui mandaadid ise on õiged. Iga Merit Aktiva riik töötab eraldi teenusena.

Piirkond: Eesti.

1. Logi Smart Accountsis 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.

Tähelepanu: saladus kuvatakse ainult genereerimise hetkel. Kui see kaob, pead Smart Accountsis paari uuesti genereerima ja mõlemad väärtused Ukuks uuesti kleepima.

Piirkond: Eesti, Läti.

1. Logi Directosse sisse ja palu oma peakasutajal 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.

Tähelepanu: Directo tokenid on seotud konkreetse ettevõtte andmebaasiga. Kui ettevõttel on mitu Directo andmebaasi, genereeri iga jaoks eraldi token ja ühenda need kliendi tasandil, mitte ettevõtte tasandil.

Piirkond: Eesti (Trigon Pank — kasutavad raamatupidamisfirmad, 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).

Tähelepanu: Trigon vahemälustab tehingumahud perioodi kaupa. Kui kliendil näib olevat kirjeid puudu, käivita integratsioonide vahekaardil Seaded valik Laadi andmed uuesti, et vahemälu värskendada.

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.

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

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

Enamikul tokenipõhistel tarnijatel (Tripletex, Trigon) on tokenitel aegumiskuupäev. Genereeri token raamatupidamistarkvaras uuesti, kleebi uus väärtus Ukuks ja testi ühendust uuesti. Smart Accountsi ja Merit Aktiva võtmed ei aegu automaatselt, kuid peakasutaja 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.