Integracja z hurtownią umożliwia pobieranie informacji o: towarach, stanach i cenach, które posiadają w swojej ofercie. Hurtownia udostępniając ogólny plik o strukturze gateway, podaje dostęp do między innymi dwóch najważniejszych plików xml, którymi są:
full – xml zawierający pełne dane o ofercie – opisy, nazwy, kody, eany, zdjęcia i parametry,
light – xml zawierający dane o aktualnych cenach (katalogowej i zakupu) oraz ilościach na stanach magazynowych.
Bazując na danych z tych dwóch xml’i pobieramy do xSale i zapisujemy dane o towarach. To czy tworzone są nowe towary i które z elementów są synchronizowane (opisy, zdjęcia, parametry) definiuje się na etapie kreatora integracji i istnieje możliwość późniejszej edycji tych danych w kreatorze.
Częstotliwość pobierania plików:
full – 1 raz dziennie w celu pobrania ogólnych informacji o towarach,
light – co 4 godziny, w celu pobierania aktualnych stanów magazynowych i cen.
Dane na karcie towaru w xSale wraz z nazwą pola w pliku z hurtowni:
| Dane w xSale | Numer pola | Dane w pliku hurtowni |
|---|---|---|
| Nazwa | 1 | <name xml:lang=”pol”> Jeżeli pole nie występuje, to <name xml:lang=”eng”>, jeżeli nie występuje to parametr o nazwie “Kod producenta” |
| Kod | 2 | <code_producer> |
| Kod ERP | 3 | Kod pochodzący z systemu ERP (nie z hurtowni) |
| EAN | 4 | <code_producer> |
| Zdjęcie główne | 5 | <large><image url> – pierwsze na liście zdjęć |
| Kategoria | 6 | Definiowana w kreatorze integracji |
| Rodzaj | 7 | Zawsze TOWAR |
| Producent | 8 | <producer name> |
| Stawka VAT | 9 | <vat> |
| Jednostka główna | 10 | <unit name> |
| Typ ceny | 11 | <price gross> |
| Typ ceny | 12 | <srp gross> |
| Magazyn | 13 | <stock id> – w pliku light może być wiele magazynów <quantity> – dostępność |
| Zdjęcia | 14 | <large><image url> wszystkie z pliku |
| Opis (domyślny) | 15 | <long_desc xml:lang=”pol”> |
| Parametry | 16 | <parameters> |
W przypadku parametrów, które mają wiele wartości dla jednego parametru, zapisujemy je w polu tekstowym, po przecinku. Na screenie sytuacja ta występuje w parametrze „Tłumaczenia”, gdzie wiele wartości zostało pobranych i zapisanych po kolei, z zastosowaniem przecinka.
Uwaga: ceny i stany są pobierane z pliku light.xml (cyklicznie, co 4 godziny). Pozostałe informacje o towarach są pobierane z pliku full.xml (1 dziennie).
W przypadku towaru, który nie będzie miał uzupełnionego <code_producer> (EAN) czy <srp gross> system pomija taki towar i nie zapisuje go.
Karta towaru w xSale
