Verskis.lt integraciniai parametrai

Turėkite Verskis.lt API adresą ir prieigos duomenis. Rivilėje turi būti paruoštas padalinys, žurnalas, pristatymo paslaugos prekė ir prekė, naudojama kai pardavimo eilutėje nėra prekės kodo. Naujų prekių kūrimui reikalingas matavimo vienetas kodu „vnt“.

Importuokite diegimo failą ir paleiskite VERSKIS-INIT. Diegiklis turi būti priskirtas Verskis programos sprendimui; jo neradęs sustoja prieš kurdamas parametrus. Tikslinėje ERP turi būti prieinamos eksportuose nurodytos programos.

KAIP PRIDĖTI PARAMETRO REIKŠMĘ

Atverkite reikiamą parametrą. Skiltyje „Parametrų reikšmės“ spauskite „Pridėti“. Lange „Nauja parametro reikšmė“ užpildykite:

  • „Įmonė“ — pasirinkite įmonę, kuriai skirta integracija.
  • „El. parduotuvė“ — įrašykite tą pačią reikšmę kaip abiejuose paleidėjuose.

Abiejų sinchronizacijos paleidėjų kode įrašykite tą patį el. parduotuvės identifikatorių. Standarto pavyzdinė reikšmė yra „verskis“:

const module = "verskis"

Vietoje „verskis“ abiejuose paleidėjuose įrašykite savo el. parduotuvės adresą. Jei turite tik vieną el. parduotuvę, reikšmę „verskis“ galite palikti. Tą pačią reikšmę įrašykite visų keturių parametrų lauke „El. parduotuvė“:

  • VERSKIS-API;
  • VERSKIS-DEFAULTS;
  • VERSKIS-PAYMENTS;
  • VERSKIS-STOCK.

Pardavimams ir likučiams naudojama viena bendra VERSKIS-API parametro reikšmė. Atskiri prisijungimo įrašai pagal paleidėjo pavadinimą nereikalingi. Paleidėjų automatizacijų kodai nesikeičia; keičiama tik el. parduotuvės reikšmė jų kode. Diegiklis esamų paleidėjų neperrašo, todėl jau įdiegtuose paleidėjuose šią reikšmę pakeiskite tiesiogiai.

Žvaigždute pažymėti laukai privalomi. Užpildę laukus spauskite „Išsaugoti“. Toliau naudojami formose rodomi laukų pavadinimai. Ekrano nuotraukose nepateiktų formų pavadinimai nurodyti pagal standarto parametrų schemas; priklausomai nuo sąsajos vertimo dalis jų gali būti rodoma lietuviškai.

VERSKIS-API — PRISIJUNGIMAS

Sukurkite vieną prisijungimo reikšmę. Lauke „El. parduotuvė“ įrašykite tą pačią reikšmę, kuri nustatyta abiejuose paleidėjuose.

  • „URL“ — įrašykite Verskis.lt API bazinį adresą.
  • „Authorization Type“ — pasirinkite autentifikavimo būdą pagal naudojamos jungties nustatymus. Galimi pasirinkimai: „No Auth“, „Basic Auth“, „Bearer Token“.
  • „Authorization“ — įrašykite prieigos reikšmę. Integracija ją taip pat naudoja kaip API raktą.
  • „Paskutinė importuoto pardavimo data“ — nustatykite pardavimų importo pradžios datos ribą. Automatizacija skaitys nuo vienos sekundės po jos.

Visi šie laukai privalomi. Pardavimų pažangos data saugoma šiame parametre, o likučių pažangos data — atskirame VERSKIS-STOCK parametre. Pasirinkite savo importo laikotarpį, ne atsitiktinę datą. Jau naudojamos integracijos pažangos datos nekeiskite be poreikio kartoti importą.

VERSKIS-DEFAULTS — PARDAVIMŲ NUSTATYMAI

Lauke „El. parduotuvė“ įrašykite tą pačią reikšmę kaip abiejuose paleidėjuose. Laukai pateikti tokia tvarka ir pavadinimais, kaip jūsų parodytoje formoje:

  • „Klientas (fizinis asmuo)“ — pasirinkite bendrą fizinių asmenų klientą, jei pardavimams norite naudoti tokią kliento kortelę. Neprivalomas.
  • „Padaliniai“ — pasirinkite pardavimams skirtą padalinį. Privalomas.
  • „Pristatymo paslauga“ — pasirinkite prekę arba paslaugą, kuri bus naudojama pristatymo eilutei. Privalomas.
  • „Žurnalas“ — pasirinkite pardavimo dokumentų žurnalą. Privalomas.
  • „Nerasta prekė“ — pasirinkite prekę, naudojamą, kai Verskis pardavimo eilutėje nepateiktas prekės kodas. Privalomas.
  • „Grupė priskiriama naujai prekei“ — pasirinkite grupę naujai kuriamoms prekėms. Neprivalomas.
  • „Dokumento tipas“ — pasirinkite „Užsakymas“ arba „SF“. Privalomas.
  • „Dokumento numeris“ — pasirinkite „eShop numeris“ arba „Dokumentų skaitliukai“. Neprivalomas.
  • „Kaina su PVM“ — pažymėkite, jei naudojamos kainos su PVM; kitu atveju palikite nepažymėtą. Patikrinkite faktinį pasirinkimą prieš išsaugodami.

