PrestaShop pardavimų nuskaitymas

Pagrindiniai integracijos kriterijai

• Prekė ar paslauga identifikuojama pagal prekės kodą — PrestaShop lauką reference (SKU). Jei importuojama prekė turi nurodytą reference, kuris nerastas Rivile ERP sistemoje, prekės kortelė bus sukuriama automatiškai (priskiriant parametruose nurodytą prekių grupę). Tais atvejais, kai importuojamuose duomenyse reference yra tuščias arba nenurodytas, bus naudojama parametruose nustatyta numatytoji prekė (pvz. „Nerasta prekė“).
• Prekės importuojamos Rivile ERP pagrindiniu mato vienetu.
• Prekių kainos naudojamos su PVM.
• Užsakymai atrenkami pagal sąskaitos datą (invoice_date) intervale nuo PRESTA_DEFAULTS parametro „Paskutinė importuoto dokumento data“ lauko iki dabar. Neužpildžius „Paskutinė importuoto dokumento data“ lauko, imamos paskutinės 30 dienų.
• Klientas identifikuojamas taip:
  • jei Prestashop užsakymo sąskaitos adrese užpildytas įmonės pavadinimas (company), klientas laikomas juridiniu asmeniu ir ieškomas pagal registracijos kodą (PrestaShop adreso laukas dni), o jo neradus — pagal el. pašto adresą;
  • kitu atveju klientas laikomas fiziniu asmeniu ir ieškomas pagal el. pašto adresą.
  • Neradus — klientas sukuriamas ir jam sukuriamas sąskaitos adresas.
  • Jei parametruose nurodytas bendrinis „Klientas“, fizinių asmenų dokumentai priskiriami jam ir naujos klientų kortelės nekuriamos.
  • Jei nėra nei el. pašto, nei registracijos kodo — dokumentas neimportuojamas ir patenka į protokolą kaip klaida.
• PrestaShop užsakymo numeris saugomas skyriuje „Bendra informacija“ lauke „Dokumentas ref.“ formatu <užsakymo ID>. Jeigu tokiu numeriu dokumentas jau egzistuoja Rivile ERP — antrą kartą įrašas neimportuojamas (protokole žymima DUPLICATE). Norint importuoti pardavimą iš naujo, reikalingas įrašo pašalinimas iš Rivile ERP.
• Dokumentas visada kuriamas būsena „Juodraštis“ ir po to patvirtinamas į būseną „Naujas“. Jeigu patvirtinti nepavyksta, dokumentas lieka kaip „Juodraštis“, o protokole žymima klaida.
• Užsakymo ar sąskaitos faktūros apmokėjimo informacija saugoma skyriuje „Mokėjimai“. Mokėjimas kuriamas tik tada, kai PrestaShop mokėjimo būdas (payment) aprašytas parametre PRESTA-PAYMENTS.
• Pristatymo kaina keliama atskira detalia eilute su parametruose nurodyta pristatymo paslauga (kai total_shipping_tax_incl ≠ 0).
• Pakavimo kaina keliama atskira detalia eilute su parametruose nurodyta pakavimo paslauga (kai total_wrapping_tax_incl ≠ 0).
• Sistema automatiškai išsaugo paskutinę sėkmingą importo datą, kad kito sinchronizavimo metu būtų importuojami tik naujesni užsakymai. Įvykus klaidoms, data nustumiama į 1 sek. prieš anksčiausiai nepavykusį užsakymą, todėl nepavykę dokumentai kartojami kito vykdymo metu.
• Vykdymas turi laiko limito apsaugą — pasiekus limitą apdorojimas sustabdomas, o likę dokumentai apdorojami kito vykdymo metu.

Pagrindiniai integraciniai veiksmai

Integraciniai sprendimai

redakcija 2026-09-16