xSale – integracja krok po kroku

xSale – integracja krok po kroku

⏱️ Ten artykuł przeczytasz w 11 minut 


Po przeczytaniu tego artykułu dowiesz się jak zintegrować aplikację xSale z empik.com, jak pobierać i tworzyć zamówienia oraz jak zmienić statusy w integratorze. 
Pełna instrukcja, w której dowiesz się jak zintegrować aplikacje i co wchodzi w jej zakres, oraz szczegóły dotyczące zakresu danych pobieranych z empik.com do xSale. 

Konfiguracja integracji

  1. Aby zintegrować Empik z xSale trzeba przejść do menu integracji z platformami Marketplace w xSale.
  2. Następnie należy wyszukać marketplace empik.com (zdjęcie poniżej) po najechaniu kursorem, kliknij „Dodaj”.
  3. Zobacz zrzut ekranu


  4. Następnie w kreatorze integracji z Empik (zdjęcie poniżej) wypełnij następujące pola: 
    1. Nazwa integracji - wpisz nazwę, która będzie wyświetlana w xSale.
    2. Klucz dostępu - podaj klucz API wygenerowany dla Twojego użytkownika. Informację o tym jak wygenerować klucz API znajdziesz w tym artykule.
    3. ID magazynu - ID twojego sklepu (znajdziesz je w panelu sprzedawcy).
    4. Zobacz zrzut ekranu

        


Zakres integracji - jak to działa?

Dzięki integracji empik.com – xSale możesz w prosty sposób obsługiwać zamówienia z Empik bezpośrednio w systemie xSale. Integracja obejmuje: 
Obsługę zamówień
  1. Zamówienia są pobierane w statusie „Oczekuje na wysyłkę” (ustawienie można zmienić w konfiguracji).
  2. Ten status oznacza: 
    1. dla zamówień opłaconych z góry – że płatność została już zaksięgowana,
    2. dla zamówień za pobraniem – że zostały one zaakceptowane i czekają na zrealizowanie.

Wymianę informacji między systemami
xSale automatycznie przekazuje do empik.com:
  1. status zamówienia - aktualizowany raz dziennie, zgodnie z mapowaniem w konfiguracji,
  2. numery listów przewozowych - również przekazywane raz dziennie.

Dopasowanie produktów do zamówień
Podczas wczytywania produktów system sprawdza je według SKU i EAN w tej kolejności:
  1. Szuka oferty w xSale o takim samym SKU jak w zamówieniu.
  2. Jeśli nie znajdzie - szuka oferty z kodem towaru odpowiadającym SKU.
  3. Jeśli nadal brak dopasowania - sprawdza, czy SKU zamówienia pasuje do EAN przypisanych do towarów.
 Jeżeli system nie znajdzie produktu na podstawie SKU ani EAN, zamówienie trafi na status „Do obsługi ręcznej” z informacją, którego SKU nie udało się dopasować.

 

Szczegółowy zakres danych pobieranych z empik.com do xSale 

Zamówienia z empik.com są automatycznie pobierane do listy zamówień sprzedaży w xSale. Nie trzeba tego robić ręcznie, system sprawdza i aktualizuje dane co 5 minut.

Co dokładnie jest przesyłane? 
Przy każdym imporcie zamówienia przenoszone są wszystkie najważniejsze informacje, takie jak: dane klienta, produkty, ceny czy sposób dostawy.
W tabeli poniżej pokazujemy:
  1. jakie pola występują w empik.com, 
  2. ich odpowiedniki w xSale,
  3. oraz numery, które znajdziesz na zrzutach ekranu w załączonych zdjęciach pod tabelą.
Dzięki temu łatwo sprawdzisz, gdzie konkretne informacje „lądują” w systemie.
 
Tabela
Obszar xSale
Pole xSale
nr
Obszar Empik
Pole Empik 
nr 
Edycja zamówienia -> Formularz zamówienia -> Informacje o zamówieniu
Data
2
Zamówienia -> Podgląd zamówienia -> Informacje -> Wysyłka
Utworzono 
2
Edycja zamówienia -> Formularz zamówienia
Nr obcy
1
Zamówienia -> Podgląd zamówienia
Zamówienie nr 
1
Edycja zamówienia -> Formularz zamówienia-> Informacje o zamówieniu
Status
3
Zamówienia -> Lista zamówień
Status
3
Edycja zamówienia -> Formularz zamówienia-> Informacje o zamówieniu
Forma płatności
5
Zamówienia -> Podgląd zamówienia -> Rozliczenia
Sposób płatności 
4






