Visma Horizon¶

• Table of contents
• Visma Horizon
• 01 Pilna oriģinālā pamācība
• 02 Ko tas aptver
• 03 Iestatīšana Docura pusē
• 04 Uzstādīšana programmā Horizon
  • 01 Saraksts pirms pirmās importēšanas
• 05 Dokumentu saņemšana (imports no Docura)
  • 01 Manuāla importēšana
  • 02 Automātiskā importēšana (ieplānotais uzdevums)
  • 03 Pēc importa
  • 04 Piezīmes
• 06 Dokumentu sūtīšana (eksports uz Docura)
  • 01 Eksportēšanas soļi
  • 02 Pēc eksporta redzamie lauki
  • 03 Piezīmes
• 07 Automātiski statusa atjauninājumi
  • 01 Konfigurācija
  • 02 Ieteicamais intervāls
  • 03 Kā darbojas statusa atjaunināšana

01 Pilna oriģinālā pamācība¶

Pilnas oriģinālās instrukcijas (latviešu valodā, ar ekrānuzņēmumiem) ir publicējusi Visma šeit:

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

Unlock02 Ko tas aptver¶

Visma Horizon piedāvā tiešu integrāciju ar Docura tirdzniecības dokumentu apmaiņai starp piegādātājiem un viņu klientiem, kas izmanto Horizon. Savienojums izmanto tiešu REST API saiti uz Docura — nav nepieciešamas lokālas failu mapes vai starpposma pakalpojumi.

Integrācija apstrādā trīs plūsmas:

1. Ienākošo dokumentu imports no Docura uz Horizon (ORDER)
2. Izejošo dokumentu eksports no Horizon uz Docura (INVOICE)
3. Eksportēto dokumentu automātiskie statusa atjauninājumi

Unlock03 Iestatīšana Docura pusē¶

Pirms Horizon savienošanas pārliecinieties:

1. Uzņēmums ir reģistrēts Docura. Soli pa solim pamācība ir wiki lapā EDI-Web reģistrācija — reģistrējieties vietnē app.docura.net, apstipriniet savu e-pasta adresi, atrodiet vai izveidojiet savu organizāciju un paņemiet savu ClientID un Client secret (API atslēgu) no sava profila
2. Ir saņemta API adrese un API atslēga — Docura atbalsts tos nosūta pēc pieprasījuma (tērzēšanā vai e-pastā)
3. Visi tirdzniecības partneri, kas vēl nav pieslēgti Docura, ir pievienoti apmaiņas tīklam

04 Uzstādīšana programmā Horizon¶

1. Dodieties uz Sistēma → Datu apmaiņa → EDI API savienojumi
2. Izveidojiet jaunu EDI API Docura savienojumu
3. Ievadiet API adresi un API atslēgu (abas obligātas; Lietotājvārds nav obligāts)
4. Noklikšķiniet uz Testēt — Horizon pārbaudīs savienojumu un ziņos par kļūdu, ja informācija ir nepareiza

01 Saraksts pirms pirmās importēšanas¶

1. Klientu ierakstos ir aizpildīts reģistrācijas numurs vai ILN (GLN)
2. Produktu ierakstos ir reģistrēti EAN svītrkodi
3. Noliktavu ierakstos ir piegādes adrese ar ILN
4. EDI API Docura savienojums ir pievienots un pārbaudīts

05 Dokumentu saņemšana (imports no Docura)¶

Atrašanās vieta: Sistēma → Datu apmaiņa → Dokumentu imports

Horizon periodiski patstāvīgi pieprasa jaunus dokumentus no Docura — nav nepieciešama manuāla failu apstrāde.

01 Manuāla importēšana¶

Sistēma → Datu apmaiņa → Dokumentu imports → Jauns dokuments

Veidojot importa ierakstu, norādiet:

1. Savienojums — Docura EDI API savienojums
2. Dokumenta pamatveids un Dokumenta veids — nosaka, kuru mērķa dokumentu Horizon izveido

Situācija	Rezultāts
Izveidots jauns importa ieraksts	Tiek importēti tikai Docura dokumenti, kas vēl nav atzīmēti kā saņemti
Mērķa dokuments jau ir pabeigts	To nav iespējams izveidot atkārtoti

02 Automātiskā importēšana (ieplānotais uzdevums)¶

Atrašanās vieta: Sistēma → Iestatījumi → Automatizētie uzdevumi → EDI dokumentu imports no vidējā slāņa

Lauks	Obligāts	Vērtības
Savienojums	Jā	Iepriekš izveidots EDI API Docura savienojums
Dokumenta tips	Jā	PASŪTĪJUMS
Mērķa dokuments	Jā	Konkrētais dokumenta tips, kas jāizveido

03 Pēc importa¶

1. Horizon automātiski izveido mērķa dokumentu
2. Oriģinālais XML fails tiek saglabāts gan importa ierakstā, gan mērķa dokumentā
3. Docura atzīmē dokumentu kā saņemtu (READ=Y) — tas vairs neparādīsies vēlākā importā

04 Piezīmes¶

