Korzystając z integracji Wysyłam z Allegro możesz napotkać komunikaty błędów. Zazwyczaj system zwróci je w przypadku braku określonych danych (odbiorcy lub nadawcy), ich nieprawidłowego formatu lub niespełnienia warunków stawianych przez przewoźnika (np. nieprawidłowa waga lub rozmiar przesyłki).
W tym wpisie znajdziesz listę najczęściej występujących błędów wraz z ich wyjaśnieniem. Treść komunikatów może pochodzić z API Allegro lub bezpośrednio z systemu konkretnego przewoźnika. Pod każdym komunikatem (lub grupą) znajdziesz wyjaśnienie ich pochodzenia oraz wytyczne, jak rozwiązać błąd, który wystąpił.
- Długość podanego tekstu przekracza 35 znaków
- Receiver name must not exceed 35 characters
- Długość podanego tekstu przekracza 30 znaków
Powyższe błędy mogą wystąpić, gdy niektóre pola w systemie przewoźnika obsługującego przesyłkę posiadają limit znaków. Zazwyczaj będzie to pole z nazwą lub adresem odbiorcy. Nie walidujemy ilości znaków w poszczególnych polach, bo limity są różne u różnych kurierów. Po otrzymaniu tego komunikatu sprawdź dane odbiorcy, wykonaj ewentualną korektę i ponownie utwórz przesyłkę. Pamiętaj, że dane odbiorcy trafiają do xSale bezpośrednio z integracji Allegro.
- Błąd zewnętrznego przewoźnika
- Wystąpił błąd komunikacji z API przewoźnika
- Nie udało się pobrać infromacji zwrotnej o wygenerowaniu przesyłki (id przesyłki)
Te błędy mogą pojawić się, kiedy w trakcie tworzenia przesyłki wystąpią różnego rodzaju błędy (np. chwilowy problem z API stronie zewnętrznego przewoźnika lub Allegro). Może się zdarzyć, że pomimo zwrócenia komunikatu błędu, przesyłka zostanie utworzona. Jeśli nie, ponów próbę jej utworzenia. Jeżeli błąd występuje przez dłuższy czas, warto sprawdzić, czy konkretny przewoźnik nie udostępnił na swojej stronie komunikatu o trwających utrudnieniach.
- Imię i nazwisko może składać się tylko z liter
- Imię i nazwisko jest wymagane
- Miasto odbiorcy jest nieprawidłowe
- Proszę podać numer komórkowy (9 cyfr)
Grupa błędów, które są zwracane, gdy system Allegro lub przewoźnika zakwalifikuje określone pole jako zawierające niepoprawne dane (lub w polu brakuje danych). Zazwyczaj wiadomość zawiera dokładne informacje, którego pola dotyczy błąd i poprawienie danych w konkretnej przesyłce rozwiązuje problem.
- Waga paczki musi być większa od 0
- Przesyłka jest zbyt ciężka (max. 1 kg)
- Weight must exceed 0 kg
- Proszę podać prawidłową wagę
Błędy informują o niepoprawnej wadze przesyłki. Jeśli komunikat wystąpi jednorazowo, upewnij się w konkretnej paczce, czy jej waga jest odpowiednia dla danego sposobu dostawy. Gdy błąd występuje w wielu przesyłkach, należy sprawdzić ustawienia wagi w konfiguracji integracji Wysyłam z Allegro (domyślne i dodatkowe).
- Wybrana metoda dostawy nie obsługuje tego zamówienia
Błąd występuje, gdy próbujesz utworzyć przesyłkę za pomocą innej metody, niż została wybrana w zamówieniu przez kupującego. Może mieć miejsce, gdy próbujesz wysłać zamówienie z płatnością za pobraniem metodą wysyłki dedykowaną dla zamówień przedpłaconych. Upewnij się, jaką metodę dostawy i i formę płatności wybrał klient (w razie potrzeby możesz sprawdzić szczegóły zamówienia w panelu Allegro). Zweryfikuj także mapowania dostaw w integracji Allegro oraz usługę podpiętą do sposobu dostawy, który został użyty to utworzenia przesyłki. W razie potrzeby nadaj przesyłkę korzystając z innej integracji kurierskiej w xSale lub bezpośrednio w panelu Allegro, wykorzystując dostawę powiązaną z umową własną.
- Płatność pobraniowa nie jest wspierana dla wybranej metody dostawy.
Błąd wystąpi, kiedy spróbujesz wysłać przesyłkę metodą, która nie obsługuje przesyłek za pobraniem.
- Usługa wielopaczka nie jest dostępna u tego przewoźnika
Błąd pojawia się przy próbie nadania przesyłki z więcej niż 1 paczką, a usługa kurierska nie oferuje takiej możliwości.
- Nie jesteś właścicielem zamówienia
Zobaczysz ten komunikat, gdy spróbujesz nadać przesyłkę usługa kurierską powiązaną z innym kontem Allegro, niż to, z którego pochodzi zamówienie. Sprawdź mapowania w integracji Allegro dla konta, z którego pochodzi zamówienie, a także kuriera w ustawieniach sposobu dostawy, którą próbujesz użyć do utworzenia przesyłki.
- Punkt nadania przesyłki jest niepoprawny
Błąd wystąpi, kiedy przewoźnik wymaga podania punktu nadania. Przyczyną jest brak odpowiednich ustawień w integracji Wysyłam z Allegro. Sprawdź ustawienia i dodaj punkt nadania dla konkretnej metody dostawy, korzystając z zakładki Dodatkowa konfiguracja. Podanie punktu nadania w konfiguracji jest wymagane dla usług Allegro Pocztex (Kurier, Odbiór w Punkcie, Automat).
