Kanały XML
Zarejestrowanym klientom hurtowym udostępniamy automatyczny feed XML z aktualnymi cenami, stanami magazynowymi i szczegółowymi informacjami o produktach. Feed nadaje się do integracji z systemami ERP, sklepami internetowymi lub wewnętrznymi narzędziami zakupowymi.
Kto może otrzymać feed?
Feed jest dostępny dla odbiorców z rocznym obrotem przekraczającym 20 000 PLN / 4 000 EUR . Aby otrzymać klucz API, prosimy o kontakt pod adresem tomoszek@metal-trade.cz .
Jak pobrać feed?
Feed jest dostępny pod adresem:
https://xml.metal-trade.cz/feed.php?key=TWÓJ_KLUCZ_API&lang=pl
Parametr
lang
określa język feedu i walutę cen. Dostępne wartości:
| lang | Język | Waluta |
|---|---|---|
cz |
Czeski | CZK + EUR |
sk |
Słowacki | EUR |
de |
Niemiecki | EUR |
en |
Angielski | EUR |
pl |
Polski | PLN + EUR |
hu |
Węgierski | HUF + EUR |
Struktura XML
Element główny
<SHOP>
zawiera listę elementów
<SHOPITEM>
— każdy odpowiada jednej wariancie produktu. Przykład:
<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/pl/sruba-oczkowa-p41081/?vid=1289</URL> <PRODUCTNAME>Oko z wkrętem, 8x4x1,8mm, Zn</PRODUCTNAME> <PARENT_PRODUCTNAME>Oko z wkrętem</PARENT_PRODUCTNAME> <DIMENSIONS>8x4x1,8mm</DIMENSIONS> <MATERIAL>stal 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_PLN>0.0272</PRICE_PLN> <PRICE_EUR>0.0066</PRICE_EUR> <UNIT>szt</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>Akcesoria druciane</CATEGORY> <CATEGORY>Oka gwintowane</CATEGORY> </CATEGORIES> <MANUFACTURER>MTR</MANUFACTURER> </SHOPITEM> ... </SHOP>
Opis pól
| Element | Opis | Zawsze |
|---|---|---|
ART_NO |
Kod produktu. Może się rzadko zmieniać — do parowania używaj przede wszystkim EAN. |
✓ |
EAN |
Kod EAN. Nigdy się nie zmienia — zalecany jako główny klucz do parowania produktów. | ✓ |
URL |
Link do strony produktu w wybranym języku. | ✓ |
PRODUCTNAME |
Nazwa wariantu w języku feedu. | ✓ |
PARENT_PRODUCTNAME |
Nazwa produktu nadrzędnego — do grupowania wariantów. | ✓ |
DIMENSIONS |
Wymiary wariantu. | ✓ |
MATERIAL |
Materiał. | – |
SURFACE_TREATMENT |
Obróbka powierzchni. | – |
WEIGHT_KG |
Waga w kg. | ✓ |
PRODUCT_IMAGE |
URL głównego zdjęcia produktu. | – |
SPECIFICATION_TABLE_IMAGE |
URL obrazu tabeli technicznej. | – |
DRAWING_IMAGE |
URL rysunku technicznego. | – |
ALTERNATIVE_IMAGE |
URL dodatkowego zdjęcia. Może pojawiać się wielokrotnie. | – |
PRICE_CZK / PRICE_EUR / PRICE_PLN / PRICE_HUF |
Cena netto za jednostkę podstawową w walucie feedu, bez VAT. Które pola się pojawią, zależy od parametru lang. |
✓ |
UNIT |
Podstawowa jednostka sprzedaży (szt, m, kg…). | ✓ |
MOQ |
Minimalna ilość zamówienia. | – |
PACK_SIZE |
Liczba sztuk w opakowaniu sprzedażowym. | ✓ |
PACK_TYPE |
Typ opakowania sprzedażowego (patrz tabela poniżej). | ✓ |
BULK_PACK_SIZE |
Liczba sztuk w opakowaniu zbiorczym. | – |
BULK_PACK_TYPE |
Typ opakowania zbiorczego (patrz tabela poniżej). | – |
STOCK |
Stan magazynu w jednostkach podstawowych. | ✓ |
NEXT_RESTOCK_QTY |
Oczekiwana ilość przy następnym uzupełnieniu magazynu. | – |
NEXT_RESTOCK_DATE |
Oczekiwana data uzupełnienia w formacie YYYY-MM-DD. |
– |
CATEGORIES / CATEGORY |
Kategoria produktu. Jeśli istnieje kategoria nadrzędna, podane są dwa elementy CATEGORY. |
✓ |
MANUFACTURER |
Producent. | ✓ |
Typy opakowań
Wartości elementów
PACK_TYPE
i
BULK_PACK_TYPE
są zawsze w języku angielskim:
| Wartość | Typ opakowania |
|---|---|
BUNDLE | Wiązka |
REEL | Szpula |
PACKAGE | Opakowanie |
CARTON | Karton |
BARREL | Beczka |
BAG | Worek |
PALLET | Paleta |
Ważne uwagi
-
Parowanie produktów:
Używaj
EANjako głównego klucza do parowania — nigdy się nie zmienia.ART_NOmoże rzadko ulec zmianie przy restrukturyzacji asortymentu. - Aktualność danych: Feed jest generowany raz dziennie. Stan magazynu odpowiada stanowi w chwili generowania — aktualną dostępność można sprawdzić w sklepie internetowym.
- Częstotliwość pobierania: Zalecamy pobieranie feedu nie częściej niż raz na godzinę. Nadmierne zapytania mogą skutkować ograniczeniem dostępu.