Dokumentacja IOF Extensions - szczegółowe informacje o towarach w ofercie w formacie IOF

IOF Extensions to propozycja IAI skierowana do najbardziej wymagających użytkowników chcących zastosować format IOF z bardzo szczegółowymi danymi o towarach w ofercie.

Co to jest IOF Extensions i do czego można użyć tych rzoszerzeń?

IOF Extensions jest rozszerzeniem tagów formatu IOF i pozwala na obsługę bardzo szczegółowych danych towarów w ofercie. Rozszerzenia polecamy szczególnie tym użytkownikom IdoSell Shop (IAI-Shop.com), którzy oprócz standardowej funkcjonalności IOF potrzebują gotowego standardu na obsługę szerszego wachlarza danych o towarach.

Chcę używać rozszerzeń IOF Extensions. Co mam zrobić?

Jeżeli po raz pierwszy masz styczność z formatem IOF, zalecamy zapoznać się ze specyfikacją funkcjonalną formatu oraz przystosowaniem swojego systemu do formatu IOF. W następnej kolejności, zapoznaj się z poniższymi punktami na tej stronie, które omawiają szczegółowo rozszerzenie pliku formatu IOF full.xml o tagi Extensions.

Przejdź do strony specyfikacji IOF, aby pobrać dokument specyfikacji funkcjonalnej.

Jeżeli znasz i pracujesz z formatem IOF, dodanie obsługi rozszerzonych tagów Extensions nie powinno być dla Ciebie problemem. Dodanie obsługi Extensions wymaga tylko ingerencji w plik full.xml. Przejdź do dalszej części strony, aby dowiedzieć się jak dodać obsługę Extensions w formacie IOF.

Jakich zasad muszę się trzymać korzystając z rozszerzonych tagów IOF Extensions?

Zalecamy zapoznać się z poniższymi punktami przed przystąpieniem do tworzenia pliku full.xml z uwzględnieniem rozszerzonych tagów Extensions:

  • w głównym tagu <offer> został wprowadzony dodatkowy atrybut @extensions, za pomocą którego można określić czy dodatkowe atrybuty towarów mają być brane pod uwagę przy odczytywaniu oferty - zalecamy ustawienie wartości atrybutu na yes,

brak zadeklarowanego atrybutu @extensions oznacza domyślną jego wartość na no,

  • wymagane jest zadeklarowanie domyślnego namespace dla formatu IOF za pomocą atrybutu @xmlns w głównym tagu <offer>,
  • wymagane jest zadeklarowanie namespace dla Extensions w tagu <products> jako atrybut @xmlns:nazwa, gdzie nazwa to przyjęte oznaczenie tagów Extensions, np.:

  • każdy użyty w pliku full.xml tag Extensions musi być odpowiednio oznaczony za pomocą nazwy namespace, co odpowiada za przyporządkowanie tagu do odpowiedniej namespace, np.:

        
        

Jakie dodatkowe informacje o towarach obsługuje IOF Extensions?

Poniżej znajduje się lista tagów dostępnych dla każdego towaru w ramach Extensions (dot. wszystkich wersji IOF, chyba, że w opisie danego tagu jest odnotowane inaczej):

Towary skojarzone


węzeł w pliku full.xml offer / products / product / iaiext:associated_products / iaiext:product
lista wymaganych atrybutów : możliwe wartość @id
: identyfikator istniejącego towaru
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:associated_products>
                            <iaiext:product id="572"/>
                            <iaiext:product id="573"/>
                        </iaiext:associated_products>
                    </product>
                </products>
            </offer>        
        


Opis towaru dla aukcji


węzeł w pliku full.xml offer / products / product / description / iaiext:auction_long_desc
lista wymaganych atrybutów : możliwe wartość @xml:lang
: kod języka (podawany opcjonalnie)
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <description>
                            <iaiext:auction_long_desc xml:lang="eng"></iaiext:auction_name>
                            <iaiext:auction_long_desc xml:lang="pol"></iaiext:auction_name>
                        </description>
                    </product>
                </products>
            </offer>    
        


Nazwa towaru dla aukcji


węzeł w pliku full.xml offer / products / product / description / iaiext:auction_name
lista wymaganych atrybutów : możliwe wartość @xml:lang
: kod języka (podawany opcjonalnie)
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <description>
                            <iaiext:auction_name xml:lang="eng"></iaiext:auction_name>
                            <iaiext:auction_name xml:lang="pol"></iaiext:auction_name>
                        </description>
                    </product>
                </products>
            </offer>    
        


