Integracje

⌘K
  2. Strona główna
  4. Dokumentacja
  6. Integracje
  8. Kurier – Wysyłam z Allegr...
  10. Komunikaty błędów

Komunikaty błędów

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.