Na tej stronie będziemy zbierać najczęściej występujące komunikaty, zwracane przez API Wysyłam z Allegro i uzupełniać je naszymi podpowiedziami.
AccessDenied: Brak dostępu do danego zasobu. (: )
Komunikat oznacza że aplikacja nie ma dostępu do funkcji API Allegro, której potrzebuje do wykonania danej operacji.
Aby zaktualizować uprawnienia aplikacji należy ponownie autoryzować konto Allegro.
Więcej szczegółów dostępne jest na stronie: WzA – AccessDenied: Brak dostępu do danego zasobu
receiver.email: musi być poprawnie sformatowanym adresem e-mail
Allegro wymaga aby adres e-mail odbiorcy przesyłki był zamieszczony w takiej samej formie jak widnieje na zamówieniu (z plusem).
receiver.email: Podany hash-mail jest niepoprawny
Adres e-mail odbiorcy przesyłki jest niepoprawny. Należy się upewnić czy jest taki sam jak w zamówieniu na serwisie Allegro.
Nie można użyć wybranej usługi ponieważ jest ona niezgodna z zamówioną przez kupującego metodą dostawy
API Wysyłam z Allegro weryfikuje czy w zamówieniu powiązanym z adresem e-mail odbiorcy jest wybrany sposób dostawy, który umożliwia przygotowanie listu daną usługą Wysyłam z Allegro. W przypadku umów negocjowanych przez Allegro (Allegro DPD, Allegro Poczta, Allegro InPost, Allegro UPS do 10 kg) na zamówieniu musi być wybrana odpowiednia forma dostawy. W przypadku umów własnych sposób dostawy na zamówieniu nie jest istotny.
Adres i numer telefonu dla podjazdu musi być taki sam jak nadawcy
Allegro wymaga aby dla danej usługi adres podjęcia przesyłki był identyczny jak adres nadawcy. Możesz poprawić dane w oknie edycji listu jeżeli problem jest jednorazowy, lub w ustawieniach konta dostępowego WZA.
NOT_SELLER_ORDER – receiver.email: Order doesn’t belong to seller NOT_SELLER_ORDER:
Nie jesteś właścicielem zamówienia (email: Order doesn’t belong to seller)
Zamówienie do którego tworzona jest przesyłka nie jest własnością konta Allegro które jest używane przy wystawianiu listu.
Należy upewnić się że jest używane odpowiednie konto WZA/Allegro do tworzenia przesyłki dla danego zamówienia.
Nazwę konta dostępowego do WZA można odczytać na pasku nazwy okna edycji listu.
W konfiguracji konta dostępowego WZA (PP2 -> WZA) należy sprawdzić jakie konto Allegro przypisane jest do danego konta dostępowego.
Warto także sprawdzić czy wybrane konto Allegro zostało autoryzowane poprawnymi danymi logowania (może były wpisane z innego konta):
PP2 -> WZA -> zębatka -> KONTA ALLEGRO.
Gdy korzystasz z wielu kont Allegro – sprawdź konfigurację automatycznego wyboru konta w ustawieniach metod eksportu.
ERROR – pickup.name: Nazwa punktu nadania przesyłki jest wymagana
Wymagane jest podanie nazwy adresu nadania / podjęcia przesyłki. Jeżeli jakaś wartość została tam wpisana, to mogła być uznana przez Allegro jako niewystarczająca, np: jeżeli zostało podane tylko nazwisko to należy podać też imię.
ERROR – pickup.address.county: Podany region punktu nadania przesyłki nie jest prawidćowy dla wybranego kraju
Wpisany region w adresie nadania przesyłki nie jest prawidłowy dla podanego kodu kraju. Należy upewnić się czy taki region w danym kraju jest dostępny. W większości przypadków pole to nie jest wymagane, więc w pierwszej kolejności należałoby spróbować je usunąć.
ERROR – pickup.pointId: Punkt punktu nadania przesyłki jest niepoprawny
Kod punktu nadania przekazany w danych podjęcia przesyłki jest nieprawidłowy. Należy sprawdzić czy dla danego przewoźnika ten kod jest prawidłowy. Numeracja punktów odbioru / nadania może być inna dla każdego przewoźnika.
ERROR: Nie można prawidłowo sparsować przesłanego obiektu (input.sender: )
Taki komunikat może się pojawić w przypadku gdy dane nadawcy nie zostały uzupełnione.
Dane nadawcy można uzupełnić w oknie listu przewozowego lub w ustawieniach konta dostępowego:
ProstaPaczka -> zakładka WYSYŁAM Z ALLEGRO -> ikona zebatki -> przycisk KONTA.
Numer telefonu musi zawierać prefiks międzynarodowy (sender.phone:
Komunikat taki zwracany jest od początku października 2026 po włączeniu przez Allegro wymagalności podawania pełnych numerów telefonów wraz z numerami kierunkowymi. „Sender phone” oznacza brak spełnienia wymagań przez numer telefonu nadawcy. Numer należy poprawić w oknie edycji listu (tylko dla konkretnego nadania) lub w ustawieniach konta dostępowego: ProstaPaczka -> zakładka WZA -> ikona zębatki -> przycisk KONTA.
ERROR – /sender: Opcja 'Inne dane na etykiecie’ nie są dostępne dla wybranego przewoźnika
Dla danego sposobu dostawy nie można użyć opcji wyświetlenia innych danych nadawcy na etykiecie. Należy wyłączyć tą opcję / usunąć inne dane nadania.
Jeżeli dla innych metod potrzebne są inne dane na etykiecie to należy rozważyć utworzenie osobnego konta dostępowego z uzupełnionymi danymi na etykietę i ustawioną usługą Allegro odpowiadającą metodzie eksportu ProstejPaczki.
ERROR – sender.address.county: Podany region nadawcy nie jest prawidćowy dla wybranego kraju
Region w sekcji adresu nadawcy (na etykiecie) nie jest prawidłowy dla podanego kodu kraju. Należy się upewnić czy w danym kraju jest dostępny taki region. W większości przypadków region nie jest wymagany i można spróbować w pierwszej kolejności usunąć nazwę regionu.
label.sender.address.postCode: nie może być puste
Kod pocztowy w sekcji nadawcy (na etykiecie) nie może być pusty – należy go uzupełnić.
Dane w tej sekcji są uzupełniane gdy wpisano je w ustawieniach konta dostępowego w zakładce WZA.
label.sender: Kombinacja kodu pocztowego nadawcy i kraju jest niepoprawna
Kod pocztowy w sekcji nadawcy (na etykiecie) nie pasuje do wpisanego kodu kraju – należy go poprawić.
Dane w tej sekcji są uzupełniane gdy wpisano je w ustawieniach konta dostępowego w zakładce WZA.
label.sender.address.city: nie może być puste
Miejscowość w sekcji nadawcy (na etykiecie) nie może być pusta, należy ją uzupełnić.
Dane w tej sekcji są uzupełniane gdy wpisano je w ustawieniach konta
label.sender.address.street: nie może być puste
Nazwa ulicy w sekcji nadawcy (na etykiecie) nie może być pusta należy ją uzupełnić.
Dane w tej sekcji są uzupełniane gdy wpisano je w ustawieniach konta
label.sender.phone: Podany telefon nadawcy jest niepoprawny.
Telefon użyty w danych adresowych nadawcy jest nieprawidłowy. Należy go zmienić w oknie edycji listu lub w ustawieniach konta dostępowego WZA:
PP2 – WZA – zębatka – KONTA – sekcja adres nadania.
receiver.name: Nazwa odbiorcy jest wymagana
Brak podanej nazwy odbiorcy lub nazwa ta jest za krótka, np. brakuje imienia.
receiver.address.street: Numer budynku odbiorcy jest wymagany
W nazwie ulicy odbiorcy przesyłki nie podano numeru budynku.
pickup.address.street: nie może być puste
Ulica w adresie nadania przesyłek nie może być pusta. Należy ją uzupełnić w oknie edycji listu lub w systemie źródłowym.
receiver.address.city: Miasto odbiorcy jest wymagane
Nie podano nazwy miejscowości w adresie odbiorcy
receiver.address.countryCode: musi pasować do wzorca „[A-Z]{2}”
Podano nieprawidłowy kod kraju odbiorcy. Musi być podany kod zgodny z Iso2 (PL, DE, FR, itd).
receiver.address.county: Podany region odbiorcy nie jest prawidćowy dla wybranego kraju
Region podany w adresie odbiorcy przesyłki nie jest prawidłowy dla wpisanego kodu kraju. Należy zweryfikować czy taki region znajduje się w danym kraju. W większości przypadków pole to nie jest wymagane, więc w pierwszej kolejności należy spróbować usunąć nazwę regionu.
Numer telefonu odbiorcy nie został rozpoznany jako prawidłowy numer telefonu komórkowego w [kraj]. Skontaktuj się z kupującym w celu ustalenia prawidłowego numeru telefonu
Komunikat taki jest zwracany przez API Allegro w przypadku gdy Allegro lub przewoźnik uzna że numer telefonu odbiorcy jest nieprawidłowy.
We wrześniu / październiku 2026 Allegro zmieniło wytyczne, że numer telefonu musi być zapisany wraz z numerem kierunkowym kraju. W pierwszej kolejności należy zweryfikować jaki numer jest na formularzu listu. Jeżeli jest bez numeru kierunkowego to można go uzupełnić. Warto zweryfikować w jakim formacie jest pobierany numer do systemu ERP z którego dane są wstawiane na list przewozowy przez ProstąPaczkę. Allegro przy pobieraniu danych zamówienia zwraca numer listu we właściwym formacie, więc taki też powinien być zapisany w systemie ERP.
Można też sprawdzić jaki numer telefonu został podany przez kupującego w zamówieniu Allegro. Jeżeli numer w oknie listu jest identyczny z tym podanym, a Allegro go nie przyjmuje, to może być błędny. Wtedy warto wykonać zalecenie Allegro i spróbować skontaktować się z kupującym aby ustalić właściwy numer telefonu.
Jeżeli numer telefonu jest prawidłowy a API Allegro dalej go nie przyjmuje to należy skontaktować się ze wsparciem Allegro aby wyjaśnili sprawę. Warto wtedy przekazać im pełny komunikat tworzenia listu aby widzieli jakie dane są przekazywane.
receiver.phone: Numer telefonu komórkowego odbiorcy jest nieprawidłowy
Podano nieprawidłowy numer telefonu odbiorcy przesyłki.
receiver.point: musi pasować do wyrażenia
Podany identyfikator punktu odbioru w sekcji odbiorcy jest niepoprawny. Należy upewnić się że wpisywana wartość jest zgodna z wzorcem dla danej usługi. Wzorzec jest podawany w komunikacie błędu zwykle jako wyrażenie regularne.
items: musi być podane
Nie podano żadnej paczki – należy wstawić przynajmniej jedną pozycję w tabeli i uzupełnić jej parametry.
INSURANCE_IS_MISSING – items.value: Ubezpieczenie jest wymagane w celu utworzenia przesyłki
Dla danego typu przesyłki wymagane jest podanie wartości paczki w tabeli paczek.
Jeżeli wartość ma być uzupełniana za każdym razem to należy sprawdzić czy w ustawieniach przetwarzania dokumentu na list Wysyłam z Allegro można ustawić uzupełnianie pola.
Jeżeli list jest jednorazowy to należy wprowadzić odpowiednią wartość paczki w tabeli.
items[0].value.currency: musi być podane
Nie podano waluty wartości w parametrach pierwszej paczki. Waluta musi być 3-znakowa: PLN, EUR itd.
INVALID_INSURANCE_CURRENCY_INTERNAL – items.value.currency: Waluta PLN nie jest wspierana dla wybranej metody dostawy
Ustawiona waluta nie jest prawidłowa dla danego sposobu dostawy i należy ustawić walutę odpowiednią dla kraju docelowego.
W przypadku listów tworzonych z dokumentów WAPRO/Subiekta waluta jest pobierana z dokumentu.
items.weight.value: Proszę podać prawidłową wagę
Podano nieprawidłową wagę paczki w pierwszej pozycji.
INVALID_PACKAGE_WEIGHT_NEGATIVE_OR_ZERO – /parcels/0/weight: Waga przesyłki musi być dodatnia
Należy zweryfikować czy każda paczka w tabeli podpaczek posiada uzupełnioną wagę i jest ona większa od zera.
Jeżeli list jest tworzony na podstawie dokumentu to należy dodatkowo sprawdzić czy odpowiednio skonfigurowane jest ustawianie wagi w ustawieniach przetwarzania danej metody.
items.dimensions: Nieprawidłowe wymiary przesyłki
Podano nieprawidłowe, najprawdopodobniej zerowe, wymiary paczki
items[0].dimensions.length:
Nie podano długości (pierwszej) paczki, należy uzupełnić długość w oknie edycji listu. Jeżeli list jest tworzony na podstawie dokumentu to należy sprawdzić czy zostały uzupełnione wymiary w ustawieniach przetwarzania danej metody eksportu.
SHIPMENT_VALIDATION_ERROR – items.description: Długość podanego tekstu przekracza 20 znaków
Podany opis paczki jest za długi i należy go skrócić.
Opis można edytować w tabeli paczek okna edycji listu.
Jeżeli do opisu wstawiane są dane z dokumentu, to należy zweryfikować ustawienia przetwarzania, aby zmieścić się w limicie.
additionalServices.cashOnDelivery.accountNumber: nie może być puste
Przy usłudze pobrania należy uzupełnić numer rachunku bankowego na które mają zostać zwrócone środki.
label.referenceNumber: wielkość musi być pomiędzy 0 a 35
Numer referencyjny przesyłki musi mieć maksymalnie 35 znaków. Jeżeli jest dłuższy to należy usunąć nadmiarową część.
label.referenceNumber: musi pasować do wzorca „[A-Za-z0-9-_]+”
Numer referencyjny przesyłki jest nieprawidłowy. Allegro wymaga aby w numerze były same cyfry 0-9, litery od a-Z lub snaki specjalne: „-„, „_”. Pozostałe znaki muszą zostać usunięte.
Błąd przetwarzania. Support został poinformowany o Twoim problemie i pracuje nad rozwiązaniem
Nieznany błąd tworzenia listu. Może dotyczyć jakiejś kombinacji parametrów przesyłki. Można próbować zmieniać usługi aby przygotować etykietę, jednak bez żadnej podpowiedzi trzeba to robić metodą prób i błędów.
Przy przedłużaniu tokenu wystąpiły błędy: invalid_grant Invalid refresh token: xxx
Komunikacja z Allegro odbywa się na podstawie automatycznie odświeżanego (przez ProstąPaczkę) tokenu dostępowego, który jest generowany przez Allegro.
Allegro może uznać taki token za nieprawidłowy (np. z powodu zmiany hasła, braku odświeżenia przez dłuższy czas).
Najlepiej spróbować ponownie autoryzować konto Allegro wg opisu: Autoryzacja konta Allegro.
serviceId: Metoda dostawy jest niedostępna
Komunikat wskazuje na błędnie wybraną metodę eksportu. Najczęściej są to przypadki typu „wybrano Allegro One Box zamiast Allegro One Box, DPD”. W komunikacie błędu pojawia się precyzyjne wskazanie na metodę wybraną podczas eksportu (nieprawidłową) i metodę, która powinna zostać wybrana (prawidłową). Nieprawidłową i prawidłową metodę możemy odczytać w zdaniu:
„This delivery option is unavailable”,”details”:”Order delivery method: xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx is not allowed, should be yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy”.
Metodę „Y” (poprawną) należy skonfigurować w zakładce WzA zgodnie z instrukcją konfiguracji modułu Wysyłam z Allegro.
COD_IBAN_NOT_EMPTY – additionalServices: Wybrana metoda dostawy nie wymaga podania numeru iban, wpłatę za przesyłki pobraniowe prześlemy na
Twoje środkiNumer konta w komunikacie jest nadmiarowy. Zgodnie z sugestią Allegro nie należy go przekazywać przy pobraniu. Proszę usunąć numer konta z listu i spróbować jeszcze raz.
DELIVERY_METHOD_NOT_AVAILABLE: Nie można utworzyć przesyłki przy użyciu umowy Allegro Standard. Metoda przypisana do tego zamówienia to umowa własna. Zmień umowę i spróbuj ponownie. (deliveryMethodId: Delivery Method is not available for this order)
Komunikat mówi, że próbujemy wysłać zamówienie metodą „Allegro Standard”, a zamówienie zostało zrealizowane (zakupione) na umowie własnej. Zgodnie z sugestią Allegro należy w PP2 nadać przesyłkę na umowie własnej.
ERROR – pickup.pointId: Punkt punktu nadania przesyłki jest wymagany
Allegro dla danej formy przesyłki wymaga podania identyfikatora punktu nadania.
Można go ustawić w PP2 -> ZAKŁADKA PROGRAMU (SELLO / SUBIEKT / WAPRO) -> koło zębate -> WYSYŁAM Z ALLEGRO -> WYSYŁAM Z ALLEGRO -> dolny przycisk konfiguracji – wybrana forma wysyłki -> PUNKT NADANIA
NotFoundException – : Funkcja niedostępna. Skontaktuj się z autorem aplikacji.
Taki komunikat może pojawić się w przypadku jak w API Allegro nie ma już zasobów do komunikacji.
W pierwszej kolejności należy upewnić się że używana jest najnowsza wersja programu ProstaPaczka.