Przejdź do treści
ABHelp ABHelpCentrum pomocy Historia zmianPanel

Przykłady: plik XML bez wariantów

Przykłady mapowania plików XML hurtowni bez wariantów: prosty plik, cena netto i brutto w atrybutach, setki parametrów, dostępność słowami, kod terminu dostawy, progi >10, nazwa w dwóch językach.

Ostatnia aktualizacja: 16 listopada 2026
  1. Jak czytać przykłady

    Każdy przykład to: kawałek pliku od hurtowni, co wybrać w kreatorze, co dostaniesz (lista ofert) i uwaga — pułapka, na którą warto uważać. Wszystkie hurtownie, produkty i ceny są wymyślone. Znak ... oznacza „i tak dalej”.
  2. Przykład A: prosty plik — lista produktów

    Hurtownia Lumenis Hurt wysyła najprostszy plik: każdy produkt ma kod, EAN, nazwę, cenę i stan.
    • <produkty>
    •   <produkt>
    •     <kod>LUM-1001</kod>
    •     <ean>5905123400070</ean>
    •     <nazwa>Lampa wisząca Brzask 30 cm biała</nazwa>
    •     <cena>129.00</cena>
    •     <stan>12</stan>
    •   </produkt>
    •   ...
    • </produkty>
    Co wybrać w kreatorze
    1. Element produktu: /produkty/produkt — program podpowie go sam.
    2. kod → SKU, ean → EAN, nazwa → Nazwa — podpowiedziane.
    3. cena → Cena → cennik… Wybierz netto albo brutto (podpowiadamy brutto, bo w pliku nie ma tego słowa — sprawdź u hurtowni).
    4. stan → Stan → magazyn….
    Co dostaniesz
    • Lampa wisząca Brzask 30 cm biała · SKU LUM-1001 · EAN 5905123400070 · cena 129,00 zł · stan 12
    • Kinkiet Fala 15 cm czarny · SKU LUM-1002 · EAN 5905123400148 · cena 89,50 zł · stan 0
    • Plafon Lumo 40 cm · SKU LUM-1003 · EAN 5905123400216 · cena 219,00 zł · stan 5
    Uwaga: plik nie ma kolumny ID. Nic się nie stanie — oferty rozpoznamy po SKU. Jeśli hurtownia kiedyś zmieni kod produktu, powstanie nowa oferta.
  3. Przykład B: dwie ceny w jednym znaczniku — netto i brutto

    Ceny są zapisane jako atrybuty — w środku znacznika, po znaku „=”.
    • <produkt id="2001">
    •   <kod>LB-2001</kod>
    •   <ean>5905123400285</ean>
    •   <nazwa>Kinkiet Fala czarny</nazwa>
    •   <price net="81.30" gross="100.00"/>
    •   <stan>5</stan>
    • </produkt>
    Netto czy brutto?
    • net / netto = cena bez VAT: 81,30 zł.
    • gross / brutto = cena z VAT 23%: 81,30 zł + 18,70 zł = 100,00 zł.
    Co wybrać w kreatorze
    1. Kolumny nazywają się price@net i price@gross (znak @ = atrybut). Program podpowie obie jako ceny: pierwszą jako netto, drugą jako brutto.
    2. Potrzebujesz jednej ceny? Zostaw jedną, drugą ustaw na Pomiń. Ceny zakupu zwykle liczy się netto.
    3. @id → ID oferty (podpowiedziane), kod → SKU, ean → EAN.
    Co dostaniesz
    • Kinkiet Fala czarny · SKU LB-2001 · netto 81,30 zł · brutto 100,00 zł · stan 5
    • Kinkiet Fala biały · SKU LB-2002 · netto 81,30 zł · brutto 100,00 zł · stan 3
    • Lampa biurkowa Bit · SKU LB-2003 · netto 64,23 zł · brutto 79,00 zł · stan 11
    Uwaga: oznaczenie netto/brutto nie zmienia liczby. Aby przeliczyć cenę netto na brutto, dodaj jawny krok VAT „Dolicz VAT” w cenniku albo w przepisie mapowania celu. Wybierz VAT produktu lub wpisz stałą stawkę i sprawdź przykłady przed zapisem.
  4. Przykład C: produkty z mnóstwem parametrów

    Hurtownia Światłomir przy każdej lampie dopisuje parametry: markę, moc, barwę światła. W prawdziwych plikach bywa ich kilkadziesiąt na produkt.
    • <produkt>
    •   <kod>SW-3001</kod>
    •   <nazwa>Plafon Lumo 40 cm</nazwa>
    •   <cena>219.00</cena>
    •   <stan>8</stan>
    •   <parametry>
    •     <param nazwa="Marka">Lumo</param>
    •     <param nazwa="Moc">24 W</param>
    •     <param nazwa="Barwa światła">3000 K</param>
    •   </parametry>
    • </produkt>
    Jak program to czyta
    • Parametrów jest więcej niż produktów, ale program wybierze /katalog/produkt — bo to produkt ma kod, nazwę, cenę i stan. Parametr ma tylko nazwę i wartość.
    • Parametry nie są wariantami. Lampa z 4 parametrami to dalej jedna oferta, a nie cztery.
    Co wybrać w kreatorze
    1. Element produktu: /katalog/produkt.
    2. Każdy parametr dostaje swoją kolumnę, np. parametry/param[@nazwa='Marka']. Program podpowie ją jako Producent / marka.
    3. Inne parametry (Moc, Barwa) zostaw na „Pomiń”, chyba że chcesz je mieć jako dane produktu.
    Co dostaniesz
    • Plafon Lumo 40 cm · SKU SW-3001 · marka Lumo · cena 219,00 zł · stan 8
    • Oprawa łazienkowa Kropla · SKU SW-3002 · marka Aqualux · cena 149,00 zł · stan 2
    • Listwa LED Linea 120 cm · SKU SW-3003 · marka Lumo · cena 99,00 zł · stan 40
    Uwaga: gdy parametr jest zapisany inaczej (np. nazwa i wartość w osobnych znacznikach), nie dostanie osobnej kolumny. Wtedy wpisz ścieżkę ręcznie w „Zaawansowane: ścieżka i przekształcenia”.
  5. Przykład D: stan zapisany słowami

    Hurtownia Lampy Bałtyk nie podaje liczby sztuk, tylko słowa.
    • <produkt>
    •   <kod>LB-4001</kod>
    •   <nazwa>Lampa stojąca Smukła</nazwa>
    •   <cena>349.00</cena>
    •   <dostepnosc>dużo na stanie</dostepnosc>
    • </produkt>
    W pliku są słowa: „dużo na stanie”, „dostępny”, „ostatnie sztuki”, „nie ma w magazynie” i „na zamówienie”.Co wybrać w kreatorze
    1. dostepnosc → Stan → magazyn… (wybierz sam — program tego nie podpowie, bo widzi słowa, a nie liczby).
    2. W polu mapy wpisz: dużo na stanie=100; dostępny=20; ostatnie sztuki=5; nie ma w magazynie=0.
    3. Reszta: kod → SKU, nazwa → Nazwa, cena → Cena.
    Co dostaniesz
    • Lampa stojąca Smukła · SKU LB-4001 · EAN 5905123400704 · cena 349,00 zł · stan 100
    • Kinkiet Muszla · SKU LB-4002 · EAN 5905123400773 · cena 119,00 zł · stan 20
    • Lampka nocna Sowa · SKU LB-4003 · EAN 5905123400841 · cena 59,00 zł · stan 5
    • Żyrandol Kaskada · SKU LB-4004 · EAN 5905123400919 · cena 899,00 zł · stan 0
    • Lampa wisząca Dzwon · SKU LB-4005 · EAN 5905123400988 · cena 259,00 zł · stan brak danych
    Uwaga: „na zamówienie” nie było w mapie, więc „Lampa wisząca Dzwon” ma brak danych, a nie 0. Liczby 100, 20 i 5 wybrałeś Ty — to umowa, nie prawdziwa liczba sztuk.
  6. Przykład E: liczba, która nie jest stanem — kod terminu dostawy

    Hurtownia Iskra Dystrybucja ma przy produkcie atrybut avail. Wygląda jak liczba, ale to kod terminu: 1 = wysyłka w 1 dzień, 3 = w 3 dni, 14 = w 2 tygodnie. Prawdziwy stan jest w stan.
    • <produkt avail="14">
    •   <kod>IS-5003</kod>
    •   <nazwa>Lampa ogrodowa Grzyb</nazwa>
    •   <cena>139.00</cena>
    •   <stan>6</stan>
    • </produkt>
    Co wybrać w kreatorze
    1. @avail → Pomiń. Program sam to podpowie — nie zmieniaj.
    2. stan → Stan → magazyn….
    Co dostaniesz
    • Oprawa schodowa Krok · SKU IS-5001 · EAN 5905123401053 · cena 69,00 zł · stan 14
    • Oprawa schodowa Krok czarna · SKU IS-5002 · EAN 5905123401121 · cena 69,00 zł · stan 0
    • Lampa ogrodowa Grzyb · SKU IS-5003 · EAN 5905123401190 · cena 139,00 zł · stan 6
    Uwaga: gdybyś ustawił @avail jako stan, lampa „Grzyb” miałaby 14 sztuk, choć hurtownia ma 6. Zanim wybierzesz kolumnę jako stan, sprawdź w opisie od hurtowni, co znaczą liczby.
  7. Przykład F: progi „>10” i „>100”

    Hurtownia Nordo Light przy dużych ilościach pisze „więcej niż”.
    • <produkt>
    •   <kod>NL-6001</kod>
    •   <nazwa>Żarówka LED E27 9 W</nazwa>
    •   <stan>>100</stan>
    • </produkt>
    Jak to czytamy
    • >10 → 11 (najmniejsza liczba większa niż 10).
    • >100 → 101.
    • Zwykłe liczby („7”, „0”) zostają bez zmian.
    Co wybrać w kreatorze
    1. stan → Stan → magazyn…. Nic więcej — zapis „>” rozumiemy sami.
    Co dostaniesz
    • Żarówka LED E27 9 W · SKU NL-6001 · EAN 5905123401268 · cena 12,90 zł · stan 101
    • Żarówka LED GU10 5 W · SKU NL-6002 · EAN 5905123401336 · cena 9,90 zł · stan 11
    • Żarówka LED E14 4 W · SKU NL-6003 · EAN 5905123401404 · cena 8,90 zł · stan 7
    • Żarówka filament E27 6 W · SKU NL-6004 · EAN 5905123401473 · cena 19,90 zł · stan 0
    Uwaga: bierzemy najmniejszą pewną liczbę. Jeśli wolisz inną (np. „>100” = 150), wpisz ją w mapie tekstu: >100=150. Zapis „<5” nie jest rozumiany sam — dopisz go do mapy, np. <5=2.
  8. Przykład G: nazwa schowana głębiej i w dwóch językach

    Hurtownia LuxPol trzyma nazwę w środku opis — po polsku i po angielsku.
    • <produkt id="8001">
    •   <kod>LX-8001</kod>
    •   <opis>
    •     <nazwa jezyk="pl">Lampa stojąca Smukła czarna</nazwa>
    •     <nazwa jezyk="en">Floor lamp Slim black</nazwa>
    •   </opis>
    •   <cena>349.00</cena>
    • </produkt>
    Co się stanie bez ustawień: kolumna opis/nazwa połączy obie nazwy: Lampa stojąca Smukła czarna | Floor lamp Slim black.Co wybrać w kreatorze
    1. opis/nazwa → Nazwa (podpowiedziane), opis/tresc → Opis.
    2. W panelu Warianty i łączenie pól rozwiń Pola wspólne i połącz kolumny, wybierz opis/nazwa i kliknij + Ustaw pole.
    3. Rozwiń Zaawansowane: ścieżka i przekształcenia i w polu ścieżki wpisz opis/nazwa[@jezyk='pl'] (czyli: nazwa, której jezyk = pl).
    4. Kliknij Wczytaj podgląd z pliku (także nowe ścieżki).
    Co dostaniesz
    • Lampa stojąca Smukła czarna · SKU LX-8001 · EAN 5905123402739 · cena 349,00 zł · stan 2
    • Lampa stojąca Smukła biała · SKU LX-8002 · EAN 5905123402807 · cena 349,00 zł · stan 0
    • Kinkiet Zorza mosiądz · SKU LX-8003 · EAN 5905123402876 · cena 229,00 zł · stan 6
    Prostszy sposób: zamiast ścieżki wpisz w „Funkcje po znaku |” słowo pierwszy — weźmiemy pierwszą nazwę z listy. Działa, dopóki hurtownia podaje polską nazwę jako pierwszą. Ścieżka z [@jezyk='pl'] jest pewniejsza.
Czy ten artykuł był pomocny?

Podgląd zdjęcia