[NEWS] Wysyłam z Allegro - od 1 października 2026 prefiks w numerze telefonu będzie obowiązkowy / Ship with Allegro - from October 1, 2026, the phone number prefix will be mandatory

**1 października 2026 roku** wprowadzimy zmiany w walidacji numerów telefonów dla przesyłek tworzonych za pomocą API Wysyłam z Allegro. Od tego dnia numery bez odpowiedniego prefiksu (kodu kierunkowego kraju) będą odrzucane.

Aby zapewnić swoim użytkownikom nieprzerwane i poprawne nadawanie paczek, **zalecamy wdrożenie odpowiednich zmian po stronie integracji już teraz**, jeszcze przed uruchomieniem walidacji.

#### Jakie zmiany wprowadzimy?

Wdrażamy **obowiązkową walidację składniową**, która będzie weryfikować obecność prefiksu kraju w numerze telefonu odbiorcy przesyłki.

Dotyczy to endpointów:

- [POST /shipment-management/shipments/create-commands](https://developer.allegro.pl/documentation#tag/Shipment-management/operation/createNewShipment) \- pola `input.sender.phone` oraz `input.receiver.phone`
- [POST /shipment-management/pickups/create-commands](https://developer.allegro.pl/documentation#tag/Shipment-management/operation/createPickup) \- pole `input.address.phone`.

W przypadku braku prefiksu zwrócimy błąd i zablokujemy utworzenie paczki lub podjazd kuriera.

#### Ważne uwagi techniczne

Podczas dostosowywania swojej aplikacji zwróć szczególną uwagę na poniższe kwestie:

* **Gotowe dane** \- w odpowiedzi na [GET /shipment-management/delivery-proposals/{orderId}](https://developer.allegro.pl/documentation#tag/Shipment-management/operation/getDeliveryProposals) otrzymasz propozycję danych i ustawień do użycia podczas tworzenia paczki wraz z numerem telefonu w prawidłowym formacie. Wystarczy, że Twoja aplikacja skorzysta z tej wartości w niezmienionym formacie.
* **Numery z zamówień** \- w szczegółach zamówień ([GET /order/checkout-forms/{id}](https://developer.allegro.pl/documentation#tag/Order-management/operation/getOrdersDetailsUsingGET)) zwracamy już pełne numery telefonów kupujących wraz z odpowiednim prefiksem.
* **Nadawca i odbiorca** \- zwróć uwagę na to, aby obydwa numery telefonu były w poprawnym formacie \- odbiorcy, ale także nadawcy.
* **Błąd walidacji** \- od 1 października brak prefiksu będzie skutkował błędem walidacji, a paczka nie zostanie utworzona.

#### Dlaczego wprowadzamy tę zmianę?

Brak prefiksu w numerze telefonu może powodować problemy z doręczeniem wiadomości SMS od przewoźników. Kompletne dane kontaktowe to pewność, że proces dostawy przebiegnie sprawnie, a kupujący będą na bieżąco informowani o statusie swojej przesyłki.

Więcej o Wysyłam z Allegro przeczytasz [w naszym poradniku](https://developer.allegro.pl/tutorials/jak-zarzadzac-przesylkami-przez-wysylam-z-allegro-LRVjK7K21sY).

_____

**On October 1, 2026**, we will introduce changes to the validation of phone numbers for shipments created via the Ship with Allegro API. From that date, numbers without the appropriate prefix (country calling code) will be rejected.

To ensure uninterrupted and correct parcel dispatch for your users, **we recommend implementing the appropriate changes on the integration side right now**, even before validation is enabled.

#### What changes will we introduce?

We are implementing **mandatory syntax validation**, which will verify the presence of a country prefix in the shipment receiver's phone number.

This applies to the following endpoints:

- [POST /shipment-management/shipments/create-commands](https://developer.allegro.pl/documentation#tag/Shipment-management/operation/createNewShipment) \- `input.sender.phone` and `input.receiver.phone` fields
- [POST /shipment-management/pickups/create-commands](https://developer.allegro.pl/documentation#tag/Shipment-management/operation/createPickup) \- `input.address.phone` field.

In the absence of a prefix, we will return an error and block the creation of the parcel or pickup.

#### Important technical notes

When adjusting your application, pay special attention to the following issues:

* **Ready-to-use data** \- in the response to [GET /shipment-management/delivery-proposals/{orderId}](https://developer.allegro.pl/documentation#tag/Shipment-management/operation/getDeliveryProposals), you will receive a proposal of data and settings to use when creating a parcel, along with a phone number in the correct format. All your application needs to do is use this value in its unchanged format.
* **Numbers from orders** \- in the order details ([GET /order/checkout-forms/{id}](https://developer.allegro.pl/documentation#tag/Order-management/operation/getOrdersDetailsUsingGET)), we already return full buyer phone numbers with the appropriate prefix.
* **Sender and receiver** \- make sure that both phone numbers are in the correct format \- not only the receiver's, but also the sender's.
* **Validation error** \- from October 1, the lack of a prefix will result in a validation error, and the parcel will not be created.

#### Why are we introducing this change?

The lack of a prefix in a phone number may cause issues with the delivery of SMS messages from carriers. Complete contact details ensure that the delivery process runs smoothly and buyers are kept up to date regarding their shipment status.

Read more about Ship with Allegro [in our guide](https://developer.allegro.pl/tutorials/jak-zarzadzac-przesylkami-przez-wysylam-z-allegro-LRVjK7K21sY).