1. Ja mērķa dokuments jau ir pabeigts, to nevar atkārtoti izveidot no importa ieraksta
2. Lai atkārtoti importētu, atveriet dokumentu Docura portālā (izmantojot EDI portāla saiti) un izvēlieties Saņemt vēlreiz
3. Pirms atkārtotas izveides pārliecinieties, ka Horizon ir novērsts sākotnējais kļūdas cēlonis (klienta, noliktavas vai preces dati)

Unlock06 Dokumentu sūtīšana (eksports uz Docura)¶

Izejošos dokumentus (INVOICE) var nosūtīt uz Docura tieši no Horizon sarakstiem vienā darbībā — nav nepieciešama manuāla XML sagatavošana.

Atrašanās vieta:

1. Dokumenti → Loģistika → Pasūtījumi → Darbības → Sarakstu eksports → EDI API pieslēgums
2. Dokumenti → Noliktava → Rēķinu saraksts → Darbības → Sarakstu eksports → EDI API pieslēgums

Šī darbība parādās izvēlnē tikai tad, ja ir konfigurēts vismaz viens EDI API pieslēgums.

01 Eksportēšanas soļi¶

Solis	Apraksts
1. Dokumentu atlase	Ja sarakstā nekas nav atlasīts, tiek eksportēts dokuments, kas atrodas zem kursora. Ja ir atlasītas vairākas rindas, tiek nosūtīti visi vēl neeksportētie dokumenti.
2. Savienojuma izvēle	Ar vienu savienojumu tas tiek izmantots automātiski. Ar vairākiem tiek atvērts dialoglodziņš; Horizon atceras pēdējo izvēli.
3. Autentifikācijas pārbaude	API savienojums tiek validēts pirms nosūtīšanas. Ja tas ir nederīgs, dokumenti netiek nosūtīti.
4. XML sagatavošana	Horizon katram dokumentam sagatavo XML failu ar galvenes informāciju, rindu elementiem un pielikumiem.
5. Sūtīšana	XML tiek nosūtīts uz Docura API. Tiek atgriezts apstiprinājuma ID vai kļūdas ziņojums; progress tiek rādīts reāllaikā.
6. Dokumenta atjaunināšana	Horizon saglabā savienojumu, operatora ID, eksportēšanas laiku un statusu Nosūtīts. Tas tiek reģistrēts kā EDI API eksporta notikums.

02 Pēc eksporta redzamie lauki¶

Lauks	Apraksts
EDI API savienojums	Kurš savienojums tika izmantots eksportēšanai
EDI eksporta statuss	Eksportēšanas brīdī Nosūtīts, vēlāk atjaunināts uz Apstrādāts vai Kļūda
EDI kļūdas kods	Docura piešķirtais ziņojuma identifikators
EDI kļūdas ziņojums	Kļūdas vai brīdinājuma teksts no Docura
EDI portāla saite	Tiešā saite uz dokumentu Docura portālā

03 Piezīmes¶

1. Jau eksportēti dokumenti tiek automātiski izlaisti, atlasot rindas — tas novērš dublikātus
2. Nesūtiet vienu un to pašu dokumentu divreiz īsā laika posmā — Docura apstrādā dokumentus asinhroni un, iespējams, neatklās dublikātu
3. EDI eksporta statusa lauki tiek aizpildīti automātiski un nav paredzēti manuālai rediģēšanai

07 Automātiski statusa atjauninājumi¶

Pēc eksporta Horizon automātiski vaicā Docura un atjaunina dokumentu statusus — manuāla pārbaude portālā nav nepieciešama.

Atrašanās vieta: Sistēma → Iestatījumi → Automatizētie darbi → EDI API eksporta dokumenta statusa izguve

Unlock01 Konfigurācija¶

Lauks	Obligāts	Vērtības
Savienojums	Jā	Iepriekš izveidots EDI API savienojums
Dokumenta tips	Nē	Visi tipi, INVOICE vai ORDER

02 Ieteicamais intervāls¶

Horizon vaicā Docura par izmaiņām pēdējo 24 stundu laikā katru reizi, kad tiek izpildīts uzdevums.

1. Minimums: ik pēc 10 minūtēm (biežākas pārbaudes rada nevajadzīgu slodzi)
2. Optimālais: reizi stundā
3. Maksimālais: vismaz reizi 24 stundās

Brīdinājums: ja uzdevums netiek izpildīts ilgāk par 24 stundām, Horizon nepamanīs nevienas Docura izmaiņas no šī perioda.

03 Kā darbojas statusa atjaunināšana¶

Docura rezultāts	Horizon statuss	Skaidrojums
Nav kļūdu	Apstrādāts	Dokuments veiksmīgi piegādāts saņēmējam. Ja ir brīdinājums, tas tiek saglabāts EDI kļūdas ziņojuma laukā.
Kļūdas karogs ir	Kļūda	Dokuments nav sasniedzis saņēmēju.

Darbs atjaunina dokumentu tikai tad, ja kaut kas patiešām ir mainījies — netiek reģistrēti lieki notikumi. Katra reāla izmaiņa tiek ierakstīta kā EDI API statusa maiņas notikums ar precīzu atjaunināto lauku sarakstu.