• Table of contents
• SimplBooks
• 01 Docura integratsiooni aktiveerimine SimplBooksis
• 02 Vajalike andmete hankimine
  • 01 Andmete aktiveerimine docura.net-i kaudu
  • 02 Andmete sisestamine SimplBooksi
• 03 Dokumentide automaatne töötlemine
  • 02 Tavaline dokumendivoog (2DOC ja 4DOC)
  • 03 Toodete seadistamine
• 04 Lisainfo
• 05 Docura EDI kasutusjuhend
• 06 KKK
  • 01 Probleemid toodete ja EAN-koodidega
  • 02 Tellimust ei õnnestunud SimplBooksi automaatselt importida.
  • 03 Kliendikoodide registreerimine Docura portaalis
  • 04 Tellimuse importimise probleemid
  • 05 Arvet ei edastata Docurasse

SimplBooks¶

01 Docura integratsiooni aktiveerimine SimplBooksis¶

Docura integratsiooni aktiveerimiseks SimplBooksis järgi neid samme:

1. Ava peamenüüst "Seaded → Integratsioonid".
2. Vali avanevast nimekirjast Docura integratsioon.
   
   

02 Vajalike andmete hankimine¶

01 Andmete aktiveerimine docura.net-i kaudu¶

Integratsiooni aktiveerimiseks on vaja sisselogimist ja API-võtit, mille saab Docura portaalist:

1. Logige sisse docura.net portaali ja minge menüüsse Seaded → Kasutajad.
2. Kui kasutaja on juba olemas:
   1. API-võtme kopeerimiseks vajutage veergu API võti nuppu Kopeeri.
   2. Sisselogimise väärtuse saab võtta veerust Sisselogimine.
      
3. Kui kasutajat pole veel loodud:
   1. Vajutage Lisa kasutajad.
   2. Uue API kasutaja loomiseks valige Lisa API kasutaja.
      

02 Andmete sisestamine SimplBooksi¶

Pärast andmete saamist Docrast:

1. Sisesta SimplBooksi Client ID väljale väärtus Login.
2. Sisesta API key Client secret väljale.
3. Salvesta seaded — ja integratsioon ongi sinu tarkvaras aktiveeritud.

03 Dokumentide automaatne töötlemine¶

Pärast edukat aktiveerimist algab Docurast dokumentide automaatne öine import. Kontrollige Tehingud - Müügitellimused

1. Uued dokumendid ilmuvad kas imporditud dokumentide loendisse,
2. või salvestab süsteem need automaatselt, kui Docura liidese seadetes on lubatud valik "Automaatne salvestamine":
   1. müügitellimusena,
   2. või saatelehe kinnitusena.
3. Kui automaatne salvestamine mingil põhjusel ebaõnnestub, jääb dokument imporditud dokumentide loendis nähtavaks olekuga "vigane".
   
   

02 Tavaline dokumendivoog (2DOC ja 4DOC)¶

1. Tüüpiline dokumendivoog on järgmine:
   1. 2DOC: Müügitellimus → Müügiarve
   2. 4DOC: Müügitellimus → Saateleht → Kinnitusleht → Müügiarve
2. Dokumentide liikumine:
   1. Müügitellimus imporditakse Docurast.
   2. Saateleht saadetakse Docurasse.
   3. Kinnitusleht imporditakse Docurast.
   4. Lõplik müügiarve saadetakse Docurasse.
      

03 Toodete seadistamine¶

EDI-müügi integratsiooni edukaks kasutamiseks peab SimplBooksis olema:

1. Sisestatud või imporditud toodete nimekiri.
2. Iga toote puhul peab olema määratud:
3. tootja/tarnija sisene kood (teie enda kood, SellerItemCode),
4. ja/või EAN-kood (GTIN).
5. Kui sisemist koodi ei ole, tuleb EAN-kood sisestada üldisesse tootekoodi väljale, mis on SimplBooksis kohustuslik väli.
6. Impordi käigus tuvastab süsteem toote esmalt tarnija koodi ja seejärel EAN-koodi (GTIN) järgi.

04 Lisainfo¶

Docura integratsioon on saadaval juba START paketis ning integratsiooni aktiveerimise ega kasutamise eest eraldi tasu ei küsita.

05 Docura EDI kasutusjuhend¶

Kuidas see töötab

