Automatické importy produktov

S doplnkom Automatické importy produktov aktualizujete produkty v e-shope pomocou XML feedu, z ktorého si systém v nastavených časoch sťahuje dáta. Môžete tak ľahko prepojiť svoj e-shop s dodávateľom alebo viac svojich e-shopov navzájom. Nebudete musieť strážiť zmeny na sklade a v cenách ani nahrávať súbory cez ručný import, doplnok všetko aktualizuje za vás.

S výberom a objednaním doplnku vám radi poradíme na info@shoptet.sk.

Čo sú automatické importy produktov?#

XML súbor (feed), z ktorého si systém dáta sťahuje, musí byť umiestnený niekde na internete. Nastaviť môžete aj to, aké hodnoty sa majú aktualizovať, napríklad len počet kusov skladom podľa dodávateľa.

Feed musí byť validný, teda mať štruktúru podľa špecifikácie Relax NG. Viac informácií o validácii nájdete v pomocníkovi XML Validácia, vrátane postupu pre prípad, kedy XML súbor validáciou neprejde.

Rozlišujeme dva typy importov, oba používajú rovnaký XML feed:

• Úplný import prebieha pri všetkých tarifách raz denne, v jednom z 8 časových okien medzi 00:00 a 07:00.
• Aktualizačný import aktualizuje len niektoré vlastnosti, napríklad Sklad, Dostupnosť alebo Cenu, a len pri existujúcich produktoch. Je možné ho naplánovať medzi 08:00 a 23:00, aj viackrát denne. Počet aktualizácií za deň závisí od tarify a platí pre všetky automatické importy dohromady:

Manuálne spustenie importu je určené len pre „krízové“ prípady a je možné ho spustiť 6x do mesiaca.

Ako import spracováva feed#

Prázdna hodnota vo feede znamená „túto hodnotu nemeň", nie „vymaž túto hodnotu". To isté platí pre prázdny tag v XML feede.

Ak potrebujete, aby prázdne hodnoty údaje v e-shope vymazali, zapnite v detaile automatického importu v sekcii Nastavenie importu voľbu Prázdne hodnoty v importe mažú údaje v e-shope. Vo východiskovom stave je vypnutá. Na rozdiel od ručného importu, kde platí len pre jedno nahranie, sa tu uloží k profilu a platí pri každom ďalšom stiahnutí feedu.

Nový produkt, ktorý vo feede nemá vyplnenú značku VISIBILITY, sa založí ako skrytý. Ak majú byť nové produkty na e-shope viditeľné hneď po importe, uveďte pri nich hodnotu visible.

Ako import zaobchádza s prázdnymi hodnotami, cenami a viditeľnosťou nových produktov a aké kontroly vykonáva, nájdete v článku Import produktov v sekcii Pravidlá importu.

Frontové spracovanie#

Spracovanie oboch typov importov je realizované pomocou fronty úloh. To znamená, že požiadavka na import (úplný aj aktualizačný) je vložená podľa nastavenia používateľa do fronty na spracovanie vo vybranom čase. To však negarantuje čas spustenia. V rámci zabezpečenia rovnomerného rozloženia záťaže na naše servery sa automatické importy nespúšťajú všetky naraz na celú hodinu, ale postupne počas celej hodiny. Presný čas spustenia importov je určený systémovo a nemožno ho meniť. Skontrolovať, v akom čase má dôjsť k spusteniu vášho importu, si môžete v administrácii vášho e-shopu v rozvrhu daného importu.

Pridanie nového importu#

Automatické importy produktov sa nachádzajú v sekcii Produkty → Automatické importy. Pokiaľ nemáte pridaný žiadny automatický import, použite tlačidlo Pridať import. Jednotlivé importy sa vám budú potom zobrazovať v tabuľke a je ich možné pridať neobmedzené množstvo.

Pri novom importe je potrebné vyplniť štyri hodnoty:

