Visma Horizon¶

• Table of contents
• Visma Horizon
• 01 Täielik algne juhend
• 02 Mida see hõlmab
• 03 Seadistamine Docura poolel
• 04 Seadistamine Horizonis
  • 01 Kontroll-leht enne esimest importi
• 05 Dokumentide vastuvõtmine (import Docurast)
  • 01 Käsitsi import
  • 02 Automaatne import (ajastatud töö)
  • 03 Pärast importi
  • 04 Märkused
• 06 Dokumentide saatmine (eksport Docurasse)
  • 01 Ekspordi sammud
  • 02 Pärast eksportimist nähtavad väljad
  • 03 Märkused
• 07 Automaatsed olekute uuendamised
  • 01 Konfiguratsioon
  • 02 Soovitatav intervall
  • 03 Kuidas olekuvärskendus töötab

01 Täielik algne juhend¶

Täielikud algsed juhised (läti keeles koos kuvatõmmistega) on avaldanud Visma aadressil:

community.visma.com — Docura integrācija preču kustības dokumentu apmaiņai

Unlock02 Mida see hõlmab¶

Visma Horizon pakub otsest integratsiooni Docuraga kaubandusdokumentide vahetamiseks tarnijate ja nende Horizonit kasutavate klientide vahel. Ühendus kasutab otset REST API linki Docuraga – kohalikke kaustu ega vahendusteenuseid ei ole vaja.

Integratsioon haldab kolme voogu:

1. Sissetulevate dokumentide importimine Docurast Horizoni (ORDER)
2. Väljaminevate dokumentide eksportimine Horizonist Docurasse (INVOICE)
3. Eksporditud dokumentide automaatsed olekute uuendused

Unlock03 Seadistamine Docura poolel¶

Enne Horizoniga ühendamist veendu:

1. Ettevõte on Docuras registreeritud. Samm-sammuline juhend on vikilehel EDI-Web registreerimine – registreeri end aadressil app.docura.net, kinnita oma e-posti aadress, leia või loo oma organisatsioon ning võta oma profiilist ClientID ja Client secret (API võti)
2. API aadress ja API võti on kätte saadud – Docura tugi saadab need soovi korral (vestluse või e-posti teel)
3. Kõik kaubanduspartnerid, kes ei ole veel Docuraga ühendatud, on vahetusvõrku lisatud

04 Seadistamine Horizonis¶

1. Mine Süsteem → Andmevahetus → EDI API ühendused
2. Loo uus EDI API Docura ühendus
3. Sisesta API aadress ja API võti (mõlemad on kohustuslikud; Kasutajanimi on valikuline)
4. Klõpsa Testi — Horizon kontrollib ühendust ja annab vea, kui andmed on valed

01 Kontroll-leht enne esimest importi¶

1. Kliendikirjetel on täidetud registrinumber või ILN (GLN)
2. Tootekirjetel on registreeritud EAN-vöötkoodid
3. Laokirjetel on tarneaadress koos ILN-iga
4. EDI API Docura ühendus on lisatud ja testitud

05 Dokumentide vastuvõtmine (import Docurast)¶

Asukoht: Süsteem → Andmevahetus → Dokumendi import

Horizon küsib Docurast uusi dokumente perioodiliselt iseseisvalt – käsitsi failide käsitlemist pole vaja.

01 Käsitsi import¶

Süsteem → Andmevahetus → Dokumendi import → Uus dokument

Impordikirje loomisel täpsusta:

1. Ühendus — Docura EDI API ühendus
2. Dokumendi baastüüp ja Dokumenditüüp — määrab, millise sihtdokumendi Horizon loob

Olukord	Tulemus
Uus impordikirje on loodud	Imporditakse ainult Docura dokumendid, mida ei ole veel märgitud vastuvõetuks
Sihtdokument on juba valmis	Selle uuesti loomine ei ole võimalik

02 Automaatne import (ajastatud töö)¶

Asukoht: Süsteem → Seaded → Automatiseeritud tööd → EDI dokumendi import vahekihist

Väli	Nõutud	Väärtused
Ühendus	Jah	Eelnevalt loodud EDI API Docura ühendus
Dokumendi tüüp	Jah	ORDER
Sihtdokument	Jah	Loodava dokumendi spetsiifiline tüüp

03 Pärast importi¶

1. Horizon loob sihtdokumendi automaatselt
2. Algne XML-fail salvestatakse nii importimise kirje kui ka sihtdokumendi juurde
3. Docura märgib dokumendi vastuvõetuks (READ=Y) – see ei ilmu hilisema importimise käigus uuesti

04 Märkused¶

