EN
Podczas wystawiania lub aktualizacji oferty Allegro xSale wysyła do Allegro dane oferty, m.in. kategorię, parametry, cenę, stan, opis, zdjęcia, dane GPSR i powiązanie z katalogiem produktów. Jeżeli Allegro odrzuci część danych albo poprzednia zmiana oferty jest jeszcze przetwarzana, na kanale sprzedaży w xSale pojawi się komunikat błędu.
Ten wpis opisuje najczęściej spotykane komunikaty i wskazuje, co sprawdzić przed ponownym zapisaniem lub aktywacją oferty.
W tym artykule znajdziesz:
- gdzie sprawdzić błąd na ofercie
- jak poprawiać błędy zwrócone przez Allegro
- najczęstsze komunikaty i sposób postępowania
- kiedy zgłosić problem do wsparcia xSale
Gdzie sprawdzić błąd na ofercie?
Komunikat błędu sprawdzisz na ofercie, w sekcji kanału sprzedaży Allegro. Przejdź do Towary i Oferty → Oferty, otwórz ofertę i sprawdź kanał sprzedaży Allegro, którego dotyczy problem.
Na liście ofert możesz też użyć filtrów związanych z błędami synchronizacji, np. wyświetlić tylko oferty aktywne z błędami albo wyszukać ofertę po treści komunikatu błędu.
Jeżeli oferta nie została wystawiona, sprawdź również wpis Dlaczego aukcja na Allegro nie wystawiła się?.
Jak poprawiać błędy zwrócone przez Allegro?
Najpierw przeczytaj treść komunikatu. Allegro często wskazuje w nim konkretne pole, parametr lub warunek, który blokuje wystawienie oferty.
W zależności od komunikatu popraw dane w odpowiednim miejscu:
- parametry uzupełnij na ofercie albo w zestawie parametrów przypisanym do kanału sprzedaży,
- cenę i stan sprawdź na ofercie oraz na powiązanym towarze,
- opis popraw w opisie blokowym, jeżeli Allegro zwraca błąd dotyczący HTML lub niedozwolonych znaków,
- EAN i katalog Allegro sprawdź w danych towaru, wariantu oraz w kroku produktyzacji,
- dane GPSR uzupełnij w parametrach sprzedaży wymaganych dla danej kategorii.
Po poprawieniu danych zapisz ofertę. Jeżeli błąd dotyczył chwilowego przetwarzania zmian po stronie Allegro, xSale ponowi aktualizację automatycznie.
Najczęstsze komunikaty i sposób postępowania
| Komunikat lub fragment komunikatu | Co oznacza? | Co zrobić? |
|---|---|---|
| Missing required parameters Uzupełnij parametry obowiązkowe |
W ofercie brakuje parametrów wymaganych przez Allegro dla wybranej kategorii. | Otwórz ofertę i uzupełnij wymagane parametry. Sprawdź też, czy oferta ma aktualną kategorię Allegro i czy parametry w xSale odpowiadają aktualnym wymaganiom tej kategorii. |
| Próbujesz dodać dwie wartości do parametru, który przyjmuje tylko jedną wartość. Parameter Code: Marka | Dla parametru jednokrotnego, np. Marka, przekazywane są dwie wartości. | Zostaw jedną poprawną wartość parametru. Jeżeli wartość pochodzi z zestawu parametrów i z oferty jednocześnie, uporządkuj konfigurację tak, aby do Allegro trafiała jedna wartość. |
| Cena musi być większa od 0 | Oferta ma cenę równą 0 albo xSale nie może wyliczyć ceny dla typu ceny używanego na kanale Allegro. | Sprawdź cenę na ofercie, cennik i typ ceny ustawiony w integracji. Jeżeli oferta jest publikowana na dodatkowych rynkach Allegro, sprawdź również walutę i konfigurację ceny dla tego rynku. |
| Currency at offer should be same as currency at additional integration | Waluta oferty nie zgadza się z walutą dodatkowego rynku Allegro. | Sprawdź ustawienia dodatkowego rynku sprzedaży Allegro i cenę/walutę oferty. Oferta musi być zgodna z walutą wymaganą dla danego rynku. |
| Błędny tag „span” Invalid HTML subset |
Opis zawiera element HTML lub znak, którego Allegro nie akceptuje. | Popraw opis blokowy. Najbezpieczniej usuń problematyczne formatowanie, przeklej treść przez zwykły edytor tekstowy i ponownie zapisz opis w xSale. |
| Collection contains null or empty elements | Do Allegro przekazywana jest pusta wartość w kolekcji danych, najczęściej w parametrach lub elementach opisu. | Sprawdź parametry i opis oferty. Usuń puste wartości, puste bloki lub parametry bez uzupełnionej wartości. |
| Kod EAN jest niepoprawny | EAN nie spełnia walidacji Allegro albo nie jest poprawnym kodem GTIN. | Popraw EAN na towarze, wariancie lub ofercie. Nie używaj wartości technicznych, np. 0, jako kodu EAN. |
| Nie udało się zaktualizować przypisania katalogu Allegro | Problem dotyczy powiązania oferty z produktem z katalogu Allegro albo danych przekazywanych przy produktyzacji. | Sprawdź EAN, wybrany produkt z katalogu Allegro, kategorię i opis. Jeżeli komunikat wskazuje na pustą wartość, usuń puste bloki lub uzupełnij brakujące dane. |
| RequiredProductName Invalid product definition |
Allegro odrzuca próbę utworzenia produktu katalogowego albo brakuje danych wymaganych do utworzenia produktu. | Sprawdź nazwę produktu, opis, kategorię, EAN i parametry. W części kategorii Allegro nie pozwala tworzyć nowych produktów z zewnętrznych narzędzi. Wtedy wybierz istniejący produkt z katalogu albo zgłoś potrzebę dodania produktu bezpośrednio do Allegro. |
| Poprzednie zmiany w ofercie wciąż są przetwarzane przez Allegro | Allegro nie zakończyło jeszcze poprzedniej operacji na ofercie, np. zmiany stanu, ceny lub publikacji. | Poczekaj. xSale automatycznie podejmie kolejną próbę aktualizacji. Nie zapisuj w tym czasie wielu kolejnych zmian na tej samej ofercie. |
| Incorrect initial quantity of stock | Allegro nie pozwala wznowić lub opublikować oferty z nieprawidłowym stanem początkowym. | Sprawdź stan magazynowy towaru i ilość na kanale sprzedaży. Jeżeli oferta ma zostać aktywowana, stan powinien pozwalać na sprzedaż. |
| Brak danych GPSR brak producenta odpowiedzialnego / osoby odpowiedzialnej / informacji o bezpieczeństwie |
Allegro wymaga danych związanych z bezpieczeństwem produktu dla danej kategorii. | Uzupełnij wymagane dane GPSR w parametrach sprzedaży oferty albo w zestawie parametrów używanym dla kanału Allegro. |
| Wybrany parametr nie ma uzupełnionej wartości | Na ofercie jest dodany parametr, ale nie ma wpisanej lub wybranej wartości. | Otwórz parametry oferty i uzupełnij wartość wskazanego parametru. Jeżeli parametr pochodzi z zestawu parametrów, popraw go również w zestawie. |
| Wartość parametru musi być liczbą | Do parametru liczbowego wpisano tekst albo wartość w formacie, którego Allegro nie przyjmuje. | Popraw wartość parametru na liczbę. Sprawdź, czy nie ma dodatkowych znaków, jednostek, spacji albo tekstu dopisanego przy liczbie. |
| Wartość parametru musi być liczbą całkowitą | Parametr przyjmuje tylko pełne liczby, bez części dziesiętnej. | Wpisz liczbę całkowitą, np. 2 zamiast 2,5. Jeżeli wartość jest pobierana z danych towaru, popraw ją przy towarze lub wariancie. |
| Brak ustawionych parametrów sprzedażowych Allegro | Oferta nie ma danych sprzedażowych wymaganych przez Allegro, np. cennika dostawy, warunków zwrotu, reklamacji, gwarancji lub czasu trwania oferty. | Uzupełnij parametry sprzedażowe na ofercie albo przypisz do kanału sprzedaży właściwy zestaw parametrów Allegro. |
| Nie znaleziono definicji dla parametru. Parametr może być nieaktualny. | Na ofercie zapisany jest parametr, który nie pasuje już do aktualnych danych kategorii Allegro. | Sprawdź kategorię Allegro na ofercie i odśwież listę parametrów. Usuń nieaktualny parametr i uzupełnij aktualny wymagany przez Allegro. |
| Nie można przesłać parametru, który jest archiwalny | Oferta zawiera parametr, który Allegro oznaczyło jako archiwalny i którego nie można już przekazywać. | Usuń archiwalny parametr z oferty albo zestawu parametrów. Następnie uzupełnij aktualny parametr dostępny dla wybranej kategorii. |
| Brak obsługi typu parametru | xSale otrzymał parametr w typie, który wymaga dodatkowej weryfikacji po stronie integracji. | Zgłoś problem do wsparcia xSale. W zgłoszeniu podaj ID oferty, kanał Allegro i pełną treść komunikatu. |
Kiedy zgłosić problem do wsparcia xSale?
Zgłoś problem do wsparcia xSale, jeżeli:
- komunikat błędu nie wskazuje, którego pola dotyczy problem,
- po poprawieniu danych i ponownej synchronizacji błąd nadal wraca,
- Allegro zmieniło wymagania kategorii, a w xSale nie widzisz nowych parametrów,
- oferta jest poprawnie uzupełniona, ale Allegro nadal odrzuca produktyzację lub publikację.
W zgłoszeniu podaj ID oferty w xSale, nazwę kanału Allegro oraz pełną treść komunikatu błędu. To przyspieszy weryfikację.