Zakres integracji z Erli

Integracja Erli pozwala obsługiwać sprzedaż w Erli z poziomu xSale. xSale może pobierać zamówienia i płatności z Erli, a także wysyłać do Erli oferty, ceny, stany magazynowe, statusy zamówień i numery przesyłek.

Uwaga: ten wpis dotyczy integracji Erli V2, czyli aktualnej wersji dostępnej w kreatorze xSale. Wcześniejsza integracja Erli V1 działała inaczej i miała inną logikę obsługi, dlatego przy konfiguracji i analizie działania korzystaj z opisu dla V2.

Ten wpis opisuje aktualną integrację Erli dostępną w kreatorze xSale. Jeżeli dopiero konfigurujesz Erli, zacznij od ustawień w kreatorze integracji, a następnie sprawdź, czy zamówienia, oferty, ceny i stany działają zgodnie z wybranym zakresem.

W tym artykule znajdziesz:

• Jakie dane są pobierane z Erli do xSale?
• Jakie dane są wysyłane z xSale do Erli?
• Czego integracja nie wysyła?
• Jak xSale rozpoznaje produkty na zamówieniu?
• Jak działa status i numer listu przewozowego?
• Jakie pola zamówienia są widoczne w xSale i Erli?

Co pobieramy z Erli do xSale?

Z Erli do xSale mogą być pobierane:

• zamówienia z danymi kupującego, odbiorcy, dostawy, płatności i pozycji zamówienia,
• płatności powiązane z zamówieniami,
• oferty i produkty z Erli, jeżeli w kreatorze integracji włączono import ofert,
• parametry sprzedaży potrzebne do wystawiania i aktualizacji ofert, na przykład cenniki dostaw, typ faktury, producent odpowiedzialny i osoba odpowiedzialna.

Zamówienia są pobierane na podstawie informacji zwracanych przez Erli. xSale odczytuje, że w Erli pojawiło się zamówienie lub zmienił się jego status, a następnie pobiera jego szczegóły i tworzy zamówienie w xSale.

Co wysyłamy z xSale do Erli?

Z xSale do Erli mogą być wysyłane:

• nowe oferty i aktualizacje istniejących ofert, w tym ofert prostych, zestawów oraz ofert wielowariantowych,
• ceny i stany magazynowe,
• nazwa oferty, EAN, SKU, stawka VAT, kategoria, parametry i atrybuty,
• opis, zdjęcia i pliki przypisane do oferty,
• parametry sprzedaży, takie jak czas wysyłki, cennik dostaw, typ faktury, producent odpowiedzialny i osoba odpowiedzialna,
• informacja o zakończeniu sprzedaży oferty na kanale Erli,
• statusy zamówień zgodnie z mapowaniem ustawionym w xSale,
• numery przesyłek/listów przewozowych.

Czego integracja nie wysyła?

Integracja nie wysyła do Erli faktury ani dokumentu sprzedaży. Jeżeli klient potrzebuje faktury, dokument należy obsłużyć poza wysyłką dokumentu sprzedaży z xSale do Erli.

xSale może przekazać do Erli numer listu przewozowego, ale nie oznacza to, że Erli pełni rolę osobnego modułu kurierskiego w xSale. Etykieta i przesyłka są obsługiwane zgodnie z konfiguracją dostawy w xSale, a do Erli trafia informacja o numerze przesyłki.

Jak xSale rozpoznaje produkty na zamówieniu?

Przy pobieraniu zamówienia z Erli xSale musi rozpoznać, której oferty w xSale dotyczy dana pozycja zamówienia. Do tego używa identyfikatora pozycji przekazanego przez Erli w polu externalId.

W praktyce xSale porównuje tę wartość z danymi zapisanymi na ofercie w xSale:

• najpierw może porównać externalId z numerem obcym oferty. Numer obcy to identyfikator oferty po stronie kanału sprzedaży. Można go sprawdzić na edycji oferty w xSale, w danych powiązanych z kanałem sprzedaży Erli,
• jeżeli oferta nie zostanie znaleziona w ten sposób, xSale może dodatkowo porównać tę samą wartość externalId z kodem oferty w xSale. Ten drugi krok zależy od ustawień importu zamówień dla integracji, czyli od konfiguracji przygotowanej dla danego klienta.

Ważne: przy rozpoznawaniu pozycji zamówienia integracja Erli nie wyszukuje oferty po SKU pozycji zamówienia. Punktem wyjścia jest identyfikator externalId przekazany przez Erli.

Jeżeli pozycja zamówienia nie zostanie poprawnie powiązana z ofertą, sprawdź na ofercie w xSale numer obcy dla kanału Erli oraz kod oferty. Te wartości powinny odpowiadać identyfikatorowi pozycji przekazywanemu przez Erli.

