Directo ühendamine Ukuga

Ettevõtte peakasutaja või Ettevõtte omanik rollis Team või Elite paketil. Vajad ka Directo administraatorit (oma büroos või kliendi juures), kes saab integratsiooni kasutajale genereerida isikliku juurdepääsutokeni — Directo tavakasutajad reeglina API tokeneid välja anda ei saa.

Directo on õige integratsioon büroodele, kes töötavad Eesti ja Läti klientidega.

Directo Ukuga ühendamiseks vajad esmalt Directos välja antud isiklikku juurdepääsutokenit. Tokenid on seotud konkreetse Directo ettevõtte andmebaasiga — kui sinu bürool on mitu Directo andmebaasi (näiteks üks iga kliendi kohta), vajad iga andmebaasi jaoks eraldi tokenit. Vaata allpool jaotist Mitme andmebaasi seadistus.

1. Logi Directosse sisse administraatorina selle ettevõtte andmebaasis, mille soovid ühendada.
2. Liigu jaotisse Seaded → Süsteemi seaded → API juurdepääs (täpne asukoht võib Directo versiooniti erineda).
3. Loo uus isiklik juurdepääsutoken seotuna kasutajakontoga, mis peaks andmeid Ukusse sünkroniseerima. Vali pigem teenuse- või integratsioonikasutaja kui reaalse töötaja konto, et token ei oleks seotud inimesega, kes võib lahkuda.
4. Määra sobiv aegumiskuupäev — piisavalt pikk, et seda ei peaks pidevalt uuendama, ja piisavalt lühike, et see vastaks sinu büroo turvapoliitikale.
5. Kopeeri tokeni väärtus. Reeglina kuvatakse tokenit ainult ühe korra loomise ajal.

Asukoht: Seaded & Äpid → Directo

Directo integratsioon tuleb enne kliendipõhist kasutamist lubada ettevõtte tasemel. Lubamine ei too veel andmeid sisse — see üksnes teeb integratsiooni kättesaadavaks.

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

Pärast Directo lubamist kleebi juurdepääsutoken integratsiooni dialoogi ja sisesta vastav ettevõtte andmebaas.

1. Vaheta integratsiooni dialoogis vahekaardile Ühenda (või Seaded).
2. Kleebi juurdepääsutoken vastavale väljale.
3. Sisesta ettevõtte andmebaasi identifikaator, kui dialoog seda küsib (Directo andmebaaside poole pöördutakse lühikese koodi kaudu).
4. Klõpsa Testi ühendust. Directo vastab andmebaasi nimega, kui token kehtib.
5. Klõpsa Salvesta.

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

Directo on standardse tööstatistika voo jaoks ühesuunaline sissetulev — see voog käivitab raamatupidamise kokkuvõtteülesandeid. Lisaks toetab Uku arvete eksporti Directosse.

Andmed	Suund	Märkused
Artiklid (tooted)	Directo → Uku	Saadaval Ukus arveldamise toodete konfigureerimisel.
Kliendid	Directo → Uku	Ainult lugemiseks — Uku saab Directo kliendiloendi lugeda, et sobitada Uku klientidega.
Tööstatistika	Directo → Uku	Käivitab kuiste kokkuvõtteülesannete väljad.
Arved	Uku → Directo	Uku arveid saab nende väljastamisel Directosse eksportida.

Kui Directo on ühendatud, ava integratsiooni dialoogi vahekaart Seaded, et seadistada, kuidas Uku iga ühendatud kliendi jaoks kuiseid kokkuvõtteülesandeid loob.

Säte	Mida see teeb
Ülesande pealkiri	Nimi, mida kasutatakse iga kuu automaatselt loodud kokkuvõtteülesande puhul.
Teema	Millise teema alla kokkuvõtteülesanne paigutatakse.
Korduvus	Alati igakuine.
Andmete import	Millal kuus andmed imporditakse — viimane tööpäev, viimane kalendripäev või konkreetne päev järgmises kuus (1.–28.).

Jaotises Seadista andmeväljad seo iga Directo andmeväli Ukus oleva kohandatud ülesande väljaga. Levinumad Directo poolt pakutavad väljad on müügikanded, ostukanded, pangatehingud ning dokumentide arv perioodis.

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

