OpenCart tiekėjų importas: XML srautai, likučiai ir kainos

OpenCart tiekėjų importo modulis – tai plėtinys, kuris tiekėjų XML srautus paverčia OpenCart prekėmis ir pagal tvarkaraštį nuolat atnaujina jų kainas, likučius ir būseną. Supplier Import – mūsų tokio tipo modulis OpenCart 3.0.x parduotuvėms: OpenCart Marketplace kataloge jis kainuoja 69 USD ir skirtas parduotuvėms, kurios perparduoda prekes ar dirba tiesioginio pristatymo (dropshipping) modeliu su keliais platintojais ir nebenori kainų bei kiekių atnaujinti rankomis.

Praktiškai tai OpenCart prekių importo įrankis ir sinchronizavimo užduotis viename. Kiekvieno tiekėjo srautą susiejate vieną kartą ir patvirtinate, iš kurių tiekėjo kategorijų galima kurti naujas prekes. Nuo tada modulis pats importuoja prekes iš tiekėjų, atnaujina tai, kas pasikeitė, ir išjungia tai, kas dingo. Kainodaros taisyklės tiekėjo kainą paverčia jūsų pardavimo kaina, o kasdienė būklės patikra el. paštu praneša, kai kam nors reikia jūsų dėmesio. Pavyzdžiui, prieš: tiekėjo prekė atkeliauja su kiekiu 0 ir sukuriama išjungta. Po: vėlesniame sraute jos likutis didesnis už 0, ir ta pati prekė vėl įjungiama be rankinio taisymo.

Sparcley Supplier Import modulį OpenCart Marketplace kataloge paskelbė 2026 m. spalį; ten taip pat rasite mūsų DPD siuntų sekimo, XML srautų ir prekių vaizdo įrašų modulius. Su 2.6 versija gaunate 12 mėnesių nemokamos pagalbos ir išsamią dokumentaciją. Modulį kūrėme veikiančiai OpenCart 3 parduotuvei, kuri tiekėjų katalogus importuoja kasdien, todėl kiekviena toliau aprašyta funkcija kilo iš realaus darbo su katalogu, o ne iš norų sąrašo. Jei norite, kad visa parduotuvė būtų sukurta atsižvelgiant į jūsų tiekėjus, kuriame ir el. parduotuves su tiekėjų integracija.

Kiekvienas tiekėjas pridedamas trimis etapais meniu Catalog > Supplier import – tiekėjas, laukai ir kategorijos, – o Supplier Import reikalauja, kad kiekviena prekė sraute būtų atskiras product elementas. PVM atskaitymo parinktis (Deduct VAT) skirta tiekėjams, kurių srauto kainose yra PVM, todėl kainodara pradedama nuo kainos be PVM.

Jei tiekėjo kategorijos labai skiriasi nuo jūsų kategorijų medžio, verta pirmiau sutvarkyti medį, o ne rankomis sieti šimtus nesutampančių kategorijų.

1. 01Sukurkite tiekėją: įrašykite srauto URL, kurį atsisiųs cron, arba įkelkite XML failą, tada nustatykite PVM atskaitymą ir išimčių sąrašą – frazes, kurias turinčios prekės praleidžiamos.
2. 02Susiekite laukus pagal pirmą srauto prekę: prekės pavadinimas, meta pavadinimas, prekės kodas (modelis) ir kategorija privalomi, o SKU, kaina, svoris, kiekis, aprašymas, EAN, nuotrauka, gamintojas ir pirkimo kaina be PVM – neprivalomi. Prekės kodą susiekite su niekada nesikeičiančia reikšme, nes jis sieja prekę tarp dviejų srautų.
3. 03Susiekite kategorijas: kiekvienai tiekėjo kategorijai parinkite parduotuvės kategoriją, pažymėkite Verify ir nustatykite kainos procentą nuo −100 iki 100 – antkainį arba nuolaidą. Naujos prekės kuriamos tik iš patvirtintų kategorijų, o esamos nepatvirtintų kategorijų prekės vis tiek gauna likučių atnaujinimus.
4. 04Paleiskite pirmą importą ir peržiūrėkite rezultatus, prieš pridėdami tiekėjo cron užduotį.

OpenCart likučių ir kainų sinchronizavimas vyksta penkiais žingsniais – nuo vieno kasdienio kiekvieno tiekėjo srauto atsisiuntimo iki trumpų pasikeitusių prekių atnaujinimų.

1. 01Pridėkite po vieną cron užduotį kiekvienam tiekėjui, dažniausiai kas 15 minučių, kad didelio srauto nereikėtų sutalpinti į vieną paleidimą.
2. 02Atsisiųskite kiekvieno tiekėjo srautą kartą per dieną.
3. 03Apdorokite kitą srauto dalį per kiekvieną cron paleidimą – nebaigtas importas tęsiamas nuo išsaugotos vietos.
4. 04Nepavykęs atsisiuntimas automatiškai pakartojamas po 75 sekundžių – iki trijų bandymų per penkias minutes, – kai tiekėjo serveris atsako HTTP 503 arba neatsako laiku (komandinės eilutės paleidimai).
5. 05Pirmuoju paleidimu importuokite visas prekes; vėliau modulis atnaujina tik naujas ir dingusias prekes bei tas, kurių kaina, kiekis, pavadinimas, kategorija ar nuotrauka pasikeitė.

