Automatické importy produktů

S funkcí Automatické importy produktů aktualizujete produkty v e-shopu pomocí XML feedu, ze kterého si systém v nastavených časech stahuje data. Můžete tak snadno propojit svůj e-shop s dodavatelem nebo více svých e-shopů navzájem. Nebudete muset hlídat změny na skladě a v cenách ani nahrávat soubory přes ruční import, funkce vše aktualizuje za vás.

S výběrem a objednáním rozšiřujících funkcí vám rádi poradíme na info@shoptet.cz.

Co jsou automatické importy produktů?

XML soubor (feed), ze kterého si systém data stahuje, musí být umístěn někde na internetu. Nastavit můžete i to, jaké hodnoty se mají aktualizovat, například jen počet kusů skladem podle dodavatele.

Feed musí být validní, tedy mít strukturu podle specifikace Relax NG. Více informací o validaci najdete v nápovědě XML Validace, včetně postupu pro případ, když XML soubor validací neprojde.

Rozlišujeme dva typy importů, oba používají stejný XML feed:

  • Úplný import probíhá u všech tarifů jednou denně, v jednom z 8 časových oken mezi 00:00 a 07:00.
  • Aktualizační import aktualizuje jen některé vlastnosti, například Sklad, Dostupnost nebo Cena, a jen u existujících produktů. Lze ho naplánovat mezi 08:00 a 23:00, i vícekrát denně. Počet aktualizací za den závisí na tarifu a platí pro všechny automatické importy dohromady:
TarifPočet dostupných aktualizací
Free, Basic1x
Business3x
Profi6x
Enterprise16x

Manuální spuštění importu je určené jen pro „krizové“ případy a je možné ho spustit 6x do měsíce.

Tip

S aktualizací zboží od dodavatelů vám pomůže doplněk NapojSe. Nebudete muset importovat produkty od každého dodavatele zvlášť. NapojSe vám je sloučí do jednoho souboru a zvládne ještě mnohem víc.

Jak import zpracovává feed

Prázdná hodnota ve feedu znamená „tuto hodnotu neměň", ne „smaž tuto hodnotu". Totéž platí pro prázdný tag v XML feedu.

Pokud potřebujete, aby prázdné hodnoty údaje v e-shopu smazaly, zapněte v detailu automatického importu v sekci Nastavení importu volbu Prázdné hodnoty v importu mažou údaje v e-shopu. Ve výchozím stavu je vypnutá. Na rozdíl od ručního importu, kde platí jen pro jedno nahrání, se tady uloží k profilu a platí při každém dalším stažení feedu.

Nový produkt, který ve feedu nemá vyplněnou značku VISIBILITY, se založí jako skrytý. Pokud mají být nové produkty na e-shopu vidět hned po importu, uveďte u nich hodnotu visible.

Varování

Import se zpracovává po dávkách po 100 produktech a každou dávku ukládá průběžně. Pokud se import zastaví kvůli chybě, produkty z už uložených dávek v e-shopu zůstanou a zbytek feedu se nenaimportuje. Katalog tak zůstane rozpracovaný. U automatických importů se to nepozná hned, proto doporučujeme výsledky importu kontrolovat.

Jak import zachází s prázdnými hodnotami, cenami a viditelností nových produktů a jaké kontroly provádí, najdete v článku Import produktů v sekci Pravidla importu.

Frontové zpracování

Zpracování obou typů importů je realizováno pomocí fronty úloh. To znamená, že požadavek na import (úplný i aktualizační) je vložen podle nastavení uživatele do fronty ke zpracovaní ve vybraném čase. To ovšem negarantuje čas spuštění. V rámci zajištění rovnoměrného rozložení zátěže na naše servery se automatické importy nespouštějí všechny najednou v celou hodinu, ale postupně během celé hodiny. Přesný čas spuštění importů je určen systémově a nelze jej měnit. Zkontrolovat si, v jakém čase má dojít ke spuštění vašeho importu, si můžete v administraci vašeho e-shopu v rozvrhu daného importu.

Info

Automatický import se spustí jen tehdy, pokud se XML feed od posledního importu změnil.

Přidání nového importu

Automatické importy produktů se nachází v sekci Produkty → Automatické importy. Pokud nemáte přidaný žádný automatický import, použijte tlačítko Přidat import. Jednotlivé importy se vám budou poté zobrazovat v tabulce a je jich možné přidat neomezené množství.