Cena dla serwisów aukcyjnych z możliwością zdefiniowania różnych typów cen dla stron, rozmiarów i poszczególnego serwisu aukcyjnego


węzeł w pliku full.xml offer / products / product / iaiext:auction_price / iaiext:site
lista wymaganych atrybutów : możliwe wartość @id
: identyfikator strony/sklepu @servis_group_id
: 2 - grupa Allegro
: 3 - grupa Ebay
@servis_id
: 0 - eBay.com
: 1 - Allegro.pl
: 2 - eBay.ca
: 3 - eBay.co.uk
: 15 - eBay.com.au
: 16 - eBay.at
: 34 - Aukro.bg
: 56 - Aukro.cz
: 71 - eBay.fr
: 77 - eBay.de
: 101 - eBay.it
: 168 - Molotok.ru
: 186 - eBay.es
: 205 - eBay.ie
: 209 - Aukro.com.ua
: 212 - eBay.pl
: 228 - TestWebAPI
@price_type
: buy_now - cena kup teraz
: minimal - cena minimalna
: start - cena wywoławcza licytacji
@size_id
: identyfikator rozmiaru z pliku sizes.xml @gross
: wartość ceny hurtowej brutto @net
: wartość ceny hurtowej netto
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:price_retail>
                            <iaiext:auction_price>
                                <iaiext:site id="1" price_type="start" gross="810.00" net="658.54" vat= "23.0"/>
                                <iaiext:site id="1" price_type="buy_now" gross="1010.00" net="821.14" vat= "23.0"/>
                                <iaiext:site id="1" price_type="minimal" gross="810.00" net="658.54" vat= "23.0"/>
                                <iaiext:site id="1" service_group_id="2" service_id="1" price_type="start" gross="820.00" net="666.67" vat="23.0"/>
                                <iaiext:site id="1" service_group_id="2" service_id="1" price_type="buy_now" gross="1020.00" net="829.27" vat="23.0"/>
                                <iaiext:site id="1" service_group_id="2" service_id="1" price_type="minimal" gross="820.00" net="666.67" vat="23.0"/>
                            </iaiext:auction_price>
                    </product>
                </products>
            </offer>
        


Określenie dostępności towaru z obsługą wielu stron


węzeł w pliku full.xml offer / products / product / iaiext:availability / iaiext:site
lista wymaganych atrybutów : możliwe wartość @id
: identyfikator strony/sklepu @value
: yes - towar widoczny na stronie
: no - towar nie widoczny na stronie
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:availability>
                            <iaiext:site id="1" value="yes"/>
                        </iaiext:availability>
                    </product>
                </products>
            </offer>    
        


Określanie dostępności towaru na magazynie


węzeł w pliku full.xml offer / products / product / iaiext:availability_management
lista wymaganych atrybutów : możliwe wartość @value
: manual - dostępność ma być określana ręcznie
: stock - dostępność ma być określana a podstawie ilości w magazynach
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:availability_management value="manual"/>
                    </product>
                </products>
            </offer>
        


Kategoria IAI


węzeł w pliku full.xml offer / products / product / iaiext:category_idosell
lista wymaganych atrybutów : możliwe wartość @id
: identyfikator kategorii IAI @xml:lang
: kod języka (podawany opcjonalnie) @path
: ścieżka nazwy kategorii IAI
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:iai_category id="5" xml:lang="pol" path="Aparaty, kamery i przyrządy optyczne > Akcesoria do aparatów, kamer i przyrządów optycznych > Akcesoria do obiektywów > Filtry na obiektywy"/>
                    </product>
                </products>
            </offer>    
        


Dostawca towaru


węzeł w pliku full.xml offer / products / product / iaiext:deliverer
lista wymaganych atrybutów : możliwe wartość @id
: identyfikator dostawcy
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:deliverer id="1"/>
                    </product>
                </products>
            </offer>    
        


Ustawienie czasu potrzebnego na sprowadzenie towaru od dostawcy


węzeł w pliku full.xml offer / products / product / iaiext:delivery_time / iaiext:mode
lista wymaganych atrybutów : możliwe wartość @type
: deliverer - czas dostawy ma być obliczany na podstawie czasu dostawcy przypisanego do towaru
: product - czas dostawy ma być obliczany na podstawie indywidualnego czasu z karty towaru
@days
: ilość dni
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:delivery_time unit="day" value="20">
                            <iaiext:mode type="product"/>
                            <iaiext:time days="20"/>
                        </iaiext:delivery_time>
                    </product>
                </products>
            </offer>    
        


