Tworzenie i aktualizacja ofert Erli

Wpis opisuje, jak działa tworzenie i aktualizacja ofert Erli w xSale. Integracja może utworzyć nową ofertę w Erli, zaktualizować istniejącą ofertę, zmienić cenę, stan magazynowy oraz zakończyć sprzedaż oferty.

W tym artykule znajdziesz

• Kiedy xSale tworzy, a kiedy aktualizuje ofertę?
• Jakie dane oferty są wysyłane do Erli?
• Co musi być uzupełnione przed wysyłką oferty?
• Jak działa aktualizacja ceny i stanu?
• Jak zakończyć sprzedaż oferty Erli?
• Jak działa import ofert z Erli do xSale?
• Dlaczego oferta może nie być aktywna w Erli?
• Jak rozwiązać najczęstsze problemy?

Kiedy xSale tworzy, a kiedy aktualizuje ofertę?

xSale identyfikuje ofertę Erli po zewnętrznym identyfikatorze oferty. W praktyce jest on pobierany z kodu oferty lub kodu wariantu w xSale. Ten identyfikator powinien być stabilny, ponieważ na jego podstawie integracja sprawdza, czy produkt istnieje już w Erli.

• Jeżeli oferta o takim identyfikatorze istnieje w Erli, xSale aktualizuje ją.
• Jeżeli oferta nie istnieje w Erli, xSale tworzy nową ofertę.
• Jeżeli podczas tworzenia okaże się, że oferta została już utworzona równolegle, xSale przechodzi na aktualizację tej oferty.

Jeżeli oferta nie ma kodu ani innego stabilnego identyfikatora, integracja nie ma podstawy do poprawnego utworzenia lub aktualizacji oferty w Erli.

Jakie dane oferty są wysyłane do Erli?

Podczas pełnego zapisu oferty xSale może wysłać do Erli następujące dane:

• nazwę oferty,
• SKU,
• EAN, jeżeli jest uzupełniony,
• cenę,
• stan magazynowy,
• status oferty, np. active albo inactive. Status inactive oznacza, że sprzedaż oferty na kanale Erli jest zakończona,
• opis,
• zdjęcia,
• kategorię Erli,
• parametry i atrybuty wymagane w kategorii,
• stawkę VAT,
• załączniki obsługiwane przez Erli, np. instrukcję, etykietę energetyczną, kartę produktu albo informacje o bezpieczeństwie,
• parametry sprzedaży, takie jak czas wysyłki, cennik dostaw, producent odpowiedzialny, osoba odpowiedzialna i rodzaj faktury.

Zdjęcia są wysyłane jako adresy URL. Jeżeli ta sama grafika występuje kilka razy, xSale pomija duplikaty. Opis może być przekazany jako zwykły opis tekstowy albo jako opis strukturalny, jeżeli został przygotowany w formacie obsługiwanym przez integrację.

Opis oferty Erli: Erli obsługuje opis w formie sekcji tekstowo-graficznych. Jeśli oferta ma przygotowany Opis blokowy, xSale przekazuje do Erli sekcje tekstowe i obrazkowe. Jeżeli w zwykłym polu opisu wpiszesz kod HTML, np. <b>tekst</b>, może on zostać potraktowany jako zwykły tekst, a nie jako formatowanie. Dla ofert Erli najlepiej przygotowywać opis jako Opis blokowy.

Co musi być uzupełnione przed wysyłką oferty?

Przed wysłaniem oferty do Erli sprawdź przede wszystkim:

• czy oferta ma stabilny kod, który może być użyty jako identyfikator oferty w Erli,
• czy oferta ma cenę,
• czy wybrano kategorię Erli,
• czy uzupełniono wymagane parametry kategorii,
• czy uzupełniono stawkę VAT, jeśli jest wymagana dla oferty,
• czy uzupełniono parametry sprzedaży wymagane w konfiguracji Erli.

Parametr Marka: w przypadku parametru Marka lista dostępnych wartości nie ładuje się od razu po otwarciu pola. Zacznij wpisywać nazwę marki w polu wyboru, a xSale pobierze i wyświetli pasujące wartości. Ten parametr ma bardzo dużo dostępnych opcji, dlatego ze względu na wydajność systemu nie wyświetlamy od razu całej listy marek.

Cena jest wymagana. Jeżeli cena nie jest uzupełniona, integracja zwróci błąd i oferta nie zostanie poprawnie zapisana w Erli.

Jeżeli w konfiguracji parametrów sprzedaży występuje Czas wysyłki albo Cennik dostawy, te pola również muszą być uzupełnione. W przeciwnym razie xSale zwróci komunikat o brakujących parametrach sprzedaży Erli.

Jak działa aktualizacja ceny i stanu?

Cena i stan mogą być aktualizowane jako osobne zmiany, bez pełnej aktualizacji wszystkich danych oferty.

• Aktualizacja ceny wysyła do Erli tylko cenę.
• Aktualizacja stanu wysyła do Erli tylko stan magazynowy.
• Jeżeli podczas aktualizacji ceny lub stanu xSale nie znajdzie oferty w Erli, integracja wykona pełny zapis oferty.