Automatické importy, záložka Přehled importů s tlačítkem Přidat import

U nového importu je potřeba vyplnit následující hodnoty:

  • Jméno: název importu pro odlišení.
  • Import kód: unikátní kód, podle kterého automatický import pozná, které produkty jím byly vytvořeny nebo aktualizovány. Hodnota je čistě na vás, ale v rámci ostatních automatických importů musí být unikátní.
  • Typ dodavatele: u běžných feedů ve specifikaci Relax NG zvolte Shoptet.
  • Výchozí dodavatel: pokud produkty nemají ve feedu uvedeného dodavatele, k produktům bude doplněn zvolený dodavatel.
  • URL adresa XML feedu: uvádějte URL adresu vašeho XML souboru, ten musí být ten musí být validní. Validace se provádí v detailu importu, budete tedy případně upozorněni, pokud nebude možné XML soubor nahrát.
Okno Přidat automatický import s poli pro jméno, import kód, dodavatele a URL feedu

Feed je zapotřebí nejprve validovat. Provedete to jednoduše v detailu jednotlivých importů, pomocí tlačítka Validovat.

Detail automatického importu se stavem feedu a tlačítkem Validovat

Základní nastavení

  • Jméno: název importu pro odlišení.
  • Import kód: unikátní kód, podle kterého automatický import pozná, které produkty jím byly vytvořeny nebo aktualizovány. Hodnota je čistě na vás, ale v rámci ostatních automatických importů musí být unikátní.
  • Typ dodavatele: standardně Shoptet.
  • Výchozí dodavatel: pokud produkty nemají ve feedu uvedeného dodavatele, k produktům bude doplněn zvolený dodavatel.
  • URL adresa XML feedu: uvádějte URL adresu vašeho XML souboru, ten musí být validní. Validace však ještě projde kontrolou, budete tedy případně upozorněni, pokud nebude možné XML soubor nahrát.
Detail automatického importu, záložka Nastavení se sekcemi Základní nastavení a Nastavení importu
  • Tlačítko Uložit: má stejnou funkci jako jinde v administraci, ukládá změněné hodnoty na stránce.
  • Tlačítko Spustit manuálně: tato možnost je dostupná pouze 6x za měsíc a slouží jako záloha, pokud potřebujete provést import produktů ihned, například kvůli chybným datům.
  • Tlačítko Zapnout / Zakázat: spouští nebo vypíná automatickou aktualizaci, můžete tedy stahování souboru kdykoli přerušit.
  • Tlačítko Smazat: odebere daný automatický import.

Nastavení importu

  • Párovat produkty podle: zde je možné vybrat, podle jaké hodnoty se mají produkty aktualizovat. Na výběr jsou dvě možnosti: Kód produktu / EAN kód.
  • Cenový koeficient: pole využijete, pokud chcete navýšit prodejní cenu, která je posílána v souboru. Je možné ji navýšit i snížit. Hodnota se poté zadává pomocí desetinné čárky, výchozí hodnota je 1, která odpovídá hodnotě 100 %. Pokud budete chtít nastavit prodejní ceny například o 10 % dráž, stačí do tohoto pole uvést 1,1.
  • Výchozí sklad: sklad, ve kterém bude pro produkty z feedu aktualizované množství. Jedná se o nastavení pro případ, kdy e-shop používá více skladů a množství pro konkrétní sklady není v xml feedu definováno.
  • Produkty chybějící ve feedu: určujete, co se má stát s produkty, které se v souboru už nevyskytují. Týkat se to může například produktů, které dodavatel nenabízí. Jsou zde čtyři možnosti: Ponechat nezměněné / Smazat produkt / Skrýt produkt / Nezobrazovat v navigaci e-shopu.
  • Aktualizovat produkty: nastavujete, které produkty se mají aktualizovat:
    • Všechny – z feedu se nahrají nové produkty a aktualizují se všechny existující
    • Pouze nové – z feedu se pouze nahrají nové produkty
    • Pouze existujicí – z feedu se aktualizují údaje u již existujících produktů a nenahrají se žádné nové produkty
  • Zahrnout do kategorie: název kategorie, do které se budou nahrávat nové produkty ze souboru. Volbu nastavujete v případě, že jsou v souboru uvedeny jiné kategorie, než potřebujete. Aby nedocházelo k přepisování kategorií, je třeba pro úplný import ponechat volbu aktualizace kategorií neaktivní.
  • Prázdné hodnoty v importu mažou údaje v e-shopu: pokud volbu zapnete, prázdná hodnota ve feedu smaže údaj v e-shopu. Ve výchozím stavu je vypnutá a prázdné hodnoty se přeskakují. Více v sekci Jak import zpracovává feed.