Edycja zamówienia -> Formularz zamówienia -> Odbiorca
Nazwa
7
Zamówienia -> Podgląd zamówienia -> Informacje -> Wysyłka
Nazwa klienta 
7
Edycja zamówienia -> Formularz zamówienia -> Odbiorca
Ulica 
8
Zamówienia -> Podgląd zamówienia -> Informacje -> Wysyłka
Ulica
8
Edycja zamówienia -> Formularz zamówienia -> Odbiorca
Miasto
9
Zamówienia -> Podgląd zamówienia -> Informacje -> Wysyłka
Miasto
9
Edycja zamówienia -> Formularz zamówienia -> Odbiorca
Kod pocztowy
10
Zamówienia -> Podgląd zamówienia -> Informacje -> Wysyłka
Kod pocztowy
9
Edycja zamówienia -> Formularz zamówienia -> Odbiorca
Kraj
11
Zamówienia -> Podgląd zamówienia -> Informacje -> Wysyłka
Kraj
10
Edycja zamówienia -> Formularz zamówienia -> Odbiorca
NIP
12
Zamówienia -> Podgląd zamówienia -> Informacje o zamówieniu
NIP klienta
26
Edycja zamówienia -> Formularz zamówienia -> Odbiorca
Telefon
13
Zamówienia -> Podgląd zamówienia -> Informacje -> Wysyłka
Telefon 1 
11
Edycja zamówienia -> Formularz zamówienia -> Odbiorca
E-mail
14
Zamówienia -> Podgląd zamówienia -> Informacje o zamówieniu
E-mail klienta
12






Edycja zamówienia -> Formularz zamówienia -> Nabywca
Nazwa
15
Zamówienia -> Podgląd zamówienia -> Rozliczenia -> Adres
Imię nazwisko 
13
Edycja zamówienia -> Formularz zamówienia -> Nabywca
Ulica
16
Zamówienia -> Podgląd zamówienia -> Rozliczenia -> Adres
Ulica
14
Edycja zamówienia -> Formularz zamówienia -> Nabywca
Miasto
17
Zamówienia -> Podgląd zamówienia -> Rozliczenia -> Adres
Miasto
15
Edycja zamówienia -> Formularz zamówienia -> Nabywca
Kod pocztowy
18
Zamówienia -> Podgląd zamówienia -> Rozliczenia -> Adres
Kod pocztowy
15
Edycja zamówienia -> Formularz zamówienia -> Nabywca
Kraj
19
Zamówienia -> Podgląd zamówienia -> Rozliczenia -> Adres
Kraj
16
Edycja zamówienia -> Formularz zamówienia -> Nabywca
NIP
20
Zamówienia -> Podgląd zamówienia -> Informacje o zamówieniu
NIP klienta
26
Edycja zamówienia -> Formularz zamówienia -> Nabywca
Telefon
21
Zamówienia -> Podgląd zamówienia -> Rozliczenia -> Adres
Telefon 1 
11
Edycja zamówienia -> Formularz zamówienia -> Nabywca
E-mail
22
Zamówienia -> Podgląd zamówienia -> Informacje o zamówieniu
E-mail klienta
12






Edycja zamówienia -> Formularz zamówienia -> Płatnik
Nazwa
23
Zamówienia -> Podgląd zamówienia -> Rozliczenia -> Adres
Imię nazwisko 
13
Edycja zamówienia -> Formularz zamówienia -> Płatnik
Ulica
24
Zamówienia -> Podgląd zamówienia -> Rozliczenia -> Adres
Ulica
14
Edycja zamówienia -> Formularz zamówienia -> Płatnik
Miasto
25
Zamówienia -> Podgląd zamówienia -> Rozliczenia -> Adres
Miasto
15
Edycja zamówienia -> Formularz zamówienia -> Płatnik
Kod pocztowy
26
Zamówienia -> Podgląd zamówienia -> Rozliczenia -> Adres
Kod pocztowy 
15
Edycja zamówienia -> Formularz zamówienia -> Płatnik
Kraj
27
Zamówienia -> Podgląd zamówienia -> Rozliczenia -> Adres
Kraj
16
Edycja zamówienia -> Formularz zamówienia -> Płatnik
NIP
28
Zamówienia -> Podgląd zamówienia -> Informacje o zamówieniu
NIP klienta 
26
Edycja zamówienia -> Formularz zamówienia -> Płatnik
Telefon
29
Zamówienia -> Podgląd zamówienia -> Rozliczenia -> Adres
Telefon 1 
11
Edycja zamówienia -> Formularz zamówienia -> Płatnik
E-mail
30
Zamówienia -> Podgląd zamówienia -> Informacje o zamówieniu
E-mail klienta 
12






