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>
