PrestaShop modul: AlzaTrade Drop API

Verze: 2025-02 Kompatibilita: Prestashop 1.6, 1.7, 8.x Minimální systémové požadavky: PHP 7.1 Autor: COFIS CZ, s.r.o. | www.cofis.cz | cofis@cofis.cz

• Základní informace
• O modulu
• Účetnictví a fakturace mezi e-shopem a Alzou
• Listing produktů
• Testovací provoz
• 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
• Práce s modulem
• Stavy objednávek při práci s modulem
• Nová rezervace
• Nová objednávka
• Zabalení zásilky
• Příprava svozu zásilek
• Expedice objednávky
• Track and Trace
• Stav doručení objednávky
• Zrušení objednávky

Základní informace

O modulu

Modul zajišťuje komunikaci mezi PrestaShop e-shopem a Drop API AlzaTrade.

Veškeré nové rezervace a objednávky od ALZA jsou ukládány do e-shopu a lze je zobrazit v administraci e-shopu v přehledu objednávek.

Objednávky mají ve sloupečku „Kód“ označení prefixem „ALZA“.

Účetnictví a fakturace mezi e-shopem a Alzou

Fakturace mezi e-shopem a Alzou probíhá separátně mimo tento modul. Více informací vám sdělí ALZA nebo se podívejte přímo na https://marketplace.alza.cz/prodej-zbozi

V současné době lze zvolit ze dvou možností fakturace:

Selfbilling

Fakturaci zařizuje Alza. Automatická fakturace prodaných položek. Alza vystavuje finanční doklady za dodavatele a posílá peníze. Ideální pro e-shopy a menší dodavatele.

EDI

Datová komunikace, která umožňuje elektronickou výměnu finančních dokladů týkajících se objednávek. Ideální volba pro větší partnery nebo ty, jejichž systém zvládne přímou integraci EDI (např. Pohoda). Ruční zasílání dokladů ve formátu EDI lze také řešit přes webový portál Orion.

Listing produktů

Listing produktů probíhá separátně mimo tento modul a provádí se přímo na partnerském portálu Alza https://marketplace.alza.cz/ kde v menu zvolte Zboží - Hromadný import. Listing zde pak probíhá pomocí Excel šablon.

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

Konkrétní provedení listingu konzultujte se svým odpovědným zástupcem na Alza Trade.

Testovací provoz

Testovací provoz předchází schválení napojení ze strany Alzy.

Modul je technicky připraven na realizaci jednotlivých testovacích scénářů. Jejich průběh a nastavení může vyžadovat určité technické znalosti. V případě potíží nás kontaktujte, pomůžeme vám testy úspěšně projít.

Konkrétní podobu testů vám sdělí odpovědný zástupce Alza Trade.

Varianty provozu napojení na Alza Trade

• testy v testovacím prostředí
• testy v ostrém prostředí (E2E)
• ostrý provoz

Instalace a nastavení modulu

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

Práce s modulem

Stavy objednávek při práci s modulem

Modul využívá tyto stavy objednávek:

• ALZA – nová rezervace
  • Prvotní stav, ALZA takto zasílá žádost o rezervaci zboží, na které plánuje objednávku. Tzn. v tomto stavu se ještě nejedná o potvrzenou objednávku. Zboží pouze rezervujte.
• ALZA – nová objednávka
  • Potvrzená objednávka, ALZA v této chvíli očekává její vyřízení a expedici.
• ALZA – stornováno Alzou
  • Stav, kdy je objednávka stornována ze strany ALZA. Proces tímto končí, objednávka je zrušena.
• ALZA – stornováno obchodem
  • Stav, kdy je objednávka stornována ze strany eshopu. Proces tímto končí, objednávka je zrušena.
• ALZA – zabaleno
  • Stav, kdy máte objednávku zabalenou v balících pro přepravce, ale ještě není objednán jejich svoz.