Edycja zamówienia -> Formularz zamówienia -> Pozycje zamówienia (Oferty)
[kod oferty] nazwa oferty
31
Zamówienia -> Podgląd zamówienia -> Szczegóły płatności
Nazwa
18
Edycja zamówienia -> Formularz zamówienia -> Pozycje zamówienia (Oferty)
Ilość
32
Zamówienia -> Podgląd zamówienia -> Szczegóły płatności
Ilość
19
Edycja zamówienia -> Formularz zamówienia -> Pozycje zamówienia (Oferty)
Cena
33
Zamówienia -> Podgląd zamówienia -> Szczegóły płatności
Cena
20






Edycja zamówienia -> Formularz zamówienia -> Dodatkowe informacje -> Informacje o przesyłce
Termin wysyłki 
34
Zamówienia -> Podgląd zamówienia -> Informacje -> Wysyłka
Termin
24
Edycja zamówienia -> Formularz zamówienia -> Dodatkowe informacje -> Informacje o przesyłce
Sposób dostawy 
35
Zamówienia -> Podgląd zamówienia -> Informacje -> Wysyłka

brak pola 
Edycja zamówienia -> Formularz zamówienia -> Dodatkowe informacje -> Informacje o przesyłce
Kurier 
36
Zamówienia -> Podgląd zamówienia -> Wysyłka -> Wyświetl informacje o śledzeniu
Nazwa przewoźnika 
21
Edycja zamówienia -> Formularz zamówienia -> Dodatkowe informacje -> Informacje o przesyłce
Nr listu
37
Zamówienia -> Podgląd zamówienia -> Wysyłka -> Wyświetl informacje o śledzeniu
Numer do śledzenia 
22
Edycja zamówienia -> Formularz zamówienia -> Dodatkowe informacje -> Informacje o przesyłce
Punkt dostawy
38
Zamówienia -> Podgląd zamówienia -> Informacje o zamówieniu
Nazwa punktu dostawy
25
Edycja zamówienia -> Formularz zamówienia -> Pozycje zamówienia (Oferty)
Dodatkowe informacje 
39
Zamówienia -> Podgląd zamówienia -> Informacje -> Wysyłka
Sposób
23


Zamówienie w panelu empik.com

Zamówienie w panelu xSale

 

    • Related Articles

    • Sellasist - integracja krok po kroku

      ⏱️ Ten artykuł przeczytasz w 20 minut Chcesz rozpocząć sprzedaż na empik.com i korzystasz z SellAsist? Dowiedz się, jak przenieść swoje oferty, automatycznie aktualizować stany i ceny oraz wygodnie obsługiwać zamówienia z empik.com Stary moduł ...

    • Konwerter Ceneo/Google – integracja krok po kroku

      ⏱️ Ten artykuł przeczytasz w 15 minut Korzystasz z plików integracyjnych Ceneo/Google i chcesz rozpocząć sprzedaż na empik.com? Skorzystaj z naszego konwertera, który w szybki i prosty sposób umożliwi Ci automatyczne wystawianie ofert na naszym ...

    • PrestaShop - integracja krok po kroku

      ⏱️Ten artykuł przeczytasz w 15 minut Chcesz rozpocząć sprzedaż na empik.com i korzystasz z PrestaShop? Dowiedz się, jak zautomatyzować dodawanie produktów, synchronizację cen i stanów magazynowych oraz obsługę zamówień w empik.com Zanim zaczniesz ...

    • Sky-Shop - integracja krok po kroku

      ⏱️ Ten artykuł przeczytasz w 15 minut Chcesz rozpocząć sprzedaż na empik.com i korzystasz ze Sky-Shop? Dowiedz się, jak przesłać swoje produkty na Empik, synchronizować oferty i ceny oraz pobierać i obsługiwać zamówienia. Włączenie integracji W ...

    • Apilo - integracja krok po kroku

      ⏱️ Ten artykuł przeczytasz w 7 minuty Chcesz rozpocząć sprzedaż na empik.com i korzystasz z Apilo? Dowiedz się, jak przenieść swoje oferty automatycznie aktualizować stany magazynowe i ceny oraz wygodnie obsługiwać zamówienia z empik.com Zanim ...