• Meno: pomenovanie, aby ste od seba importy boli schopný odlíšiť.
• Import kód: unikátny kód, podľa ktorého automatický import pozná, ktoré produkty boli vytvorené či aktualizované. Hodnota je čisto na vás, ale je potrebné, aby nebola použitá u ostatných automatických importov.
• Typ dodávateľa: štandardne Shoptet.
• Predvolený dodávateľ: pokiaľ produkty nemajú vo feede uvedeného dodávateľa, k produktom bude doplnený zvolený dodávateľ.
• URL adresa XML feedu: uvádzajte URL adresu vášho XML súboru, ten musí byť validný. Validácia sa vykonáva v detaile importu, budete teda prípadne upozornený, pokiaľ nebude možné XML súbor nahrať.

Feed je potrebné najskôr validovať. Vykonáte to jednoducho v detaile jednotlivých importov, pomocou rovnomenného tlačidla.

Základné nastavenia#

• Meno: názov importu pre odlíšenie.
• Import kód: unikátny kód, podľa ktorého automatický import vie, ktoré produkty ním boli vytvorené či aktualizované. Hodnota je čisto na vás, ale v rámci ostatných automatických importov musí byť unikátny.
• Typ dodávateľa: štandardne Shoptet.
• Predvolený dodávateľ: pokiaľ produkty nemajú vo feede uvedeného dodávateľa, k produktom bude doplnený zvolený dodávateľ.
• URL adresa XML feedu: uvádzajte URL adresu vášho XML súboru, ten musí byť validný. Feed však ešte prejde kontrolou, budete teda prípadne upozornený, pokiaľ nebude možné XML súbor nahrať.

• Tlačidlo Uložiť: má rovnakú funkciu, ako inde v administrácii, ukladá zmenené hodnoty na stránke.
• Tlačidlo Spustiť manuálne: táto možnosť je dostupná iba 6x za mesiac a slúži ako záloha, pokiaľ potrebujete vykonať import produktov ihneď, napríklad kvôli chybným dátam.
• Tlačidlo Zapnúť / Vypnúť: spúšťa či vypína automatickú aktualizáciu, môžete teda sťahovanie súboru kedykoľvek prerušiť.
• Tlačidlo Zmazať: odoberie daný automatický import.

Nastavenie importu#

• Párovať produkty podľa: tu je možné, vybrať podľa akej hodnoty sa majú produkty aktualizovať, na výber sú dve možnosti: Kód produktu / EAN kód.
• Cenový koeficient: toto pole je určené, pokiaľ chcete navýšiť predajnú cenu, ktorá je posielaná v súbore, je možné ju navýšiť, ale aj znížiť. Hodnota sa potom zadáva pomocou desatinnej čiarky, predvolená hodnota je 1, ktorá odpovedá hodnote 100 %. Pokiaľ budete chcieť nastaviť predajné ceny napríklad o 10 % drahšie, stačí do tohto poľa uviesť 1,1.
• Predvolený sklad: sklad v ktorom sa bude aktualizovať skladové množstvo tovaru v prípade, že e-shop využíva viac skladov a konkrétne sklady v importovanom feede nie sú definované
• Produkty chýbajúce vo feede: určujete, čo sa má stať s produktami, ktoré sa v súbore už nevyskytujú (napríklad produkty, ktoré dodávateľ už neponúka). Sú tu štyri možnosti: Ponechať nezmenené / Zmazať produkt / Skryť produkt / Nezobrazovať v navigácii e-shopu.
• Aktualizovať produkty: nastavujete, ktoré produkty sa majú aktualizovať:
  • Všetky – z feedu sa nahrajú nové produkty a aktualizujú sa všetky existujúce
  • Len nové – z feedu sa nahrajú iba nové produkty
  • Iba existujúce – z feedu sa aktualizujú údaje už existujúcich produktov a nenahrajú sa žiadne nové produkty