Opcje dodatkowe dla parametrów


węzeł w pliku full.xml dotyczy tylko: IOF 2.5 i IOF 2.6 offer / products / product / parameters / parameter
lista wymaganych atrybutów : możliwe wartość @iaiext:distinction
: y - parametr wyróżnony
: n - parametr nie wyróżniony
@iaiext:hide
: y - parametr ukryty na liście parametrów w karcie towaru
: n - parametr nie ukryty na liście parametrów w karcie towaru
@iaiext:group_distinction
: y - parametr rozróżniający towary w grupie
: n - parametr nie rozróżniający towary w grupie
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <parameters>
                            <parameter id="781" name="Typ" xml:lang="pol" iaiext:distinction="y" iaiext:group_distinction="y" iaiext:hide="y" iaiext:auction_template_hide="y" iaiext:priority="0" iaiext:context_id="CONTEXT_STATE"><value id="784" name="white" xml:lang="pol" iaiext:priority="0" iaiext:context_id="CONTEXT_STATE_NEW"/>
                        </parameters>
                    </product>
                </products>
            </offer>    
        


Dostępność towaru dla sprzedaży POS


węzeł w pliku full.xml offer / products / product / iaiext:enable_in_pos
lista wymaganych atrybutów : możliwe wartość @enabled
: yes - towar dostępny w sprzedaży POS
: no - towar niedostępny w sprzedaży POS
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:enable_in_pos enabled="yes"/>
                    </product>
                </products>
            </offer>
        


Ręczna konfiguracja strefy Przecena


węzeł w pliku full.xml offer / products / product / iaiext:hotspots / iaiext:site / iaiext:discount
lista wymaganych atrybutów : możliwe wartość @visible
: yes - towar będzie pokazywany w strefie
: no - towar nie będzie pokazywany w strefie
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:hotspots>
                            <iaiext:site id="1" manual_config="yes">
                                <iaiext:discount visible="yes"/>
                            </iaiext:site>
                        </iaiext:hotspots>    
                    </product>
                </products>
            </offer>
        


Ręczna konfiguracja strefy Wyróżnione


węzeł w pliku full.xml offer / products / product / iaiext:hotspots / iaiext:site / iaiext:distinguished
lista wymaganych atrybutów : możliwe wartość @visible
: yes - towar będzie pokazywany w strefie
: no - towar nie będzie pokazywany w strefie
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:hotspots>
                            <iaiext:site id="1" manual_config="yes">
                                <iaiext:distinguished visible="yes"/>
                            </iaiext:site>
                        </iaiext:hotspots>    
                    </product>
                </products>
            </offer>
        


Ręczna konfiguracja strefy Promocja


węzeł w pliku full.xml offer / products / product / iaiext:hotspots / iaiext:site / iaiext:promotion
lista wymaganych atrybutów : możliwe wartość @visible
: yes - towar będzie pokazywany w strefie
: no - towar nie będzie pokazywany w strefie
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:hotspots>
                            <iaiext:site id="1" manual_config="yes">
                                <iaiext:promotion visible="yes"/>
                            </iaiext:site>
                        </iaiext:hotspots>    
                    </product>
                </products>
            </offer>
        


Ręczna konfiguracja strefy Specjalne


węzeł w pliku full.xml offer / products / product / iaiext:hotspots / iaiext:site / iaiext:special
lista wymaganych atrybutów : możliwe wartość @visible
: yes - towar będzie pokazywany w strefie
: no - towar nie będzie pokazywany w strefie
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:hotspots>
                            <iaiext:site id="1" manual_config="yes">
                                <iaiext:special visible="yes"/>
                            </iaiext:site>
                        </iaiext:hotspots>    
                    </product>
                </products>
            </offer>
        


Ustawienia pokazywania towarów w strefach hotspot


węzeł w pliku full.xml offer / products / product / iaiext:hotspots / iaiext:site
lista wymaganych atrybutów : możliwe wartość @id
: identyfikator strony/sklepu @manual_config
: yes - strefy hotspot ustawiane ręcznie
: no - strefy hotspot generowane automatycznie
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:hotspots>
                            <iaiext:site id="1" manual_config="yes"/>
                        </iaiext:hotspots>    
                    </product>
                </products>
            </offer>
        


