Komunikaty błędów

Wysyłam z Allegro pozwala generować przesyłki i etykiety dla zamówień Allegro z poziomu xSale. Podczas rejestracji przesyłki xSale przekazuje do Allegro dane odbiorcy, nadawcy, punktu odbioru lub nadania, wybraną usługę dostawy, parametry paczki, pobranie, ubezpieczenie, referencję i opis.

Jeżeli Allegro albo przewoźnik odrzuci żądanie, komunikat błędu wraca do xSale i jest widoczny przy przesyłce. Najczęściej błąd oznacza brak wymaganych danych, nieprawidłowy format pola albo niedopasowanie usługi dostawy do zamówienia.

W tym artykule znajdziesz:

• Jak podejść do diagnozy?
• Limity znaków i zbyt długie pola
• Brak danych lub nieprawidłowy format
• Waga i ograniczenia usługi
• Błędy komunikacji i błędy zewnętrzne
• Metoda dostawy, pobranie i liczba paczek
• Uprawnienia i zgodność konta
• Przypadki specyficzne

Jak podejść do diagnozy?

• Sprawdź dane odbiorcy na zamówieniu: imię i nazwisko, telefon, e-mail, adres oraz punkt odbioru, jeśli jest wymagany.
• Sprawdź dane nadawcy w konfiguracji integracji Wysyłam z Allegro: nazwę, telefon, e-mail, adres i punkt nadania.
• Zweryfikuj metodę dostawy na zamówieniu i mapowanie tej metody w xSale.
• Sprawdź, czy użyta usługa dostawy obsługuje pobranie, wielopaczkowość, punkt odbioru lub wymagany punkt nadania.
• Sprawdź parametry paczki: typ, wagę, szerokość, wysokość i długość.
• Jeżeli komunikat dotyczy chwilowego błędu komunikacji, ponów rejestrację 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 Allegro albo przewoźnika przekracza limit znaków wymagany dla danej usługi.
Co sprawdzić	nazwę odbiorcy lub firmy, nazwę firmy nadawcy w konfiguracji integracji, pole Referencja i Opis przesyłki. Po skróceniu wartości ponów rejestrację przesyłki.

reference: too_long
Kiedy występuje	Gdy wartość w polu referencji przekracza maksymalną długość akceptowaną przez danego przewoźnika.
Co sprawdzić	Skróć wartość referencji i ponów rejestrację przesyłki. W xSale referencja może być budowana z konfiguracji, dlatego sprawdź też ustawienie referencji w integracji.

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 albo przewoźnik odrzuca dane nadawcy lub odbiorcy, bo są puste albo mają nieprawidłowy format.
Co sprawdzić	Uzupełnij lub popraw dane odbiorcy na zamówieniu oraz dane nadawcy w konfiguracji integracji.

Miasto odbiorcy jest nieprawidłowe
Kiedy występuje	Gdy pole miasta jest puste albo zawiera wartość nieakceptowaną przez przewoźnika.
Co sprawdzić	Popraw dane adresowe odbiorcy na zamówieniu.

Proszę podać numer komórkowy (9 cyfr)
Kiedy występuje	Gdy numer telefonu odbiorcy jest pusty, niepełny albo ma nieprawidłowy format.
Co sprawdzić	Uzupełnij numer telefonu na zamówieniu i ponów rejestrację przesyłki.

Street field must include the building number / Pole ulica musi zawierać numer budynku
Kiedy występuje	Gdy w danych adresowych brakuje numeru budynku.
Co sprawdzić	Uzupełnij pełny adres dostawy na zamówieniu albo w edycji przesyłki w xSale, a następnie ponów rejestrację.

Opis przesyłki nie może być pusty
Kiedy występuje	Gdy wybrana usługa lub przewoźnik wymaga wypełnienia opisu przesyłki. Dotyczy to szczególnie wybranych usług obsługiwanych przez DHL.
Co sprawdzić	Uzupełnij pole Opis przesyłki w konfiguracji lub w edycji 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 albo waga jest ustawiona na 0.
Co sprawdzić	Uzupełnij wagę paczki. Jeżeli w integracji włączono wyliczanie wagi z dokumentu, sprawdź też wagę towarów i konfigurację domyślnej wagi paczki.

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 wybranej usługi.
Co sprawdzić	Zweryfikuj wagę paczki i wybierz usługę dostawy zgodną z ograniczeniami 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 albo xSale nie otrzyma odpowiedzi o zakończeniu tworzenia przesyłki.
Co sprawdzić	Spróbuj ponownie po krótkim czasie. Jeżeli błąd pojawił się po wysłaniu żądania, sprawdź w Allegro, czy przesyłka nie została mimo wszystko utworzona. Jeśli problem się powtarza, sprawdź status usług Allegro lub przewoźnika.

