PrestaShop modul: MALL Partner Portal
Verze: 2021-10 Kompatibilita: Prestashop 1.6, 1.7 Minimální systémové požadavky: PHP 7.1 Autor: COFIS CZ, s.r.o. | www.cofis.cz | cofis@cofis.cz
- Základní informace
- Instalace a nastavení modulu
- Instalace modulu
- Nastavení e-shopu: Skupina zákazníků MALL
- Nastavení e-shopu: Zákazník MALL
- Nastavení e-shopu: Dopravce MALL
- Nastavení modulu
- Nastavení e-shopu: Značky
- Nastavení e-shopu: Kategorie
- Nastavení e-shopu: Produkty
- Nastavení automatické komunikace (CRON)
- Nastavení v MALL Partner Portálu
- Práce s modulem
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žte
Prá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á rezervace
Nová 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ávka
Expedice 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.
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“.
Stav objednávky: MALL – expedováno
Stav 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 - ztraceno
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 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