Ikona dla aukcji interenetowej


węzeł w pliku full.xml dotyczy tylko: IOF 2.5 offer / products / product / iaiext:icons / iaiext:auction_icon
lista wymaganych atrybutów : możliwe wartość @url
: link obrazka ikony @date_changed
: data ostatniej modyfikacji obrazka ikony @hash
: klucz md5 obrazka ikony
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:icons>
                            <iaiext:auction_icon url=" http://example.iai-shop.com/data/gfx/icons/versions/4/7/574.jpg" date_changed="2018-04-19 09:29:20" hash="c6b80d307c4446d79b64a058cb07815f"/>
                        </iaiext:icons>
                    </product>
                </products>
            </offer>    
        


Ikona dla towaru w grupie


węzeł w pliku full.xml dotyczy tylko: IOF 2.5 offer / products / product / iaiext:icons / iaiext:group_icon
lista wymaganych atrybutów : możliwe wartość @url
: link obrazka ikony @date_changed
: data ostatniej modyfikacji obrazka ikony @hash
: klucz md5 obrazka ikony
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:icons>
                            <iaiext:group_icon url=" http://example.iai-shop.com/data/gfx/icons/versions/4/7/574.jpg" date_changed="2018-04-19 09:29:20" hash="c6b80d307c4446d79b64a058cb07815f"/>
                        </iaiext:icons>
                    </product>
                </products>
            </offer>    
        


Określenie ilości sprzedawanej w opakowaniu


węzeł w pliku full.xml offer / products / product / iaiext:inwrapper
lista wymaganych atrybutów : możliwe wartość @quantity
: ilość
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:inwrapper quantity="10"/>
                    </product>
                </products>
            </offer>;
        


Lokalizacja towaru na magazynie


węzeł w pliku full.xml dotyczy tylko: IOF 2.5 i IOF 2.6 offer / products / product / iaiext:sizes / iaiext:size / iaiext:stock
lista wymaganych atrybutów : możliwe wartość @iaiext:location_id
: identyfikator lokalizacji w magazynie @iaiext:location_text_id
: nazwa lokalizacji w magazynie
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:sizes>
                            <iaiext:size ...>
                                <iaiext:stock ... iaiext:location_id="1"  iaiext:location_text_id="Magazyn A / Regał nr 4"/>
                            </iaiext:size>
                        </iaiext:sizes>
                    </product>
                </products>
            </offer>
        


Ustawienia programu lojalnościowego z podziałem na strony


węzeł w pliku full.xml offer / products / product / iaiext:loyalty_program / iaiext:site
lista wymaganych atrybutów : możliwe wartość @id
: identyfikator strony/sklepu @operation
: clients_cost - określa, którzy klienci mogą kupować wybrane towary za punkty
: clients_award - określa, czy klient otrzymuje punkty za zakup towaru pieniędzmi
: count_cost - określa ilości punktów za jaką sprzedawany będzie towary
: count_award - określa ilości punktów jaką zostaną nagrodzeni klienci za kupno wybranego towaru
@clients
: wholesalers - hurtownicy
: retailers - detaliści
: both - hurtownicy i detaliści
: nobody - hurtownicy i detaliści (wyłączenie możliwości kupowania i nagradzania punktami)
@points
: ilość punktów
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:loyalty_program>
                            <iaiext:site id="1" operation="count_cost" clients="retailers" points="10"/>
                            <iaiext:site id="1" operation="count_cost" clients="wholesalers" points="20"/>
                            <iaiext:site id="1" operation="client_award" clients="retailers" points="100"/>
                            <iaiext:site id="1" operation="client_award" clients="wholesalers" points="200"/>
                        </iaiext:loyalty_program>
                    </product>
                </products>
            </offer>    
        


Meta-dane (Opis

)
węzeł w pliku full.xml offer / products / product / description / iaiext:meta_description
lista wymaganych atrybutów : możliwe wartość @xml:lang
: kod języka (podawany opcjonalnie)
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <description>
                            <iaiext:meta_description xml:lang="eng"></iaiext:meta_description>
                            <iaiext:meta_description xml:lang="pol"></iaiext:meta_description>
                        </description>
                    </product>
                </products>
            </offer>    
        


