MALL Partner feed pro Shopify

Pokud si MALL pamatujete jako středoevropský marketplace, mapa se změnila. MALL Partner v Česku, na Slovensku a v Maďarsku skončil na konci roku 2024 a tyto domény dnes přesměrovávají na Allegro. Program pokračuje na dvou webech, Mall.hr a Mimovrste.com, a partnerský portál nabízí přihlášení právě pro tyto dvě země.

Pro obchodníka na Shopify to znamená, že tento feed dává smysl, pokud prodáváte do Chorvatska nebo Slovinska. Struktura MALL XML feedů je pro obě země stejná; liší se strom kategorií, přesné znění hodnot parametrů, které musí být v místním jazyce, a sazby DPH, které MALL přijímá.

MALL sklad v produktovém feedu nepřijímá. Zásoby patří do samostatného dostupnostního feedu se třemi povinnými elementy na řádek: ID, které se musí přesně shodovat s ID v produktovém feedu (ID varianty, nikdy skupiny), IN_STOCK jako celé číslo do 9999 a ACTIVE. Produktový feed se stahuje po 6, 12 nebo 24 hodinách, dostupnostní po 15, 30 nebo 60 minutách a intervaly si volíte v portálu.

Oba feedy musí být dostupné online jako XML v UTF-8; FTP MALL nepřijímá. Každou URL vložíte do vlastního pole v nastavení feedů v portálu. Na jednom kroku se zasekne hodně nových partnerů: tlačítko Save changes URL jen uloží a feed se začne zpracovávat až po stisku Assign for processing. Feedflock oba soubory hostuje na stabilních URL a přegenerovává je klidně každou hodinu.

CATEGORY_ID není cesta ani název, ale kód MALL, například ED006. Stromy kategorií pro Chorvatsko a Slovinsko zveřejňuje MALL jako dva excelové exporty ve své znalostní bázi, dostupné komukoli bez přihlášení, každý s více než 1 600 použitelnými kódy kategorií. Své typy produktů na tyto kódy namapujete jednou. Neznámý kód MALL rovnou odmítne.

BRAND_ID je technický kód značky, ne její název. Najdete ho v partnerském portálu v sekci Products, Brands, a pokud tam značka chybí, požádáte o ni tlačítkem Create a brand, což obvykle trvá dva až tři pracovní dny. Šablona plní BRAND_ID z pole vendor v Shopify, což je správně jen tehdy, když se vendor shoduje s kódem MALL; jinak nastavte kód pro každou značku zvlášť. Kromě kódů má každá kategorie třídicí parametry, které MALL nevaliduje: produkt se špatnými nebo chybějícími parametry projde a pak se na webu prostě nikdy neobjeví.

MALL produktový feed validuje proti schématu. Elementy ve špatném pořadí nebo chybějící povinný element znamenají validační chybu a chybou je i jakýkoli element bez hodnoty: nepovinný element je potřeba odstranit celý. Šablona se drží pořadí vlastního vzorového feedu MALL a nepovinné elementy zapisuje jen tehdy, když mají hodnotu.

Chyby najdete v portálu v sekci Feeds, Statistics, vždy jednu na produkt: MALL produkt kontroluje, dokud nenarazí na první problém, a jde dál, takže druhá chyba vyplave až při dalším stažení. Dvě selhání nezanechají stopu vůbec. Opakované ID se nahraje jednou a kopie zmizí bez řádku v logu a špatné parametry kategorie produkt skryjí bez jakékoli hlášky. Vlastní pravidla mají i obrázky: nejvýš 20 na produkt, každý nejvýš 2 MB a 2000 × 2000 px, na bílém pozadí.

PRICE je cena včetně DPH země, do které prodáváte, a vedle ní jde VAT jako celočíselné procento, které MALL kontroluje proti vlastnímu seznamu pro danou zemi. Element pro měnu neexistuje: měna je dána webem a oba weby používají euro. RRP, doporučená maloobchodní cena, je v šabloně nepovinná a posílá se jako celé číslo.

O ceně dopravy se v XML neposílá nic. Dopravci, cenové nebo váhové hladiny, příplatek za dobírku a hranice pro dopravu zdarma jsou v nastavení dopravy v portálu. Feed jen říká, s jakou přepravou se produkt páruje: PACKAGE_SIZE smallbox nebo bigbox, hmotnost pro váhové hladiny a DELIVERY_DELAY, kde 0 znamená, že platí nastavení dopravy z portálu.