EN
Integracja z uniwersalną hurtownią pobiera do xSale dane o towarach, cenach, stanach magazynowych, opisach, zdjęciach i parametrach. Dane są pobierane z plików XML udostępnianych przez hurtownię w formacie IOF.
Hurtownia powinna udostępniać link typu gateway. Na jego podstawie xSale pobiera adresy dwóch plików:
- full – zawiera pełne dane o towarach, m.in. nazwy, kody, EAN, opisy, zdjęcia, producenta, jednostkę, VAT i parametry,
- light – zawiera dane aktualizowane częściej, przede wszystkim ceny i stany magazynowe.
To, czy xSale tworzy nowe towary oraz czy synchronizuje opisy, zdjęcia i parametry, zależy od ustawień wybranych w kreatorze integracji z uniwersalną hurtownią.
W tym artykule znajdziesz
- jak często pobierane są dane z hurtowni,
- najważniejsze zasady importu towarów,
- szczegółowy zakres danych zapisywanych w xSale,
- zrzuty ekranu karty towaru w xSale.
Częstotliwość pobierania danych
- Plik full – pobierany raz dziennie. Służy do pobrania i aktualizacji ogólnych danych towaru.
- Plik light – pobierany cyklicznie co 4 godziny. Służy do aktualizacji cen i stanów magazynowych.
Najważniejsze zasady importu
- Podstawowym identyfikatorem produktu z pliku hurtowni jest
code_producer. Jeżeli produkt nie ma tej wartości, xSale pomija go i nie zapisuje jako towaru. - Wartość
code_producerjest zapisywana w xSale jako Kod i EAN. - Jeżeli towar z hurtowni nie jest jeszcze powiązany z towarem w xSale, system próbuje go odnaleźć według klucza wybranego w kreatorze: EAN, KOD albo Kod ERP.
- Jeżeli towar nie zostanie odnaleziony, nowe kartoteki są tworzone tylko wtedy, gdy w kreatorze włączono tworzenie nowych towarów.
- Jeżeli synchronizacja parametrów jest włączona, parametry są zapisywane w kategorii wskazanej w kreatorze jako kategoria dla nowych towarów i parametrów.
- Jeżeli towar przestanie występować w pliku
full, xSale archiwizuje go i zeruje jego stany na magazynach mapowanych dla tej integracji.
Szczegółowy zakres danych zapisywanych w xSale
| Dane w xSale | Numer pola | Dane w pliku hurtowni / działanie integracji |
|---|---|---|
| Nazwa | 1 | Z pliku full: <description><name xml:lang="pol">. Jeżeli polska nazwa nie występuje, xSale próbuje pobrać <name xml:lang="eng">. |
| Kod | 2 | Z pliku full: code_producer. Ten sam identyfikator jest też używany jako EAN. |
| Kod ERP | 3 | Kod ERP nie jest pobierany z hurtowni. Może istnieć na towarze w xSale, jeżeli pochodzi z ERP lub wcześniejszej konfiguracji towaru. |
| EAN | 4 | Z pliku full: code_producer. |
| Zdjęcie główne | 5 | Z pliku full: zdjęcia z sekcji <images><large><image>. Zdjęcia są pobierane tylko wtedy, gdy w kreatorze włączono synchronizację zdjęć. |
| Kategoria | 6 | Kategoria wskazana w kreatorze jako kategoria dla nowych towarów i parametrów. Integracja nie pobiera pełnego drzewa kategorii hurtowni. |
| Rodzaj | 7 | Ustawiany jako Towar. |
| Producent | 8 | Z pliku full: <producer name>. |
| Stawka VAT | 9 | Z pliku full: atrybut vat w elemencie <price>. |
| Jednostka główna | 10 | Z pliku full: <unit name>. |
| Cena zakupu | 11 | Z pliku light: <price net> albo <price gross>, zależnie od tego, czy wybrany typ ceny w xSale jest ceną netto czy brutto. Jeżeli w kreatorze ustawiono marżę procentową albo kwotową, marża jest doliczana do tej ceny. |
| Cena katalogowa / sugerowana | 12 | Z pliku light: <srp net> albo <srp gross>, zależnie od typu ceny w xSale. Marża z kreatora nie jest doliczana do ceny srp. Jeżeli element srp nie występuje, ta cena nie zostanie zapisana. |
| Magazyn i stan | 13 | Z pliku light: <stock id> oraz atrybut quantity. Stan jest zapisywany tylko dla magazynów zmapowanych w kreatorze. |
| Zdjęcia | 14 | Z pliku full: zdjęcia z sekcji <images><large><image>. Synchronizacja zależy od ustawienia Synchronizacja zdjęć w kreatorze. |
| Opis domyślny | 15 | Z pliku full: <description><long_desc xml:lang="pol">. Opis jest zapisywany tylko wtedy, gdy w kreatorze włączono synchronizację opisów. |
| Parametry | 16 | Z pliku full: <parameters><parameter xml:lang="pol"> oraz polskie wartości <value xml:lang="pol">. Parametry są zapisywane tylko wtedy, gdy w kreatorze włączono synchronizację parametrów i wskazano kategorię. |
Jeżeli jeden parametr ma kilka wartości, xSale zapisuje je w jednym polu tekstowym, po przecinku.
Uwaga: ceny i stany są aktualizowane z pliku light, a pozostałe dane towaru z pliku full. Dlatego zmiana ceny lub stanu może pojawić się w xSale szybciej niż zmiana opisu, zdjęć albo parametrów.
Karta towaru w xSale
Poniższe zrzuty pokazują przykładową kartę towaru w xSale z polami opisanymi w tabeli.