Rozvrh

Upozornění

Nelze nastavit více importů na stejné hodiny, pokud tedy chcete aktualizovat dva a více importů, je potřeba vybírat z jiných dostupných hodin.

Na této záložce se určuje, kdy se má automatický import aktualizovat, ať už jde o kompletní nebo o aktualizační.

  • Rozvrh úplného importu: můžete aktualizaci vypnout (první hodnota ve výběru) nebo nastavit čas aktualizace, jsou zde k dispozici časy 00:00 a 07:00, a to po každé hodině. Import se tedy provádí pouze jednou denně.
  • Rozvrh aktualizačního importu: na výběr jsou zde časy od 08:00 do 23:00. V závislosti na tarifu lze vybrat více časů, u tarifu Enterprise ho můžete nastavit až na 16x za den (možnosti aktualizací jsou rozlišeny tarifově = 1x Free, Basic, 3x Business, 6x Profi a až 16x Enterprise).
    • Tato hodnota je však společná pro všechny feedy, tedy např. u třech automatických importů to budou 4 časová "okna" využitelná pro jednotlivé aktualizace (v případě, že chcete dělat aktualizace rovnoměrně pro všechny 3 feedy).
Detail automatického importu, záložka Rozvrh s rozvrhem úplného a aktualizačního importu

Položky importu

Jedná se o nastavení, z jakých elementů má systém stahovat informace a ty následně aktualizovat u produktů. Pokud se jedná o nový produkt v souboru, prvotně se nahrají všechny údaje uvedené v XML souboru, poté se bude aktualizovat dle tohoto nastavení.

Tip

Povinné hodnoty pro nové produkty jsou stejné jako v případě ručních importů. Pro založení produktů je nutné v souboru uvést kód, jméno produktu a jeho cenu.

  • Úplný import: probíhá pouze jednou denně a je možné zde vybrat ze všech možností.
  • Aktualizační import: probíhá vícekrát denně v závislosti na tarifu. Vybrat můžete pouze z některých možností, kvůli rychlosti aktualizace.

Externí ID

Tato značka (EXTERNAL_ID), resp. její hodnota, pomáhá spárovat varianty s konkrétním produktem. Při jejím použití odpadá nutnost v souboru XML uvádět vždy ostatní varianty. Políčko může obsahovat znaky 0–9 a A–Z.

Mezi položkami automatických importů se nenachází, aktualizuje se vždy, pokud je v tomto políčku uvedena hodnota.

Import dalších ceníků

Automatický import dokáže pracovat i s více ceníky a podle nich upravovat ceny v příslušných cenících na e-shopu. Aby import dalších ceníků proběhl správně, je nutné, aby se názvy ceníků uvedených v XML souboru shodovaly s názvy ceníků založenými na e-shopu.

Podmínkou pro vytvoření dalších ceníků je nainstalovaná funkce Velkoobchod. Zápis dalších ceníků v XML struktuře vypadá následovně:

<PRICELISTS>
   <PRICELIST>
     <TITLE>Název ceníku</TITLE>
     ...
   </PRICELIST>
</PRICELISTS>

Kompletní zápis produktu se všemi použitelnými značkami, včetně značek platných v rámci importu dalších ceníků, najdete uvedený ve vzorovém XML souboru.

Tabulka položek Úplného importu

Upozornění

Soubor (feed) v XML formátu musí být validní. To znamená, že jeho struktura musí být dle specifikace Relax NG. Více informací o validaci najdete v nápovědě XML Validace, včetně postupu pro případ, když XML soubor validací neprojde. V tabulce níže je uveden pouze výčet elementů. 