1. Kui integreerimise seadetes on automaatne salvestamine lubatud:
   1. Kehtivad tellimused lähevad otse jaotisse "Müük".
   2. Neid ei kuvata vaates "Imporditud dokumendid".
2. Vigased dokumendid jäävad jaotise "Imporditud dokumendid" alla.

Kuidas Docurast dokumente käsitsi importida:

1. Vajuta lehe ikoonile (isiku ikooni kõrval).
2. Ava jaotis "Imporditud dokumendid".
3. Vali jaotis "Käsitsi import" → "Impordi Docurast".

Parendusettepanek

1. Lisa "Impordi Docurast" nupp nupu "Impordi Telemast" kõrvale – nii toimub kõik ühes vaates, nagu varem.

Mida teha vigase dokumendiga?

1. Leia see jaotisest "Imporditud dokumendid".
2. Kontrolli seda ja salvesta käsitsi.
   

06 KKK¶

01 Probleemid toodete ja EAN-koodidega¶

1. Vead on põhjustatud ebakorrektsest SimplBooksi seadistusest (tooted, EAN-koodid, parameetrid).
2. Sellisel juhul probleem kordub regulaarselt erinevate partneritega.
3. Kõige tihedamini tekib probleem SimplBooksi poolel valest seadistusest.

Kokkuvõte

1. Kõik dokumendid, ka vigased, imporditakse SimplBooksi.
2. Klient peab kauba andmed SimplBooksis ise korrektselt seadistama.
3. API arendus ei ole mõistlik, sest kaup tuleb seadistada SimplBooksis.

02 Tellimust ei õnnestunud SimplBooksi automaatselt importida.¶

1. Tellimust ei õnnestunud SimplBooksi süsteemi automaatselt importida.
2. Põhjus: kliendi andmed olid puudulikud või pärast saatmist muutunud, mistõttu süsteem ei saanud tellimust töödelda.
3. Import tehti käsitsi. Pärast kliendi andmete uuendamist salvestati tellimus korrektselt.

Lahendus:

1. Kliki SimplBooksi logol (lehe ikoon) ja seejärel "Jätka siit" nupul imporditavate dokumentide kõrval.
   
2. Kui tellimust ei õnnestu automaatselt importida, kliki sellel dokumentide loendis.
   
3. Avatud tellimusel, kliendi andmete uuendamiseks:
   1. Kliki pliiatsi ikoonil kliendi nime kõrval.
   2. Kliki lingil "Vajuta siia uute andmete laadimiseks".
   3. Kliki "OK" nupul, et uuendust kinnitada.
      
4. Pärast kliendi andmete uuendamist salvesta tellimus — import on edukalt lõpetatud.
   

03 Kliendikoodide registreerimine Docura portaalis¶

SimplBooksis on kliendid ja tarnijad esindatud sama tüüpi objektidena.

Igal kliendil (nt Prisma) võib olla mitu tarnepunkti, mis on selle kliendiga seotud alamobjektid.

Tarnepunktid on tuvastatavad unikaalse süsteemi loodud ID-ga, mida kasutaja ei saa muuta.

Kliendid saavad eksportida kõik tarnepunktid või ainult valitud tarnepunktid CSV- või Excel-formaadis, mis sisaldab ka tarnepunktide ID-sid.

Alternatiivina saab tarnepunktide ID-sid käsitsi kontrollida, vaadates brauseri URL-i, kui avada SimplBooksis konkreetne tarneaadress.

Need ID-d on integratsiooni jaoks olulised ja need tuleks edastada Docurale, kus neid kasutatakse Docura süsteemis PartyCode'ina.

Järgmise sammuna vajavad SimplBooksi kliendid juhendit või ekraanipilte, kuidas eksportida tarnepunkte koos ID-dega.

Pärast eksportimist saab need ID-d Docurasse üles laadida, mis võimaldab sujuvat andmete integreerimist.

04 Tellimuse importimise probleemid¶

1. Kliendid soovisid tellimuste importimist.
2. Impordil tekkisid probleemid: põhjuseks oli puuduv API kasutaja või SimplBooksi sisestamata andmed.
3. Pärast API kasutaja loomist ja andmete SimplBooksi lisamist peaks tellimuse import nüüd korrektselt töötama.

05 Arvet ei edastata Docurasse¶

Arve loomisel tuleb määrata tarnekoht, sest kui tarnekoht ei ole täidetud, siis arvet Docurasse ei edastata ja see ei kuvata Docura portaalis.