• ALZA – připraveno k expedici
  • Stav, kdy je pro objednávku objednán svoz u dopravce a čeká se na fyzické odeslání (předání dopravci).
• ALZA – expedováno
  • Objednávka byla předána dopravci a je na cestě k zákazníkovi.
• ALZA – doručeno
  • Stav pro úspěšně doručené objednávky.
• ALZA – vráceno
  • Stav pro objednávky, které byly vráceny z důvodu nedoručení zákazníkovi.

U těchto stavů vypněte automatické zasílání emailů zákazníkům a možnost stažení dodacích listů a faktur.
Pro zákazníky musí být tyto stavy neviditelné. Veškerou komunikaci se zákazníkem zajišťuje ALZA.

Část stavů objednávek se nastavuje automaticky systémem, viz popis níže. Zbytek stavů je nutné nastavovat ručně uživatelsky v administraci e-shopu při zpracování objednávek.

Každou objednávku je NUTNÉ uzavřít jedním z koncových stavů:

• ALZA – stornováno = zrušené objednávky
• ALZA – vráceno = nedoručené, dopravcem vrácené objednávky
  • pokud využíváte dopravce ALZA, tak stačí stav ALZA – expedováno
• ALZA – doručeno = úspěšně doručené objednávky
  • pokud využíváte dopravce ALZA, tak stačí stav ALZA – expedováno

Adresy

• Fakturační adresa = ALZA.cz a.s. (resp. dle nastavení při konfiguraci modulu)
• Dodací adresa = koncový zákazník (až u potvrzené objednávky, rezervace dodací adresu neobsahují)

Doprava a platba

• Platba = dle nastavení při konfiguraci modulu, typicky „Předem“ a „Dobírka“
• Dopravce = dle nastavení při konfiguraci modulu, typicky „ALZA"

Nová rezervace

Prvotní informace od ALZA, že něco bude chtít. Jedná se o předběžnou rezervaci zboží pro budoucí objednávku.

Stav je nastaven automaticky na základě požadavku z ALZA.

Stav objednávky: ALZA – nová rezervace

Nová objednávka

Závazné potvrzení nové objednávky ze strany ALZA. V této chvíli se očekává vyřízení a expedice dané objednávky.

Stav je nastaven automaticky na základě požadavku z ALZA.

Stav objednávky: ALZA – nová objednávka

Zabalení zásilky

Objednávky, které jsou připraveny na expedici je třeba zabalit do balíků pro dopravce. V administraci e-shopu v přehledu objednávek označte všechny objednávky ve stavu „ALZA – nová objednávka“, které si přejete zabalit pro expedici.

V případě, že využíváte vlastního dopravce, je nejprve nutné pro danou objednávku vyplnit Sledovací číslo zásilky (tracking number).

Přes menu „Hromadné akce“ poté zvolte „ALZA – generovat zásilky“.

Dojde k před-vytvoření balíků. Ty jsou ve výchozím tvaru rozděleny podle místa doručení. Tzn. například zásilky na 1 konkrétní pobočku ALZA jsou spojeny do jednoho balíku. Pokud potřebujete zboží z objednávek zabalit do více balíků, je zde nutné provést ruční úpravu. K tomu slouží zelené tlačítko „Přidat balík“, které přidá do seznamu prázdný balík. Rozdělení balíků na konkrétní zásilky pak provedete pomocí přepínačů „+“ a „-“ u pole „Množství“.

Zároveň je nutné ke každému balíku doplnit jeho skutečnou váhu.

Na závěr je nutné vygenerovat pro tyto připravené balíky zásilky. Provedete stiskem modrého tlačítka „VYGENEROVAT BALÍKY“.

Pokud je balík doručován na pobočku ALZA, je nutné před skutečným zabalením polepit každý jednotlivý produkt tzv. BCX kódem. Kódy lze po vygenerování balíků vytisknout v menu "ALZA DROPSHIPMENT – Balíky". Přesný postup je popsaný v následující kapitole tohoto návodu.

