Integracja flux CSV lub XML
Wprowadzenie
Produkty z Państwa strony mogą zostać zintegrowane w systemie sklepu Spartoo za pomocą flux plików CSV lub XML.W tym celu, plik CSV lub XML, zawierający informacje dotyczące wszystkich Państwa produktów musi być dostępny w sieci dla naszego robota.
Nasz robot mniej więcej co godzinę pobierać będzie pliki, integrując zawarte w nich informacje.
Plik powinien być zaktualizowany, aby uniknąć sytuacji pojawienia się na stronie Spartoo produktów już de facto niedostępnych.
Plik winien zawierać wszystkie niezbędne informacje, pozwalające na przypisanie produktów do poszczególnych kategorii i na oszacowanie zapasów magazynowych.
Rubryki mogą być obowiązkowe, zalecane lub opcjonalne. Jeżeli zatem rubryka 'obowiązkowa' pozostanie pusta lub będzie źle wypełniona, produkt nie zostanie zintegrowany.
Poniżej podajemy przykładowe pliki CSV i XML. Modele te mają charakter poglądowy, nie są narzucone przez Spartoo. Jednakże Państwa plik musi zawierać wszystkie informacje o charakterze obowiązkowym.
W wersji idealnej, plik zawierać powinien kodowanie UTF-8. W przeciwnym wypadku, prosimy o informacje, pozwalające nam na skonfigurowanie parametrów niezbędnych do obsługi pliku.
Jeżeli chodzi o plik CSV, plik musi korzystać z formuły kropka-przecinek ';'. W przeciwnym wypadku, prosimy o informacje, pozwalające nam na skonfigurowanie parametrów niezbędnych do obsługi pliku.
Jeśli nie posiadają Państwo serwera udostępniania plików (serwer ftp) Spartoo poleca użyć Dropbox.
więcej informacji
Definicje
-
Produkt lub Produkt parent: Dla Spartoo, produkt parent to produkt odpowiadający danemu modelowi lub kolorowi.
Tak więc, jeżeli dany model ma dwa kolory, będą to dwa oddzielne produkty w tym rozumieniu (dwa różne ID)
Natomiast ten sam produkt może występować w kilku rozmiarach.
-
Produkt child: Dla Spartoo, produkt child to produkt odpowiadający danemu produktowi w konkrement rozmiarze.
Tak więc, jeżeli dany model występuje w jednym kolorze, ale w 2 rozmiarach, utworzone zostaną dwa "produkty child" (z jednym ID produktu i dwoma osobnymi id ''child'' dla danego rozmiaru)
Ilość, czyli zapasy magazynowe muszą bazować obowiązkowo na danych dotyczących produktów oznaczonych jako ''child''. Jest to jedyna wymagana informacja dla tej grupy produktów. Inne informacje dotyczą produktów parent nie są wymagane przy produktach child, a więc mogą zostać pominięte.
Lista informacji dla flux CSV
Nazwa rubryki | Rubryka | Opis |
---|---|---|
SKU / Numer produktu | Obowiązkowa |
SKU identyfikuje produkt parent. Może zawierać wyłącznie znaki alfanumeryczne oraz znaki takie jak - (myślnik) _ (podkreślenie) i . (kropka). Numer może być nadany dla każdego produktu child (np: kod EAN ), nie jest to jednak obowiązkowe. |
Parent / Child | Obowiązkowa dla CSV |
Ta rubryka jest obowiązkowa, jeżeli plik zawiera osobną linię dla każdego produktu i osobno linię dla produktu child W tym przypadku należy wskazać sposób pozwalający na odróżnienie linii produktu od linii produktu child. Ta rubryka może przykładowo zawierać słowo "Parent" dla produktów parent i określenie "Child" dla produktów child. |
Parent SKU | Obowiązkowa dla CSV |
Ta rubryka jest obowiązkowa, jeżeli plik zawiera osobną linię dla każdego produktu i osobno linię dla każdego produktu child. Dla każdego produktu child, istotne jest, abyśmy mogli ustalić właściwy dla niego produkt parent. Rubryka ta musi zatem zawierać numer produktu stanowiący oznaczenie produktu parent. |
Nazwa modelu | Zalecana | <Ta rubryka zawierać może jedynie nazwę modelu, nie może zawierać innych informacji (kategoria, kolor, marka) |
Nazwa marki | Obowiązkowa | |
Płeć | Obowiązkowa |
Oznacza dla kogo przeznaczony jest produkt. Należy użyć następujących oznaczeń:
|
Cena produktu | Obowiązkowa |
Musi być wyrażona w walucie 'PLN'. Cena dotyczy wyłącznie produktu parent. Nie ma możliwości przypisania różnych cen dla produktów child. |
Kategoria | Obowiązkowa |
Rubryka zawiera kod kategorii produktu. Prosimy o nieużywanie kategorii ogólnych (na czerwono) i korzystanie z kategorii bardziej precyzyjnych. Jeżeli nie chcą Państwo wskazać kodu Spartoo, można wpisać nazwę kategorii. W tym przypadku należy skorzystać z narzędzia w postaci ''matchingu'' kategorii, aby znaleźć odpowiednik Państwa kategorii, wśród kategorii Spartoo. Zobacz listę wszystkich kodów kategorii. |
Wybór produktów | Opcjonalna |
Pozwala na określenie kontekstów wykorzystania produktu prze pomocy listy id. Całość możliwych kontekstów jest dostępna tutaj |
Cena obniżona | Zalecana |
Zawiera obniżoną cenę produktu. Jeżeli poziom obniżki jest spełniony i nie pasuje do ceny obniżonej, wtedy to cena obniżona jest brana pod uwagę. |
Poziom obniżki | Zalecana |
Zawiera żądaną obniżkę. Wszystkie obniżki zostaną zaokrąglone w dół przez Spartoo, do równych 5%. Np. obniżka 27% zostanie zaokrąglona do 25%. |
Daty promocji | Opcjonalna |
Promocje mogą zostać skonfigurowane poprzez wskazanie daty początkowej i końcowej. Jeżeli daty te nie zostaną wskazane, promocja rozpocznie się natychmiast. Rozwiązanie to jest przydatne w przypadku zaplanowanych wyprzedaży, obniżone ceny pojawią się w ściśle określonej dacie i godzinie, bez konieczności oczekiwania na najbliższą integrację plików. |
Rozmiar | Obowiązkowa |
Rubryka zawiera nazwę rozmiaru dla danego produktu. Jeżeli rubryka nie istnieje albo jest pusta, produkt uznany zostanie jako dostępny w jednym rozmiarze. W przypadku jeżeli odzień ma rozmiary w oznaczeniach US, musimy mieć możliwość ustalenia czy chodzi o rozmiar EU czy US: albo poprzez wpisanie US w nazwie rozmiaru, albo poprzez dodanie rubryki, pozwalającej na rozróżnienie rozmiarów US od EU. |
Ilość | Obowiązkowa |
Ilość musi być określona dla każdego rozmiaru. Aby zdezaktywować produkt, należy wprowadzić 0 w rubryce ilość. Gdy ilość wynosi 0, produkt jest zdezaktywowany i nie wyświetla się na stronie Spartoo. |
EAN | Obowiązkowa | Międzynarodowy kod identyfikujący produkt, warunkujący także obecność w google shopping oraz w innych porównywarkach cen. |
Zdjęcia | Obowiązkowa |
Wymagane jest przynajmniej jedno zdjęcie. Zalecamy umieszczenie co najmniej 3 zdjęć. Maksymalna ilość zdjęć wynosi 8. Należy przekazać nam link do zdjęcia. Nazwa pliku powinna zawierać wyłącznie znaki alfanumeryczne, a także znaki ''-'' (myślnik), ''_'' (podkreślnik) i ''.'' (kropka). Litery z akcentami (np. ą, ę) nie są dozwolone. Zdjęcie zostanie pobrane tylko raz i zostanie zachowane na naszym serwerze, po dopasowaniu rozmiarów zdjęcia do rozmiarów wymaganych w Spartoo. Zdjęcia muszą być w formacie jpg, kwadratowe, o rozdzielczości 350x350 pikseli. Zdjęcia o rozdzielczości równej lub większej od 800x800 pikseli, umożliwiają korzystanie z funkcji zoom. |
Opis produktu | Zalecana |
Opis produktu. Opis produktu pozwala na dodanie maksymalnej ilości informacji o produktach, które mogą pomóc klientowi podjąć decyzję o zakupie. Dobry opis jest szczegółowy i przeznaczony dla danego produktu. Może zatem zawierać nazwę modelu, markę, kolor, styl, materiał, etc. Nie jest możliwe dodanie HTML, z wyjątkiem punktu na linii: ' '. Javascript nie jest dozwolony. Będzie widoczny wyłącznie w karcie produktu. |
Kolor - filtr | Zalecana |
Oznaczenie Spartoo dla danego koloru. Pozwala na użycie filtru kolor w menu na stronie. Jeżeli nie podano tego oznaczenia, można posłużyć się narzędziem ''matching'' kolorów, dla znalezienia odpowiednika danej nazwy koloru, w systemie kolorów Spartoo. Zobacz listę wszystkich kodów kolorów |
Kolor | Zalecana | Rubryka tekstowa dla koloru. Wyświetla się na karcie produktu. |
Skład | Opcjonalna |
Wyłącznie dla butów. Możemy zintegrować 4 różne elementy składu:
Zobacz listę wszystkich kodów dla składu |
Wysokość obcasa | Opcjonalna |
Wyłącznie dla butów damskich (czółenka, kozaki, etc ... ) Wysokość obcasa w centymetrach. Wskaż tylko liczbę i użyj kropki, aby oddzielić jednostkę od ułamków dziesiętnych (przykład: 1,7) cm. |
Kraj pochodzenia | Opcjonalnie |
Kraj pochodzenia Voir les valeurs possibles |
Kod HS | Opcjonalnie | Kod HS produktu do odprawy celnej |
Dodatkowe informacje | Opcjonalnie |
Wykaz kodów informacyjnych oddzielonych przecinkami (np. '120,521') Voir les valeurs possibles |
Sezon | Obowiązkowe dla MPO |
Sezon produktu, składający się z kodu "JZ" (Jesień-Zima) lub "WL" (Wiosna-Lato ) wraz z rokiem. (np: JZ21, WL22) |
Lista informacji dla plików XML
Tag | Opis | Obowiązkowa | ||
---|---|---|---|---|
reference_partenaire |
Identyfikacja produktu sprzedawcy. Sku identyfikuje produkt danej marki w konkretnym kolorze Indywidualne oznaczenie produktu, jego numer, może zawierać wyłącznie znaki alfanumeryczne oraz znaki - (myślnik) _ (podkreślenie) i . (kropka). |
NonTak | ||
product_name |
Nazwa modelu Nazwa nie może zawierać kategorii, koloru ani marki produktu. Nazwa nie może także zawierać znaków ani symboli html. |
Nie | ||
manufacturers_name | Nazwa marki danego produktu | Tak | ||
product_sex |
Płeć, przeznaczenie, produktu > Zobacz dopuszczalne wartości |
Tak | ||
product_price | Cena produktu w euro (nieobowiązkowa dla cen rozmiarów) | Tak / Nie | ||
color_id |
Kolor przeznaczony do filtru w menu na stronie Jeżeli nie został podany, produkt nie pojawi się w wynikach wyszukiwania z pomocą filtru kolor. > Zobacz dopuszczalne wartości |
Nie | ||
product_style |
Kategoria produktu > Zobacz dopuszczalne wartości |
Tak | ||
product_description | Opis produktu. Wyświetla się na karcie produktu. | Nie | ||
product_color | Rubryka na wpisanie koloru. Wyświetla się na karcie produktu. | Nie | ||
product_quantity |
Całkowity stan magazynowy produktu Zignorowano jeśli jeden, lub wiele znaczników size_quantity wykrytych dla produktu. Dla produktów o rozmiarze uniwersalnym, jest konieczne oznaczenie product_quantity jeśli ozaczenie balise size_quantity nie jest wskazane. |
Nie | ||
size |
Spis rozmiarów i ich ilości. Informacja opcjonalna, dla produktów, które nie mają rozmiarów (torby/akcesoria). Dla innych, obowiązkowa. |
Tak / Nie | ||
size_name |
Nazwa rozmiaru > Zobacz dopuszczalne wartości |
Tak | ||
size_quantity | Dla każdego rozmiaru musi być sprecyzowana dostępna ilość. Aby dezaktywować produkt należy zmienić dostępną ilość na 0. Kiedy stock jest ustawiony na 0, produkt jest dezaktywowany i nie jest widoczny w Spartoo |
Tak | ||
size_reference |
Oznaczenie produktu według rozmiaru. Ta rubryka służy wyłącznie do przesłania danych w ramach eksportu zamówień lub zwrotów. Najlepiej jest wygenerować wpis w tej rubryce łącząc reference_partenaire i size_name za pomocą podkreślnika (dolnego myślnika) "_". |
Nie | ||
ean | EAN dla danego rozmiaru | Nie | ||
zdjęcia |
Lista zdjęć i ich url. Wymagane jest przynajmniej jedno zdjęcie. Zalecamy dodanie przynajmniej 3 zdjęć. Możliwe jest dodanie maksymalnie 8 zdjęć. Zdjęcie zostanie probrane tylko raz i po zmianie rozmiaru na wymiary Spartoo zostanie zapisane na naszych serwerach. Zdjęcia muszą mieć format jpg, muszą być kwadratowe i mieć co najmniej 350 x 350 pikseli. Jeśli są większe lub równe 800 x 800 pikseli, możliwe będzie zrobienie zoomu na stronie. |
Tak | ||
url1, url2 ... url8 |
Linki do zdjęć Należy udostępnić nam link do każdego zdjęcia. Nazwa pliku powinna zawierać wyłącznie znaki alfanumeryczne, a także znaki "-" (myślnik), "_" (podkreślnik) i "." (kropka). Spacje i litery akcentowane (np. ą, ż) nie są dozwolone. | heel_height | Wysokość obcasa w centymetrach (cm). Dotyczy wyłącznie obuwia damskiego. Wysokość musi być wielokrotnością 0,5. | No |
product_composition |
Skład cholewki. Wyłącznie dla butów. > Zobacz dopuszczalne wartości |
Nie | ||
voering_composition |
Skład wyściółki w bucie. Dotyczy wyłącznie obuwia. > Zobacz dopuszczalne wartości |
Nie | ||
first_composition |
Skład wkładki wewnętrznej. Dotyczy wyłącznie obuwia. > Zobacz dopuszczalne wartości |
Nie | ||
zool_composition |
Skład podeszwy. Dotyczy wyłącznie obuwia. > Zobacz dopuszczalne wartości |
Nie | ||
discount |
Umożliwia zastosowanie promocji na produkt lub na rozmiar. Rubryka rate, w rubryce discount dotyczy procentowej obniżki w stosunku do ceny wpisanej w rubryce product_price. Rubryka price_discount w rubryce discount dotyczy kwotowej obniżki stałej ceny. Procent wyświetlonej obniżki zostanie wyliczony. Jeżeli obie rubryki są dostępne, rubryka price_discount ma pierwszeństwo przed rubryką rate. Jeśli rabat jest natychmiastowy, nie ma potrzeby wypełniania rubryki startdate. Jeśli pole stopdate nie zostanie określone, promocja będzie trwała domyślnie jeden miesiąc. Jeżeli zakładka sales została określona, promocja będzie promocją w czasie wyprzedaży. W przeciwnym wypadku chodzi o zwykłą promocję poza wyprzedażą. Określenie tego parametru powoduje, że produkty wyświetlane będą na stronie wyprzedaży w okresie, gdy trwa wyprzedaż. I |
Nie | ||
extra_infos |
Rubryka dotyczy dodatkowych informacji w zależności od typu produktu. Każda informacja skonstruowana jest z id ( > Zobacz wartości ) oraz z wartości w formie liczbowej. |
Nie | ||
selekcja | Pozwala określić kontekst wykorzystania produktu przy pomocy listy id. Wszystkie konteksty są określone i dostępne ici. |
Nie |
Format parametru xml
Rubryki tekstowe muszą być chronione przez tagi CDATA, jeżeli zawierają znaki specjalne, które mogłyby spowodować nieprawidłowość XML.
Format jeden kraj
<root> <products> <product> <reference_partenaire>string</reference_partenaire> <product_name>string</product_name> <manufacturers_name>string</manufacturers_name> <code_idu>string</code_idu> <product_sex>char</product_sex> <product_price>float</product_price> <product_quantity>int</product_quantity> <color_id>int</color_id> <product_style>int</product_style> <product_description>string</product_description> <product_color>string</product_color> <heel_height>float</heel_height> <country_origin>int</country_origin> <code_hs>int</code_hs> <size_list> <size> <size_name>string</size_name> <size_quantity>int</size_quantity> <size_reference>string</size_reference> <ean>string</ean> <code_hs>int</code_hs> <product_price>float</product_price> <discount> <startdate>timestamp</startdate> <stopdate>timestamp</stopdate> <price_discount>float</price_discount> <rate>int</rate> <sales/> </discount> </size> <!-- ... Różne tagi "size" możliwe ... --> </size_list> <product_composition>int</product_composition> <voering_composition>int</voering_composition> <first_composition>int</first_composition> <zool_composition>int</zool_composition> <photos> <url1>url</url1> <url2>url</url2> <url3>url</url3> <url4>url</url4> <url5>url</url5> <url6>url</url6> <url7>url</url7> <url8>url</url8> </photos> <discount> <startdate>timestamp</startdate> <stopdate>timestamp</stopdate> <price_discount>float</price_discount> <rate>int</rate> <sales>0/1</sales> </discount> <extra_infos> <info> <id>int</id> <value>float</value> </info> <!-- ... Różne tagi "info" możliwe ... --> </extra_infos> <selections> <selection>int</selection> <!-- ... Różne tagi "selection" możliwe ... --> </selections> </product> <!-- ... Różne tagi "product" możliwe ... --> </products> </root>
Format wiele krajów
<root> <products> <product> <reference_partenaire>string</reference_partenaire> <manufacturers_name>string</manufacturers_name> <product_sex>char</product_sex> <product_quantity>int</product_quantity> <color_id>int</color_id> <product_style>int</product_style> <heel_height>float</heel_height> <country_origin>int</country_origin> <code_hs>int</code_hs> <languages> <language> <code>string</code> <product_name>string</product_name> <product_description>string</product_description> <code_idu>string</code_idu> <product_color>string</product_color> <product_price>float</product_price> <discount> <startdate>timestamp</startdate> <stopdate>timestamp</stopdate> <price_discount>float</price_discount> <rate>int</rate> <sales /> </discount> </language> <!-- ... Różne tagi "language" możliwe ... --> </languages> <size_list> <size> <size_name>string</size_name> <size_quantity>int</size_quantity> <size_reference>string</size_reference> <ean>string</ean> <code_hs>int</code_hs> <languages> <language> <code>string</code> <product_price>float</product_price> <discount> <startdate>timestamp</startdate> <stopdate>timestamp</stopdate> <price_discount>float</price_discount> <rate>int</rate> <sales/> </discount> </language> <!-- ... Różne tagi "language" możliwe ... --> </languages> </size> <!-- ... Różne tagi "size" możliwe ... --> </size_list> <product_composition>int</product_composition> <voering_composition>int</voering_composition> <first_composition>int</first_composition> <zool_composition>int</zool_composition> <photos> <url1>url</url1> <url2>url</url2> <url3>url</url3> <url4>url</url4> <url5>url</url5> <url6>url</url6> <url7>url</url7> <url8>url</url8> </photos> <extra_infos> <info> <id>int</id> <value>float</value> </info> <!-- ... Różne tagi "info" możliwe ... --> </extra_infos> <selections> <selection>int</selection> <!-- ... Różne tagi "selection" możliwe ... --> </selections> </product> <!-- ... Różne tagi "product" możliwe ... --> </products> </root>
Przykłady plików
Pliki CSV
Plik CSV z produktem parent / produkt child klasykFichier CSV Multi pays
Pliki XML
Przykład pliku XML Mono krajPrzykład pliku XML Multi kraj
Pliki XSD
Fichier XSD Multi paysLista kodów błędów produktów
Kod | Poziom | Opis |
---|---|---|
1 | Fatal | Dane referencyjne firmy partnerskiej są zbyt krótkie |
2 | Fatal | Dane referencyjne firmy partnerskiej są nieprawidłowe, powinny zawierać one wyłącznie znaki alfanumeryczne |
3 | Warning | Nazwa produktu nie jest określona |
4 | Fatal | Marka nie jest określona |
5 | Fatal | Rodzaj nie jest prawidłowo określony, dopuszczalne symbole to: H, F, M, K, G |
6 | Fatal | Cena musi być liczbą |
7 | Fatal | cena jest ujemna lub nie została podana |
8 | Warning | Cena wydaje się nam zbyt wysoka (> 4000 zł) |
9 | Fatal | Kwota musi być liczbą całkowitą |
10 | Fatal | Ilość musi mieć wartość dodatnią |
11 | Warning | Kolor xxx nie istnieje: produkt nie będzie dostępny w wyszukiwaniu poprzez filtr kolorów |
13 | Fatal | Kategoria xxx nie istnieje |
14 | Warning | Opis produktu jest pusty |
15 | Warning | Kolor nie jest podany |
16 | Warning | Brak listy rozmiarów: oznaczenie one size |
17 | Warning | Skład jest określony, ale nie jest poprawny |
18 | Fatal | Zdjęcie 1 jest obowiązkowe |
19 | Warning | Wysokość rabatu w ramach promocji musi zawierać się pomiędzy 0 i 100, promocja nie zostanie uwzględniona |
20 | Warning | Rozmiar xxx nie istnieje |
200 | Fatal | Rozmiar xxx nie istnieje dla marki xxx. |
201 | Fatal | Kod EAN jest obowiązkowy |
202 | Fatal | Kod EAN xxx numeru referencyjnego xxx w rozmiarze xxx został już użyty przez ref: xxx. |
203 | Warning | Kod EAN jest zbyt krótki lub kończy się na "000". |
204 | Warning | Kod EAN xxx występuje w kilku egzemplarzach. |
205 | Fatal | Zbyt długi numer referencyjny partnera |
23 | Warning | Zdjęcie xxx jest mniejsze niż 350x350: jego jakość na stronie będzie bardzo słaba |
24 | Warning | Zdjęcie xxx jest mniejsze niż 350x350: nie zostanie ono wyświetlone na stronie |
25 | Fatal | Rozmiar xxx: Niemożliwa regulacja stanu magazynowego |
26 | Fatal | Brak w stanie magazynowym: produkt nie zostanie utworzony |
27 | Fatal | Brak dostępu do zdjęcia 1 ( url xxx ) |
28 | Warning | Brak dostępu do zdjęcia xxx ( url xxx ) |
281 | Fatal | Rozmiar zdjęcia jest za duży (xxxo) |
30 | Fatal | Ilość dla rozmiaru xxx jest zbyt duża (Ilość maks.: xxx) |
31 | Warning | Twoje konto nie jest aktywowane na stronie xxx |
32 | Fatal | Nie znaleziono informacji o produkcie dla tego kraju |
33 | Fatal | Produkt typu xxx nie może należeć do kategorii xxx |
34 | Fatal | Słowo xxx znajduje się na czarnej liście i nie powinno się pojawiać w nazwie lub opisie produktu. |
35 | Fatal | Nazwa produktu zbyt długa, musi ona wyłącznie zawierać nazwę modelu. Błąd (błędy) w kraju (krajach): xxx |
341 | Fatal | Słowo xxx znajduje się na czarnej liście i nie powinno się pojawiać w opisie produktu. |
36 | Fatal | Nie można przenieść produktu: produkt jest duplikatem rozmiar / kolor. |
38 | Fatal | Rozmiar xxx może być zdefiniowany tylko jeden raz dla numeru referencyjnego xxx |
39 | Warning | Odniesienie do partnera występuje kilka razy w przepływie, duplikaty zostały zignorowane. |
42 | Warning | Sezon nie został zatwierdzony. |
43 | Warning | Informacja o produkcie xxx odpowiada rodzajowi produktu = xxx, a nie xxx. |
44 | Warning | Kategoria xxx nie odpowiada typowi produktu xxx tylko xxx. |
451 | Fatal | Brak ceny dla rozmiaru xxx w kraju xxx. (wymagany do uzyskania zniżki) |
452 | Warning | Data końcowa rabatu przekroczona dla rozmiaru xxx kraju xxx. |
453 | Fatal | "rate" (xxx) nieprawidłowa dla rozmiaru xxx kraju xxx. |
454 | Fatal | "rate" (xxx) > 85% dla rozmiaru xxx kraju xxx. |
455 | Warning | Rozmiar xxx ma cenę w kraju (xxx) niezdefiniowanym dla produktu. |
456 | Warning | Rozmiar xxx z ceną w xxx identyczną z ceną globalną w tym kraju. |