1. Vali väli vasakpoolses veerus.
2. Vali parempoolses ripploendis vastav Uku kohandatud ülesande väli.
3. Tühjaks jäetud väljad ei impordita.
4. Klõpsa Näita rohkem, et avada täiendavaid harvemini kasutatavaid välju.
5. Kasuta ripploendis valikut Uus lisaväli, et luua kohandatud väli kohapeal, kui sobivat veel pole.
6. Lõpuks klõpsa Salvesta.

Directo integratsiooni lubamine registreerib selle ainult ettevõtte tasemel. Andmed hakkavad liikuma alles siis, kui iga Uku klient on seotud ka oma vastava Directo kliendikirjega. Kogu kliendipõhise ühendamise töövoo leiad artiklist Ühenda klient raamatupidamistarkvaraga. Lühike versioon:

1. Klõpsa klientide loendis kliendi real veergu Integratsioon.
2. Vali integratsiooni ripploendist Directo.
3. Uku loeb Directo kliendiloendi salvestatud tokeniga ja laseb sul valida sobiva kliendi.
4. Salvesta. Alates järgmisest planeeritud impordipäevast tõmbab Uku selle kliendi statistikat.

Selleks, et täita ajaloolised kuud kohe pärast ühendamist, kasuta integratsiooni vahekaardil Seaded valikut Impordi töömahud kohe.

Directo juurdepääsutokenid on seotud ühe ettevõtte andmebaasiga. Kui sinu büroo haldab mitut Directo andmebaasi (üks kliendi kohta või üks juriidilise isiku kohta), on soovitatav muster järgmine:

• Genereeri igas Directo andmebaasis eraldi token.
• Ühenda need kliendi tasemel, mitte Uku ettevõtte tasemel. Integratsiooni dialoog toetab kliendipõhiseid mandaate, nii et iga Uku klient saab osutada oma Directo andmebaasile oma tokeniga.

Kui vajad abi mitme andmebaasi ühenduste seadistamisel suuremas mahus, võta ühendust Uku klienditoega.

Kõigi ühendatud klientide Directo andmete uuesti importimiseks (täidab ajalooliselt viimased 12 kuud ja kirjutab olemasolevad kokkuvõtteülesannete väljaväärtused üle):

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

Andmete uuesti importimine on õige tegevus alati, kui muudad andmeväljade seoseid, muudad mõnda Directo seadet, mis mõjutab ajaloolisi andmeid, või taastud olukorrast, kus ühendus oli mõnda aega katkenud.

Directo ühenduse testi tõrked on peaaegu alati üks järgmistest:

• Tokenil on alguses või lõpus tühikuid. Kopeeri see uuesti otse Directo API juurdepääsu paneelilt.
• Token on aegunud. Directo tokenitel on aegumiskuupäev — genereeri Directos uus ja kleebi uus väärtus.
• Token on seotud teise ettevõtte andmebaasiga, kui see, mida soovid ühendada.
• Directo administraator on tokeni tühistanud.

Kui Directo ühendus läbib testi, kuid kokkuvõtteülesannetesse statistikat ei ilmu, ei piisa ainult integratsiooni lubamisest. Lisaks tuleb:

• Ühendada iga klient oma Directo kirjega — määra kliendi real veerus Integratsioon väärtuseks Directo.
• Seadistada kokkuvõtteülesande seaded integratsiooni vahekaardil Seaded (ülesande pealkiri, teema, impordipäev, andmeväljade seosed).
• Oodata järgmist planeeritud impordipäeva või käivitada Impordi töömahud kohe, et täita viimased 12 kuud.

Kui Uku kliendile on ühendatud vale Directo klient, paranda see klientide loendis. Klõpsa selle kliendi real veergu Integratsioon ja vali ripploendist õige Directo klient. Seejärel käivita Impordi töömahud kohe, et värskendada ajalooline statistika.

Kui Directo ühendus, mis töötas, on sünkroniseerimise lõpetanud, on tegu peaaegu alati tokeni probleemiga. Directo tokenitel on aegumiskuupäev ja administraator võib need ka mandaate vahetades tühistada. Genereeri Directos uus token, kleebi uus väärtus Ukusse ja klõpsa Testi ühendust, et kinnitada. Kui ühendus on kliendipõhine, tee seda mõjutatud kliendi mandaatide jaoks.

Kui Directo väli jõuab Uku kokkuvõtteülesannetesse järjepidevalt tühjana, ei ole see suure tõenäosusega seotud 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 täita olemasolevad kuud.