XML feedy
Registrovaným veľkoobchodným odberateľom poskytujeme automatizovaný XML feed s aktuálnym cenníkom, stavom skladu a podrobnými informáciami o produktoch. Feed je vhodný na napojenie do ERP systémov, e-shopov alebo interných nákupných nástrojov.
Kto môže feed získať?
Feed je dostupný odberateľom s ročným obratom presahujúcim 4 000 EUR . Pre získanie API kľúča napíšte na tomoszek@metal-trade.cz .
Ako feed stiahnuť?
Feed je dostupný na adrese:
https://xml.metal-trade.cz/feed.php?key=VÁŠ_API_KĽÚČ&lang=sk
Parameter
lang
určuje jazyk feedu a menu cien. Dostupné hodnoty:
| lang | Jazyk | Mena |
|---|---|---|
cz |
Čeština | CZK + EUR |
sk |
Slovenčina | EUR |
de |
Nemčina | EUR |
en |
Angličtina | EUR |
pl |
Poľština | PLN + EUR |
hu |
Maďarčina | HUF + EUR |
Štruktúra XML
Koreňový element
<SHOP>
obsahuje zoznam elementov
<SHOPITEM>
— každý zodpovedá jednej produktovej variante. Prí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/sk/oko-so-skrutkou-p41081/?vid=1289</URL> <PRODUCTNAME>Oko so skrutkou, 8x4x1,8mm, Zn</PRODUCTNAME> <PARENT_PRODUCTNAME>Oko so skrutkou</PARENT_PRODUCTNAME> <DIMENSIONS>8x4x1,8mm</DIMENSIONS> <MATERIAL>oceľ 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_EUR>0.0066</PRICE_EUR> <UNIT>ks</UNIT> <PACK_SIZE>600</PACK_SIZE> <PACK_TYPE>PACKAGE</PACK_TYPE> <BULK_PACK_SIZE>36000</BULK_PACK_SIZE> <BULK_PACK_TYPE>CARTON</BULK_PACK_TYPE> <STOCK>84000</STOCK> <CATEGORIES> <CATEGORY>Drôtená skrutkovica</CATEGORY> <CATEGORY>Oká závitové</CATEGORY> </CATEGORIES> <MANUFACTURER>MTR</MANUFACTURER> </SHOPITEM> ... </SHOP>
Popis polí
| Element | Popis | Vždy |
|---|---|---|
ART_NO |
Kód produktu. Môže sa vzácne zmeniť — na párovanie primárne používajte EAN. |
✓ |
EAN |
EAN kód. Nikdy sa nemení — odporúčame ako primárny kľúč pre párovanie. | ✓ |
URL |
Odkaz na produktovú stránku v príslušnom jazyku. | ✓ |
PRODUCTNAME |
Názov varianty v jazyku feedu. | ✓ |
PARENT_PRODUCTNAME |
Názov nadriadeného produktu — na zoskupovanie variantov. | ✓ |
DIMENSIONS |
Rozmery varianty. | ✓ |
MATERIAL |
Materiál. | – |
SURFACE_TREATMENT |
Povrchová úprava. | – |
WEIGHT_KG |
Hmotnosť v kg. | ✓ |
PRODUCT_IMAGE |
URL hlavnej fotografie produktu. | – |
SPECIFICATION_TABLE_IMAGE |
URL obrázka technickej tabuľky. | – |
DRAWING_IMAGE |
URL nákresu produktu. | – |
ALTERNATIVE_IMAGE |
URL ďalšieho obrázka. Môže sa opakovať viackrát. | – |
PRICE_CZK / PRICE_EUR / PRICE_PLN / PRICE_HUF |
Cena bez DPH za základnú jednotku v mene feedu. Ktoré polia sa zobrazia závisí od parametra lang. |
✓ |
UNIT |
Základná predajná jednotka (ks, m, kg…). | ✓ |
MOQ |
Minimálne odberné množstvo. | – |
PACK_SIZE |
Počet kusov v predajnom balení. | ✓ |
PACK_TYPE |
Typ predajného balenia (pozri tabuľku nižšie). | ✓ |
BULK_PACK_SIZE |
Počet kusov v hromadnom balení. | – |
BULK_PACK_TYPE |
Typ hromadného balenia (pozri tabuľku nižšie). | – |
STOCK |
Stav skladovej zásoby v základnej jednotke. | ✓ |
NEXT_RESTOCK_QTY |
Očakávané množstvo pri ďalšom naskladnení. | – |
NEXT_RESTOCK_DATE |
Očakávaný termín naskladnenia vo formáte YYYY-MM-DD. |
– |
CATEGORIES / CATEGORY |
Produktová kategória. Ak existuje nadkategória, sú uvedené dva elementy CATEGORY. |
✓ |
MANUFACTURER |
Výrobca. | ✓ |
Typy balenia
Hodnoty elementov
PACK_TYPE
a
BULK_PACK_TYPE
sú vždy v angličtine:
| Hodnota | Typ balenia |
|---|---|
BUNDLE | Zväzok |
REEL | Cievka |
PACKAGE | Balík |
CARTON | Kartón |
BARREL | Sud |
BAG | Vrece |
PALLET | Paleta |
Dôležité poznámky
-
Párovanie produktov:
Primárne párujte podľa
EAN— tento kód sa nikdy nemení.ART_NOsa môže vzácne zmeniť pri reštrukturalizácii sortimentu. - Aktuálnosť dát: Feed sa generuje raz denne. Stav skladu zodpovedá stavu v čase generovania — aktuálnu dostupnosť môžete overiť na e-shope.
- Frekvencia sťahovania: Odporúčame sťahovať feed najviac raz za hodinu. Nadmerné dotazovanie môže viesť k obmedzeniu prístupu.