• Zahrnúť do kategórie: do tohto políčka sa uvádza názov kategórie, do ktorej sa budú nahrávať nové produkty zo súboru. Voľbu nastavujete v prípade, že sú v súbore uvedené iné kategórie, než potrebujete. Aby nedochádzalo k prepisovaniu kategórií, je potrebné pre úplný import ponechať voľbu aktualizácie kategórií neaktívnu.
• Prázdne hodnoty v importe mažú údaje v e-shope: ak voľbu zapnete, prázdna hodnota vo feede vymaže údaj v e-shope. Vo východiskovom stave je vypnutá a prázdne hodnoty sa preskakujú. Viac v sekcii Ako import spracováva feed.

Rozvrh#

Na tejto záložke sa určuje, kedy sa má automatický import aktualizovať, nech už ide o kompletný alebo o aktualizačný.

• Rozvrh úplného importu: môžete aktualizáciou vypnúť (prvá hodnota vo výbere) alebo nastaviť čas aktualizácie, sú tu k dispozícii časy 00:00 až 07:00 a to po každej hodine. Import sa teda vykonáva iba jedenkrát denne.
• Rozvrh aktualizačného importu: na výber sú tu ostatné hodiny, teda od 08:00 do 23:00, a je možné ich nastaviť na častejšie aktualizácie. Maximálny počet sa môže líšiť podľa vašej tarify, kde napríklad u tarify Enterprise ho môžete nastaviť až na 16x za deň (možnosti aktualizácií sú rozlíšené tarifovo = 1x Free, Basic, 3x Business, 6x Profi a až 16x Enterprise). Táto hodnota je však spoločná pre všetky feedy, teda napr. u troch automatických importov to budú 4 časové "okná" využiteľné pre jednotlivé aktualizácie (v prípade, že chcete robiť aktualizácie rovnomerne pre všetky 3 feedy).

Položky importu#

Jedná sa o nastavenie, z akých elementov má systém sťahovať informácie a tie aktualizovať pri produktoch, pokiaľ ide o nový produkt v súbore, prvotne sa nahrajú všetky údaje uvedené v XML súbore, až potom sa bude aktualizovať podľa tohto nastavenia.

• Úplný import: prebieha iba jedenkrát denne a je tu možné vybrať zo všetkých možností.
• Aktualizačný import: prebieha viackrát denne v závislosti od tarify. Vybrať môžete iba z niektorých možností, kvôli rýchlosti aktualizácie.

Externé ID#

Táto značka (EXTERNAL_ID), resp. jej hodnota, pomáha spárovať varianty s konkrétnym produktom. Pri jej použití odpadá nutnosť v súbore XML uvádzať vždy ostatné varianty. Políčko môže obsahovať znaky 0-9 a A-Z.

Medzi položkami automatických importov sa nenachádza, aktualizuje sa vždy, pokiaľ je v tomto políčku uvedená hodnota.

Import ďalších cenníkov#

Automatický import dokáže pracovať aj s viacerými cenníkmi a podľa nich upravovať ceny v príslušných cenníkoch na e-shope. Aby import ďalších cenníkov prebehol správne, je potrebné, aby sa názvy cenníkov uvedených v XML súbore zhodovali s názvami cenníkov založenými na e-shope.

Podmienkou pre vytvorenie ďalších cenníkov je doplnok Veľkoobchod. Zápis ďalších cenníkov v XML štruktúre vyzerá nasledovne:

<PRICELISTS>
   <PRICELIST>
     <TITLE>Názov cenníku</TITLE>
     ...
   </PRICELIST>
</PRICELISTS>

Kompletný zápis produktu so všetkými použiteľnými značkami, vrátane značiek platných v rámci importu ďalších cenníkov, nájdete uvedené vo vzorovom XML súbore.

Tabuľka položiek Úplného importu#

Tabuľka položiek Aktualizačného importu#