Integracja Erli jest dwukierunkowa. xSale pobiera z Erli dane potrzebne do obsługi zamówień i ofert, a do Erli wysyła informacje związane z ofertami, stanami, cenami, statusami zamówień i numerami przesyłek.
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 dopasowuje 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, domyślnie m.in. ze statusami pending, purchased i cancelled, zależnie od konfiguracji,
- płatności, domyślnie płatności ze statusem COMPLETED,
- szczegóły zamówienia i płatności po identyfikatorze z Erli,
- oferty i produkty z Erli, jeżeli wykorzystywany jest import ofert,
- parametry sprzedaży Erli, np. cenniki dostaw, producentów odpowiedzialnych, osoby odpowiedzialne i typ faktury.
Zamówienia są obsługiwane przez mechanizm SiteJournal/inbox Erli. Oznacza to, że integracja nie działa jak klasyczny import zamówień z listy lub pliku, tylko pobiera zdarzenia i szczegóły zamówień udostępniane przez Erli.
Co wysyłamy z xSale do Erli?
Z xSale do Erli mogą być wysyłane:
- nowe oferty i produkty,
- aktualizacje ofert i produktów,
- ceny,
- stany magazynowe,
- opisy i zdjęcia,
- EAN, SKU, nazwa, VAT, kategoria oraz parametry i atrybuty,
- parametry sprzedaży, takie jak czas wysyłki, cennik dostaw, producent odpowiedzialny, osoba odpowiedzialna i typ faktury,
- dezaktywacja oferty przez ustawienie statusu inactive,
- zmiany statusów zamówień zgodnie z mapowaniem w xSale,
- numer przesyłki lub listu przewozowego jako informacja o paczce przekazywana do Erli.
Czego integracja nie wysyła?
W obecnym działaniu nie jest obsługiwana wysyłka faktury ani dokumentu sprzedaży do Erli. Integracja nie ma też osobnego modułu wysyłkowego działającego jako niezależny ShipmentService. Numer listu przewozowego może być jednak przekazywany do Erli z zamówienia w xSale.
Jak xSale dopasowuje produkty na zamówieniu?
Przy wczytywaniu pozycji zamówienia xSale bierze pod uwagę SKU i EAN. Wyszukiwanie odbywa się w następującej kolejności:
- system szuka oferty w xSale o kodzie takim jak SKU,
- jeżeli nie znajdzie oferty, szuka towaru o kodzie takim jak SKU,
- jeżeli nadal nie znajdzie dopasowania, szuka po kodzie EAN wśród EAN-ów towarów podłączonych do ofert.
Jeżeli xSale nie znajdzie oferty ani towaru po SKU lub EAN, zamówienie zostanie zaimportowane na status wymagający obsługi ręcznej. W informacji o zamówieniu pojawi się wtedy SKU, którego nie udało się dopasować.
Jak działa status i numer listu przewozowego?
Status zamówienia może być wysyłany z xSale do Erli zgodnie z mapowaniem skonfigurowanym w integracji. Przykładowo status xSale Nowe może zostać powiązany ze statusem Erli inProgress, a status Anulowane ze statusem canceled.
Numer listu przewozowego jest przekazywany do Erli jako informacja o przesyłce. Jeżeli list przewozowy został wygenerowany w ramach usługi ErliPRO i Erli sam zapisuje numer na zamówieniu, nie trzeba dodatkowo wysyłać tego numeru przez integrację 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 | 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 | 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. |
EN


