Project

General

Profile

View source (English) EN RU ET LT LV Lietuvių
English Русский Eesti Latviešu

Wiki » 06 Prepared integration package and ERPs »

Visma Horizon

01 Visas originalios gairės

Visos originalios instrukcijos (latvių kalba, su ekrano nuotraukomis) yra paskelbtos Visma adresu:

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

Unlock02 Ką apima

„Visma Horizon“ siūlo tiesioginę integraciją su „Docura“, skirtą keistis prekybos dokumentais tarp tiekėjų ir jų klientų, naudojančių „Horizon“. Ryšys naudoja tiesioginę REST API nuorodą į „Docura“ – nereikia vietinių failų aplankų ar tarpinių paslaugų.

Integracija apima tris srautus:

  1. Gaunamų dokumentų importas iš „Docura“ į „Horizon“ (ORDER)
  2. Išsiunčiamų dokumentų eksportas iš „Horizon“ į „Docura“ (INVOICE)
  3. Automatiniai eksportuotų dokumentų būsenos atnaujinimai

Unlock03 Nustatymas „Docura“ pusėje

Prieš prijungiant „Horizon“, įsitikinkite:

  1. Įmonė užregistruota „Docura“ sistemoje. Žingsnis po žingsnio vadovas pateikiamas wiki puslapyje „EDI-Web registracija“:https://redmine.docura.net/projects/docura-manual-en/wiki/lt/01_EDI-Web_registration – užsiregistruokite app.docura.net, patvirtinkite savo el. pašto adresą, raskite arba sukurkite savo organizaciją ir paimkite ClientID bei Client secret (API raktą) iš savo profilio
  2. Gavote API adresą ir API raktą – „Docura“ palaikymo tarnyba juos išsiunčia paprašius (per pokalbį ar el. paštu)
  3. Visi prekybos partneriai, dar neprijungti prie „Docura“, buvo pridėti prie mainų tinklo

04 Sąranka Horizon sistemoje

  1. Eikite į System → Data exchange → EDI API connections
  2. Sukurkite naują EDI API Docura ryšį
  3. Įveskite API adresą ir API raktą (abu privalomi; Vartotojo vardas yra neprivalomas)
  4. Spustelėkite Testi – Horizon patikrins ryšį ir praneš apie klaidą, jei duomenys yra neteisingi

01 Kontrolinis sąrašas prieš pirmąjį importą

  1. Klientų įrašuose nurodytas registracijos numeris arba ILN (GLN)
  2. Produktų įrašuose užregistruoti EAN brūkšniniai kodai
  3. Sandėlio įrašuose yra pristatymo adresas su ILN
  4. EDI API Docura jungtis buvo pridėta ir išbandyta

05 Dokumentų gavimas (importas iš Docura)

Vieta: Sistema → Duomenų mainai → Dokumentų importas

Horizon periodiškai pats užklauso naujus dokumentus iš Docura – nereikia jokio rankinio failų tvarkymo.

01 Rankinis importas

Sistema → Duomenų mainai → Dokumentų importas → Naujas dokumentas

Kuriant importo įrašą, nurodykite:

  1. Ryšys — Docura EDI API ryšys
  2. Dokumento bazinis tipas ir Dokumento tipas — nustato, kokį tikslinį dokumentą Horizon sukuria
Situacija Rezultatas
Sukurtas naujas importo įrašas Importuojami tik Docura dokumentai, dar nepažymėti kaip gauti
Tikslinis dokumentas jau užbaigtas Pakartotinis jo sukūrimas neįmanomas

02 Automatinis importavimas (suplanuota užduotis)

Vieta: Sistema → Nustatymai → Automatizuotos užduotys → EDI dokumentų importavimas iš tarpinio sluoksnio

Laukas Būtinas Reikšmės
Ryšys Taip Anksčiau sukurtas EDI API Docura ryšys
Dokumento tipas Taip ORDER
Tikslinis dokumentas Taip Konkretus kuriamas dokumento tipas

03 Po importo

  1. Horizon automatiškai sukuria paskirties dokumentą
  2. Originalus XML failas saugomas ir importo įraše, ir paskirties dokumente
  3. Docura pažymi dokumentą kaip gautą (READ=Y) – jis nebeatsiras vėlesniame importe

04 Pastabos

  1. Jei tikslinis dokumentas jau užpildytas, jo negalima iš naujo sukurti iš importo įrašo
  2. Norėdami iš naujo importuoti, atidarykite dokumentą Docura portale (naudodami EDI portalo nuorodą) ir pasirinkite Gauti dar kartą
  3. Prieš atkuriant, įsitikinkite, kad pradinė klaidos priežastis (kliento, sandėlio ar produkto duomenys) buvo ištaisyta sistemoje Horizon

