XML feedy

Registrovaným velkoobchodním odběratelům poskytujeme automatizovaný XML feed s aktuálním ceníkem, skladovými zásobami a detailními informacemi o produktech. Feed je vhodný pro napojení do ERP systémů, e-shopů nebo interních obchodních nástrojů.

Kdo může feed získat?

Feed je dostupný odběratelům s ročním obratem přesahujícím 100 000 Kč / 4 000 EUR . Pro získání API klíče napište na tomoszek@metal-trade.cz .

Jak feed stáhnout?

Feed je dostupný na adrese:

https://xml.metal-trade.cz/feed.php?key=VÁŠ_API_KLÍČ&lang=cz

Parametr lang určuje jazyk feedu a měnu cen. Dostupné hodnoty:

lang	Jazyk	Měna
`cz`	Čeština	CZK + EUR
`sk`	Slovenština	EUR
`de`	Němčina	EUR
`en`	Angličtina	EUR
`pl`	Polština	PLN + EUR
`hu`	Maďarština	HUF + EUR

Struktura XML

Kořenový element <SHOP> obsahuje seznam elementů <SHOPITEM> — každý odpovídá jedné produktové variantě. Příklad:

<SHOP version="1.0" generated="2026-05-03T06:00:00">
  <SHOPITEM>
    <ART_NO>1200-0804</ART_NO>
    <EAN>8596221100039</EAN>
    <URL>https://metal-trade.cz/cz/oko-s-vrutem-p41081/?vid=1289</URL>
    <PRODUCTNAME>Oko s vrutem, 8x4x1,8mm, Zn</PRODUCTNAME>
    <PARENT_PRODUCTNAME>Oko s vrutem</PARENT_PRODUCTNAME>
    <DIMENSIONS>8x4x1,8mm</DIMENSIONS>
    <MATERIAL>ocel S235JR</MATERIAL>
    <SURFACE_TREATMENT>Zn</SURFACE_TREATMENT>
    <WEIGHT_KG>0.0006</WEIGHT_KG>
    <PRODUCT_IMAGE>https://cdn.metal-trade.cz/images/0/aee82ebcef162d6e/100/1200_product_image.jpg?hash=-2</PRODUCT_IMAGE>
    <SPECIFICATION_TABLE_IMAGE>https://cdn.metal-trade.cz/images/0/4919f11877671f0e/100/1200_specification_table_image.jpg?hash=-2</SPECIFICATION_TABLE_IMAGE>
    <DRAWING_IMAGE>https://cdn.metal-trade.cz/images/0/da20d9bcef7000d3/100/1200_drawing_image.png?hash=-2</DRAWING_IMAGE>
    <PRICE_CZK>0.1616</PRICE_CZK>
    <PRICE_EUR>0.0066</PRICE_EUR>
    <UNIT>ks</UNIT>
    <PACK_SIZE>600</PACK_SIZE>
    <PACK_TYPE>bal</PACK_TYPE>
    <BULK_PACK_SIZE>36000</BULK_PACK_SIZE>
    <BULK_PACK_TYPE>kar</BULK_PACK_TYPE>
    <STOCK>84000</STOCK>
    <CATEGORIES>
      <CATEGORY>Drátěná šroubovina</CATEGORY>
      <CATEGORY>Oka závitová</CATEGORY>
    </CATEGORIES>
    <MANUFACTURER>MTR</MANUFACTURER>
  </SHOPITEM>
  ...
</SHOP>

Popis polí

Element	Popis	Vždy
`ART_NO`	Kód produktu. Může se vzácně změnit — pro párování primárně používejte `EAN` .	✓
`EAN`	EAN kód. Nikdy se nemění — doporučujeme jako primární klíč pro párování .	✓
`URL`	Odkaz na produktovou stránku v příslušném jazyce.	✓
`PRODUCTNAME`	Název varianty v jazyce feedu.	✓
`PARENT_PRODUCTNAME`	Název nadřazeného produktu.	✓
`DESCRIPTION`	Dlouhý popis produktu.	–
`DIMENSIONS`	Rozměry varianty.	✓
`MATERIAL`	Materiál.	–
`SURFACE_TREATMENT`	Povrchová úprava.	–
`WEIGHT_KG`	Hmotnost v kg.	✓
`PRODUCT_IMAGE`	URL hlavní fotografie produktu.	–
`SPECIFICATION_TABLE_IMAGE`	URL obrázku technické tabulky.	–
`DRAWING_IMAGE`	URL nákresu produktu.	–
`ALTERNATIVE_IMAGE`	URL dalšího obrázku. Může se opakovat vícekrát.	–
`PRICE_CZK` / `PRICE_EUR` / `PRICE_PLN` / `PRICE_HUF`	Cena bez DPH za základní jednotku v měně feedu. Která pole se zobrazí závisí na parametru `lang` .	✓
`UNIT`	Základní prodejní jednotka (ks, m, kg, svz).	✓
`MOQ`	Minimální odebrané množství.	–
`PACK_SIZE`	Počet kusů v prodejním balení.	✓
`PACK_TYPE`	Typ prodejního balení (viz tabulka níže).	✓
`BULK_PACK_SIZE`	Počet kusů v velkoodběrovém balení.	–
`BULK_PACK_TYPE`	Typ velkoodběrového balení (viz tabulka níže).	–
`STOCK`	Stav skladové zásoby v základní jednotce.	✓
`NEXT_RESTOCK_QTY`	Očekávané množství při příštím naskladnění.	–
`NEXT_RESTOCK_DATE`	Očekávaný termín naskladnění ve formátu `YYYY-MM-DD` .	–
`CATEGORIES / CATEGORY`	Produktová kategorie. Pokud existuje nadkategorie, jsou uvedeny dva elementy `CATEGORY` .	✓
`MANUFACTURER`	Výrobce.	✓

Typy balení

Hodnoty elementů PACK_TYPE a BULK_PACK_TYPE jsou vždy v angličtině:

Hodnota	Typ balení
`BUNDLE`	Svazek
`REEL`	Cívka
`PACKAGE`	Sáček
`CARTON`	Karton
`BARREL`	Sud
`BAG`	Pytel
`PALLET`	Paleta

Důležité poznámky

Párování produktů: Primárně párujte podle EAN — tento kód se nikdy nemění. ART_NO se může vzácně změnit při restrukturalizaci sortimentu.
Produktová rodina: Varianty stejného produktu sdílejí prefix kódu ART_NO před pomlčkou — např. 1200-0603 a 1200-0804 patří ke stejnému produktu (1200).
Aktuálnost dat: Feed se generuje jednou denně. Stav skladu odpovídá stavu v době vygenerování — okamžitou skladovou zásobu můžete ověřit na ehsopu.
Frekvence stahování: Doporučujeme stahovat feed nejvýše jednou za hodinu. Nadměrné dotazování může vést k omezení přístupu.

Changelog

Verze	Datum	Změny
`v1.1`	2026-08-14	Přidán element `DESCRIPTION` s dlouhým popisem produktu (z nadřazeného produktu).
`v1.0`	2026-05-03	První stabilní verze feedu — struktura `SHOP`/`SHOPITEM`, základní pole (`ART_NO`, `EAN`, `URL`, `PRODUCTNAME`, ceny, sklad, kategorie aj.).