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. Błąd może dotyczyć zarówno pola z nazwą lub adresem odbiorcy, jak i danych nadawcy. Nie walidujemy ilości znaków w poszczególnych polach ze względu na duże rozbieżności limitów w systemach różnych kurierów. Jeśli widzisz ten komunikat błędu, sprawdź dane odbiorcy i nadawcy (czy liczba znaków nie przekracza wymienionego limitu), wykonaj ewentualną korektę i ponownie utwórz przesyłkę. Pamiętaj, że dane odbiorcy trafiają do zamówień w 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)
- Opis przesyłki nie może być pusty (dotyczy zwłaszcza metod dostawy obsługiwanych przez DHL)
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.
- Kod pocztowy nadawcy znajduje się poza obszarem One Kuriera
Komunikat ten jest zwracany przez Allegro, oznacza on, że na danym terenie nie ma możliwości korzystania z tej usługi. W przypadku wystąpienia tego błędu należy skontaktować się bezpośrednio z Allegro.
- 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).
- Imię i nazwisko jest wymagane
Ten błąd pojawia się przy sposobach dostawy Allegro Pocztex. API wymaga, aby nazwa nadawcy była dwuczłonowa,. Rozwiązaniem jest rozdzielenie nazwy w ustawieniach integracji Wysyłam z Allegro.
Przykład: w polach „Nadawca – Nazwa firmy” i „Nadawca – Imię i nazwisko” popraw nazwę z „FirmaxSale” na „Firma xSale”.
- musi pasować do wyrażenia [A-Za-z0-9-_]+ musi pasować do wyrażenia [A-Za-z0-9-_]+ Informacje o błędzie: {„errors”:[{„code”:”VALIDATION_ERROR”,”message”:”musi pasować do wyrażenia [A-Za-z0-9-_]+”,”details”:”Invalid value: treść w nadawcy”,”path”:”input.sender.point”,”userMessage”:”musi pasować do wyrażenia [A-Za-z0-9-_]+”}]}
Powyższy błąd przy wysyłkach metodami Allegro Pocztex informuje o nieprawidłowym formacie danych w polu „Nadawca – Punkt nadania”. Punkt nadania dla metod Allegro Pocztex to 6 cyfr. Jest to identyfikator Urzędu nadania. Można go sprawdzić w panelu Allegro, korzystając z funkcji nadania przesyłki (pole podkreślone na zrzucie ekranu).
