B2B - oferta w XML
Oferta w XML to dane towarowe sklepu udostępniane kontrahentom B2B w ich panelu. Format XML pozwala na przetwarzanie przez dowolne skrypty i integracje, np. na rzecz prezentowania produktów w niezależnym sklepie klienta. Funkcja wymaga konfiguracji w panelu sprzedawcy, następnie kontrahent zainteresowany tą formą integracji uruchamia generowanie indywidualnych plików w panelu sklepu:
Wówczas na tej samej podstronie prezentowane są spersonalizowane odnośniki do:
- oferty pełnej - wszystkie dane towarowe, plik generowany domyślnie raz na dobę (dla różnych wersji językowych dostępne są osobne pliki),
- oferty skróconej - stany magazynowe oraz ceny, plik generowany domyślnie raz na godzinę.
Informacje te uwzględniają indywidualny cennik kontrahenta, a także powiązania kontrahenta z magazynami (dostawcami).
Poniżej opisana została struktura danych.
Format pełny
<products> <product> <!-- produkt bez wariantów do wyboru --> <id>45939</id> <!-- ID produktu w bazie AtomStore --> <code><![CDATA[YBIK-YBIKE-NI]]></code> <!-- kod produktu --> <name><![CDATA[Rowerek biegowy Y BIKE ORYGINAL niebieski ]]></name> <!-- nazwa --> <description><![CDATA[Ten mały rowerek otrzymał nagrodę SABS Design Excellence Award]]></description> <!-- opis --> <producer><![CDATA[YBIKE]]></producer> <!-- producent (marka) --> <categories> <!-- kategorie, do których przypisany jest produkt (wyrażone poprzez pełne ścieżki) --> <category><![CDATA[DLA DZIECI / ROWERKI BIEGOWE]]></category> </categories> <active>1</active> <!-- produkt aktywny (1 = tak, 0 = nie) --> <new>0</new> <!-- nowość (1 = tak, 0 = nie) --> <recommend>0</recommend> <!-- produkt wyróżniony (1 = tak, 0 = nie) --> <quantity>100</quantity> <!-- stan magazynowy --> <sale_quantity>80</sale_quantity> <!-- stan promocyjny - znacznik obecny tylko dla produktów objętych wyprzedażą --> <unit>sztuka</unit> <!-- jednostka --> <weight>0.0000</weight> <!-- waga (ciężar) --> <price_netto>6.3064</price_netto> <!-- cena dla klienta, netto, uwzględniająca cennik klienta, promocje i wyprzedaże --> <base_price_netto>11.4663</base_price_netto> <!-- tylko gdy promocja/wyprzedaż, zawiera cenę dla klienta BEZ promocji/wyprzedaży --> <default_price_netto>19.1105</default_price_netto> <!-- cena netto w cenniku domyślnym / podstawowym --> <suggested_price>19.1106</suggested_price> <!-- cena katalogowa (sugerowana) --> <currency>EUR</currency> <!-- waluta klienta --> <tax> <value>23</value> <!-- stawka VAT --> <released>0</released> <!-- zwolnienie z VAT --> <excluded>0</excluded> <!-- nie podlega VAT --> </tax> <images> <!-- zdjęcia w galerii produktu --> <image> <url>https://demo.atomstore.pl/.../YBIK_YBIKE_NI_A.jpg</url> <!-- bewzględny adres URL --> <title><![CDATA[Rowerek biegowy Y BIKE ORYGINAL niebieski]]></title> <!-- tytuł --> <description><![CDATA[Rowerek biegowy Y BIKE ORYGINAL niebieski]]></description> <!-- opis --> <hash><![CDATA[b046cdcd901ce50ab9eb0cb005e46d27575d90a2]]></hash> <!-- unikalny kod zdjęcia --> <type>file</type> <!-- typ pliku --> </image> </images> <attachments/> <!-- załączniki do towaru --> <attributes> <!-- atrybuty produktu --> <attribute type="1"> <!-- typ atrybutu (1 = cecha, 2 = cecha grupowa, czyli atrybut wielowartościowy) --> <name><![CDATA[EAN]]></name> <!-- nazwa atrybutu --> <values> <!-- wartości przypisane do produktu --> <value><![CDATA[5390081031860]]></value> </values> </attribute> </attributes> </product> <product> <!-- produkt z wariantami do wyboru (np. różne rozmiary) --> <id>14399</id> <!-- (...) --> <combinations> <!-- warianty produktu --> <combination> <code><![CDATA[R14KE28230010MJ]]></code> <!-- kod wariantu --> <active>1</active> <!-- wariant aktywny (1 = tak, 0 = nie) --> <quantity>100</quantity> <!-- stan magazynowy --> <sale_quantity>80</sale_quantity> <!-- stan promocyjny - znacznik obecny tylko dla wariantów objętych wyprzedażą --> <price_modifier>=</price_modifier> <!-- różnica względem ceny produktu - modyfikator (+, -, %, =) --> <price_value>267.6117</price_value> <!-- różnica względem ceny produktu - wartość różnicy --> <price_netto>64.2268</price_netto> <!-- cena dla klienta, netto, uwzględniająca cennik klienta, promocje i wyprzedaże --> <default_price_netto>267.6117</default_price_netto> <!-- cena netto w cenniku domyślnym / podstawowym --> <base_price_netto>160.567</base_price_netto> <!-- tylko gdy promocja/wyprzedaż, zawiera cenę dla klienta BEZ promocji/wyprzedaży --> <currency>EUR</currency> <!-- waluta klienta --> <image>https://demo.atomstore.pl/.../evado_2018_bialy.png</image> <!-- URL zdjęcia wariantu --> <image_hash>9422a5c5dba545b5fee79a586101ff14c0c9c253</image_hash> <!-- unikalny kod zdjęcia wariantu --> <attributes> <!-- atrybuty opisujące wariant (do wyboru) --> <attribute> <name><![CDATA[Wielkość ramy]]></name> <!-- nazwa atrybutu --> <value><![CDATA[XL]]></value> <!-- wartość atrybutu --> </attribute> <attribute> <name><![CDATA[Kolor]]></name> <value><![CDATA[biały]]></value> </attribute> </attributes> <params> <!-- parametry wariantu (dodatkowe cechy, brak wyboru) --> <param> <name><![CDATA[EAN]]></name> <!-- nazwa parametru --> <value><![CDATA[222333444555]]></value> <!-- wartość parametru --> </param> </params> </combination> </combinations> <!-- (...) --> </product> </products>
Format skrócony
<products> <product> <!-- produkt bez wariantów do wyboru --> <code><![CDATA[YBIK-YBIKE-NI]]></code> <!-- kod produktu --> <active>1</active> <!-- produkt aktywny (1 = tak, 0 = nie) --> <quantity>100</quantity> <!-- stan magazynowy --> <sale_quantity>80</sale_quantity> <!-- stan promocyjny - znacznik obecny tylko dla produktów objętych wyprzedażą --> <price_netto>6.3064</price_netto> <!-- cena dla klienta, netto, uwzględniająca cennik klienta, promocje i wyprzedaże --> <base_price_netto>11.4663</base_price_netto> <!-- tylko gdy promocja/wyprzedaż, zawiera cenę dla klienta BEZ promocji/wyprzedaży --> <currency>EUR</currency> <!-- waluta klienta --> <tax> <value>23</value> <!-- stawka VAT --> <released>0</released> <!-- 1 = zwolnienie z VAT --> <excluded>0</excluded> <!-- 1 = nie podlega VAT --> </tax> </product> <product> <!-- produkt z wariantami do wyboru (np. różne rozmiary) --> <code><![CDATA[EVADO_1_2018]]></code> <active>1</active> <combinations> <!-- 1 = warianty produktu --> <combination> <code><![CDATA[R14KE28230010MJ]]></code> <!-- kod wariantu --> <active>1</active> <!-- wariant aktywny (1 = tak, 0 = nie) --> <quantity>100</quantity> <!-- stan magazynowy --> <sale_quantity>80</sale_quantity> <!-- stan promocyjny - znacznik obecny tylko dla wariantów objętych wyprzedażą --> <price_modifier>+</price_modifier> <!-- różnica względem ceny produktu - modyfikator (+, -, %, =) --> <price_value>0.0000</price_value> <!-- różnica względem ceny produktu - wartość różnicy --> <price_netto>88.3119</price_netto> <!-- cena dla klienta, netto, uwzględniająca cennik klienta, promocje i wyprzedaże --> <base_price_netto>160.567</base_price_netto> <!-- tylko gdy promocja/wyprzedaż, zawiera cenę dla klienta BEZ promocji/wyprzedaży --> <currency>EUR</currency> <!-- waluta klienta --> </combination> <combination> <!-- (...) --> </combination> </combinations> <price_netto>160.567</price_netto> <currency>EUR</currency> <tax> <value>23</value> <released>0</released> <excluded>0</excluded> </tax> </product> </products>