Automatické importy produktů

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.

Co jsou automatické importy produktů?

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.

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 (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.

Přidání nového importu

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):

• 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.

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

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.

• 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 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 například ceny 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 / Jen nové / Jen změněné.
• 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í.

Rozvrh

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).

• 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, Start, Lite, 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).

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í.

• Ú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.

Tabulka položek Úplného importu

Tabulka položek Aktualizačního importu