Meta-dane (Słowa kluczowe

)
węzeł w pliku full.xml offer / products / product / description / iaiext:meta_keywords
lista wymaganych atrybutów : możliwe wartość @xml:lang
: kod języka (podawany opcjonalnie)
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <description>
                            <iaiext:meta_keywords xml:lang="eng"></iaiext:meta_keywords>
                            <iaiext:meta_keywords xml:lang="pol"></iaiext:meta_keywords>
                        </description>
                    </product>
                </products>
            </offer>    
        


Meta-dane (Tytuł

)
węzeł w pliku full.xml offer / products / product / description / iaiext:meta_title
lista wymaganych atrybutów : możliwe wartość @xml:lang
: kod języka (podawany opcjonalnie)
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <description>
                            <iaiext:meta_title xml:lang="eng"></iaiext:meta_title>
                            <iaiext:meta_title xml:lang="pol"></iaiext:meta_title>
                        </description>
                    </product>
                </products>
            </offer>    
        


Menu


węzeł w pliku full.xml offer / products / iaiext:navigation / iaiext:site
lista wymaganych atrybutów : możliwe wartość @id
: identyfikator strony/sklepu
offer / products / iaiext:navigation / iaiext:site / iaiext:menu
lista wymaganych atrybutów : możliwe wartość @id
: identyfikator drzewa menu
offer / products / iaiext:navigation / iaiext:site / iaiext:menu / iaiext:item
lista wymaganych atrybutów : możliwe wartość @textid
: identyfikator tekstowy elementu drzewa menu
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:navigation>
                            <iaiext:site id="1">
                                <iaiext:menu id="1">
                                    <iaiext:item id="11" menu_id="1" textid="Oferty\Zima 2018" iaiext:priority_menu="1"/>
                                </iaiext:menu>
                            </iaiext:site>
                        </iaiext:navigation>
                    </product>
                </products>
            </offer>            
        


Adnotacja do towaru


węzeł w pliku full.xml offer / products / product / iaiext:note
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:note>treść adnotacji</iaiext:taxcode>
                    </product>
                </products>
            </offer>    
        


Ustawienia dotyczące cen dla POS


węzeł w pliku full.xml offer / products / product / iaiext:pos_prices_config / iaiext:site
lista wymaganych atrybutów : możliwe wartość @id
: identyfikator strony/sklepu @type : pos_equals_retail - cena dla POS taka sama jak cena detaliczna
: pos_notequals_retail - cena dla POS różna od ceny detalicznej
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:pos_prices_config>
                            <iaiext:site id="1" type="pos_equals_retail"/>
                        </iaiext:pos_prices_config>
                    </product>
                </products>
            </offer>
        


Cena minimalna towaru z możliwością zdefiniowania różnych cen minimalnych dla stron i rozmiarów


węzeł w pliku full.xml offer / products / product / iaiext:price_minimal / iaiext:site
lista wymaganych atrybutów : możliwe wartość @id
: identyfikator strony/sklepu @size_id
: identyfikator rozmiaru z pliku sizes.xml @gross
: wartość ceny hurtowej brutto @net
: wartość ceny hurtowej netto
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:price_minimal>
                            <iaiext:site id="1" size_id="C" gross="255.00" net="207.32"/>
                        </iaiext:price_minimal>
                    </product>
                </products>
            </offer>
        


Cena dla POS z podziałem na rozmiary


węzeł w pliku full.xml offer / products / product / iaiext:price_pos / iaiext:price
lista wymaganych atrybutów : możliwe wartość @size_id
: identyfikator rozmiaru z pliku sizes.xml @gross
: wartość ceny dla POS brutto @net
: wartość ceny dla POS netto
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:price_pos>
                            <iaiext:price size_id="C" gross="255.00" net="207.32"/>
                        </iaiext:price_pos>    
                    </product>
                </products>
            </offer>
        


Cena detaliczna towaru z możliwością zdefiniowania różnych cen detalicznych dla stron i rozmiarów


węzeł w pliku full.xml offer / products / product / iaiext:price_retail / iaiext:site
lista wymaganych atrybutów : możliwe wartość @id
: identyfikator strony/sklepu @size_id
: identyfikator rozmiaru z pliku sizes.xml @gross
: wartość ceny detalicznej brutto @net
: wartość ceny detalicznej netto
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:price_retail>
                            <iaiext:site id="1" size_id="C" gross="255.00" net="207.32"/>
                        </iaiext:price_retail>
                    </product>
                </products>
            </offer>
        


