S doplňkem Automatické importy produktů získáte užitečný nástroj pro aktualizaci dat pomocí XML feedu. Můžete snadno propojit svůj e-shop s dodavatelem nebo více vašich e-shopů navzájem. Nebudete muset hlídat změny na skladě a v cenách, doplněk vše aktualizuje za vás.
S výběrem a objednáním doplňku vám rádi poradíme na info@shoptet.cz.
Pomocí aktualizačních importů je možné aktualizovat informace jako je Sklad, Dostupnost nebo Cena. Máte k dispozici 16 různých časových oken, které můžete využít pro naplánování aktualizací mezi jednotlivými feedy v rámci jednoho dne (zde jsou maximální četnosti aktualizací rozlišeny dle vašich tarifů = 1x Free, Basic, 3x Business, 6x Profi a až 16x u tarifu Enterprise).
Úplný automatický import probíhá u všech tarifů jedenkrát denně, je možné vybrat z 8 časových oken.
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.
Jedná se o možnost aktualizace produktů za pomoci XML souboru, ze kterého si bude systém v daném časovém okně stahovat informace. Soubor tedy musí být umístěn někde na internetu.
Můžete aktualizovat své produkty jednoduše bez nutnosti nahrávat je přes manuální import dat. Dále lze nastavit, jaké hodnoty se mají aktualizovat, například jen počet kusů skladem přímo podle dodavatele.
Soubor (feed) ve 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.
Rozlišujeme mezi úplným importem, který probíhá 1x denně mezi 00:00 až 07:00 a aktualizačním importem, který lze naplánovat od 08:00 do 23:00. Oba importy používají stejný dodavatelský XML feed, ale aktualizační import aktualizuje pouze některé vlastnosti a pouze u existujících produktů.
Pro aktualizace skladu, které je třeba provést častěji než 1x denně, slouží aktualizační importy, těch může být až 16 v nejvyšším tarifu Enterprise. Hodnota daná tarifem se vztahuje na všechny automatické importy dohromady.
Tarif | Počet dostupných aktualizací |
---|---|
Free, Basic | 1x |
Business | 3x |
Profi | 6x |
Enterprise | 16x |
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.
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 (slot). To ovšem negarantuje čas spuštění. Úlohy z fronty jsou zpracovávány několika souběžně běžícími procesy, jejichž počet se během dne může měnit. Může se tedy stát, že úplné importy naplánované na 01:00 proběhnou až okolo 3:00.
Automatické importy produktů se nachází v sekci Produkty → Automatické importy (obrázek 01). 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í.
U nového importu je potřeba vyplnit následující hodnoty (obrázek 02):
Feed je zapotřebí nejprve validovat. Provedete to jednoduše v detailu jednotlivých importů, pomocí tlačítka Validovat (obrázek 03).
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í (obrázek 05).
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í.
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.
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.
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ý doplněk 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.
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 pole | Název elementu v XML feedu | Vysvětlení |
---|---|---|
Kód | CODE | Kó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ázev | NAME | Název produktu. |
Doplněk k názvu | APPENDIX | Doplně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. |
URL | URL | URL 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í. |
Dodavatel | SUPPLIER | Dodavatel 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ýrobce | EXTERNAL_CODE | Kód výrobce produktu nebo varianty. |
EAN | EAN | EAN kód produktu. Produkty při automatickém importu je možné rovněž podle EAN kódu párovat. |
PLU | PLU | PLU (kód pro dohledání ceny) produktu nebo varianty. |
ISBN kód | PRODUCT_NUMBER | Produktové číslo produktu nebo varianty. |
Sériové číslo | SERIAL_NUMBER | Sériové číslo produktu nebo varianty. |
Číslo dílu výrobce (MPN) | PART_NUMBER | Číslo dílu výrobce (MPN) u produktu nebo varianty. |
Sady | SET_ITEMS | Slouží 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. |
Cena | PRICE / 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í cena | ACTION_PRICE | Zlevněná cena produktu, která se zobrazuje místo prodejní ceny. |
Nákupní cena | PURCHASE_PRICE | Nákupní cena produktu, z té se následně vypočítává marže a zisk. |
Standardní cena | STANDARD_PRICE | Pů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_COUNT | Definuje 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. |
Sklad | STOCK | Nadřazený tag, pro počet kusů, minimální a maximální objednatelné množství. |
Krátký popis | SHORT_DESCRIPTION | Krátký popis produktu, je možné uvádět včetně html značek. |
Jednotka | UNIT | Určuje, v jaké jednotce je produkt uveden, výchozí jednotkou jsou kusy. |
Viditelnost | VISIBILITY | Skrý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. |
Záruka | WARRANTY | Definuje záruku produktu, co je uvedeno v tagu, to se zobrazí na e-shopu. |
Stav zboží | ITEM_CONDITION > GRADE | Informace 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 > DESCRIPTION | Informace o stavu bazarového zboží určená pro Zboží.cz. Podrobnější popis stavu produktu. Neslouží pro popis produktu. |
Hmotnost | LOGISTIC > WEIGHT | Určuje, váhu produktu, jednotky jsou nastaveny na kg. |
Šířka | LOGISTIC > WIDTH | Šířka balení. |
Výška | LOGISTIC > HEIGHT | Výška balení. |
Délka | LOGISTIC > DEPTH | Délka balení. |
Měna | CURRENCY | Měna v mezinárodním formátu (CZK, EUR atp.). |
Kategorie | CATEGORY | Urč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. |
Popis | DESCRIPTION | Podrobný popis produktu, může obsahovat i html značky. Maximální počet povolených znaků 32767. |
Příznaky | FLAGS | Akce, Tip, Novinka jsou tři příznaky, které je k produktu možné přiřadit. |
Doprava zdarma | FREE_SHIPPING | Určuje je pro produkt doprava zdarma povolena. Příznak doprava zdarma má vliv na cenu dopravy nebo platby. |
Obrázky | IMAGES | Obrá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í parametry | INFORMATION_PARAMETERS | Jedná se o parametry pro filtrování, pomocí kterých lze vytvořit parametrický filtr. |
Parametry | PARAMETERS | Varianty produktu, je možné uvádět až 3 různé hodnoty variant. |
Vlastnosti | TEXT_PROPERTIES | Popisné parametry, zde se zadávají informace o produktu (materiál, barva, atp). |
Druh položky | ITEM_TYPE | Určuje, jestli se jedná o produkt, bazarový produkt, sadu nebo službu. Hodnoty jsou product, bazaar, set, service. |
Výrobce | MANUFACTURER | Výrobce (značka) produktu. |
Maximální množství | MAXIMAL_AMOUNT | Maximální počet kusů pro objednání produktu, musí být zařazen pod tag STOCK. |
Minimální množství | MINIMAL_AMOUNT | Minimální počet kusů pro objednání produktu, musí být zařazen pod tag STOCK. |
Nákup do minusu | NEGATIVE_AMOUNT | Uvádí, jestli lze produkt nakupovat i do minusových skladových zásob. |
Množství | AMOUNT | Přenáší počet kusů skladem, pro správnou aktualizaci je potřeba mít zaškrtnutou i volbu Sklad. |
Dostupnost | AVAILABILITY | Dostupnost, 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é produkty | ALTERNATIVE_PRODUCTS | Definují se pomocí kódu produktu, možnost použít vícekrát. |
Dárky k produktu | GIFTS | Definují se pomocí kódu produktu, možnost použít vícekrát. |
Související produkty | RELATED_PRODUCTS | Definují se pomocí kódu produktu, možnost použít vícekrát. |
Související videa | RELATED_VIDEOS | Definují se pomocí URL adresy, možnost použít vícekrát. |
Související soubory | RELATED_FILES | Definují se pomocí URL adresy, možnost použít vícekrát. |
Atypická doprava | ATYPICAL_SHIPPING | Definuje, jestli produkt vyžaduje atypickou dopravu a jestli se tedy u produktu v košíku objeví atypický dopravce. |
Atypická platba | ATYPICAL_BILLING | Definuje, jestli produkt vyžaduje atypickou platbu a jestli se tedy u produktu v košíku objeví atypická platba. |
Nezobrazovat na Heurece | HEUREKA_HIDDEN | Vyloučí produkt z Heureka XML feedu a produkt nebude na Heureka.cz nabízen. |
Nezobrazovat v Heureka Marketplace | HEUREKA_CART_HIDDEN | Vyloučí produkt z nabídky v Heureka Marketplace. |
Heureka CPC | HEUREKA_CPC | Maximální cena prokliku na Heureka.cz. |
Nezobrazovat na Zboží.cz | ZBOZI_HIDDEN | Určuje, jestli bude produkt na Zboží.cz zobrazen. |
Zboží.cz CPC | ZBOZI_CPC | Maximální cena za proklik ve fulltextovém vyhledávání Zboží.cz |
Zboží.cz CPC (vyhledávání) | ZBOZI_SEARCH_CPC | Maximální cena prokliku na Zboží.cz |
Heureka kategorie na úrovni produktu | HEUREKA_CATEGORY_ID | ID kategorie napárované na úrovni produktu pro Heureka.cz. |
Zboží.cz kategorie na úrovni produktu | ZBOZI_CATEGORY_ID | ID kategorie napárované na úrovni produktu pro Zboží.cz. |
ID Google kategorie | GOOGLE_CATEGORY_ID | ID kategorie napárované na úrovni produktu pro Google Nákupy. |
Glami kategorie na úrovni produktu | GLAMI_CATEGORY_ID | ID kategorie napárované na úrovni produktu pro Glami. |
Příplatkové parametry | SURCHARGES_PARAMETRES | Příplatkové parametry. |
OSS sazby | OSS_TAX_RATES | Zvláštní daňová sazba OSS pro různé země. Více v Zvláštní daňové režimy OSS a Reverse charge. |
Název pole | Název elementu v XML feedu | Vysvětlení |
---|---|---|
Cena | PRICE / 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í cena | ACTION_PRICE | Zlevněná cena produktu, která se zobrazuje místo prodejní ceny. |
Nákupní cena | PURCHASE_PRICE | Nákupní cena produktu, z té se následně vypočítává marže a zisk. |
Standardní cena | STANDARD_PRICE | Původní cena produktu, je-li vyplněna, na e-shopu se zobrazuje rozdíl původní a současné ceny. |
Viditelnost | VISIBILITY | Skrý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_AMOUNT | Maximální počet kusů pro objednání produktu, musí být zařazen pod tag STOCK. |
Minimální množství | MINIMAL_AMOUNT | Minimální počet kusů pro objednání produktu, musí být zařazen pod tag STOCK. |
Nákup do minusu | NEGATIVE_AMOUNT | Uvádí, jestli lze produkt nakupovat i do minusových skladových zásob. |
Množství | AMOUNT | Přenáší počet kusů skladem, pro správnou aktualizaci je potřeba mít zaškrtnutou i volbu Sklad. |
Dostupnost | AVAILABILITY | Dostupnost, 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á doprava | ATYPICAL_SHIPPING | Definuje, jestli produkt vyžaduje atypickou dopravu a jestli se tedy u produktu v košíku objeví atypický dopravce. |
Atypická platba | ATYPICAL_BILLING | Definuje, jestli produkt vyžaduje atypickou platbu a jestli se tedy u produktu v košíku objeví atypická platba. |