Przejdź do treści
ABHelp ABHelpCentrum pomocy Historia zmianPanel

Przykłady: plik XML z wariantami (rozmiary, kolory)

Przykłady mapowania plików XML z wariantami: rozmiary w środku produktu, stan z wybranego magazynu, numery rozmiarów 0 i 1 w każdym produkcie, kolor i rozmiar z własnym EAN, cena z produktu gdy wariant jej nie ma.

Ostatnia aktualizacja: 16 listopada 2026
  1. Zanim zaczniesz

    Wariant to odmiana produktu — rozmiar, kolor, pojemność. W ABListings każdy wariant to osobna oferta z własnym SKU, EAN i stanem. Litery przykładów są dalszym ciągiem przykładów bez wariantów.
    Jedna lampa w trzech rozmiarach w pliku hurtowni daje trzy oferty z własnym SKU i stanem; cena przychodzi z produktu.
    Jedna lampa w trzech rozmiarach w pliku hurtowni daje trzy oferty z własnym SKU i stanem; cena przychodzi z produktu.
  2. Przykład H: rozmiary w środku produktu (format sklepów internetowych)

    Hurtownia Kandela eksportuje plik w formacie popularnym w sklepach internetowych. Każdy produkt ma sizes — listę rozmiarów. Każdy rozmiar ma swój kod, EAN i stany w dwóch magazynach.
    • <product id="7001">
    •   <description>
    •     <name>Lampa wisząca Brzask</name>
    •   </description>
    •   <price gross="129.00" net="104.88"/>
    •   <sizes>
    •     <size id="0" name="30 cm" code="ORB-30" code_producer="5905123401541">
    •       <stock id="1" quantity="4"/>
    •       <stock id="2" quantity="10"/>
    •     </size>
    •     <size id="1" name="45 cm" code="ORB-45" code_producer="5905123401619">
    •       <stock id="1" quantity="0"/>
    •       <stock id="2" quantity="2"/>
    •     </size>
    •   </sizes>
    • </product>
    Co wybrać w kreatorze
    1. Element produktu: /offer/products/product.
    2. Warianty: Każdy „sizes/size” to osobna oferta. Magazyny stock nie są wariantami — to miejsca, gdzie leży towar.
    3. description/name → Nazwa, price@gross → Cena brutto (podpowiedziane). price@net → Pomiń (albo drugi cennik).
    4. sizes/size@code → SKU (podpowiedziane z rozmiaru).
    5. sizes/size@code_producer → EAN (podpowiedziane — to kod kreskowy, choć nazywa się „kod producenta”).
    6. Stan: kreator zapyta Hurtownia podaje stan w kilku magazynach: Magazyn 1, Magazyn 2. Który brać? Podpowie Magazyn 2 — tylko on ma stan w każdym rozmiarze (Kinkiet Fala 25 cm nie ma wpisu w magazynie 1). Możesz wybrać Magazyn 1 albo sumę.
    7. @id → Pomiń (dlaczego — w przykładzie I).
    Co dostaniesz
    • Lampa wisząca Brzask — 30 cm · SKU ORB-30 · EAN 5905123401541 · cena 129,00 zł · stan 4
    • Lampa wisząca Brzask — 45 cm · SKU ORB-45 · EAN 5905123401619 · cena 129,00 zł · stan 0
    • Kinkiet Fala — 15 cm · SKU FAL-15 · EAN 5905123401688 · cena 89,00 zł · stan 7
    • Kinkiet Fala — 25 cm · SKU FAL-25 · EAN 5905123401756 · cena 89,00 zł · stan brak danych
    • Plafon Lumo — 40 cm · SKU LUMO-40 · EAN 5905123401824 · cena 219,00 zł · stan 2
    • Plafon Lumo — 60 cm · SKU LUMO-60 · EAN 5905123401893 · cena 219,00 zł · stan 12
    Nazwa wariantu składa się sama: nazwa produktu + „ — ” + nazwa rozmiaru. Cena przychodzi z produktu do każdego rozmiaru. Stany powyżej są dla Magazynu 1. Z podpowiadanym Magazynem 2 wyjdzie: 10, 2, 1, 5, 0, 3; z sumą: 14, 2, 8, brak danych, 2, 15. Uwaga: „Kinkiet Fala — 25 cm” nie ma nic w magazynie 1 (jest tylko w magazynie 2), więc przy Magazynie 1 i przy sumie ma brak danych, a nie 0. Przy jednym magazynie liczymy stan z niego; przy sumie brak w jednym magazynie też daje brak danych.
  3. Przykład I: rozmiary mają numery 0, 1, 2 w każdym produkcie

    W tym samym formacie rozmiary często mają id="0", id="1" — w każdym produkcie od nowa. To jak numery mieszkań: mieszkanie 1 jest w każdym bloku.
    • <product id="7101">
    •   <description><name>Klosz szklany Kula</name></description>
    •   <sizes>
    •     <size id="0" name="20 cm" code_producer="5905123401961">...</size>
    •     <size id="1" name="30 cm" code_producer="5905123402036">...</size>
    •   </sizes>
    • </product>
    • <product id="7102">
    •   <sizes>
    •     <size id="0" name="20 cm" ...>...</size>
    •     <size id="1" name="30 cm" ...>...</size>
    •   </sizes>
    • </product>
    Co się stanie bez poprawki: oferty dostałyby ID „0”, „1”, „0”, „1”. Nie zgubimy żadnej oferty po cichu — pobranie zatrzyma się i powie, ile ID się powtarza. Kreator sam proponuje ID złożone: ID produktu + ID rozmiaru.Ręcznie, w widoku zaawansowanym — „adres” zamiast numeru mieszkania (najprościej: zaznacz „ID oferty = ID produktu + ID wariantu”; albo krok po kroku:)
    1. @id → ID oferty.
    2. W panelu Warianty i łączenie pól rozwiń Pola wspólne i połącz kolumny, wybierz @id i kliknij + Ustaw pole.
    3. Kliknij + Połącz kolumnę — pole ma teraz dwie kolumny.
    4. Rozwiń Zaawansowane: ścieżka i przekształcenia i w polu ścieżki wpisz ../@id (czyli: ID produktu nadrzędnego). Druga kolumna zostaje @id (ID rozmiaru).
    5. W polu Separator wpisz -. Źródło zostaw „Wariant, gdy puste — produkt”.
    Co dostaniesz
    • ID 7101-0 · Klosz szklany Kula — 20 cm · EAN 5905123401961 · stan 3
    • ID 7101-1 · Klosz szklany Kula — 30 cm · EAN 5905123402036 · stan 0
    • ID 7102-0 · Klosz szklany Stożek — 20 cm · EAN 5905123402104 · stan 8
    • ID 7102-1 · Klosz szklany Stożek — 30 cm · EAN 5905123402173 · stan 1
    Prostsza droga: jeśli każdy rozmiar ma własny kod (SKU), ustaw @id na „Pomiń” — oferty rozpoznamy po SKU, jak w przykładzie H.
  4. Przykład J: kolor i rozmiar, własny EAN, cena z produktu, gdy wariant jej nie ma

    Hurtownia Promyk ma warianty z kolorem i rozmiarem. Niektóre warianty mają własną cenę, inne nie.
    • <produkt>
    •   <id>P300</id>
    •   <sku>KOR</sku>
    •   <ean>5905123402241</ean>
    •   <nazwa>Lampa wisząca Koral</nazwa>
    •   <cena>159.00</cena>
    •   <warianty>
    •     <wariant>
    •       <id>P300-1</id> <sku>KOR-B-30</sku> <ean>5905123402319</ean>
    •       <kolor>biały</kolor> <rozmiar>30 cm</rozmiar>
    •       <cena></cena> <stan>6</stan>
    •     </wariant>
    •     <wariant>
    •       <id>P300-2</id> <sku>KOR-C-30</sku> <ean>5905123402388</ean>
    •       <kolor>czarny</kolor> <rozmiar>30 cm</rozmiar>
    •       <cena>165.00</cena> <stan>0</stan>
    •     </wariant>
    •     <wariant>
    •       <id>P300-3</id> <sku>KOR-C-45</sku> <ean></ean>
    •       <kolor>czarny</kolor> <rozmiar>45 cm</rozmiar>
    •       <cena></cena> <stan>3</stan>
    •     </wariant>
    •   </warianty>
    • </produkt>
    Co wybrać w kreatorze
    1. Warianty: Każdy „warianty/wariant” to osobna oferta.
    2. Role (podpowiedziane): id → ID oferty, sku → SKU, ean → EAN, nazwa → Nazwa, cena → Cena, stan → Stan.
    3. W pytaniu Jak ma się nazywać oferta? program proponuje wszystkie cechy wersji: klocki kolor i rozmiar. Znak: spacja. Zostaw zaznaczone „Nie powtarzaj słów, które już są w nazwie”.
    4. Sprawdź SKU: „Wartość / sufiks SKU” = sku, „SKU produktu + sufiks” odznaczone — warianty mają własne SKU.
    5. „EAN tylko wariantu” = ean.
    6. Cena: pusta cena wersji sama dostaje cenę produktu. Pusty stan i pusty EAN zostają brakiem.
    Co dostaniesz
    • Lampa wisząca Koral biały 30 cm · SKU KOR-B-30 · EAN 5905123402319 · cena 159,00 zł · stan 6
    • Lampa wisząca Koral czarny 30 cm · SKU KOR-C-30 · EAN 5905123402388 · cena 165,00 zł · stan 0
    • Lampa wisząca Koral czarny 45 cm · SKU KOR-C-45 · EAN — · cena 159,00 zł · stan 3
    • Plafon Mgiełka 40 cm biały · SKU MGL-B · EAN 5905123402524 · cena 189,00 zł · stan 2
    • Plafon Mgiełka 40 cm szary · SKU MGL-S · EAN 5905123402593 · cena 189,00 zł · stan 3
    • Kinkiet Iskra · SKU ISK · EAN 5905123402661 · cena 99,00 zł · stan 4
    Uwagi
    • „Lampa wisząca Koral czarny 45 cm” nie ma EAN — i nie dostanie EAN produktu. Inaczej wszystkie warianty miałyby ten sam kod kreskowy.
    • W produkcie „Plafon Mgiełka 40 cm” rozmiar „40 cm” już jest w nazwie, więc nie dopisujemy go drugi raz.
    • „Kinkiet Iskra” nie ma wariantów — zostaje jedną ofertą, jak był.
    • Bez klocka rozmiar dwa różne rozmiary nazywałyby się tak samo: „Lampa wisząca Koral czarny”.
  5. Sprawdź również

Czy ten artykuł był pomocny?

Podgląd zdjęcia