Jak działa status i numer listu przewozowego?

Status zamówienia może być wysyłany z xSale do Erli zgodnie z mapowaniem statusów ustawionym w integracji. Przy mapowaniu trzeba używać wartości technicznych wymaganych przez Erli, na przykład inProgress, sent, readyToPickup, received, returned albo canceled.

Numer listu przewozowego może zostać przekazany z xSale do Erli jako informacja o przesyłce. Żeby wysyłka numeru była możliwa, zamówienie musi mieć numer zamówienia Erli, nazwę kuriera i numer listu przewozowego.

Jeżeli numer listu został już nadany i zapisany bezpośrednio w Erli, nie trzeba wysyłać go drugi raz z xSale.

Szczegółowy zakres danych przesyłanych z Erli do xSale

Poniższa tabela pokazuje, gdzie wybrane dane zamówienia są widoczne w xSale i Erli. Numery pól odnoszą się do zrzutów ekranu umieszczonych pod tabelą.

Zakres opisuje aktualne działanie integracji Erli. Część danych, np. koszt dostawy, jest pobierana z Erli jako informacja na zamówieniu, a dopiero w dalszej obsłudze xSale lub integracji ERP może zostać zapisana jako osobna pozycja transportowa zgodnie z konfiguracją.

Obszar xSale	Pole xSale	nr	Obszar Erli	Pole ERLI	nr	Uwagi
Zamówienie > Nagłówek zamówienia	Data utworzenia / data zakupu	1	Zamówienie	Data zakupu	1	Kod ustawia datę utworzenia dokumentu z pola created, a datę rezerwacji z purchasedAt, jeżeli Erli ją zwróci.
Zamówienie > Nagłówek zamówienia	Zewnętrzny nr zamówienia	3	Nagłówek zamówienia	Numer zamówienia	3	Do xSale trafia identyfikator zamówienia Erli. Pole externalOrderId jest używane w obsłudze zdarzeń SiteJournal, ale numerem dokumentu w xSale jest id zamówienia Erli.
Zamówienie > Nagłówek zamówienia	Status	2	Zamówienie	Status zamówienia	4	Status z Erli trafia na zamówienie w xSale. Dla statusów cancelled i returned integracja ustawia też odpowiedni stan gotowości do dalszego przetwarzania.
Zamówienie > Nagłówek zamówienia	Uwagi / opis	6	Zamówienie > Notatka	Notatka	5	Komentarz z zamówienia Erli jest zapisywany w opisie zamówienia w xSale.
Zamówienie > Nagłówek zamówienia	Waluta		Integracja Erli	brak widocznego pola waluty na zamówieniu		Integracja ustawia walutę zamówienia i pozycji jako PLN.
Zamówienie > Informacje o dostawie	Sposób dostawy	4	Dostawa > Dostawa	Dostawa	6	Nazwa dostawy z Erli trafia do xSale jako nazwa sposobu dostawy. Wyświetlana lub docelowo używana nazwa może zależeć od mapowania dostaw w konfiguracji.
Zamówienie > Informacje o dostawie	Koszt dostawy	31	Produkty	Koszt dostawy	7	Koszt dostawy jest widoczny w podsumowaniu produktów oraz wynika z danych dostawy. W xSale jest zapisywany na zamówieniu jako wartość dostawy brutto. Nie jest bezpośrednio tworzony przez konwerter Erli jako osobna pozycja TRANSPORT.
Zamówienie > Informacje o dostawie	Kraj docelowy	17	Dostawa > Dane odbiorcy	Adres odbiorcy	12	Kod kraju z adresu dostawy jest zapisywany jako kraj docelowy zamówienia.
Zamówienie > Informacje o płatności	Forma płatności	5	Płatność	metoda płatności / status	8	Jeżeli w Erli widoczna jest płatność przy odbiorze, xSale ustawia formę płatności COD. W pozostałych przypadkach integracja używa danych pobranej operacji płatności: najpierw operator, potem kod metody, a następnie nazwę metody.
Zamówienie > Nabywca	Nazwa	9	Dostawa > Faktura	Firma / dane faktury	9	Jeżeli Erli zwróci dane fakturowe, xSale używa ich jako danych nabywcy. Gdy jest podana firma, zapisywana jest firma; w przeciwnym razie imię i nazwisko. Druga linia nazwy nie jest uzupełniana osobno.
Zamówienie > Nabywca	Ulica i numer	15	Dostawa > Faktura	Adres z danych faktury	9	Adres jest zapisywany z pól adresowych danych fakturowych. Numer budynku i lokalu są przepisywane, jeśli Erli je zwróci.
Zamówienie > Nabywca	Kod pocztowy, miasto, kraj	16, 14, 17	Dostawa > Faktura	Adres z danych faktury	9	Dane adresowe nabywcy są pobierane z adresu fakturowego. Jeżeli Erli nie zwróci adresu fakturowego, integracja używa adresu dostawy.
Zamówienie > Nabywca	NIP	11	Dostawa > Faktura	NIP	9	NIP jest zapisywany z danych fakturowych, jeżeli Erli go zwróci.
Zamówienie > Nabywca	E-mail	13	Dostawa > Dane odbiorcy	adres e-mail	14	Adres e-mail użytkownika Erli jest zapisywany przy adresie głównym oraz w kontakcie klienta.
Zamówienie > Nabywca	Telefon	12	Dostawa > Dane odbiorcy / Faktura	Tel. / telefon z danych faktury	13	Dla kontaktu klienta integracja używa telefonu z adresu dostawy, a jeśli go nie ma, telefonu z adresu fakturowego. Przy adresie nabywcy zapisywany jest telefon z adresu fakturowego.
Zamówienie > Odbiorca	Nazwa	9	Dostawa > Dane odbiorcy	Imię i nazwisko / firma	10	Jeżeli Erli zwróci firmę, zapisywana jest firma; w przeciwnym razie imię i nazwisko. Druga linia nazwy nie jest uzupełniana osobno.
Zamówienie > Odbiorca	Ulica i numer	15	Dostawa > Dane odbiorcy	Adres odbiorcy	11	Adres dostawy jest zapisywany jako adres odbiorcy. Numer budynku i lokalu są przepisywane, jeśli Erli je zwróci.
Zamówienie > Odbiorca	Kod pocztowy, miasto, kraj	16, 14, 17	Dostawa > Dane odbiorcy	Adres odbiorcy	12	Dane adresowe odbiorcy są pobierane z adresu dostawy.
Zamówienie > Odbiorca	Telefon	12	Dostawa > Dane odbiorcy	Tel.	13	Telefon z adresu dostawy jest zapisywany przy odbiorcy oraz w kontakcie klienta.
Zamówienie > Odbiorca	E-mail	13	Dostawa > Dane odbiorcy	adres e-mail	14	Erli zwraca e-mail na poziomie użytkownika, a nie osobno w adresie dostawy. Ten adres jest zapisywany także przy odbiorcy.
Zamówienie > Pozycje zamówienia	Kod artykułu	29	Produkty	SKU	16	W panelu sprzedawcy widoczny jest kod SKU. Technicznie jako kod pozycji xSale używa najpierw externalId. Jeżeli go nie ma, używa sku.
Zamówienie > Pozycje zamówienia	Nazwa pozycji	29	Produkty	Nazwa produktu	15	Nazwa pozycji z Erli jest zapisywana jako nazwa artykułu na pozycji zamówienia.
Zamówienie > Pozycje zamówienia	EAN	34	Produkty	EAN	17	EAN z pozycji Erli jest zapisywany na pozycji zamówienia w xSale.
Zamówienie > Pozycje zamówienia	Ilość	30	Produkty	ilość przy cenie produktu, np. 1 × 13,44 zł	18	Ilość z pozycji Erli jest zapisywana jako ilość pozycji zamówienia.
Zamówienie > Pozycje zamówienia	Cena brutto	28	Produkty	cena przy produkcie, np. 1 × 13,44 zł	19	Cena jednostkowa z Erli jest zapisywana jako cena i cena brutto pozycji w xSale. Kwota z Erli jest przeliczana z groszy na złote.
Zamówienie > Płatności	Kwota płatności	32	Płatność	kwota z dostawą	22	Do xSale trafiają tylko płatności ze statusem COMPLETED i kwotą większą od zera.
Zamówienie > Płatności	Data płatności	33	Płatność	status płatności	23	Jako data płatności używana jest data zakończenia płatności. Jeśli jej nie ma, integracja używa daty utworzenia płatności.
Zamówienie > Płatności	Forma płatności	5	Płatność	metoda płatności	8	Nazwa formy płatności jest wybierana w kolejności: operator, methodCode, methodName, a na końcu status.
Zamówienie > Płatności	Numer zewnętrzny płatności	brak odpowiednika w polu	Płatność	identyfikator	20	Jeżeli Erli zwróci zewnętrzny identyfikator płatności, xSale zapisuje go jako numer obcy i opis płatności. W przeciwnym razie używany jest identyfikator płatności Erli.

Zrzuty Erli

Zrzut xSale

Zrzut xSale – EAN na ofercie