Obnovit stránku
Alza Trade

Listing z XML feedu

Aktualizováno

V tomto článku se dozvíte, jak postupovat při listingu produktů z XML feedu na Alza.cz. Najdete zde i formát XML feedu a vysvětlení jednotlivých XML elementů.





  1. Postup pro listing z XML feedu
  2. Formát XML feedu
  3. Jednotlivé elementy XML feedu

Postup pro listing z XML feedu na Alza.cz

Body 1-7 níže lze přeskočit napojením API klienta viz AlzaTrade API - použití.

  1. Stáhněte si z Trade portálu XLS šablonu pro kategorie, do které chcete listovat.
    2. XLS šablona trade
  2. Na listě data ve stažené šabloně naleznete všechny parametry, které se musí v XML produktovém feedu objevit. Parametry, které jsou označeny tučně jsou povinné, bez nich nebude možné produkt založit.
  3. Na listě data naleznete také číslo kategorie, do které se listuje (vždy v prvním sloupci).
  4. Na listě číselníky naleznete všechny hodnoty výše zmíněných parametrů.
  5. Na listě SEO prefixy naleznete konkrétní obecný identifikátor produktu Alza = SEO prefix.
  6. Na základě dat z tabulky a níže popsaného formátu XML vytvoříte feed pro zalistování na Alzy.
  7. Při vyplňování dat se řiďte návodem viz: Návod k vyplňování zalistovacích tabulek.
  8. V XML feedu může být více kategorií pro zalistování najednou, vždy musí být označeny správným číslem a mít odpovídající parametry.
  9. XML feed musí obsahovat všechny níže povinně předepsané elementy.
  10. S připraveným produktovým feedem postupujte dle pokynů zde: Převod feedu na tabulky (NÁVOD).

Formát XML feedu

<SHOP>

<SHOPITEM>

<PARAM>

<PARAM_NAME>MAIN_CATEGORY_ID</PARAM_NAME>

<VAL>ID hlavní kategorie</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_0005</PARAM_NAME>

<VAL>SEO-Prefix</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_0002</PARAM_NAME>

<VAL>SEO-Název</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_0003</PARAM_NAME>

<VAL>NameExt custom</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_2015</PARAM_NAME>

<VAL>Dodavatelský kód produktu - SKU</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_1933</PARAM_NAME>

<VAL>EAN kód</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_0004</PARAM_NAME>

<VAL>Výrobce</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_5135</PARAM_NAME>

<VAL>CZK Eshop cena s DPH</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_7152</PARAM_NAME>

<VAL>Hloubka obalu (konz.) [cm]</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_7155</PARAM_NAME>

<VAL>Výška obalu (konz.) [cm]</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_7151</PARAM_NAME>

<VAL>Šířka obalu (konz.) [cm]</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_7153</PARAM_NAME>

<VAL>Váha vč. obalu (konz.) [kg]</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_26133</PARAM_NAME>

<VAL>Má bezpečnostní list</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PICTURE_01</PARAM_NAME>

<VAL>Obrázek (odkaz) - 01.</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PICTURE_02</PARAM_NAME>

<VAL>Obrázek (odkaz) - 02.</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PICTURE_03</PARAM_NAME>

<VAL>Obrázek (odkaz) - 03.</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PICTURE_04</PARAM_NAME>

<VAL>Obrázek (odkaz) - 04.</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PICTURE_05</PARAM_NAME>

<VAL>Obrázek (odkaz) - 05.</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>MANUFACTURER_CONTACT</PARAM_NAME>

<VAL>Kontaktní informace výrobce</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_1934</PARAM_NAME>

<VAL>ProductNumber</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_5131</PARAM_NAME>

<VAL>Specifikace popisu</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_12943</PARAM_NAME>

<VAL>Složení</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>SAFETY_ALERT</PARAM_NAME>

<VAL>Bezpečnostní upozornění</VAL>

</PARAM>

</SHOPITEM>

Jednotlivé elementy XML feedu

PARAMETER_2015 / Dodavatelský kód produktu (povinný)

  • Unikátní identifikátor produktu ve vašem interním systému (tento identifikátor bude využit pro synchronizaci dostupnosti produktů).
  • Element se u každého produktu vyskytuje pouze 1x.

PARAMETER_5131 / Specifikace popisu (nepovinný)

  • Textový popis produktů bez HTML tagů.
  • Element se u každého produktu vyskytuje pouze 1x.

PICTURE_01 / Obrázky (povinný)

  • URL produktových obrázků na bílém pozadí.
  • Počet výskytů elementu u produktu je určen počtem dostupných obrázků (PICTURE_02, PICTURE_03, …)

