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 ustalić, której oferty w xSale dotyczy dana pozycja zamówienia. Do tego porównuje identyfikator pozycji przekazany przez Erli z danymi zapisanymi na ofercie w xSale.

Po stronie Erli sprawdzanym identyfikatorem jest kod widoczny przy produkcie na zamówieniu.

Po stronie xSale ten kod powinien odpowiadać danym zapisanym na właściwej ofercie. Najczęściej należy sprawdzić numer obcy oferty albo kod oferty.

Jeżeli pozycja zamówienia nie zostanie poprawnie powiązana z ofertą, porównaj kod widoczny przy produkcie w Erli z danymi oferty w xSale. W pierwszej kolejności sprawdź numer obcy oferty, a następnie kod oferty.

Ważne: w integracji Erli V2 xSale nie szuka pozycji zamówienia po SKU widocznym na pozycji zamówienia w Erli. Punktem wyjścia jest kod przekazany przez Erli dla pozycji zamówienia. Jeżeli pozycja nie zostanie poprawnie rozpoznana, sprawdź, czy ten kod jest zgodny z numerem obcym albo kodem właściwej oferty w xSale.

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