Listing z 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 (na adrese portal.alza.cz/app/aik-template/export - ke správnému načtení je potřeba být přihlášen).
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 produkt 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. Tabulku vyplňte podle návodu 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 parametry.
9. XML feed musí obsahovat všechny níže povinně předepsané elementy.
10. Pokud jsou v XML feedu nalezeny chybějící nebo chybné parametry, je tyto parametry třeba opravit v rámci námi zaslané listovací tabulky.
11. Připravený produktový feed k listingu nám prosím pošlete skrz uživatelskou podporu na Alza Trade
    

Formát XML feedu

<SHOP>

<SHOPITEM>

<ITEM_ID>AB123</ITEM_ID>

<PRODUCTNAME>Nokia 5800 XpressMusic</PRODUCTNAME>

<DESCRIPTION>Klasický s plným dotykovým uživatelským rozhraním</DESCRIPTION>

<URL>http://obchod.cz/mobily/nokia-5800-xpressmusic</URL>

<PRICE>1000</PRICE>

<PRICE_VAT>1210</PRICE_VAT>

<MANUFACTURER>NOKIA</MANUFACTURER>

<CATEGORY>18843445</CATEGORY>

<EAN>6417182041488</EAN>

<SEO_Prefix>Mobilní telefon</SEO_Prefix>

<PARAM>

<PARAM_NAME>PARAMETER_0021</PARAM_NAME>

<VAL>černá</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_0001</PARAM_NAME>

<VAL>další/dropshipment</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_0005</PARAM_NAME>

<VAL>Čistící váleček na oděvy</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_0002</PARAM_NAME>

<VAL>Gelový čistící váleček na čištění oděvů Sticky Budy</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_0003</PARAM_NAME>

<VAL>Gelový váleček; na oděvy; na nečistoty; odchlupovací</VAL>

</PARAM>

<PARAM_NAME>PARAMETER_5135</PARAM_NAME>

<VAL>88</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_7152</PARAM_NAME>

<VAL>8.50</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_7155</PARAM_NAME>

<VAL>22.20</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_7151</PARAM_NAME>

<VAL>12.10</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PARAMETER_7153</PARAM_NAME>

<VAL>282.00</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PICTURE_01</PARAM_NAME>

<VAL>//dropohs.cz/docs/images_0b/1658442174_19ab578f.jpg/orig</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PICTURE_02</PARAM_NAME>

<VAL>//dropohs.cz/docs/images_3f/1659296781_80bc2d58.jpg/orig</VAL>

</PARAM>

<PARAM>

<PARAM_NAME>PICTURE_03</PARAM_NAME>

<VAL>//dropohs.cz/docs/images_00/1659296793_2eab9c78.jpg/orig</VAL>

</PARAM>

</SHOPITEM>

...

</SHOP>

Jednotlivé elementy XML feedu

ITEM_ID (povinný)

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

PRODUCTNAME (povinný)

1. Název produktu.
2. Element se u každého produktu vyskytuje pouze 1x.

DESCRIPTION (nepovinný)

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

URL (nepovinný)

1. URL produktu na vašem Webu (pokud dostupné).
2. Element se u každého produktu vyskytuje pouze 1x.

IMGURL (povinný)

1. URL produktových obrázků na bílém pozadí.
2. Počet výskytů elementu u produktu je určen počtem dostupných obrázků.

PRICE_VAT (nepovinný)

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

MANUFACTURER (povinný)

1. Název výrobce produktu.
2. Element se u každého produktu vyskytuje pouze 1x.

CATEGORY (povinný)

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

EAN (povinný)

1. Unikátní EAN produktů.
2. Element se u každého produktu vyskytuje pouze 1x.

SEO_Prefix (povinný)

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

STOCK (nepovinný)

1. Počet kusů produktu skladem.
2. Do parametru se doplňuje pouze číselná hodnota, bez jednotky (hodnoty 1ks, 1 ks apod. nebudou akceptovány).
3. Element se u každého produktu vyskytuje pouze 1x.

PARAM (povinný)

1. Param_name – Název parametru, který naleznete v XLS tabulce (viz. výše) v prvním řádku (např. MAIN_CATEGORY_ID nebo PARAMETER_0001).
2. Value – Hodnota jednotlivých parametrů. Hodnoty naleznete v XLS tabulce (viz. výše) na listě číselníky (např. červená, modrá atp.). Pokud má parametr více hodnot, tak proveďte oddělení znakem ; (tedy např. <Value>Modrá;černá;zelená</Value>).
3. Počet výskytů elementu u produktu je určen počtem požadovaných parametru ze strany Alza (viz. návod výše).

PRODUCTNO (nepovinný)

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

ITEMGROUP_ID (nepovinný)

1. Označení skupiny příbuzných produktů (např. Velikostních variant).
2. Element se u každého produktu vyskytuje pouze 1x.