Instalace a nastavení modulu

• Instalace modulu
• Nastavení e-shopu: Skupina zákazníků ALZA
• Nastavení e-shopu: Zákazník ALZA
• Nastavení e-shopu: Dopravce ALZA
• Nastavení modulu
• Nastavení automatické komunikace (CRON)
• Nastavení Alza Trade portál

Instalace modulu

Modul nainstalujte klasickým způsobem v administraci e-shopu přes správce modulů.

Pokud používáte multistore, je nutné veškeré nastavení provádět v kontextu e-shopu, pro který máte licenci, tzn. ne v kontextu všech e-shopů.

Nastavení e-shopu: Skupina zákazníků ALZA

V administraci e-shopu v číselníku Skupiny zákazníků vytvořte skupinu „ALZA“.

Této skupině nastavte ceny produktů ve výši, ve které je chcete do Alzy odesílat (vždy se odesílají ceny v Kč bez DPH). Případně lze na přiřazení cen využít i jinou skupinu zákazníků, viz dále.

Nastavení e-shopu: Zákazník ALZA

V administraci e-shopu v číselníku Zákazníci vytvořte zákazníka „Alza.cz a.s.“. Na tohoto zákazníka se budou vytvářet objednávky přijaté skrz Dropshipment.

• Emailovou adresu nastavte nějakou svoji interní, Alza neočekává žádné emailové zprávy.
• Nastavte členství zákazníka ve skupině ALZA a případně i v dalších skupinách pro nastavení cenové hladiny produktů.
• Jako výchozí skupinu zvolte tu, podle které se má nastavit cenová hladina.
• Zapamatujte si ID číslo vytvořeného zákazníka, budete ho potřebovat dále při nastavení modulu
• Zákazníkovi po vytvoření nastavte kontaktní adresu a také si zapamatujte její ID číslo.

Nastavení e-shopu: Dopravce ALZA

V administraci e-shopu v číselníku Dopravců vytvořte dopravce pro ALZA objednávky.

• V nastavení dopravce ho povolte pouze pro zákaznickou skupinu „ALZA“.

Nastavení modulu

V konfiguraci modulu „Alza Connector“ nastavte:

• Země
  • Česká republika (Modul lze napojit pouze na CZ pobočku ALZA)
• Měna
  • Česká koruna (Modul umí pracovat pouze s měnou CZK)
• Dopravce
  • ALZA, respektive toho, který byl vytvořen v části „Nastavení e-shopu: Dopravce ALZA“
• eshop ID zákazníka ALZA
  • ID číslo zákazníka, kterého jste vytvořili v části „Nastavení e-shopu: Zákazník ALZA“
• eshop ID skladu
  • ID skladu v případě, že využíváte v e-shopu sklady; jinak nechte prázdné
• eshop ID adresy zákazníka ALZA
  • ID číslo adresy zákazníka, která byla vytvořena v části „Nastavení e-shopu: Zákazník ALZA“
• ALZA - Branch ID
  • požadovanou hodnotu naleznete ve svém partnerském účtu na Alza Trade
• ALZA - Supplier ID
  • požadovanou hodnotu naleznete ve svém partnerském účtu na Alza Trade
• API - Klíč
  • požadovanou hodnotu naleznete ve svém partnerském účtu na Alza Trade
• API - URL
  • požadovanou hodnotu naleznete ve svém partnerském účtu na Alza Trade
    • Testovací = „https://externalservicesmanagement-test.alza.cz/“
    • Produkční = „https://externalservicesmanagement.alza.cz/“
• API - cesta
  • požadovanou hodnotu naleznete ve svém partnerském účtu na Alza Trade
    • Testovací i produkční = „dropship-api/v1“
• Způsob platby - Dobírka
  • název typu platby pro dobírky, např. „Dobírka“
• Způsob platby - Předem
  • název typu platby pro platbu předem, např. „Předem“
• Seznam ID povolených výrobců
  • pokud filtrujete produkty odesílané do ALZA pomocí výrobce, uveďte jejich ID (odděleno čárkou)
• Maximální délka rezervace
  • maximální počet dnů rezervace zboží pro Alzu, např. 50
• Pricing mode
  • Latest = aktuálně používaný formát cen, odesílá se cena bez DPH dle zvolené skupiny zákazníků
  • Legacy = starý, již nepodporovaný způsob odesílání cen
• Test number
  • pole se využívá pouze při testovacím provozu pro označení čísla testovacího scénáře; v produkčním provozu nechte prázdné
• Skupina zákazníků - ceny
  • skupina zákazníků podle které se určuje cena produktů odesílaná na ALZA
• Identifikace produktů
  • způsob identifikace produktu mezi e-shopem a Alzou (domluveno při listingu produktů s ALZA)
    • ID produktu a ID kombinace
    • Referenční kód produktu
• Filtr na produkty
  • filtr na produkty odesílané z e-shopu do Alzy
    • Všechny produkty = všechny produkty na e-shopu
    • Dle výrobce = jen vybraní výrobci
    • Dle seznamu kódů v CSV = jen konkrétní produkty zadané v CSV
      • Vzor CSV „products.csv“ má 4 sloupce, popsané níže (hodnoty odděleny středníkem ";")
        • Kód produktu
        • Sleva % (nepovinné pole); formát číslo bez %
        • Datum platnosti slevy od (nepovinné pole); formát DD.MM.YYYY
        • Datum platnosti slevy do (nepovinné pole); formát DD.MM.YYYY
      • Název souboru je nutné zachovat „products.csv“
      • Soubor umístěte na FTP do rootu složky modulu, typicky „složka_eshopu/modules/cofiscz_alza/“ nebo nahrajte přes rozhraní modulu

Náhled CSV souboru „products.csv“

Nastavení automatické komunikace (CRON)

Alza očekává 2 typy pravidelných datových zpráv, které e-shop musí odesílat. Nastavte pomocí tzv. „cronů“. Správné nastavení proberte se svým IT správcem e-shopu.

• Full Availability = kompletní aktualizace produktů
  • 1x denně v brzkých ranních hodinách
  • varianty cron příkazu:
    • „[web_root]/modules/cofiscz_alza/update_availability.php Full“
    • https://www.vase-domena.cz/modules/cofiscz_alza/update_availability.php?type=full
• Update Availability = průběžná aktualizace změn na produktech (dostupné množství)
  • Každých 15 minut
  • varianty cron příkazu:
    • „[web_root]/modules/cofiscz_alza/update_availability.php Update“
    • https://www.vase-domena.cz/modules/cofiscz_alza/update_availability.php?type=update

Nastavení Alza Trade portál

Po přihlášení do partnerského portálu na Alza (https://marketplace.alza.cz/) je nutné nastavit několik údajů, pro správnou komunikaci modulu s Alzou.

Listing produktů

Listing se provádí v menu Zboží - Hromadný import.

Druhou možností jak provést listing je pomocí XML, více informací na https://www.alza.cz/listing-z-xml-feedu

Postupujte podle popisu na Alza portálu, případě po konzultaci se svým Alza onboarding specialistou.

Nastavení API a komunikace

Nastavení najdete v menu Zboží - Nastavení logistiky.

• Používaný systém skladu
  • "PrestaShop"
• Url
  • "https://vase.domena/modules/cofiscz_alza"
• Externí customer Id
  • Zde vložte ID účtu zákazníka Alza v eshopu, kterého jste vytvářeli v kapitole Nastavení e-shopu: Zákazník ALZA