XML feeds
Registered wholesale customers can access an automated XML feed with current pricing, stock levels and detailed product information. The feed is suitable for integration with ERP systems, e-commerce platforms or internal purchasing tools.
Who can access the feed?
The feed is available to customers with an annual turnover exceeding 4 000 EUR . To request an API key, write to tomoszek@metal-trade.cz .
How to download the feed?
The feed is available at:
https://xml.metal-trade.cz/feed.php?key=YOUR_API_KEY&lang=en
The
lang
parameter sets the feed language and price currency. Available values:
| lang | Language | Currency |
|---|---|---|
cz |
Czech | CZK + EUR |
sk |
Slovak | EUR |
de |
German | EUR |
en |
English | EUR |
pl |
Polish | PLN + EUR |
hu |
Hungarian | HUF + EUR |
XML Structure
The root element
<SHOP>
contains a list of
<SHOPITEM>
elements — each representing one product variant. Example:
<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/en/screw-eye-p41081/?vid=1289</URL> <PRODUCTNAME>Eye bolt, 8x4x1.8mm, Zn</PRODUCTNAME> <PARENT_PRODUCTNAME>Eye bolt</PARENT_PRODUCTNAME> <DIMENSIONS>8x4x1.8mm</DIMENSIONS> <MATERIAL>steel 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>pcs</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>Wire hardware</CATEGORY> <CATEGORY>Eye bolts</CATEGORY> </CATEGORIES> <MANUFACTURER>MTR</MANUFACTURER> </SHOPITEM> ... </SHOP>
Field reference
| Element | Description | Always |
|---|---|---|
ART_NO |
Product code. Can rarely change — use EAN as the primary matching key. |
✓ |
EAN |
EAN barcode. Never changes — recommended as the primary key for product matching. | ✓ |
URL |
Link to the product page in the requested language. | ✓ |
PRODUCTNAME |
Variant name in the feed language. | ✓ |
PARENT_PRODUCTNAME |
Master product name — for grouping variants. | ✓ |
DESCRIPTION |
Long product description. | – |
DIMENSIONS |
Variant dimensions. | ✓ |
MATERIAL |
Material. | – |
SURFACE_TREATMENT |
Surface treatment. | – |
WEIGHT_KG |
Weight in kg. | ✓ |
PRODUCT_IMAGE |
URL of the main product image. | – |
SPECIFICATION_TABLE_IMAGE |
URL of the technical specification table image. | – |
DRAWING_IMAGE |
URL of the technical drawing. | – |
ALTERNATIVE_IMAGE |
URL of an additional image. May appear multiple times. | – |
PRICE_CZK / PRICE_EUR / PRICE_PLN / PRICE_HUF |
Net price per base unit in the feed currency, excluding VAT. Which fields appear depends on the lang parameter. |
✓ |
UNIT |
Base sales unit (pcs, m, kg, bdl). | ✓ |
MOQ |
Minimum order quantity. | – |
PACK_SIZE |
Number of units per sales pack. | ✓ |
PACK_TYPE |
Sales pack type (see table below). | ✓ |
BULK_PACK_SIZE |
Number of units per bulk pack. | – |
BULK_PACK_TYPE |
Bulk pack type (see table below). | – |
STOCK |
Stock quantity in base units. | ✓ |
NEXT_RESTOCK_QTY |
Expected quantity at next restock. | – |
NEXT_RESTOCK_DATE |
Expected restock date in YYYY-MM-DD format. |
– |
CATEGORIES / CATEGORY |
Product category. If a parent category exists, two CATEGORY elements are listed. |
✓ |
MANUFACTURER |
Manufacturer. | ✓ |
Packaging Types
Values of
PACK_TYPE
and
BULK_PACK_TYPE
are always in English:
| Value | Type |
|---|---|
BUNDLE | Bundle |
REEL | Reel |
PACKAGE | Package |
CARTON | Carton |
BARREL | Barrel |
BAG | Bag |
PALLET | Pallet |
Important Notes
-
Product matching:
Always use
EANas the primary matching key — it never changes.ART_NOcan rarely change when the product range is restructured. -
Product family:
Variants of the same product share the
ART_NOprefix before the hyphen — e.g.1200-0603and1200-0804belong to the same product (1200). - Data freshness: The feed is generated once per day. Stock figures reflect the state at the time of generation — current availability can be verified on the e-shop.
- Download frequency: We recommend downloading the feed no more than once per hour. Excessive requests may result in access being restricted.
Changelog
| Version | Date | Changes |
|---|---|---|
v1.1 |
2026-08-14 | Added the DESCRIPTION element with the long product description (from the master product). |
v1.0 |
2026-05-03 |
First stable feed version — SHOP/SHOPITEM structure, core fields
(ART_NO, EAN, URL, PRODUCTNAME, prices, stock, categories, etc.).
|