Dokumentacja sklepu

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>