Verskis.lt pardavimų nuskaitymas ir likučių siuntimas

Pardavimų šaltiniai ir atranka:

Užsakymai ir pardavimo sąskaitos nuskaitomi iš skirtingų Verskis.lt šaltinių:

  • „Dokumento tipas“ → „Užsakymas“: el. parduotuvės užsakymai (orders).
  • „Dokumento tipas“ → „SF“: el. parduotuvėje išrašytos sąskaitos (invoices).

Pasirinkus „SF“, užsakymas be el. parduotuvėje išrašytos sąskaitos nebus nuskaitytas kaip pardavimo sąskaita.

Dokumentai atrenkami pagal sukūrimo datą ir skaitomi po 50 įrašų, kol gaunami visi pasirinkto laikotarpio duomenys. Apmokėjimo ar įvykdymo būsenos filtras netaikomas: nuskaitymas neapribotas tik apmokėtais ar įvykdytais užsakymais. Kartu paimami pirkėjo duomenys, prekių kodai, pavadinimai, kiekiai, sumos, nuolaidos, pristatymo ir mokėjimo būdo informacija.

Nuskaitymas tęsiamas nuo „Paskutinės importuoto pardavimo datos“, pridedant vieną sekundę, nebent vykdymui tiesiogiai perduota kita laikotarpio pradžia. Data atnaujinama tik kai bent vienas dokumentas sėkmingai importuotas ir nėra klaidų ar nesėkmingais pažymėtų dokumentų. Dublikatai taip pat įtraukiami į nesėkmingų dokumentų skaičių, todėl jų turinti partija datos nepastumia.

Pirkėjo atpažinimas

Jei pateiktas įmonės pavadinimas, pirkėjas laikomas juridiniu asmeniu ir Rivilėje ieškomas pagal įmonės kodą. Neradus kuriama kliento kortelė. Fiziniams asmenims naudojamas lauke „Klientas (fizinis asmuo)“ pasirinktas klientas. Jei jis nepasirinktas, kliento ieškoma pagal el. paštą, o neradus kuriama nauja kortelė. Naujam juridiniam klientui reikalingas įmonės kodas, fiziniam asmeniui — tinkamas el. paštas. Paruošiami adreso ir kontaktiniai duomenys.

Prekių atpažinimas

Prekės ieškoma pagal iš Verskis.lt gautą prekės kodą:

  • Radus naudojama esama prekės kortelė.
  • Jei kodas pateiktas, bet prekės nėra, kuriama nauja prekė su gautu kodu ir pavadinimu, matavimo vienetu „vnt“ ir, jei pasirinkta, lauke „Grupė priskiriama naujai prekei“ nurodyta grupe.
  • Jei kodas nepateiktas arba tuščias, naudojama lauke „Nerasta prekė“ pasirinkta prekė.

Pristatymas

Jei pristatymo suma nelygi nuliui, pridedama atskira eilutė su lauke „Pristatymo paslauga“ pasirinkta preke arba paslauga. Kiekis yra vienetas, o sumos paimamos iš el. parduotuvės pristatymo duomenų.

Sumos, PVM ir nuolaidos

Naudojami el. parduotuvės pateikti kiekiai, sumos be PVM, sumos su PVM ir nuolaidų sumos. PVM suma apskaičiuojama kaip sumų su PVM ir be PVM skirtumas. Prekės vieneto kaina apskaičiuojama sudėjus eilutės sumą be PVM, PVM ir nuolaidos sumą bei padalijus iš kiekio. Nuolaida perduodama kaip suma. Dokumento kainų su PVM požymis nustatomas pagal lauką „Kaina su PVM“.

Dokumento numeris

Pasirinkus „Dokumento numeris“ → „eShop numeris“, naudojamas iš el. parduotuvės dokumento duomenų parenkamas numeris. Pasirinkus „Dokumentų skaitliukai“, numeravimas paliekamas Rivilės skaitliukams.

Mokėjimo būdo susiejimas

El. parduotuvės mokėjimo būdo kodas (payment.code) lyginamas su parametro VERSKIS-PAYMENTS lauku „Reikšmė“, nepaisant didžiųjų ir mažųjų raidžių. Radus atitikmenį, naudojamas prie jo pasirinktas „Mokėjimo metodas“. Sukuriamas su dokumentu susietas mokėjimo įrašas visai el. parduotuvės dokumento sumai (grand_total). Mokėjimo data nustatoma pagal dokumento sukūrimo datą. Neradus atitikmens mokėjimo įrašas nekuriamas, tačiau dokumento importas tęsiamas.

Faktinė apmokėjimo būsena ir sumokėta suma netikrinamos, daliniai mokėjimai nevertinami. Mokėjimo įrašas gali būti sukurtas ir neapmokėtam užsakymui; jis savaime nepatvirtina, kad pinigai faktiškai gauti.

Likučių siuntimas

Į Verskis.lt prekių šaltinį (products) siunčiami pasikeitusių prekių likučiai pagal pasirinktus padalinius ir prekių medį. Kiekiai susumuojami pagal prekės kodą. El. parduotuvės prekės kodas turi sutapti su Rivilės prekės kodu. Siunčiamas kodas ir kiekis; kainos, aprašymai bei nuotraukos neatnaujinami.

Verskis.lt siuntimą priima apdoroti paketu. Priėmimas dar nereiškia, kad likučiai atnaujinti. Kito paleidimo metu tikrinama paketo būsena (products/batch/{paketo identifikatorius}):

  • Jei paketas laukia apdorojimo, nauji likučiai nesiunčiami.
  • Patvirtinus sėkmingą apdorojimą išsaugoma „Paskutinė likučių sinchronizacijos data“ ir tęsiamas naujų pakeitimų siuntimas.
  • Jei apdorojimas nepavyko, šio paketo data neišsaugoma kaip sėkmingos sinchronizacijos data.

Siuntimo rezultatai pateikiami likučių ataskaitoje. Laukiantis apdorojimo įrašas nėra galutinai patvirtintas atnaujinimas. Pardavimų ir likučių sinchronizacijos datos saugomos atskirai.

Integraciniai sprendimai

redakcija 2026-09-28