Unlock06 Dokumentų siuntimas (eksportas į Docura)

Išsiunčiami dokumentai (INVOICE) gali būti siunčiami į Docura tiesiogiai iš Horizon sąrašų vienu veiksmu – nereikia rankiniu būdu ruošti XML.

Vieta:

  1. Dokumentai → Logistika → Užsakymai → Veiksmai → Sąrašo eksportas → EDI API jungtis
  2. Dokumentai → Sandėlis → Sąskaitų sąrašas → Veiksmai → Sąrašo eksportas → EDI API jungtis

Šis veiksmas meniu atsiranda tik sukonfigūravus bent vieną EDI API jungtį.

01 Eksportavimo žingsniai

Žingsnis Aprašymas
1. Dokumentų pasirinkimas Jei sąraše niekas nepasirinkta, eksportuojamas dokumentas, esantis po žymekliu. Jei pasirinktos kelios eilutės, siunčiami visi dar neeksportuoti dokumentai.
2. Ryšio pasirinkimas Esant vienam ryšiui, jis naudojamas automatiškai. Esant keliems, atidaromas dialogas; Horizon prisimena paskutinį pasirinkimą.
3. Autentifikacijos patikrinimas API ryšys patvirtinamas prieš siunčiant. Jei jis netinkamas, jokie dokumentai nesiunčiami.
4. XML paruošimas Horizon kiekvienam dokumentui paruošia XML failą su antraštės informacija, eilutės elementais ir priedais.
5. Siuntimas XML siunčiamas į Docura API. Grąžinamas patvirtinimo ID arba klaidos pranešimas; progresas rodomas realiuoju laiku.
6. Dokumento atnaujinimas Horizon išsaugo ryšį, operatoriaus ID, eksportavimo laiką ir būseną Išsiųsta. Tai registruojama kaip EDI API eksporto įvykis.

02 Laukai, rodomi po eksporto

Laukas Aprašymas
EDI API jungtis Kuri jungtis buvo naudojama eksportui
EDI eksporto būsena Eksporto metu Išsiųsta, vėliau atnaujinta į Apdorota arba Klaida
EDI klaidos kodas Pranešimo identifikatorius, priskirtas Docura
EDI klaidos pranešimas Klaidos arba įspėjimo tekstas iš Docura
EDI portalo nuoroda Tiesioginė nuoroda į dokumentą Docura portale

Unlock03 Pastabos

  1. Jau eksportuoti dokumentai praleidžiami automatiškai parenkant eilutes – tai apsaugo nuo dublikatų
  2. Nesiųskite to paties dokumento du kartus per trumpą laiką – „Docura“ dokumentus apdoroja asinchroniškai ir gali neaptikti dublikato
  3. EDI eksporto būsenos laukai užpildomi automatiškai ir nėra skirti redaguoti rankiniu būdu

07 Automatiniai būsenos atnaujinimai

Po eksporto Horizon automatiškai užklausia Docura ir atnaujina dokumentų būsenas – nereikia rankinio patikrinimo portale.

Vieta: Sistema → Nustatymai → Automatinės užduotys → EDI API eksporto dokumentų būsenos atsiėmimas

Unlock01 Konfigūracija

Laukas Privaloma Reikšmės
Prisijungimas Taip Anksčiau sukurtas EDI API prisijungimas
Dokumento tipas Ne Visi tipai, INVOICE arba ORDER

02 Rekomenduojamas intervalas

„Horizon“ kiekvieną kartą paleidus užduotį teiraujasi „Docura“ apie pastarųjų 24 valandų pakeitimus.

  1. Minimalus: kas 10 minučių (dažnesni patikrinimai sukelia nereikalingą apkrovą)
  2. Optimalus: kartą per valandą
  3. Maksimalus: bent kartą per 24 valandas

Įspėjimas: jei užduotis nebus vykdoma ilgiau nei 24 valandas, „Horizon“ nepasieks jokių „Docura“ pakeitimų iš to laikotarpio.

Unlock03 Kaip veikia būsenos atnaujinimas

„Docura“ rezultatas „Horizon“ būsena Paaiškinimas
Be klaidos Apdorota Dokumentas sėkmingai pristatytas gavėjui. Jei yra įspėjimas, jis saugomas EDI klaidos pranešimo lauke.
Yra klaidos žyma Klaida Dokumentas nepasiekė gavėjo.

Užduotis atnaujina dokumentą tik tada, kai kas nors iš tikrųjų pasikeitė – nereikalingi įvykiai neloginami. Kiekvienas realus pakeitimas įrašomas kaip EDI API būsenos pakeitimo įvykis su tiksliu atnaujintų laukų sąrašu.

Source version: 10 · Status: fresh · Roman Startsev