Cena hurtowa towaru z możliwością zdefiniowania różnych cen hurtowych dla stron i rozmiarów


węzeł w pliku full.xml offer / products / product / iaiext:price_wholesale / iaiext:site
lista wymaganych atrybutów : możliwe wartość @id
: identyfikator strony/sklepu @size_id
: identyfikator rozmiaru z pliku sizes.xml @gross
: wartość ceny hurtowej brutto @net
: wartość ceny hurtowej netto
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:price_wholesale>
                            <iaiext:site id="1" size_id="C" gross="255.00" net="207.32"/>
                        </iaiext:price_wholesale>
                    </product>
                </products>
            </offer>
        


Nazwa dla porównywarek cen, katalogów i pasaż


węzeł w pliku full.xml offer / products / product / iaiext:pricecomparator_name
lista wymaganych atrybutów : możliwe wartość @xml:lang
: kod języka (podawany opcjonalnie)
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:pricecomparator_name xml:lang="pol"></iaiext:pricecomparator_name>
                    </product>
                </products>
            </offer>    
        


Cena dla porównywarek cen z możliwością zdefiniowania różnych cen dla stron i poszczególnej porównywarki cen


węzeł w pliku full.xml offer / products / product / iaiext:pricecomparator_price / iaiext:site
lista wymaganych atrybutów : możliwe wartość @id
: identyfikator strony/sklepu @servis_id
: identyfikator wybranej porównywarki cen @gross
: wartość ceny hurtowej brutto @net
: wartość ceny hurtowej netto
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:pricecomparator_price>
                            <iaiext:site id="1" servis_id="3" gross="255.00" net="207.32"/>
                        </iaiext:pricecomparator_price>
                    </product>
                </products>
            </offer>
        


Ustawienia dotyczące cen


węzeł w pliku full.xml offer / products / product / iaiext:prices_config / iaiext:site
lista wymaganych atrybutów : możliwe wartość @id
: identyfikator strony/sklepu @type : wholesale_equals_retail - cena hurtowa taka sama jak cena detaliczna
: wholesale_notequals_retail - cena hurtowa różna od ceny detalicznej
: all_prices_undefined - wszystkie ceny na telefon
: retail_price_undefined - cena detaliczna na telefon
: retail_equals_suggested - cena detaliczna taka jak sugerowana
: automatically_calculated - automatycznie wyliczaj cenę
: default_prices - ceny domyślne
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:prices_config>
                            <iaiext:site id="1" type="wholesale_equals_retail"/>
                        </iaiext:prices_config>
                    </product>
                </products>
            </offer>
        


Ustawienia dotyczące cen dla sklepów


węzeł w pliku full.xml offer / products / product / iaiext:prices_configuration_for_shops
lista wymaganych atrybutów : możliwe wartość @value
: same_prices - wszystkie ceny oprócz ceny dla POS mają być jednakowe
: competitive_prices - wszystkie ceny mają być konkurencyjne
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:prices_configuration_for_shops value="same_prices"/>
                    </product>
                </products>
            </offer>
        


Priorytet towaru


węzeł w pliku full.xml offer / products / product / iaiext:priority
lista wymaganych atrybutów : możliwe wartość @level
: wartość priorytetu
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:priority level="5"/>
                    </product>
                </products>
            </offer>        
        


Towar gratisowy


węzeł w pliku full.xml offer / products / product
lista wymaganych atrybutów : możliwe wartość @iaiext:product_free
: y - towar gratisowy
: n - towar nie będący gratisem
przykład użycia
            <offer>
                <products ...>
                    <product ... iaiext:product_free="y"/>
                </products>
            </offer>    
        


Profil wysyłki i zwrotu towaru


węzeł w pliku full.xml offer / products / product
lista wymaganych atrybutów : możliwe wartość @iaiext:product_shipment_profile_id
: identyfikator profilu
przykład użycia
            <offer>
                <products ...>
                    <product ... iaiext:product_shipment_profile_id="1"/>
                </products>
            </offer>    
        


Profil rabatowy


węzeł w pliku full.xml dotyczy tylko: IOF 3.0 offer / products / product
lista wymaganych atrybutów : możliwe wartość @iaiext:rebate
: identyfikator profilu "Rabaty ilościowe do towarów"
przykład użycia
            <offer>
                <products ...>
                    <product ... iaiext:rebate="2"/>
                </products>
            </offer>    
        


Zapamiętuj numery seryjne sprzedawanych produktów