Įmonę, klientą, padalinį ir kitas reikšmes rinkitės pagal savo apskaitą. Ekrano nuotraukoje pateikti konkretūs pasirinkimai nėra standarto reikalavimas.

VERSKIS-PAYMENTS — MOKĖJIMO BŪDŲ ATITIKMENYS

Skiltyje „Parametrų reikšmės“ spauskite „Pridėti“. Lange „Nauja parametro reikšmė“ pasirinkite „Įmonė“, o lauke „El. parduotuvė“ įrašykite tą pačią reikšmę kaip abiejuose paleidėjuose.

Srityje „Parametro reikšmė“ užpildykite:

  • „Mokėjimo metodas“ — pasirinkite atitinkamą mokėjimo metodą Rivilėje.
  • „Reikšmė“ — įrašykite mokėjimo būdo kodą, gaunamą iš Verskis.lt.

Abu laukai privalomi kuriant atitikmenį. Spauskite „Išsaugoti“. Kiekvienam mokėjimo būdui pridėkite atskirą reikšmę. Jei mokėjimo atitikmenų nereikia, šio parametro reikšmių galima nepildyti.

VERSKIS-STOCK — LIKUČIŲ NUSTATYMAI

Lauke „El. parduotuvė“ įrašykite tą pačią reikšmę kaip abiejuose paleidėjuose. Šių laukų pavadinimai pateikti pagal standarto schemą:

  • „Department“ — pasirinkite padalinius, kurių likučiai bus naudojami. Neprivalomas filtras.
  • „Product tree“ — pasirinkite prekių medį, jei norite taikyti šį filtrą. Neprivalomas.
  • „Paskutinė likučių sinchronizacijos data“ — nustatykite likučių sinchronizacijos pradžios datą. Privalomas.
  • „Batch uid“ — apdorojimo paketo identifikatorius; jį pildo automatizacija.
  • „Batch data“ — apdorojimo paketo data; ją pildo automatizacija.

Naujoje instaliacijoje paketo laukų savavališkai nepildykite. Veikiančioje integracijoje išsaugokite jų esamas reikšmes. Patvirtinus ankstesnio paketo sėkmingą apdorojimą atnaujinama „Paskutinė likučių sinchronizacijos data“.

PALEIDIMAS IR REZULTATŲ PATIKRA

  1. Užpildykite ir išsaugokite parametrų reikšmes.
  2. Pardavimo SF sąraše paleiskite „Pardavimų nuskaitymas Verskis.lt“.
  3. Patikrinkite sukurtus dokumentus, klientus, prekes, sumas ir mokėjimus. Dokumentai kuriami juodraščiais, tada bandoma pakeisti statusą į „Naujas“.
  4. Atsargų likučių sąraše paleiskite „Likučių sinchronizacija Verskis.lt“.
  5. Patikrinkite likučius Verskis.lt ir vykdymo rezultatą Rivilėje.

Pardavimų vykdymas grąžina būseną, pranešimą ir dokumentų skaičius. „Paskutinė importuoto pardavimo data“ atnaujinama tik kai nėra importo klaidų, nesėkmingais pažymėtų dokumentų ir bent vienas dokumentas sėkmingai importuotas.

PAKARTOTINIS DIEGIMAS IR APRIBOJIMAI

Oficiali versija — 1.0.0. Diegiklis esamus parametrus ir automatizacijas praleidžia. Pakartotinis diegimas nekeičia įvestų reikšmių ir pažangos datų.

Dublikatai šiuo metu skaičiuojami kaip nesėkmingi dokumentai, todėl partija su dublikatais pardavimų datos nepastumia. Jei dokumentas sukurtas tik iš dalies (pavyzdžiui, nepavyko mokėjimas ar statuso pakeitimas), patikrinkite jį Rivilėje: pakartotinis importas gali jį praleisti kaip dublikatą.

Paketo struktūra ir vykdymo scenarijai patikrinti imituotoje aplinkoje. Tikroje Rivilėje ir Verskis.lt API paketas dar nepaleistas; pirmą vykdymą atlikite bandomojoje aplinkoje.

Integraciniai sprendimai

redakcija 2026-09-28