PARAMETER_5135 / CZK Eshop cena s DPH(povinný)

  • Prodejní cena vč. DPH.
  • Element se u každého produktu vyskytuje pouze 1x.

PARAMETER_0004 / Výrobce (povinný)

  • Název výrobce (bez s.r.o., a.s.). Maximální délka je 30 znaků včetně mezer.
  • Element se u každého produktu vyskytuje pouze 1x.

MAIN_CATEGORY_ID / ID hlavní kategorie (povinný)

  • Číslo vybrané Alza kategorie (naleznete na listě data v prvním sloupci – viz. výše).
  • Element se u každého produktu vyskytuje pouze 1x.

PARAMETER_1933 /EAN (povinný)

  • Pro každý produkt musí být uveden jedinečný EAN kód. Duplicitní kódy budou vraceny k opravě. Pokud nemáte vytvořený EAN kód, doporučujeme si ho oficiálně vygenerovat (ne vymyslet). EAN kódy se poté párují i v online reklamě (např. GoogleAds) a v případě duplicit nemůžeme produkt inzerovat.
  • Element se u každého produktu vyskytuje pouze 1x.

PARAMETER_0005 / SEO-prefix (povinný)

  • Obecný identifikátor zboží Alza, který naleznete v XLS tabulce (např. Mobilní telefon, Hodinky atp.).
  • Element se u každého produktu vyskytuje pouze 1x.

PARAMETER_7152 / 7152 / 7151 / Velikost obalu (povinný)

  • Velikost přepravního balení uvádějte vždy v cm.

PARAMETER_7153 / Váha vč. obalu (konz.) [kg] (povinný)

  • Váha produktu s obalem. Uvádějte vždy v kg.

PARAMETER_26133 / Má bezpečnostní list (povinný)

  • Týká se chemických a nebezpečných látek a směsí – viz mpo.gov.cz/cz/prumysl/chemicke-latky-a-smesi/reach-povinnosti-a-informace/bezpecnostni-list-_-nove-pozadavky-od-1-1-2023--272067/
  • Pokud vyplníte hodnotu Ano, musíte i přiložit odkazy na bezpečnostní list dle zemí prodeje zde:
    • SAFETY_SHEET_1 / Bezpečnostní list CZ
    • SAFETY_SHEET_2 / Bezpečnostní list SK
    • SAFETY_SHEET_5 / Bezpečnostní list DE
    • SAFETY_SHEET_13 / Bezpečnostní list HU
  • Nahrávejte URL odkaz na bezpečnostní list v .pdf formátu. K nahrávání dokumentů můžete použít náš portál.
  • Pokud vyplníte hodnotu Ne, prohlašujete, že produkt nepodléhá této zákonné povinnosti.

PARAMETER_xxxx (povinný)

  • Název parametru, který naleznete v XLS tabulce (viz. výše) v prvním řádku (např. PARAMETER_0021 nebo PARAMETER_23727).
  • Hodnoty naleznete v XLS tabulce (viz. výše) na listě číselníky (např. červená, modrá atp.). Pokud má parametr více hodnot, tak pro každou hodnotu je nutný vlastní záznam (PARAMETER_xxxx.02, PARAMETER_xxxx.03)
  • Tučně zvýrazněné parametry v XLS šabloně jsou povinné. Ostatní nepovinné, ale jejich vyplnění vede k lepší dohledatelnosti produktu na stránkách obchodu a tím i k vyšším prodejům Vašich produktů. Dále také k tvorbě obsáhlejších textů.

SAFETY_ALERT (povinný/nepovinný – dle produktu)

  • Parametr "Bezpečnostní upozornění" - specifická varování, pokyny nebo upozornění pro bezpečné využití produktu, pokud povaha a typ produktu takové informace předpokládá a vyžaduje.

MANUFACTURER_CONTACT (povinný)

  • Informace o výrobci v EU, dovozci, zplnomocněném zástupci nebo poskytovateli služeb plnění. Sloupec je povinný pro každý produkt.
  • Zejména je potřeba uvést:
    • název zodpovědného subjektu pro evropský trh
    • adresa sídla
    • kontakt - email, telefonní číslo nebo odkaz na web vedoucí na kontaktní formulář

PARAMETER_12943 / Složení (povinný/nepovinný – dle produktu)

  • Kompletní složení produktu
  • Povinnost uvést složení ověříte na záložce SEO-Prefixy v XLS šabloně (1=povinné, musíte uvést)

