Pro import produktů do e-shopu se využívá importu skrz dodavatele.

Postup pro nastavení importu dodavatele

• Zajisti vstupní XML feed (návod: Co musí obsahovat FEED?)

• V e-shopu Katalog > Dodavatelé > Přidat vyplň údaje nového dodavatele, včetně URL adresy feedu

  • Položku "Typ importu" nastav na hodnotu "Individuální mapování"
  • Pokud nemá dodavatel dostupný feed na URL adrese, tak jej vlož na naše FTP pomocí návodu (případně vývojový tým pomůže)
    • Návod na připojení k FTP pomocí programu WinSCP
    • FTP přístupy:
      • Hostitel: 185.59.208.129
      • Uživatelské jméno: 2anti_supplier
      • Heslo: De6heileithaicae2
    • Po uploadu souboru na FTP bude URL souboru: http://2anti.cz/files/<nazev-souboru>

• Po vytvoření dodavatele dojde k přesměrování na funkci "Mapování vstupního feedu"

  • V praxi jde o přiřazení položek v XML na položky z e-shopu
  • Mapování lze měnit i zpětně v Katalog > Dodavatelé > Nastavit mapování

  

  Ukázka nastavení mapování vstupního feedu

  • Povinné parametry k nastavení
    • ID produktu
    • Název
    • Popis

• Jakmile je nastaveno mapování, tak lze import spustit manuálně pomocí funkce Katalog > Dodavatelé > Spustit import nebo počkat na běh automatické úlohy, která import pravidelně provádí (pokud bylo nastaveno)

  • pozn. při importu pomocí manuálního spuštění funkce "Spustit import" může dojít k "výpadku prohlížeče", zobrazí se chyba "504 Bad Gateway" - jde o to, že proces importu je časové náročný a prohlížeč od serveru nedostal v požadované době odezvu, import ale stále na serveru v pozadí probíhá

Obecné poznámky k funkci

• Podmínky blokující spuštění importu
  • Feed není na URL dostupný
  • Feed není validní
  • Importem by se archivovalo více než polovina všech produktů
• Import nových produktů
  • U dodavatele lze nastavit "Zakládat nové produkty". Tato funkce nebude zakládat nové produkty, které se objeví po prvním importu. První import po založení dodavatele proběhne vždy.
  • U dodavatele lze nastavit "Aktivovat nové produkty". Tato funkce dovolí naimportovat nové produkty, ale naimportuje je jako neaktivní pro všechny jazyky. Funkce má opodstatnění především pro klienty, kteří chtějí nově naimportované produkty nejdříve zkontrolovat a až poté je zveřejnit na shopu.
• Archivace produktu
  • U nastavení dodavatele existuje nastavení "Vypínat produkty"
    • Při volbě ANO: dochází pouze ke změně příznaku archive = 1, produkt se z databáze nemaže
    • Při volbě NE: a neexistenci produktu ve zdrojovém feedu nedochází k archivaci produktu (zůstává aktivní)
• Import fotografií probíhá rovnou při importu (do budoucna lze v rámci optimalizace rychlosti import produktů a fotografií rozdělit)
• Import ceny
  • musí být s DPH, měna lze zvolit v nastavení importu dodavatele (výchozí je Kč)
  • automaticky se postupuje k přepočtení ceny na další měny e-shopu
  • lze využít formáty: 1000, 1000 Kč, 1 000,00 CZK, 1 000.00 CZK
  • v případě využití funkce "zamknout cenu" u produktu se cena produktu importem neaktualizuje
• Import skladových zásob
  • Ne vždy je žádoucí automaticky aktualizovat stavy skladu. Lze to řešit těmito způsoby
    • Vůbec element "počet ks" nenamapovat (nenaimportuje se ale ani výchozí stav)
    • U dodavatele existuje nastavení "Aktualizovat skladovou zásobu" (je vhodné použít pro prvotní import a pak tuto možnost vypnout)
• Import textů
  • Název, popis i texty kategorií se vloží jen při prvním importu a podstoupí k překladu, při aktualizaci se již texty neaktualizují
  • V nastavení importu dodavatele lze zvolit výchozí jazyk textů "Jazyk:". Pro tento jazyk budou importované texty označeny jako přeložené, pro ostatní jazyky jako nepřeložené
• Import kategorií
  • Jako vlastní kategorie se vždy vloží název dodavatele
  • Typ importu kategorií - lze nastavit v editaci dodavatele:
    • "Import jako kategorie"
    • "Import jako tagy"
  • Typ překladu kategorií - lze nastavit v editaci dodavatele
    • "Kategorie do překladu" (texty se postoupí k překladu)
    • "Ponechat původní název v originálním jazyce" (kategorie jsou označeny jako neaktivní a nepřekládají se, tagy jsou označeny jako přeložené)
• Import variant

  • Typ "Varianta (skupina)" - dle ITEMGROUP_ID

    • Typ importu variant - lze nastavit v editaci dodavatele
      • "Varianty jako související produkty (duplikace produktů)"
      • "Varianty jako skutečné varianty (redukce produktů)"
    • O obou případech je nutné nastavit pole "ID souvisejících produktů (varianty):"
    • V případě "skutečných variant" je nutné vyplnit "Parametry variant produktu:"
      • Existuje výjimka, kdy v přítomnosti pouze jednoho parametru bude právě tento jeden považován jako "Parametr varianty produktu"
      • Pokud i přesto nebude ""Parametry variant produktu:" vyplněn a bude u produktu existovat více parametrů, tak se naimportují jako klasické parametry, ale nebudou určovat variantu
    • Volitelně lze nastavit "Název skupiny produktů:", který se nastaví název hlavnímu produktu (pokud se názvy jednotlivých variant liší)
      • pokud se nevyplní, tak se použije název prvního produktu ve skupině

  • Typ "Varianta (u produktu)"

    • Při vyplnění parametrů s příznakem "Varianta (u produktu)" se naimportují k produktu i varianty

    • Formát XML může vypadat např. takto

      

  • Import parametrů

    • Parametry lze zadat "obecným typem" nebo "statickým typem"

      • Obecný typ:

        • Feed musí obsahovat zvlášť elementy "název" a "hodnotu". Při nevyplnění názvu se budou parametry ignorovat
        • Pokud se v názvu vyskytne řetězec "hmotnost" nebo "weight", tak se parametr naimportuje jako vlastnost přímo k produktu (očekává se hmotnost v gramech)

        

      • Statický typ:

        • Jde o předem definovaný výčet parametrů, kdy stačí jen nastavit namapování hodnoty z feedu
        • Element se může ve feedu vyskytovat opakovaně nebo může být v jednom elementu obsaženo více parametrů, kterou odděleny znakem "|"

        

        • Statické parametry lze rozšířit o jakýkoliv parametr úpravou ve zdrojovém kódu
    • U nastaveno dodavatele lze nastavit příznak "Aktualizovat parametry: ANO/NE". Při nastavení hodnoty "NE" se parametry naimportují vložení produktu a následně se již neaktualizují.