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 dezaktywować ofertę.

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 działa dezaktywacja oferty?
• 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,
• 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ę.

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.

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 działa dezaktywacja oferty?

Jeżeli oferta albo wariant są oznaczone w xSale jako zamykane lub archiwalne, integracja nie wysyła zwykłej aktualizacji danych. Zamiast tego ustawia w Erli status oferty inactive.

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.

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 oferta lub wariant nie są oznaczone w xSale jako zamykane albo archiwalne. Takie oznaczenie powoduje wysłanie do Erli statusu inactive.