Název poleNázev elementu v XML feeduVysvětlení
KódCODEKód produktu nebo variant. Mezi volitelnými políčky k aktualizaci se nenachází. Párují se podle něj produkty při automatickém importu. Povolené znaky pro kód produktu jsou A–Z, 0–9 a speciální znaky _ /-. mezera.
NázevNAMENázev produktu.
Doplněk k názvuAPPENDIXDoplněk názvu produktu. Lze do něj propisovat akční nabídky a dárky, více informací najdete v článku Doplněk produktu a dárky.
URLORIG_URLURL adresa, na které se produkt nachází. Pokud je volba aktivní dochází ke změně URL adres podle názvu produktu. Při změně URL adresy je automaticky založeno přesměrování z původní URL adresy. Pokud volba aktivní není, URL adresa se při změně názvu produktu nemění. 
DodavatelSUPPLIERDodavatel produktu. I když feed od dodavatele neobsahuje tuto značku, můžete dodavatele k produktu přidat v detailu produktu na e-shopu. 
Kód výrobceEXTERNAL_CODEKód výrobce produktu nebo varianty.
EANEANEAN kód produktu. Produkty při automatickém importu je možné rovněž podle EAN kódu párovat.
PLUPLUPLU (kód pro dohledání ceny) produktu nebo varianty.
ISBN kódPRODUCT_NUMBERProduktové číslo produktu nebo varianty.
Sériové čísloSERIAL_NUMBERSériové číslo produktu nebo varianty.
Číslo dílu výrobce (MPN)PART_NUMBERČíslo dílu výrobce (MPN) u produktu nebo varianty.
SadySET_ITEMSSlouží pro výčet jednotlivých položek sady. Pro správné nahrání je třeba jako Druh položky (ITEM_TYPE) uvést hodnotu set. 
CenaPRICE / PRICE_VAT / (VAT)Cena produktu – je možné odlišit, jestli je cena bez DPH (PRICE), nebo včetně DPH (PRICE_VAT). Volitelně můžete v elementu VAT specifikovat výši sazby DPH u produktu.
Akční cenaACTION_PRICEZlevněná cena produktu, která se zobrazuje místo prodejní ceny. 
Nákupní cenaPURCHASE_PRICENákupní cena produktu, z té se následně vypočítává marže a zisk.
DPH nákupní cenyPURCHASE_VATVýše DPH u nákupní ceny
Nákupní cena včetně / bez DPHPURCHASE_PRICE_INCL_VATHodnoty 0/1: 0 – nákupní cena je bez DPH; 1 – nákupní cena je včetně DPH
Standardní cenaSTANDARD_PRICEPůvodní cena produktu. Je-li vyplněna a zobrazení povoleno, na e-shopu se zobrazuje rozdíl původní a současné ceny.
Desetinné místo DECIMAL_COUNTDefinuje počet možných desetinných míst pro produkt. Použít lze pro položky prodávané na váhu nebo po metrech. 
SkladSTOCKNadřazený tag, pro počet kusů, minimální a maximální objednatelné množství.
Krátký popisSHORT_DESCRIPTIONKrátký popis produktu, je možné uvádět včetně html značek.
JednotkaUNITUrčuje, v jaké jednotce je produkt uveden, výchozí jednotkou jsou kusy.
ViditelnostVISIBILITYSkrývání a zobrazování produktu – hodnota hidden produkt skryje, hodnota visible ho zobrazí. Pokud hodnotu u nového produktu neuvedete, založí se jako skrytý. Další možné hodnoty: blocked – zamezí objednání produktu; showRegistered – produkt je viditelný pouze pro registrované uživatele; blockUnregistered – produkt nelze zakoupit, pokud zákazník není registrován; cashDeskOnly – zobrazit jen na pokladně; detailOnly – nezobrazovat v navigaci e-shopu.
ZárukaWARRANTYDefinuje záruku produktu, co je uvedeno v tagu, to se zobrazí na e-shopu.
Stav zboží ITEM_CONDITION > GRADEInformace o stavu bazarového zboží určená pro Zboží.cz. Povolené hodnoty jsou used – použité; refurbished – repasované; open_box – rozbalené. 
Popis stavu ITEM_CONDITION > DESCRIPTIONInformace o stavu bazarového zboží určená pro Zboží.cz. Podrobnější popis stavu produktu. Neslouží pro popis produktu. 
Hmotnost LOGISTIC > WEIGHTUrčuje, hmotnost produktu, jednotky jsou nastaveny na kg.
Šířka LOGISTIC > WIDTHŠířka balení. 
Výška LOGISTIC > HEIGHTVýška balení. 
Délka LOGISTIC > DEPTHDélka balení. 
HS kódHS_CODEHS kód (Harmonized System), tedy celní sazební kód zboží. Používá se při celním odbavení zboží ze zemí mimo EU. Pole se nastavuje na úrovni produktu a může zůstat prázdné. Vyplněná hodnota musí obsahovat pouze 6 až 10 číslic. Pokud import obsahuje hodnotu v neplatném formátu (6 až 10 číslic), přeskočí se pouze HS kód a ostatní údaje produktu se aktualizují.
Omezení výdejních boxů LOGISTIC > BOX_RESTRICTIONHodnoty: 0/1. Je-li aktivní, zákazník nebude moci vybrat výdejní box v košíku. Toto omezení nemusí podporovat veškeré externí přepravní metody a přepravce.
MěnaCURRENCYMěna v mezinárodním formátu (CZK, EUR atp.).
KategorieCATEGORYUrčuje, do jaké kategorie produkt patří, může být použito vícekrát. Pokud se kategorie ve feedu a na e-shopu liší, je třeba aktualizaci kategorií zakázat. 
PopisDESCRIPTIONPodrobný popis produktu, může obsahovat i html značky. Maximální počet povolených znaků 32767.
PříznakyFLAGS Akce, Tip, Novinka jsou tři příznaky, které je k produktu možné přiřadit.
Doprava zdarmaFREE_SHIPPINGUrčuje je pro produkt doprava zdarma povolena. Příznak doprava zdarma má vliv na cenu dopravy nebo platby.
ObrázkyIMAGESObrázek musí být nahrán někde na internetu a mít svou URL adresu, aby se mohl stáhnout a na e-shopu zobrazit.
Informační parametryINFORMATION_PARAMETERSJedná se o parametry pro filtrování, pomocí kterých lze vytvořit parametrický filtr.
ParametryPARAMETERSVarianty produktu, je možné uvádět až 3 různé hodnoty variant.
VlastnostiTEXT_PROPERTIESPopisné parametry, zde se zadávají informace o produktu (materiál, barva, atp).
Druh položkyITEM_TYPEUrčuje, jestli se jedná o produkt, bazarový produkt, sadu nebo službu. Hodnoty jsou product, bazaar, set, service.
VýrobceMANUFACTURERVýrobce (značka) produktu.
Maximální množstvíMAXIMAL_AMOUNTMaximální počet kusů pro objednání produktu, musí být zařazen pod tag STOCK.
Minimální množstvíMINIMAL_AMOUNTMinimální počet kusů pro objednání produktu, musí být zařazen pod tag STOCK.
Nákup do minusuNEGATIVE_AMOUNTUvádí, jestli lze produkt nakupovat i do minusových skladových zásob.
Množství a pozice na skladě