Stav objednávky: ALZA – zabaleno

Příprava svozu zásilek

Připravené balíčky je třeba odeslat dopravci jako žádost o vytvoření zásilky (objednávka svozu). V administraci e-shopu v přehledu ALZA DROPSHIPMENT – Balíky označte všechny balíčky, které hodláte odeslat (stav "Připraveno"). Přes menu „Hromadné akce“ poté zvolte „Vytvořit zásilku“, tím dojde k připravení zásilky pro svoz. Zatím stále jen v eshopu, dopravci zatím není žádná informace odeslána.

Stejný postup platí i v případě, že využíváte vlastního dopravce.

V případě, že potřebujete balíčky z nějakého důvodu upravit, zvolte z menu „Hromadné akce“ volbu „Smazat balíček“. Poté opakujte postup pro vytvoření balíčku z předchozího bodu.

Pro jednotlivé položky objednávek je nutné vytisknout BCX kódy a polepit jimi každý jednotlivý kus zboží. Označte jednotlivé balíčky a přes menu hromadných akcí zvolte "Tisk BCX".

• Tisk BCX kódů se provádí pouze pro zásilky s dodáním na Alza pobočku.

Stav objednávky: ALZA – připraveno k expedici

Expedice objednávky

V administraci e-shopu v přehledu ALZA DROPSHIPMENT – Zásilky je přehled všech připravených zásilek. U těch, které chcete odeslat, klikněte na tlačítko „Odeslat zásilku“. Data byla v této chvíli odeslána na dopravce jako žádost o svoz.

Stejný postup platí i v případě, že využíváte vlastního dopravce.

Po odeslání najdete v tomto přehledu odkaz na stažení PDF se štítky dopravce a PDF se svozovým listem.

Štítky vytiskněte a nalepte na připravené balíky. Štítky se zobrazí po kliknutí v novém okně, pokud váš prohlížeč blokuje, upravte nastavení nebo stáhněte pomocí volby Uložit jako přes pravé tlačítko myši.

Po fyzickém odeslání označte zásilku jako odeslanou kliknutím na tlačítko „Označit jako odeslané“.

Stav objednávky: ALZA – expedováno

Track and Trace

Při dopravě objednávky vlastním dopravcem je nutné Alzu informovat a průběžném stavu dopravy pomocí Track and Trace zpráv. Tyto zprávy se odesílají uživatelsky z detailu objednávky.

Pořadí odesílání zpráv

• Delivered to depot (přijato na depo)
• Final delivery (doručováno)
• Delivered to end customer or buyer branch (úspěšně doručeno)

V případě vrácení zásilky se využije "Rejected by end customer od buyer branch (vráceno)".

• Při využívání „ALZA dopravce“ se tato část nepoužívá.

Stav objednávky: ALZA – TnT

Stav doručení objednávky

Konečný stav pro označení objednávky a rozlišení, zda byla nebo nebyla úspěšně doručena. Nastavuje se uživatelsky ručně v detailu objednávky pomocí tlačítka „Vrátit objednávku jako nedoručenou“ pokud byla objednávka zákazníkem vrácena.

• Při využívání „ALZA dopravce“ není nutné zadávat.

Stav objednávky: ALZA – doručeno nebo ALZA – vráceno

Zrušení objednávky

Objednávku lze zrušit (stornovat) v různých případech.

• Automaticky v případě, kdy při nové rezervaci není skladem odpovídající množství. Zrušení provede modul.
• Automaticky na základě požadavku z ALZA. Zrušení provede modul.
• Ručně uživatelsky, kdy chcete novou objednávku zrušit z pozice provozovatele e-shopu.
  • V detailu objednávky pomocí tlačítka „Zrušit objednávku“

Stav objednávky: ALZA – stornováno Alzou nebo ALZA – stornováno obchodem