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 - pola input.sender.phone oraz input.receiver.phone
• POST /shipment-management/pickups/create-commands - 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} 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}) 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.