# Automatické importy {% hint style="warning" %} Pouze pro klienty **Rocketoo MAX**. {% endhint %} Modul **Automatické importy** slouží k **pravidelnému načítání produktů z externích zdrojů**, typicky: * XML / CSV feedy dodavatelů, * exporty jiných e‑shopů nebo velkoobchodů. Importy umožňují: * udržovat nabídku produktů aktuální **bez ručního přepisování**, * pravidelně aktualizovat **ceny, skladovou dostupnost, popisy** a další údaje, * automaticky přidávat nové produkty a sledovat změny ve feedu. ### K čemu slouží automatické importy Automatické importy řeší zejména: * **napojení na dodavatele** – zboží, které dodavatel poskytuje v XML/CSV feedu, se pravidelně načítá do vašeho e‑shopu, * **aktualizaci stávajících produktů** – když dodavatel změní cenu, dostupnost nebo jiné parametry, změna se promítne i do vašeho e‑shopu, * **sledování smazaných produktů** – vidíte, co dodavatel z feedu odstranil (a můžete tomu přizpůsobit nabídku). Výhodou je, že: * nemusíte ručně přidávat nebo měnit stovky produktů, * minimalizujete riziko chyb (špatné ceny, nedostupné zboží), * ušetříte čas sobě i svému týmu. ### Kde najdu modul? {% hint style="info" %} Modul je nutné nejprve nainstalovat ve **Správci rozšíření**. {% endhint %} V administraci e‑shopu přejděte na: * **Nastavení → Produkty → Automatické importy** * zde uvidíte přehled všech importů a jejich nastavení. V rámci modulu jsou dostupné tyto záložky: * **Importy** – seznam všech definovaných importů, * **Importované produkty** – přehled produktů načtených z feedů, * **Nové produkty** – nově importované, zatím **neviditelné** produkty, čekající na schválení, * **Smazané produkty** – produkty, které už v importu nejsou, ale kdysi byly importovány, * **Nenapárované / Napárované kategorie** – mapování kategorií importu na kategorie vašeho e‑shopu, * **Záznamy o importech (logy)** – historie běhů importů. ## Jak funguje jeden import Každý import má: * **Typ importovaného souboru** – jaký formát / strukturu feedu používáte (volí se připravený „importér“), * **URL adresu** souboru – odkaz, odkud se data stahují (např. XML feed dodavatele), * **Případně přístupové údaje** – uživatelské jméno a heslo, pokud je feed chráněný, * **Rozvrh spuštění** – kdy a jak často se import automaticky spouští, * **Stav (Aktivní / Vypnuto)** – jestli je import zapnutý. Systém může pro každý import provádět: * **úplný import** – načte a projde celý feed (obvykle 1× denně v noci), * **aktualizační importy** – během dne vícekrát provádí menší aktualizace (např. ceny, skladovost). ## Vytvoření nového importu {% stepper %} {% step %} V administraci přejděte na **Importy** a klikněte na **Vytvořit import**. {% endstep %} {% step %} Vyplňte: * **Název** – např. „Dodavatel ABC – elektro“, „Partner X – móda“. * **Typ importovaného souboru** – vyberte vhodný importér podle poskytovaného feedu (pokud si nejste jisti, konzultujte to s implementátorem nebo dodavatelem). * **URL adresa** – přímý odkaz na feed (XML/CSV). * **Aktivní** – zapněte, pokud chcete, aby se import podle rozvrhu skutečně spouštěl. {% endstep %} {% step %} Podle potřeby nastavte **přístupové údaje** (uživatelské jméno a heslo), pokud je feed chráněn. {% endstep %} {% step %} V záložce **Rozvrh** nastavte časování (viz kapitola „Nastavení rozvrhu“). {% endstep %} {% step %} Uložte import. Poznámka: Část „Nastavení importu“ (detailní mapování polí, specifické volby) je obvykle připravena implementátorem a běžný správce e‑shopu ji mění jen výjimečně. {% endstep %} {% endstepper %} ## Nastavení zdroje dat (URL, přístup, heslo) V sekci **Nastavení přístupu k importnímu souboru** můžete určit: * **URL adresu** feedu – adresa, kde je soubor umístěn (např. `https://dodavatel.cz/feed.xml`). * **Soubor je chráněn heslem** – pokud dodavatel feed zabezpečuje: * zaškrtněte volbu, * vyplňte **uživatelské jméno** a **heslo**. Systém se pak při každém běhu importu k feedu přihlásí a stáhne aktuální data. ## Nastavení importu ### Nastavení viditelnosti importovaných produktů
V této části určíte, jak se mají produkty chovat po importu: **Nově importované produkty budou neviditelné** Produkty se po importu nahrávají do administrace jako skryté.\ Toto nastavení doporučujeme, pokud chcete produkty před zveřejněním upravit nebo zkontrolovat. **Nově importované produkty budou viditelné** Produkty se okamžitě po importu zobrazí na e-shopu a mohou být objednány.\ Hodí se v případech, kdy feed chcete publikovat automaticky a bez manuálních zásahů. **Všechny produkty obsažené v importovaném souboru se označí jako viditelné** Každý produkt, který import obsahuje, bude automaticky označen jako viditelný — bez ohledu na jeho původní stav. ### Chování importu při neobsazených produktech/variantách
Tato volba řeší situace, kdy se produkt nebo varianta už nenachází ve feedu, ale v databázi ho/ji stále máte. **Nedělat nic** Produkty i varianty, které ve feedu chybí, zůstanou beze změny.\ Doporučeno v případech, kdy nechcete automaticky skrývat ani mazat. **Smazat neobsažené varianty** Varianty, které nejsou ve feedu, se odstraní.\ Hodí se pro feedy, kde se varianty často mění (např. velikosti). **Skrýt neobsažené produkty** Pokud produkt ve feedu chybí, označí se jako neviditelný.\ Praktické v situacích, kdy chcete automaticky skrývat položky, které už nejsou dostupné. ### Zaokrouhlení ceny
Při importu můžete upravit způsob, jakým se ceny zaokrouhlují: * Nezaokrouhlovat — ceny se převezmou přesně tak, jak jsou uvedeny ve feedu. * Matematicky — běžné matematické zaokrouhlení. * Nahoru — vždy zaokrouhlí cenu směrem nahoru. * Dolů — vždy zaokrouhlí cenu směrem dolů. ## Práce s cenami při importu Při importu je možné ceny nejen zaokrouhlovat, ale také je konvertovat nebo procentuálně upravit. Každou volbu lze zapnout samostatně — zaškrtnutý checkbox znamená, že se daná operace použije.
### Konvertovat ceny Pokud jsou ceny ve feedu uvedené v jiné měně, než máte nastavenou jako systémovou, můžete je automaticky převést. * Vyberte měnu, ze které se bude konverze provádět. * Použije se aktuální kurz zvolený v systému. Tuto volbu doporučujeme u mezinárodních feedů (např. EUR, USD). ### Upravit cenu importovaného produktu Umožňuje navýšit nebo snížit běžnou cenu každého importovaného produktu o určité procento. * Kladné číslo = zvýšení ceny * Záporné číslo = snížení ceny Například: +10 znamená zdražení o 10 %, −15 znamená zlevnění o 15 %. ### Upravit nákupní cenu Nákupní cena se standardně generuje z běžné ceny produktu.\ Tímto nastavením můžete nákupní cenu při importu procentuálně upravit podle potřeby. Tato informace se používá zejména pro statistiky a přehledy marží. ### Upravit doporučenou cenu Doporučená (doporučená prodejní) cena se běžně generuje z běžné ceny.\ Pokud zapnete tuto volbu, můžete doporučenou cenu automaticky: * navýšit, * snížit, * nebo ponechat stejnou při hodnotě 0 %. Hodí se v případech, kdy pracujete s vlastní strategií doporučených cen. ## Nastavení rozvrhu (časování importů) V záložce **Rozvrh** nastavujete: ### Úplný import * **Rozvrh úplného importu**: * plánuje se **maximálně 1× denně**, * povolený čas je obvykle v noci (např. 00:00–07:00), kdy je menší zátěž na server i dodavatele. * **Čas plánovaného spuštění** – zvolte konkrétní hodinu (např. 02:00). ### Aktualizační importy * **Rozvrh aktualizačního importu**: * můžete zvolit víc časů během dne (např. 9:00, 12:00, 15:00 atd.), * každý e‑shop má podle tarifu **omezený počet aktualizací za den** – tento limit se vztahuje na všechny importy dohromady. * **Vyberte časy spuštění** – označte časy v průběhu dne. Pokud počet nastavených aktualizací překročí váš limit: * v konfiguraci importu se zobrazí **varování**, * dokud počet časů nesnížíte, rozvrh nebude platit. ## Nové produkty z importu V záložce **Nové produkty** najdete: * **Nově importované produkty**, které: * byly načteny z feedu, * ale zatím **nejsou viditelné na e‑shopu** (např. čekají na ruční schválení). Můžete: * prohlédnout si jejich parametry (název, kategorie, cenu apod.), * produkt otevřít a případně upravit (doplnit popis, obrázky, nastavení viditelnosti), * nebo produkt **smazat**, pokud ho nechcete zařadit do nabídky. V toolbaru najdete volbu: * **Smazat vybrané** – hromadně odstraní označené nově importované produkty, * tato akce je nevratná – produkty se při další synchronizaci vytvoří znovu jen pokud jsou stále ve feedu a konfigurace importu to umožňuje.
Co se stane s produkty, které ve feedu přestanou existovat? Pokud produkt aktuálně není ve feedu, ale máte ho zveřejněný na e-shopu, zůstane aktivní, dokud jej ručně nesmažete.
{% hint style="success" %} **Tip pro práci s produkty:** Máte-li stejný produkt ve více kategoriích, v administraci e-shopu můžete filtrovat produkty podle kategorií. V drobečkové navigaci klikněte na šipku a zobrazíte si produkty pouze z vybrané kategorie. Vyberte ideální produkt, nastavte cenu a publikujte. {% endhint %} ## Smazané produkty v importu V záložce **Smazané produkty** vidíte přehled produktů, které: * byly v minulosti prostřednictvím importu do systému načteny, * ale **aktuálně už v Rocketoo neexistují** (např. byly smazány). Zde můžete: * sledovat, jaké produkty „vypadly“ ze synchronizace, * případně smazat záznamy z tohoto seznamu: * po odstranění záznamu se produkt při příštím běhu importu může **znovu naimportovat** z feedu. Produkty v této záložce se při nové aktualizaci feedu znovu neobjeví mezi novými produkty. Pokud ale položku následně odstraníte i z této záložky, při další aktualizaci se z feedu opět načte. Toto je užitečné například tehdy, když chcete některé dříve smazané produkty vrátit do nabídky. ## Přehled importovaných produktů V záložce **Importované produkty**: * vidíte seznam produktů, které byly importy **vytvořeny nebo aktualizovány**, * můžete filtrovat podle jednotlivých importů, kategorií, stavu apod. (dle konfigurace filtrů). Tento přehled vám pomůže: * kontrolovat, co přesně import dělá, * rychle najít produkty, které pochází z konkrétního feedu. ## Napárování kategorií Pokud feed dodavatele používá **jinou strukturu kategorií** než váš e‑shop, je potřeba je napárovat: * **Nenapárované kategorie**: * seznam kategorií z feedu, které ještě **nemají přiřazenou** kategorii ve vašem e‑shopu, * zde provádíte ruční mapování (např. *Elektro* → *Televize a Audio* přiřadíte k vaší kategorii *Elektronika / TV a audio*). * **Napárované kategorie**: * přehled všech již spárovaných kategorií, * v případě potřeby můžete mapování upravit (přeřadit k jiné kategorii). Správné párování kategorií je klíčové pro to, aby: * se nové produkty z importu zařazovaly do smysluplných kategorií na e‑shopu, * zákazníci snadno našli importované zboží tam, kde ho čekají. ## Záznamy o běhu importů (logy) V záložce **Záznamy o importech (logy)**: * vidíte historii všech běhů importů: * kdy se import spustil, * zda proběhl úspěšně, * kolik produktů bylo načteno / aktualizováno, * případné chyby nebo varování. Logy používáte k: * řešení problémů (např. chyba v URL, neplatné přístupové údaje), * kontrole, že importy běží podle plánu, * komunikaci s dodavateli (můžete jim poskytnout informaci, že feed byl nečitelný apod.). ## Často kladené otázky
Jaký typ souboru / feedu mohu použít? To záleží na **dostupných importérech** v systému (typy v poli *Typ importovaného souboru*).\ Obvykle jsou podporované standardní XML feedy pro e‑shopy nebo specifické formáty dodavatelů, které vám zprovozní implementační partner. {% hint style="info" %} Pokud od dodavatele obdržíte specifický datový soubor pro import, můžeme pro vás připravit vhodný importer na míru {% endhint %}
Co když je vytvoření importů zakázané? Pokud v horní části modulu vidíte informaci, že *Vytváření automatických importů není momentálně povoleno*: * váš tarif nebo konfigurace neumožňuje přidávat další importy, * pro aktivaci nebo navýšení limitu kontaktujte podporu nebo svého account manažera.
Jak poznám, kolik importů / aktualizací mohu mít? V informačním panelu modulu se zobrazuje: * **Aktivní importy** – např. „3 z 5“, * **Nastavené aktualizace** – např. „10 z 20“. Tato čísla ukazují: * kolik importů a denních aktualizačních běhů máte aktuálně využito, * jaký je váš maximální limit.