Stan magazynowy jest liczony z przekazanej listy stanów. Jeżeli taka lista nie jest dostępna, xSale korzysta ze stanów zapisanych przy wariancie. Jeżeli nie ma żadnego stanu, do Erli zostanie przekazany stan 0.

Jak zakończyć sprzedaż oferty Erli?

Po wybraniu kanału sprzedaży Erli i przejściu do okna edycji oferty w xSale widoczny jest przycisk służący do zakończenia sprzedaży danej oferty. Użyj go wtedy, gdy oferta nie ma być już aktywnie sprzedawana w Erli.

Zakończenie sprzedaży powoduje wysłanie do Erli informacji, że oferta nie ma być już sprzedawana na tym kanale. Technicznie integracja ustawia wtedy status oferty inactive, czyli kończy sprzedaż oferty w Erli.

Jeżeli oferta albo wariant są oznaczone w xSale jako zamykane lub archiwalne, integracja również ustawia w Erli status oferty inactive. W praktyce oznacza to zakończenie sprzedaży tej oferty na kanale Erli.

Dla aktywnej oferty standardowo wysyłany jest status active. Ostateczna możliwość sprzedaży oferty zależy jednak także od walidacji po stronie Erli, np. kompletności kategorii, parametrów, zdjęć, ceny, stanu i wymagań konta sprzedawcy.

Jak działa import ofert z Erli do xSale?

Jeżeli w konfiguracji integracji wykorzystywany jest import ofert, xSale może pobrać z Erli listę produktów i podstawowe dane ofertowe. Import służy przede wszystkim do utworzenia w xSale reprezentacji oferty istniejącej już w Erli albo do uzupełnienia danych potrzebnych do dalszej obsługi integracji.

Podczas importu xSale korzysta z identyfikatora oferty Erli i danych produktu udostępnionych przez API. Pobierane mogą być m.in. nazwa, opis, EAN, SKU, kategoria, zdjęcia, cena, stan, status, parametry sprzedaży i informacje walidacyjne zwracane przez Erli.

Przy imporcie kategorii xSale próbuje dopasować kategorię Erli do kategorii zapisanej w xSale. Jeżeli kategoria Erli nie ma odpowiednika, jest zarchiwizowana albo nie została wcześniej zsynchronizowana, import może wymagać ręcznej korekty kategorii lub parametrów.

Import oferty nie zastępuje kontroli poprawności danych. Po pobraniu oferty warto sprawdzić w xSale, czy kategoria, parametry, zdjęcia, cena, stan i parametry sprzedaży są kompletne oraz czy oferta może być później poprawnie aktualizowana z xSale do Erli.

Dlaczego oferta może nie być aktywna w Erli?

Samo wysłanie oferty z xSale nie zawsze oznacza, że oferta będzie od razu aktywna i możliwa do zakupu w Erli. Po zapisie Erli wykonuje własną walidację danych oferty i może zwrócić problemy blokujące sprzedaż.

Najczęstsze obszary, które warto sprawdzić, to:

• cena oferty,
• stan magazynowy,
• kategoria Erli,
• wymagane parametry i atrybuty kategorii,
• zdjęcia,
• stawka VAT,
• cennik dostawy i czas wysyłki,
• warunki sprzedaży i wymagania konta sprzedawcy,
• aktywność sklepu Erli, w tym wymagania KYC lub ograniczenia po stronie marketplace,
• status oferty, np. czy sprzedaż nie została zakończona przez ustawienie statusu inactive.

Jeżeli Erli zwróci komunikat walidacyjny, należy poprawić wskazane dane w xSale lub w konfiguracji konta Erli, a następnie ponownie wysłać aktualizację oferty.

Najczęstsze problemy

Oferta nie utworzyła się w Erli

Sprawdź, czy oferta ma kod, cenę, kategorię Erli, wymagane parametry kategorii oraz wymagane parametry sprzedaży. Brak ceny albo wymaganych parametrów sprzedaży zatrzymuje zapis oferty.

Oferta została wysłana, ale Erli jej nie aktywuje

Sprawdź komunikaty walidacyjne zwrócone przez Erli. Erli może zgłosić problemy związane m.in. z dostawą, stanem, kategorią, zdjęciem, ceną, stawką VAT, aktywnością sklepu, warunkami sprzedaży albo brakującymi tłumaczeniami.

Cena albo stan nie zaktualizowały się

Sprawdź, czy oferta ma ten sam identyfikator w xSale i Erli. Jeżeli oferta nie zostanie znaleziona po identyfikatorze, xSale spróbuje wykonać pełny zapis oferty.

Brakuje parametrów sprzedaży

Uzupełnij parametry sprzedaży Erli w ofercie lub wariancie. Dotyczy to szczególnie czasu wysyłki i cennika dostaw, jeżeli są wymagane w konfiguracji integracji.

Oferta została dezaktywowana

Sprawdź, czy sprzedaż oferty nie została zakończona ręcznie oraz czy oferta lub wariant nie są oznaczone w xSale jako zamykane albo archiwalne. Takie działanie powoduje wysłanie do Erli statusu inactive, czyli zakończenie sprzedaży oferty na kanale Erli.