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.	✓
`DESCRIPTION`	Długi opis produktu.	–
`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, wiązka).	✓
`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 EAN jako głównego klucza do parowania — nigdy się nie zmienia. ART_NO może rzadko ulec zmianie przy restrukturyzacji asortymentu.
Rodzina produktów: Warianty tego samego produktu mają wspólny prefiks kodu ART_NO przed myślnikiem — np. 1200-0603 i 1200-0804 należą do tego samego produktu (1200).
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.

Historia zmian

Wersja	Data	Zmiany
`v1.1`	2026-08-14	Dodano element `DESCRIPTION` z długim opisem produktu (z produktu nadrzędnego).
`v1.0`	2026-05-03	Pierwsza stabilna wersja feedu — struktura `SHOP`/`SHOPITEM`, podstawowe pola (`ART_NO`, `EAN`, `URL`, `PRODUCTNAME`, ceny, stan magazynowy, kategorie itd.).