Kadangi atnaujinama tik tai, kas pasikeitė, automatinis kainų ir likučių atnaujinimas trunka trumpai net dideliame kataloge. Atskiras prekes galima išimti iš atnaujinimų arba užrakinti jų laukus, pavyzdžiui, kainą ar aprašymą (2.6 versijoje tai nustato programuotojas – administravimo skydelyje šios funkcijos dar nėra). Kas nutinka kiekvienai prekei:

• Naujos prekės įjungiamos, kai kiekis didesnis už 0, ir sukuriamos išjungtos, kai kiekis lygus 0.
• Kiekis, didesnis už 0, vėl įjungia esamą prekę; kiekis 0 palieka jos būseną, o prekė rodoma kaip neturima sandėlyje.
• Iš srauto dingusios prekės išjungiamos, bet niekada netrinamos, o grįžusios atgauna kainą, likutį ir būseną.
• Trūkstamos nuotraukos atsisiunčiamos į jūsų serverį; esamos paliekamos, o tuščias aprašymas sraute niekada neištrina užpildyto.

Šešios apsaugos neleidžia sugedusiam tiekėjo srautui perrašyti jūsų OpenCart katalogo. Tiekėjų srautai genda nuspėjamai – tuščias failas, nebaigtas eksportas, staiga visur nuliniai likučiai, – ir kiekviena apsauga skirta vienam iš šių atvejų:

• Srauto patikra: failas, kuris nėra XML arba neturi product elementų, atmetamas dar prieš bet kokį pakeitimą.
• Masinio išjungimo apsauga: jei paleidimas išjungtų daugiau nei 10 prekių arba 20 % įjungtų tiekėjo prekių (taikoma didesnė riba), neišjungiama nieko, o klaida įrašoma į žurnalą.
• Likučių apsauga: jei ankstesniame sraute sandėlyje buvo bent 20 prekių, o naujame – 10 % to kiekio ar mažiau, tame paleidime likučiai nenunulinami.
• Paleidimo užraktas: to paties tiekėjo niekada neimportuoja du paleidimai vienu metu.
• Klaidų izoliavimas: nepavykusi prekė įrašoma į žurnalą ir praleidžiama, o likęs srautas apdorojamas toliau.
• Įstrigę importai: paleidimas, kuris dvi valandas nejuda, pažymimas, o importo pozicijos grąžinimas į pradžią (Reset import position) jį paleidžia iš naujo.

Kiekvienos prekės kainą nustato lygiai viena taisyklė – taisyklės niekada nesumuojamos. Kainodaros taisyklės yra meniu Catalog > Supplier import > Pricing, atskirai kiekvienam tiekėjui, ir tikrinamos fiksuota tvarka: kainos užraktas, prekės taisyklė, prekės ženklo taisyklė, tiekėjo taisyklė, kategorijos taisyklė, prisegta nuolaida, kategorijos procentas ir be pakeitimų. Tame pačiame lygyje laimi taisyklė su daugiau sąlygų, po to – aukštesnio prioriteto.

Taisyklės tikrina gamintoją, parduotuvės kategoriją, tiekėjo kategoriją ir bazinės kainos intervalą. Veiksmas – antkainio formulė „bazė × (1 + % / 100) + fiksuota suma“, suapvalinta iki centų, arba fiksuota kaina vienos prekės taisyklėms; bazė – srauto kaina be PVM. Įrankis „Kodėl tokia kaina?“ paaiškina bet kurios prekės kainą taisyklė po taisyklės.

Kai pirkimo kaina susieta, kainodaros taisyklės sukurtos taip, kad kaina neliktų žemiau savikainos: importas neįrašo mažesnės kainos, o kasdienė kainų patikra pakelia tas, kurios nukrito žemiau. Išimtys – užrakinta kaina, kuri išlaikoma ir apie kurią pranešama, ir nustatymu išjungta savikainos riba. 2.6 versijoje visos įjungtos dubliuotos prekės kopijos, susietos pagal GTIN arba gamintojo kodą ir prekės ženklą, gauna aukščiausią grupės kainą; kol šio režimo neįjungiate, jis tik praneša apie planuojamus pakeitimus. Pakeitimai pritaikomi žingsniais:

1. 01Išsaugokite naują ar pakeistą taisyklę kaip laukiantį pakeitimą.
2. 02Peržiūrėkite poveikį: kylančias, krentančias ir nepakitusias kainas, konfliktus ir didžiausius pokyčius, su CSV atsisiuntimu.
3. 03Patvirtinkite pakeitimą, jei jis paliečia daugiau nei 20 % įjungtų tiekėjo prekių arba vieną kainą pakeičia daugiau nei 30 %.
4. 04Pritaikykite pakeitimą: kainos įrašomos paketais po 500, o kainų sinchronizavimas (Sync prices) patvirtina, kad nebeliko ką keisti.
5. 05Patikrinkite istoriją – joje fiksuojamas kiekvienas pritaikymas, o atšaukimas (Roll back) grąžina ankstesnes paskutinio paketo taisykles ir kainas.

Automatinis OpenCart importas veikia per cron: modulis pats nieko neplanuoja, todėl kiekvienam tiekėjui reikia atskiros cron užduoties prieglobos serveryje, dažniausiai paleidžiamos kas 15 minučių.

1. 01Nusikopijuokite kiekvieno tiekėjo paruoštą komandą iš skilties Settings > Cron.
2. 02Pridėkite ją prieglobos serveryje kaip atskirą to tiekėjo cron užduotį, dažniausiai kas 15 minučių.
3. 03Paleiskite ją per PHP CLI, kai tik galite: komandinės eilutės režimu PHP pagal numatytuosius nustatymus neriboja vykdymo laiko (max_execution_time 0), kitaip nei interneto užklausa.
4. 04Naudokite žetonu apsaugotą HTTP adresą su išorine cron paslauga tik tada, kai neturite komandinės eilutės prieigos: ilgi importai gali atsiremti į serverio laiko limitą.
5. 05Tikrinkite Cron puslapį ir importo žurnalą. Cron puslapyje matyti kiekvieno tiekėjo tvarkaraštis, paskutinis paleidimas, pozicija ir paskutinis srauto atsisiuntimas, o žurnale – po vieną eilutę kiekvienam tiekėjui per dieną su apdorotų, įterptų, atnaujintų ir nepatvirtintų prekių skaičiais.
6. 06Nustatykite ataskaitos valandą ir pasirinkite, ar kasdienė būklės patikra el. paštu siųs rezultatą kasdien, ar tik tada, kai yra klaidų ar naujų įspėjimų.

Kasdienė būklės patikra apima:

• nepavykusius, įstrigusius ar nepasileidusius importus ir apsaugų suveikimus
• srautus, kurių turinys nesikeitė septynias dienas ar ilgiau
• įjungtas prekes, parduodamas žemiau savikainos, įskaitant specialias kainas ir kiekio nuolaidas
• nesusietas kategorijas ir OpenCart klaidų žurnalą
• užsakymus – įspėjimas po 72 valandų be užsakymo
• mūsų XML srautų generatoriaus ir DPD sekimo modulius, jei jie įdiegti

Reikia OpenCart 3.0.x, PHP 7.4 ar naujesnės versijos su cURL, XMLReader, SimpleXML, mbstring ir JSON, MySQL arba MariaDB su InnoDB, cron prieigos prieglobos serveryje ir veikiančio parduotuvės pašto. Pridėtos anglų ir lietuvių administravimo kalbos, o OpenCart branduolio failai neperrašomi. Ką verta žinoti apie 2.6 versiją:

• 2.6 versija dirba tik su XML srautais; jei tiekėjas siūlo tik CSV ar XLS, prieš pirkdami atsiųskite mums pavyzdį.
• 2.6 versijoje PVM atskaitymas taiko fiksuotą 21 % tarifą (kainos dalijamos iš 1,21); jei jūsų tiekėjų kainose yra kitoks PVM tarifas, prieš pirkdami atsiųskite mums srauto pavyzdį.
• Naujos prekės gauna fiksuotą numatytąją mokesčių klasę, sandėlio būseną ir parduotuvę, todėl po pirmo importo patikrinkite, ar jos atitinka jūsų nustatymus.
• Su Journal3 importo paleidimai gali perkurti temos meniu pagal viršutinio lygio kategorijas, todėl prieš pirmą importą pasidarykite temos nustatymų atsarginę kopiją.
• Kasdienės patikros išvados ir ataskaitos laiškas kol kas pateikiami lietuvių kalba.

Taip. Atsiųskite mums tiekėjo srauto pavyzdį – į kiekvieną užklausą atsakome per 24 darbo valandas – ir pasakysime, ar jis susiejamas be kliūčių. Tiekėjų XML struktūros skiriasi: įdėtiniai laukai, vardų erdvės ir variantai elgiasi skirtingai, todėl tikras pavyzdys pasako daugiau nei aprašymas. Tada modulį sukonfigūruojame jūsų parduotuvės bandomojoje kopijoje, dar prieš paleidžiant importą gyvai.

Jei kuriate naują parduotuvę, Sparcley el. parduotuvė sukuriama maždaug per 5 savaites ir apima integraciją su 1 tiekėju arba iki 50 prekių įkėlimą.

Po paleidimo planas „Skaitmeninė priežiūra“ apima 4 darbo valandas per mėnesį, todėl importo ataskaitas galime ir toliau stebėti už jus kaip nuolatinės parduotuvės priežiūros dalį.