AMOUNT

LOCATION

Přenáší počet kusů skladem a pozici zboží na skladě, pro správnou aktualizaci je potřeba mít zaškrtnutou i volbu Sklad.
DostupnostAVAILABILITYDostupnost, lze dělit podle skladového hospodářství. Pokud je na e-shopu aktivní jsou dvě dostupnosti: AVAILABILITY_IN_STOCK a AVAILABILITY_OUT_OF_STOCK.
Podobné produktyALTERNATIVE_PRODUCTSDefinují se pomocí kódu produktu, možnost použít vícekrát.
Dárky k produktuGIFTSDefinují se pomocí kódu produktu, možnost použít vícekrát.
Související produktyRELATED_PRODUCTSDefinují se pomocí kódu produktu, možnost použít vícekrát.
Související videaRELATED_VIDEOSDefinují se pomocí URL adresy, možnost použít vícekrát. 
Související souboryRELATED_FILESDefinují se pomocí URL adresy, možnost použít vícekrát. 
Atypická dopravaATYPICAL_SHIPPINGDefinuje, jestli produkt vyžaduje atypickou dopravu a jestli se tedy u produktu v košíku objeví atypický dopravce.
Atypická platbaATYPICAL_BILLINGDefinuje, jestli produkt vyžaduje atypickou platbu a jestli se tedy u produktu v košíku objeví atypická platba.
Nezobrazovat na HeureceHEUREKA_HIDDENVyloučí produkt z Heureka XML feedu a produkt nebude na Heureka.cz nabízen. 
Nezobrazovat v Heureka MarketplaceHEUREKA_CART_HIDDENVyloučí produkt z nabídky v Heureka Marketplace. 
Heureka CPCHEUREKA_CPCMaximální cena prokliku na Heureka.cz. 
Nezobrazovat na Zboží.czZBOZI_HIDDENUrčuje, jestli bude produkt na Zboží.cz zobrazen. 
Zboží.cz CPCZBOZI_CPCMaximální cena za proklik ve fulltextovém vyhledávání Zboží.cz
Zboží.cz CPC (vyhledávání)ZBOZI_SEARCH_CPCMaximální cena prokliku na Zboží.cz
Heureka kategorie na úrovni produktuHEUREKA_CATEGORY_IDID kategorie napárované na úrovni produktu pro Heureka.cz.
Zboží.cz kategorie na úrovni produktuZBOZI_CATEGORY_IDID kategorie napárované na úrovni produktu pro Zboží.cz.
ID Google kategorieGOOGLE_CATEGORY_IDID kategorie napárované na úrovni produktu pro Google Nákupy.
Glami kategorie na úrovni produktuGLAMI_CATEGORY_IDID kategorie napárované na úrovni produktu pro Glami.
Příplatkové parametrySURCHARGES_PARAMETRESPříplatkové parametry. 
OSS sazbyOSS_TAX_RATESZvláštní daňová sazba OSS pro různé země. Více v Zvláštní daňové režimy OSS a Reverse charge.