DOCUMENT_01 / Odkaz dokumentu (manuál, energetický štítek,..) (nepovinný)

  • Nahrávejte URL odkaz na manuál v .pdf formátu. Vkládejte pouze dokumenty relevantní k produktu.

DOCUMENT_COUNTRIES_01 / Jazyk/Země dokumentu (nepovinný)

Uveďte, pro kterou zemi je dokument určen, v jakém jazyce je napsán

PARAMETER_1934 (nepovinný)

  • Produktové číslo produktu ve vašem systému.
  • Element se u každého produktu vyskytuje pouze 1x.

PRICE_COMPARER / Srovnávač (nepovinný)

  • Odkaz na produkt na Heureka.cz, Zboží.cz

Příklad správně zapsaného feedu najdete níže v roletce.

Příklad správně zapsaného feedu

<SHOP>

<SHOPITEM>

<PARAM>

<PARAM_NAME>MAIN_CATEGORY_ID</PARAM_NAME>

<VAL>18862622</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_0005</PARAM_NAME>

<VAL>Batoh</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_0002</PARAM_NAME>

<VAL>Harry Potter batoh do školy</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_0003</PARAM_NAME>

<VAL>objem 23 litrů, materiál polyester, zapínání na zip, nastavitelné popruhy a kompresní popruhy, vyztužená záda, hmotnost 1,39 kg, černá barva</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_2015</PARAM_NAME>

<VAL>1000001</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_1933</PARAM_NAME>

<VAL>85934569125</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_0004</PARAM_NAME>

<VAL>AlzaErgo</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_5135</PARAM_NAME>

<VAL>999</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_7152</PARAM_NAME>

<VAL>10</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_7155</PARAM_NAME>

<VAL>23</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_7151</PARAM_NAME>

<VAL>16</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_7153</PARAM_NAME>

<VAL>0,3</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_26133</PARAM_NAME>

<VAL>Ne</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PICTURE_01</PARAM_NAME>

<VAL> https://i.ibb.co/Vab8PF7b/batoh-1.jpg

</PARAM>

<PARAM>

<PARAM_NAME>PICTURE_02</PARAM_NAME>

<VAL>https://i.ibb.co/Vab9PF7b/batoh-2.jpg

</PARAM>

<PARAM>

<PARAM_NAME>PICTURE_03</PARAM_NAME>

<VAL>https://i.ibb.co/Vab7PF7b/batoh-3.jpg </VAL>

</PARAM>

<PARAM>

<PARAM_NAME>MANUFACTURER_CONTACT</PARAM_NAME>

<VAL> Alza.cz a.s., Jankovcova 1522/53, 170 00 Praha 7 - Holešovice, +420 225 340 111, obchod@alza </VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_1934</PARAM_NAME>

<VAL>85934569125</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_5131</PARAM_NAME>

<VAL>Batoh je ideální pro děti do školy. Objem je 23 litrů, je vyrobený z odolných a pevných materiálů. Vhodné pro děti od 3 let. Jde o dvoukomorový batoh opatřený navíc na čelní stěně dvěma samostatnými kapsami. Pomocí postranních popruhů lze snadno nastavit aktuálně potřebný objem batohu. Všechny úložní prostory jsou zavírané pomocí dvoucestných zdrhovadel.</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>SAFETY_ALERT</PARAM_NAME>

<VAL>Vhodné pro děti od 3 let.</VAL>

</PARAM>

</SHOPITEM>

Zalistování produktů na Alza.cz prostřednictvím XML feedu je klíčové pro efektivní prodej a správné zobrazení vašich produktů na tomto významném online tržišti. Dodržováním uvedených postupů, správného vyplnění šablony a respektováním povinných elementů zajistíte rychlé a bezproblémové zalistování. Správně vyplněný feed zvyšuje šanci na úspěch vašeho zboží a zároveň minimalizuje riziko zamítnutí produktů kvůli chybějícím nebo nesprávným údajům.

Zpět na Alza Trade od A do Z


Zkuste naše cookies

My, společnost Alza.cz a.s., IČO 27082440 používáme soubory cookies a další údaje k zajištění funkčnosti webu a s Vaším souhlasem i mj. k personalizaci obsahu našich webových stránek. Kliknutím na tlačítko „Rozumím“ souhlasíte s využívaním cookies a dalších údajů vč. jejich předání pro zobrazení cílené reklamy na sociálních sítích a reklamních sítích na dalších webech.

Více informací
Rozumím Podrobné nastavení Odmítnout vše
P-DC1-WEB09