PrestaShop modul: MALL Partner Portal Základní informace O modulu Modul zajišťuje komunikaci mezi PrestaShop e-shopem a API MALL Partner Portal Veškeré nové rezervace a objednávky od MALL 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 „MALL“.Účetnictví a fakturace mezi e-shopem a MALL Fakturace mezi e-shopem a MALL probíhá separátně mimo tento modul. Více informací vám sdělí MALL nebo se podívejte přímo na https://partners.mallgroup.com/cs V současné době lze zvolit ze dvou možností fakturace: Selfbilling Fakturaci zařizuje Mall. Automatická fakturace prodaných položek. Mall vystavuje finanční doklady za dodavatele a posílá peníze. Ideální pro e-shopy a menší dodavatele. Fakturace Klasický způsob vystavování daňových dokladů. Vše potřebné naleznete po přihlášení na MALL Partner Portálu.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ů MALL V administraci e-shopu v číselníku Skupiny zákazníků vytvořte skupinu „MALL“. Této skupině nastavte ceny produktů ve výši, ve které je chcete do Mallu 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 MALL V administraci e-shopu v číselníku Zákazníci vytvořte zákazníka „Internet Mall a.s.“. Na tohoto zákazníka se budou vytvářet objednávky přijaté skrz MALL API. Emailovou adresu nastavte nějakou svoji interní, Mall neočekává žádné emailové zprávy. Nastavte členství zákazníka ve skupině MALL 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 MALL V administraci e-shopu v číselníku Dopravců vytvořte dopravce pro MALL objednávky. V nastavení dopravce ho povolte pouze pro zákaznickou skupinu „MALL“. Nastavení modulu V konfiguraci modulu „Mall Connector“ nastavte: Client ID Client ID najdete v MALL Partner portálu na stránce Partner / API klíč Language Čeština (Modul umí pracovat pouze s českou jazykovou mutací) Měna Česká koruna (Modul umí pracovat pouze s měnou CZK) Dopravce MALL, respektive toho, který byl vytvořen v části „Nastavení e-shopu: Dopravce MALL“ Customer ID ID číslo zákazníka, kterého jste vytvořili v části „Nastavení e-shopu: Zákazník MALL“ Reservation / invoice ID (CZE) ID číslo adresy zákazníka, která byla vytvořena v části „Nastavení e-shopu: Zákazník MALL“ Nastavení e-shopu: Značky Jednotlivé značky produktů na e-shop je nutné propojit s číselníkem značek na MALL. Nastavení provedete jednoduše v administraci e-shopu v editaci vybrané značky. V části Mall settings zvolte odpovídající značku z číselníku Mall Brand.Nastavení e-shopu: Kategorie Jednotlivé kategorie produktů na e-shop lze volitelně nastavit propojení s číselníkem kategorií na MALL. Nastavení lze provést buď na kategoriích nebo pak individuálně na jednotlivých produktech. Nastavení provedete jednoduše v administraci e-shopu v editaci vybrané kategorie. V části Mall settings zvolte odpovídající kategorii z číselníku Mall category.Nastavení e-shopu: Produkty Jednotlivé produkty na e-shopu je nutné propojit s kategoriemi MALL. Nastavení provedete jednoduše v administraci e-shopu v editaci vybraného produktu. V části Mall settings proveďte následuíjcí nastavení: Send to Mall Pokud je aktivní, je produkt odeslán na MALL Partner Portal Show on Mall (draft / live) Určuje způsob zanesení na MALL Partner Portal Mall category Nastavení MALL kategorie pro daný produkt Mall Parameters Podrobnější zatřídění produktu v rámci MALL Nastavení lze provést také na úrovni kategorie, takže bude platné pro všechny produkty v dané kategorii. Nastavení automatické komunikace (CRON) MALL očekává několik 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. Update products = kompletní aktualizace produktů 1x denně v brzkých ranních hodinách Update availability = aktualizace dostupného množství produktů Každých 15 minut „[web_root]/modules/cofisczmall/availability?token=111“ Další informace jsou na MALL odesílány automaticky při editaci produktu v administraci e-shopu. Vybrané akce lze spustit také ručně v nastavení modulu.Nastavení v MALL Partner Portálu Na portálu MALL Partner (https://new-partners.mallgroup.com) proveďte následující nastavení. Nastavení služeb Zažádejte o aktivaci následujících služeb: MALL Delivery Self-billing Partnerská stránka Platba dobírkou (v případě, že chcete dobírku zákazníkům umožnit) Webhook Do pole URL pro webhook vložte adresu ve tvaru: "https://www.vas-eshop.cz/module/cofisczmall/webhook". Následně povolte používání webhooku a nastavení uložtePráce s modulem Stavy objednávek při práci s modulem Modul využívá tyto stavy objednávek: MALL – nová rezervace Prvotní stav, MALL 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. MALL – nová objednávka Potvrzená objednávka, MALL v této chvíli očekává její vyřízení a expedici. MALL – stornováno Mallem Stav, kdy je objednávka stornována ze strany MALL. Proces tímto končí, objednávka je zrušena. MALL – stornováno obchodem Stav, kdy je objednávka stornována ze strany eshopu. Proces tímto končí, objednávka je zrušena. MALL – připraveno k expedici Stav, kdy máte objednávku zabalenou a připravenou pro předání dopravci (včetně polepení štítky). MALL – expedováno Objednávka byla předána dopravci a je na cestě k zákazníkovi. MALL – doručeno Stav pro úspěšně doručené objednávky. MALL – vráceno Stav pro objednávky, které byly vráceny z důvodu nedoručení zákazníkovi. MALL – ztraceno Stav pro objednávky, která byla v průběhu doručování dopravcem ztracena. 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 MALL. Všechny stavy se objednávkám nastavují buďto automaticky nebo při vyvolání uživatelské akce. Vše je popsáno v následujících kapitolách. Adresy Fakturační adresa = Internet Mall 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 „MALL" Nová rezervace Prvotní informace od MALL, ž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 MALL. Stav objednávky: MALL – nová rezervaceNová objednávka Závazné potvrzení nové objednávky ze strany MALL. 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 MALL. Stav objednávky: MALL – nová objednávkaExpedice objednávky 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 „MALL – nová objednávka“, které si přejete zabalit pro expedici. Přes menu „Hromadné akce“ poté zvolte „MALL – Generate labels“. Pro označené objednávky se zobrazí štítky pro dopravce. Ty je třeba vytisknout a polepit jimi jednotlivé balíky. V případě potřeby lze tuto akci vyvolat i opakovaně. Po fyzickém předání zásilek dopravci označte odpovídající objednávky ve stavu „MALL – připraveno k expedici“ a přes menu „Hromadné akce“ poté zvolte „MALL – Shipped“. Tím je proces expedice dokončen. Stav objednávky: MALL – expedovánoStav doručení objednávky Konečný stav pro označení objednávky a rozlišení, zda byla nebo nebyla úspěšně doručena. Při využívání MALL Delivery zasílá tento stav automaticky MALL API. Stav objednávky: MALL – doručeno nebo MALL – vráceno nebo MALL - ztracenoZruš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 MALL. 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: MALL – stornováno Mallem nebo MALL – stornováno obchodem