1. Kui sihtdokument on juba valmis, ei saa seda importkirjest uuesti luua
2. Uuesti importimiseks avage dokument Docura portaalis (EDI portaali lingi kaudu) ja valige Võta uuesti vastu
3. Enne uuesti loomist veenduge, et algne veapõhjus (kliendi, lao või toote andmed) on Horizonis parandatud

Unlock06 Dokumentide saatmine (eksport Docurasse)¶

Väljuvaid dokumente (INVOICE) saab saata Docurasse otse Horizoni loenditest ühe toiminguga – käsitsi XML-i ettevalmistamine pole vajalik.

Asukoht:

1. Dokumendid → Logistika → Tellimused → Tegevused → Loendi eksport → EDI API ühendus
2. Dokumendid → Ladu → Arve loend → Tegevused → Loendi eksport → EDI API ühendus

See toiming ilmub menüüsse alles siis, kui vähemalt üks EDI API ühendus on konfigureeritud.

01 Ekspordi sammud¶

Samm	Kirjeldus
1. Dokumendi valik	Kui loendis pole midagi valitud, eksporditakse kursori all olev dokument. Kui on valitud mitu rida, saadetakse kõik veel eksportimata dokumendid.
2. Ühenduse valik	Ühe ühenduse puhul kasutatakse seda automaatselt. Mitme ühenduse puhul avaneb dialoog; Horizon jätab viimase valiku meelde.
3. Autentimise kontroll	API ühendus valideeritakse enne saatmist. Kui see on kehtetu, siis dokumente ei saadeta.
4. XML-i ettevalmistamine	Horizon valmistab igale dokumendile ette XML-faili koos päiseinfoga, realiste ja manustega.
5. Saatmine	XML saadetakse Docura API-le. Tagastatakse kinnituse ID või veateade; edenemist näidatakse reaalajas.
6. Dokumendi uuendamine	Horizon salvestab ühenduse, operaatori ID, eksportimise aja ja oleku Saadetud. See logitakse EDI API eksportimise sündmusena.

02 Pärast eksportimist nähtavad väljad¶

Väli	Kirjeldus
EDI API ühendus	Millist ühendust ekspordiks kasutati
EDI ekspordi staatus	Ekspordi ajal Saadetud, hiljem uuendatakse olekuks Töödeldud või Viga
EDI veakood	Docura määratud teate identifikaator
EDI veateade	Vea- või hoiatus tekst Docurast
EDI portaali link	Otselink dokumendile Docura portaalis

03 Märkused¶

1. Juba eksporditud dokumendid jäetakse ridade valimisel automaatselt vahele – see hoiab ära duplikaadid
2. Ärge saatke sama dokumenti lühikese aja jooksul kaks korda – Docura töötleb dokumente asünkroonselt ega pruugi duplikaati tuvastada
3. EDI ekspordi oleku väljad täidetakse automaatselt ja neid ei ole ette nähtud käsitsi redigeerimiseks

07 Automaatsed olekute uuendamised¶

Pärast eksporti küsib Horizon automaatselt Docurast dokumentide olekuid ja uuendab neid – portaalis pole vaja käsitsi kontrollida.

Asukoht: Süsteem → Seaded → Automatiseeritud tööd → EDI API eksporditud dokumendi oleku päring

Unlock01 Konfiguratsioon¶

Väli	Nõutav	Väärtused
Ühendus	Jah	Varem loodud EDI API ühendus
Dokumendi tüüp	Ei	Kõik tüübid, INVOICE või ORDER

02 Soovitatav intervall¶

Horizon küsib Docurast iga kord töö käivitamisel viimase 24 tunni muutusi.

1. Miinimum: iga 10 minuti tagant (sagedasemad kontrollid lisavad asjatut koormust)
2. Optimaalne: kord tunnis
3. Maksimaalne: vähemalt kord 24 tunni jooksul

Hoiatus: kui töö ei käivitu üle 24 tunni, ei korja Horizon selle perioodi jooksul tehtud Docura muudatusi üles.

03 Kuidas olekuvärskendus töötab¶

Docura tulemus	Horisondi olek	Selgitus
Vigu pole	Töödeldud	Dokument edastati edukalt saajale. Kui on hoiatus, salvestatakse see EDI veateate väljale.
Veamärgis olemas	Viga	Dokument ei jõudnud saajani.

Töö värskendab dokumenti ainult siis, kui midagi on tegelikult muutunud – tarbetuid sündmusi ei logita. Iga tegelik muutus registreeritakse kui EDI API oleku muutmise sündmus koos täpse uuendatud väljade loeteluga.