Tabulka položek Aktualizačního importu

Název poleNázev elementu v XML feeduVysvětlení
CenaPRICE / PRICE_VAT / (VAT)Cena produktu – je možné odlišit, jestli je cena bez DPH (PRICE), nebo včetně DPH (PRICE_VAT). Volitelně můžete v elementu VAT specifikovat výši sazby DPH u produktu.
Akční cenaACTION_PRICEZlevněná cena produktu, která se zobrazuje místo prodejní ceny. 
Nákupní cenaPURCHASE_PRICENákupní cena produktu, z té se následně vypočítává marže a zisk.
Standardní cenaSTANDARD_PRICEPůvodní cena produktu, je-li vyplněna, na e-shopu se zobrazuje rozdíl původní a současné ceny.
ViditelnostVISIBILITYSkrývání a zobrazování produktu – hodnota hidden produkt skryje, hodnota visible je výchozí stav, produkt bude vidět. Další možné hodnoty: blocked – zamezí objednání produktu; showRegistered – produkt je viditelný pouze pro registrované uživatele; blockUnregistered – produkt nelze zakoupit, pokud zákazník není registrován; cashDeskOnly – zobrazit jen na pokladně; detailOnly – nezobrazovat v navigaci e-shopu.
Maximální množstvíMAXIMAL_AMOUNTMaximální počet kusů pro objednání produktu, musí být zařazen pod tag STOCK.
Minimální množstvíMINIMAL_AMOUNTMinimální počet kusů pro objednání produktu, musí být zařazen pod tag STOCK.
Nákup do minusuNEGATIVE_AMOUNTUvádí, jestli lze produkt nakupovat i do minusových skladových zásob.
Množství a pozice na skladě

AMOUNT

LOCATION

Přenáší počet kusů skladem a pozici zboží na skladě, pro správnou aktualizaci je potřeba mít zaškrtnutou i volbu Sklad.
DostupnostAVAILABILITYDostupnost, lze dělit podle skladového hospodářství. Pokud je na e-shopu aktivní jsou dvě dostupnosti: AVAILABILITY_IN_STOCK a AVAILABILITY_OUT_OF_STOCK.
Atypická dopravaATYPICAL_SHIPPINGDefinuje, jestli produkt vyžaduje atypickou dopravu a jestli se tedy u produktu v košíku objeví atypický dopravce.
Atypická platbaATYPICAL_BILLINGDefinuje, jestli produkt vyžaduje atypickou platbu a jestli se tedy u produktu v košíku objeví atypická platba.