węzeł w pliku full.xml offer / products / product
lista wymaganych atrybutów : możliwe wartość @iaiext:save_serial_numbers
: na - nieużywane
: optional - opcjonalne
: required - wymagane
przykład użycia
            <offer>
                <products ...>
                    <product ... iaiext:product_shipment_profile_id="1"/>
                </products>
            </offer>    
        


Towar sprzedawany po konkretnej ilości dla klientów detalicznych


węzeł w pliku full.xml offer / products / product / iaiext:sell_by / iaiext:retail
lista wymaganych atrybutów : możliwe wartość @quantity
: ilość
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:sell_by>
                            <iaiext:retail quantity="3"/>
                        </iaiext:sell_by>
                    </product>
                </products>
            </offer>
        


Towar sprzedawany po konkretnej ilości dla klientów hurtowych


węzeł w pliku full.xml offer / products / product / iaiext:sell_by / iaiext:wholesale
lista wymaganych atrybutów : możliwe wartość @quantity
: ilość
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:sell_by>
                            <iaiext:wholesale quantity="5"/>
                        </iaiext:sell_by>
                    </product>
                </products>
            </offer>
        


Tabela rozmiarów


węzeł w pliku full.xml offer / products / product / iaiext:size_chart
lista wymaganych atrybutów : możliwe wartość @id
: identyfikator tabeli rozmiarów @xml:lang
: kod jęzka (podawany opcjonalnie) @name
: nazwa tabeli rozmiarów
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:size_chart id="1" xml:lang="pol" name="Przykładowa tabela rozmiarów dla odzieży"/>
                    </product>
                </products>
            </offer>    
        


Towar w koszyku sumuje się przy wielokrotnym dodawaniu


węzeł w pliku full.xml offer / products / iaiext:sum_in_basket
lista wymaganych atrybutów : możliwe wartość @value
: yes - towar będzie sumowany w koszyku
: no - towar nie będzie sumowany w koszyku
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:sum_in_basket value="yes"/>
                    </product>
                </products>
            </offer>    
        


PKWiU


węzeł w pliku full.xml offer / products / product / iaiext:taxcode
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:taxcode>PKWiU towaru</iaiext:taxcode>
                    </product>
                </products>
            </offer>    
        


Widoczny w eksporcie do porównywarek cen


węzeł w pliku full.xml offer / products / iaiext:visibility / iaiext:price_comparator
lista wymaganych atrybutów : możliwe wartość @visible
: yes - towar eksportowany to pliku bazowego dla porównywarek
: no - towar nie eksportowany to pliku bazowego dla porównywarek
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:visibility>
                            <iaiext:price_comparator visible="yes"/>
                        </iaiext:visibility>
                    </product>
                </products>
            </offer>        
        


Ukryty na stronie przed klientami


węzeł w pliku full.xml offer / products / iaiext:visibility / iaiext:site
lista wymaganych atrybutów : możliwe wartość @visible
: yes - towar nie widoczny dla klientów w sklepie
: no - towar widoczny dla klientów w sklepie
przykład użycia
            <offer>
                <products ...>
                    <product ...>
                        <iaiext:visibility>
                            <iaiext:site visible="yes"/>
                        </iaiext:visibility>
                    </product>
                </products>
            </offer>    
        

Każdy z wyżej wymienionych tagów jest opcjonalny. Informacje na temat atrybutów oraz ich wymagalności w poszczególnych tagach znajdziesz w pliku XSD.

XML Schema Validator: plik iof_exstensions (XSD) file

Ważne informacje dla użytkowników IdoSell Shop (IAI-Shop.com) i IAI Downloader

  • IdoSell Shop (IAI-Shop.com) posiada wbudowany mechanizm eksportu danych towarów do IOF Extensions (dostępny z poziomu listy towarów w IdoSell Shop (IAI-Shop.com) lub modułu Udostępniania oferty do integracji w edycji konta klienta),
  • IAI Downloader od wersji 1.0 dla scenariuszy: Import i Aktualizacja posiada obsługę danych o towarach w formie tagów IOF Extensions,
  • IdoSell Shop (IAI-Shop.com) i IAI Downloader od wersji 1.0 jest przystosowany do obsługi rozszerzenia IOF Extensions z zadeklarowaną nazwą namespace iaiext:
xmlns:iaiext="https://www.idosell.com/pl/shop/developers/iof/extensions.phtml"