Wysyłam z Allegro to usługa logistyczna Allegro, która pozwala generować przesyłki (etykiety) do zamówień z Allegro. Podczas rejestracji przesyłki Allegro (lub przewoźnik) może zwrócić komunikat błędu – zwykle wtedy, gdy brakuje danych, mają nieprawidłowy format lub przesyłka nie spełnia wymagań danej usługi (np. waga, liczba paczek).
W tym artykule znajdziesz najczęstsze komunikaty błędów oraz wskazówki: kiedy występują i co sprawdzić, żeby samodzielnie je rozwiązać.
Jak podejść do diagnozy
- Sprawdź dane odbiorcy w zamówieniu (imię i nazwisko, telefon, adres).
- Sprawdź dane nadawcy w integracji „Wysyłam z Allegro” (np. nazwa firmy, imię i nazwisko, punkt nadania – jeśli wymagany).
- Zweryfikuj wybraną metodę dostawy i formę płatności w zamówieniu (np. pobranie).
- Sprawdź parametry przesyłki: waga, liczba paczek, ewentualnie pola „Opis” i „Referencja”.
- Jeśli komunikat dotyczy chwilowego błędu komunikacji – spróbuj ponownie po krótkim czasie.
Limity znaków i zbyt długie pola
Długość podanego tekstu przekracza 35 znaków / Receiver name must not exceed 35 characters / Długość podanego tekstu przekracza 30 znaków
Kiedy występuje: gdy jedno z pól przekazywanych do przewoźnika ma limit znaków (różny dla różnych usług).
Co sprawdzić:
- nazwa odbiorcy lub firmy,
- nazwa firmy nadawcy (ustawienia integracji),
- pole „Referencja” i/lub „Opis przesyłki”.
Po skróceniu wartości w polu, które przekracza limit, ponów rejestrację przesyłki.
reference: too_long
Kiedy występuje: gdy wartość w polu kod referencji przekracza maksymalną długość akceptowaną przez danego przewoźnika.
Co sprawdzić: skróć wartość w polu referencji (limit zależy od przewoźnika i wybranej metody dostawy), a następnie ponów rejestrację przesyłki.
Brak danych lub nieprawidłowy format
Imię i nazwisko może składać się tylko z liter / Imię i nazwisko jest wymagane
Kiedy występuje: gdy Allegro lub przewoźnik odrzuca dane nadawcy lub odbiorcy (brak / niepoprawny format).
Co sprawdzić: uzupełnij brakujące dane lub popraw format w zamówieniu albo w ustawieniach integracji (domyślne dane nadawcy).
Miasto odbiorcy jest nieprawidłowe
Kiedy występuje: gdy pole „miasto” jest puste lub zawiera wartość nieakceptowaną przez przewoźnika.
Co sprawdzić: popraw dane adresowe odbiorcy w zamówieniu.
Proszę podać numer komórkowy (9 cyfr)
Kiedy występuje: gdy numer telefonu odbiorcy jest niepełny lub ma nieprawidłowy format.
Co sprawdzić: uzupełnij numer telefonu w zamówieniu, a następnie ponów rejestrację.
Street field must include the building number / Pole ulica musi zawierać numer budynku
Kiedy występuje: gdy w danych adresowych brakuje numeru ulicy lub numeru budynku.
Co sprawdzić: uzupełnij pełny adres dostawy (w zamówieniu lub w edycji przesyłki w xSale), a następnie ponów rejestrację przesyłki.
Opis przesyłki nie może być pusty (dotyczy zwłaszcza metod dostawy obsługiwanych przez DHL)
Kiedy występuje: gdy przewoźnik wymaga wypełnienia pola „Opis przesyłki”.
Co sprawdzić: uzupełnij opis przesyłki i spróbuj ponownie.
Waga i ograniczenia usługi
Waga paczki musi być większa od 0 / Weight must exceed 0 kg / Proszę podać prawidłową wagę
Kiedy występuje: gdy w przesyłce brakuje wagi lub jest ustawiona na 0.
Co sprawdzić: uzupełnij wagę paczki i ponów rejestrację przesyłki.
Przesyłka jest zbyt ciężka (max. 1 kg) / Podana waga przekracza limit 31,5 kg
Kiedy występuje: gdy waga przesyłki przekracza limit wybranego przewoźnika / usługi. Limit może zależeć od metody dostawy.
Co sprawdzić: zweryfikuj wagę w przesyłce i dopasuj metodę dostawy do warunków przewoźnika.
Błędy komunikacji i błędy zewnętrzne
Błąd zewnętrznego przewoźnika / Wystąpił błąd komunikacji z API przewoźnika / Nie udało się pobrać informacji zwrotnej o wygenerowaniu przesyłki
Kiedy występuje: gdy podczas tworzenia przesyłki wystąpi problem po stronie Allegro lub przewoźnika (np. chwilowa niedostępność API).
Co sprawdzić: spróbuj ponownie utworzyć przesyłkę. Może się zdarzyć, że mimo komunikatu błędu przesyłka została utworzona – warto to zweryfikować. Jeśli problem utrzymuje się dłużej, sprawdź komunikaty przewoźnika o utrudnieniach.
Metoda dostawy, pobranie i liczba paczek
Wybrana metoda dostawy nie obsługuje tego zamówienia
Kiedy występuje: gdy próbujesz utworzyć przesyłkę inną metodą niż ta wybrana przez kupującego w zamówieniu (np. pobranie vs przedpłata).
Co sprawdzić: upewnij się, jaka metoda dostawy i forma płatności są w zamówieniu (szczegóły możesz sprawdzić w panelu Allegro). Zweryfikuj mapowania dostaw w integracji Allegro oraz usługę podpiętą do sposobu dostawy użytego do utworzenia przesyłki.
Płatność pobraniowa nie jest wspierana dla wybranej metody dostawy
Kiedy występuje: gdy próbujesz nadać przesyłkę za pobraniem metodą, która nie obsługuje pobrania.
Co sprawdzić: wybierz metodę dostawy obsługującą pobranie lub zmień sposób nadania zgodnie z warunkami przewoźnika.
Usługa wielopaczka nie jest dostępna u tego przewoźnika / W żądaniu może być tylko jedna paczka
Kiedy występuje: gdy próbujesz nadać przesyłkę z więcej niż jedną paczką, a dana usługa nie obsługuje wielopaczkowości.
Co sprawdzić: utwórz przesyłkę jako jednopaczkową lub wybierz usługę, która wspiera więcej niż jedną paczkę.
Uprawnienia i zgodność konta
Nie jesteś właścicielem zamówienia
Kiedy występuje: gdy próbujesz nadać przesyłkę usługą powiązaną z innym kontem Allegro niż to, z którego pochodzi zamówienie.
Co sprawdzić: sprawdź mapowania w integracji Allegro dla konta, z którego pochodzi zamówienie, oraz ustawienia kuriera dla sposobu dostawy, którego używasz do utworzenia przesyłki.
Przypadki specyficzne: Allegro One, punkty nadania i Paczkomaty
Kod pocztowy nadawcy znajduje się poza obszarem One Kuriera
Kiedy występuje: gdy wybrana metoda dostawy Allegro One Kurier nie obsługuje adresu nadawcy (kod pocztowy nadawcy jest poza zasięgiem usługi).
Co sprawdzić: w takiej sytuacji Allegro nie umożliwi wygenerowania etykiety dla tej metody. Konieczne może być ustalenie z kupującym alternatywnej metody wysyłki lub kontakt bezpośrednio z Allegro.
Paczkomat o podanej nazwie nie istnieje. Musisz wybrać inny.
Kiedy występuje: gdy wskazany Paczkomat został wyłączony z obsługi na danym obszarze (InPost).
Co sprawdzić: w edycji przesyłki w xSale zmień kod Paczkomatu odbiorcy na najbliższy dostępny punkt i ponów rejestrację.
Punkt nadania przesyłki jest niepoprawny
Kiedy występuje: gdy przewoźnik wymaga podania punktu nadania, a w konfiguracji brakuje poprawnej wartości.
Co sprawdzić: sprawdź ustawienia integracji i dodaj punkt nadania dla konkretnej metody dostawy w zakładce „Dodatkowa konfiguracja”. Podanie punktu nadania jest wymagane m.in. dla usług Allegro Pocztex (Kurier, Odbiór w Punkcie, Automat).
musi pasować do wyrażenia [A-Za-z0-9-_]+ (VALIDATION_ERROR)
Kiedy występuje: gdy w polu „Nadawca – Punkt nadania” jest wartość w nieprawidłowym formacie (np. dla metod Allegro Pocztex).
Co sprawdzić: punkt nadania dla metod Allegro Pocztex to 6 cyfr (identyfikator urzędu nadania). Możesz go sprawdzić w panelu Allegro podczas nadawania przesyłki.