Nieprawidłowy status przesyłki
Kiedy występuje	Gdy Allegro zwróci status procesu tworzenia przesyłki inny niż oczekiwany przez xSale.
Co sprawdzić	Ponów próbę po krótkim czasie. Jeśli błąd wraca, sprawdź szczegóły w Allegro i skontaktuj się z pomocą techniczną xSale z numerem zamówienia oraz treścią komunikatu.

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, która pasuje do zamówienia, np. dla innego konta Allegro, innego sposobu płatności albo innej usługi dostawy.
Co sprawdzić	Sprawdź metodę dostawy na zamówieniu, mapowanie formy dostawy i usługę podpiętą do sposobu dostawy. Pomocny może być wpis Mapowanie form dostawy w Wysyłam z Allegro.

Płatność pobraniowa nie jest wspierana dla wybranej metody dostawy
Kiedy występuje	Gdy zamówienie ma być nadane za pobraniem, ale wybrana usługa dostawy nie obsługuje pobrania.
Co sprawdzić	Wybierz usługę dostawy obsługującą pobranie. Dla pobrania warto mieć osobny sposób dostawy i osobne mapowanie.

Kwota ubezpieczenia nie może być mniejsza niż kwota pobrania
Kiedy występuje	Gdy przewoźnik albo Allegro odrzuca przesyłkę, ponieważ wartość ubezpieczenia jest niższa niż wartość pobrania.
Co sprawdzić	W aktualnym mechanizmie xSale wylicza ubezpieczenie na podstawie wartości dokumentu w walucie docelowej i mnoży tę wartość przez 1,3. Dla walut bez groszy wartość jest dodatkowo zaokrąglana, a dla HUF zaokrąglana do kroku 5. Jeżeli mimo to pojawia się błąd, sprawdź kwotę dokumentu, kwotę pobrania, walutę zamówienia oraz walutę wymaganą przez usługę dostawy.

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ć więcej niż jedną paczkę, a wybrana usługa nie obsługuje wielopaczkowości.
Co sprawdzić	Utwórz przesyłkę jako jednopaczkową albo wybierz usługę, która obsługuje kilka paczek.

Uprawnienia i zgodność konta

Nie jesteś właścicielem zamówienia
Kiedy występuje	Gdy próbujesz nadać przesyłkę integracją Wysyłam z Allegro powiązaną z innym kontem Allegro niż konto, z którego pochodzi zamówienie.
Co sprawdzić	Sprawdź, z którego konta Allegro pochodzi zamówienie, oraz czy sposób dostawy jest powiązany z integracją Wysyłam z Allegro dla tego samego konta.

Integracja [przewoźnik] możliwa przez bezpośrednią integrację [przewoźnik], nie korzystaj w tym przypadku z Wysyłam z Allegro
Kiedy występuje	Gdy w sposobie dostawy wybrano usługę, która nie powinna być obsługiwana przez Wysyłam z Allegro, tylko przez bezpośrednią integrację danego przewoźnika.
Co sprawdzić	W konfiguracji sposobu dostawy wybierz właściwą integrację kurierską. Jeśli przesyłka ma iść przez bezpośrednią integrację przewoźnika, nie wybieraj Wysyłam z Allegro jako docelowej integracji.

Przypadki specyficzne

Kod pocztowy nadawcy znajduje się poza obszarem One Kuriera
Kiedy występuje	Gdy wybrana metoda dostawy Allegro One Kurier nie obsługuje adresu nadawcy.
Co sprawdzić	Allegro nie umożliwi wygenerowania etykiety dla tej metody, jeśli kod pocztowy nadawcy jest poza zasięgiem usługi. Wybierz inną metodę dostawy albo ustal z kupującym alternatywny sposób wysyłki.

Paczkomat o podanej nazwie nie istnieje. Musisz wybrać inny.
Kiedy występuje	Gdy wskazany automat paczkowy nie jest dostępny dla wybranej usługi.
Co sprawdzić	W edycji przesyłki w xSale zmień punkt odbioru na dostępny punkt i ponów rejestrację.

Punkt nadania przesyłki jest niepoprawny
Kiedy występuje	Gdy przewoźnik wymaga punktu nadania, a w konfiguracji usługi brakuje poprawnej wartości.
Co sprawdzić	Sprawdź konfigurację integracji Wysyłam z Allegro i uzupełnij punkt nadania dla konkretnej usługi dostawy. Dotyczy to między innymi usług Allegro Pocztex.

musi pasować do wyrażenia [A-Za-z0-9-_]+ (VALIDATION_ERROR)
Kiedy występuje	Gdy w polu Nadawca – punkt nadania wpisano wartość w nieprawidłowym formacie.
Co sprawdzić	Dla metod Allegro Pocztex punkt nadania to 6 cyfr, czyli identyfikator urzędu nadania. Możesz go sprawdzić w panelu Allegro podczas nadawania przesyłki.