Integracje

⌘K
  1. Strona główna
  2. Integracje
  3. Marketplace – Erli
  4. Zakres integracji z Erli

Zakres integracji z Erli

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

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 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

Zamówienie Erli w panelu sprzedawcy z oznaczonymi polami

Zrzut xSale

Zamówienie Erli w xSale z oznaczonymi polami zamówienia

Zrzut xSale – EAN na ofercie

Kod EAN na ofercie w xSale

Czego brakuje w tym artykule?