Walidator kodów ZIP i pocztowych
Sprawdź poprawność kodu pocztowego dla 60+ krajów: Polska (XX-XXX), USA (ZIP 5/9), UK (postcode), Niemcy i inne. Instant walidacja. Bezpłatnie.
-
1Wprowadź dane
Wpisz treść, wklej tekst lub załaduj plik z dysku. -
2Kliknij przycisk
Narzędzie natychmiast przetworzy Twoje dane w przeglądarce. -
3Pobierz wynik
Skopiuj gotowy tekst lub zapisz plik na urządzeniu.
return "Wynik gotowy w 0.1s";
}
Oceń to narzędzie:
Powiązane narzędzia
Inne narzędzia, które mogą Ci się przydaćWalidator kodów pocztowych – 60+ krajów, Polska, USA, UK, DE
Kod pocztowy to kluczowy element adresu pocztowego – różne kraje mają różne formaty, długości i reguły. Narzędzie waliduje format kodu pocztowego dla ponad 60 krajów: sprawdza regex wzorzec, długość i (opcjonalnie) przynależność do regionu.
Formaty kodów pocztowych
Polska (PL): XX-XXX (5 cyfr z myślnikiem, np. 00-001). USA ZIP: 12345 lub 12345-6789 (ZIP+4). UK: AN NAA lub ANN NAA (np. SW1A 1AA). Niemcy (DE): 5 cyfr (10115). Francja (FR): 5 cyfr (75001). Holandia (NL): 1234 AB. Kanada (CA): A1A 1A1. Australia (AU): 4 cyfry. Japonia (JP): 123-4567.
Polska numery pocztowe – struktura
Pierwsze 2 cyfry: rejon pocztowy (00-XX Warszawa, 30-XX Kraków, 60-XX Poznań, 80-XX Gdańsk). Format: XX-XXX gdzie X=cyfra. Pełna regex: ^[0-9]{2}-[0-9]{3}$. Walidacja rozszerzona: sprawdzenie czy prefiks odpowiada istniejącemu miastu (opcjonalna baza).
Walidacja rozszerzona vs formatowa
Formatowa (regex): sprawdza tylko czy ciąg pasuje do wzorca formatu. Szybka, bez bazy. Np. 99-999 przejdzie. Rozszerzona (baza): sprawdza czy kod faktycznie istnieje w bazie pocztowej danego kraju. Wolniejsza, wymaga aktualnej bazy. Dla e-commerce: rozszerzona dla kluczowych rynków.
Integracja walidacji w formularzach
HTML5: – natywna walidacja bez JS. JavaScript: /^[0-9]{2}-[0-9]{3}$/.test(zip). Biblioteki: libaddressinput (Google), Zod (.string().regex()), Yup. Komunikat błędu: "Kod pocztowy powinien mieć format XX-XXX (np. 00-001)".
Jak działa walidator kodów pocztowych – od wpisanej wartości do wyniku
Walidator nie porównuje wpisanego kodu z listą adresów ani z mapą punktów dostawy. Najpierw sprowadza wartość do postaci kanonicznej: obcina białe znaki z początku i końca, ujednolica wielkość liter i doprowadza separator (myślnik lub spację) do jednej, ustalonej postaci przewidzianej dla danego kraju. Dopiero tak przygotowany ciąg jest konfrontowany z wzorcem kraju wybranego w formularzu lub rozpoznanego po prefiksie.
Wzorzec to wyrażenie regularne zakotwiczone z obu stron, czyli sprawdzany jest cały ciąg, a nie jego fragment. Wyrażenie określa trzy rzeczy jednocześnie: łączną liczbę znaków, to które pozycje zajmują cyfry, a które litery, oraz obecność i miejsce separatora. Dlatego kod o poprawnej długości, ale z myślnikiem w niewłaściwym miejscu, zostaje odrzucony tak samo jak kod o złej liczbie znaków.
Wynik jest deterministyczny – ten sam kod w tym samym kraju zawsze daje tę samą odpowiedź. Walidator zwraca nie tylko informację poprawny lub niepoprawny, ale też powód odrzucenia: zła długość, niedozwolony znak, brak separatora albo jego zła pozycja. Przy włączonej weryfikacji rozszerzonej dochodzi jeszcze jeden etap: porównanie prefiksu z bazą istniejących kodów. Ten etap jest opcjonalny i zależy od tego, czy dla danego kraju dostępna jest aktualna baza.
Przykład krok po kroku: polski kod pocztowy w czterech wariantach zapisu
- Wejście pierwsze: użytkownik wpisuje 1234, czyli cztery cyfry bez myślnika.
- Normalizacja obcina białe znaki i nic więcej nie zmienia – ciąg nadal ma cztery znaki.
- Wzorzec dla Polski to ^[0-9]{2}-[0-9]{3}$, czyli dwie cyfry, myślnik i trzy cyfry – razem sześć znaków. Cztery różni się od sześciu, więc wynik to kod niepoprawny, a powód to zła długość.
- Wejście drugie: 12-345. Po normalizacji ciąg ma sześć znaków, na pozycjach pierwszej i drugiej są cyfry, na trzeciej myślnik, na trzech kolejnych cyfry. Układ zgadza się z wzorcem, więc format jest poprawny. Jeżeli włączono weryfikację rozszerzoną, sprawdzany jest dodatkowo prefiks kodu.
- Wejście trzecie: 123-45. Długość jest dobra, ale myślnik stoi na czwartej pozycji, a wzorzec wymaga go na trzeciej. Wynik: kod niepoprawny, powód to zła pozycja separatora.
- Wejście czwarte: 12345, pięć cyfr bez separatora. Wynik: kod niepoprawny, powód to brak myślnika wymaganego przez wzorzec.
Zapis kanoniczny kodów w najczęściej walidowanych krajach
| Kraj | Zapis wzorcowy | Co jest sprawdzane |
|---|---|---|
| Polska (PL) | XX-XXX, np. 00-001 | 5 cyfr i myślnik po drugiej cyfrze |
| USA (US) | 12345 lub 12345-6789 | 5 cyfr albo 5 cyfr, myślnik i 4 cyfry |
| Wielka Brytania (UK) | AN NAA lub ANN NAA, np. SW1A 1AA | litery i cyfry w ściśle określonych pozycjach oraz jedna spacja |
| Niemcy (DE) | 10115 | dokładnie 5 cyfr, bez separatora |
| Francja (FR) | 75001 | dokładnie 5 cyfr, bez separatora |
| Holandia (NL) | 1234 AB | 4 cyfry, spacja i 2 litery |
| Kanada (CA) | A1A 1A1 | naprzemienny układ litera-cyfra oraz spacja |
| Japonia (JP) | 123-4567 | 3 cyfry, myślnik i 4 cyfry |
Praktyczne wskazówki przy walidacji kodów pocztowych
- Zawsze przekazuj kraj razem z kodem. Ten sam ciąg znaków bywa poprawny w jednym kraju i błędny w innym, a wiele wzorców opiera się na zbliżonej długości. Bez informacji o kraju walidator działa na niepewnym założeniu.
- Nie odrzucaj zapisu z separatorem. Użytkownicy wpisują kody różnie: z myślnikiem, ze spacją, bez separatora. Normalizacja jest zadaniem walidatora, a nie użytkownika – blokowanie pola przy każdym nietypowym zapisie zniechęca do dokończenia formularza.
- Powtórz sprawdzenie po stronie serwera. Walidacja w HTML5 i w JavaScripcie działa w przeglądarce, więc można ją ominąć. Ostateczna decyzja o przyjęciu zamówienia powinna zapaść na serwerze.
- Testuj przypadki brzegowe. Puste pole, kod krótszy o jeden znak, kod z literą w miejscu cyfry, kod z dodatkową spacją w środku, kod dłuższy niż wzorzec – to pięć scenariuszy, które najczęściej ujawniają błędy w implementacji.
- Dopasuj komunikat do wybranego kraju. Jeden uniwersalny tekst pomocy nie wystarczy, gdy obsługujesz kilkanaście rynków. Komunikat powinien pokazywać wzór właściwy dla kraju wskazanego w formularzu.
Czego walidator nie sprawdza
- Istnienia kodu w bazie. Domyślnie sprawdzany jest tylko format. Kod, który formalnie pasuje do wzorca, może nie odpowiadać żadnej realnej jednostce pocztowej – walidator formatowy tego nie wykryje.
- Zgodności z resztą adresu. Narzędzie nie porównuje kodu z miejscowością ani ulicą. Dwa kody z tym samym prefiksem przejdą walidację identycznie, nawet jeśli tylko jeden odpowiada podanemu adresowi.
- Kodów specjalnych i wewnętrznych. Kody skrytek pocztowych, kody obsługi dużych odbiorców, oznaczenia wojskowe oraz wewnętrzne systemy firmowe mogą nie mieścić się w standardowym wzorcu kraju i zostaną odrzucone mimo poprawnego zastosowania.
- Zmian regulacji i nowych zakresów. Wzorce odzwierciedlają reguły obowiązujące w momencie ich przygotowania. Reforma administracyjna albo rozszerzenie puli kodów w danym kraju może sprawić, że walidator będzie działał na nieaktualnych danych.
Najczęstsze pytania
Dlaczego kody pocztowe są ważne dla e-commerce?
Nieprawidłowy kod pocztowy = nieudostarczenie paczki + koszt zwrotu. Walidacja przed złożeniem zamówienia: oszczędność kosztów logistycznych. UPS/DHL/InPost: sprawdzają kod pocztowy przed przyjęciem przesyłki. Dla Polski: błąd 99-999 zamiast 99-000 może skierować do złego urzędu pocztowego.
Jak sprawdzić przynależność kodu pocztowego do miasta?
Poczta Polska: baza kodów pocztowych (odpłatna licencja). GUS TERYT: bezpłatna baza podziału administracyjnego. OpenStreetMap Nominatim API: geokodowanie (kod → współrzędne → miasto). Google Geocoding API: dokładna weryfikacja (płatna przy wyższym ruchu).
Co to jest ZIP+4 Code (USA)?
ZIP: 5 cyfr (podstawowy, np. 90210). ZIP+4: dodatkowe 4 cyfry po myślniku (np. 90210-1234) – precyzuje sektor dostawy (blok, biuro). USPS używa ZIP+4 do sortowania automatycznego. Dla standardowych zamówień: ZIP 5-cyfrowy wystarczy. USPS lookup: usps.com/zip-code-lookup.
Czy UK postcode jest case-sensitive?
Nie – SW1A 1AA = sw1a 1aa = SW1A1AA. Format UK: część outward (SW1A) + spacja + część inward (1AA). Regex: ^[A-Z]{1,2}[0-9][A-Z0-9]?\s*[0-9][A-Z]{2}$. Spacja może być brak lub jedna. Baza UK postcodes: postcodes.io (bezpłatne API).
Jak walidować kody pocztowe w wielu krajach jednocześnie?
Biblioteka google-libaddressinput (Android/iOS/web): zawiera reguły dla 200+ krajów. Narzędzia: addressr (Node.js), postcode-validator (npm). Najprościej: jeśli kraj nieznany, waliduj tylko alfanumeryczny 3-10 znaków bez znaków specjalnych.
Czy walidator sprawdza, że kod pocztowy naprawdę istnieje?
W trybie formatowym nie. Sprawdzana jest wyłącznie zgodność z wzorcem kraju: długość, rodzaj znaków i separator. Weryfikacja istnienia kodu wymaga bazy pocztowej i jest dostępna tylko dla części krajów oraz jako opcja rozszerzona.
Dlaczego mój kod pocztowy jest odrzucany, chociaż wygląda poprawnie?
Najczęstsze przyczyny to myślnik lub spacja w niewłaściwym miejscu, brak wymaganego separatora, dodatkowy znak na końcu albo wybrany w formularzu kraj, który nie odpowiada wpisanemu kodowi. Rozszerzona weryfikacja może też odrzucić kod o nieistniejącym prefiksie.
Czy w USA kod ZIP musi mieć myślnik?
Nie. Podstawowy ZIP to pięć cyfr i jest zapisywany bez separatora. Rozszerzona wersja ZIP+4 ma postać pięciu cyfr, myślnika i czterech cyfr, na przykład 12345-6789.
Jak prawidłowo zapisać kod pocztowy w Wielkiej Brytanii?
Kod składa się z liter i cyfr w określonych pozycjach, a część zewnętrzna jest oddzielona od wewnętrznej jedną spacją. Przykład poprawnego zapisu to SW1A 1AA. Zapis bez spacji zwykle przechodzi po normalizacji.
W jakim formacie jest kod pocztowy w Holandii?
To cztery cyfry, spacja i dwie litery, na przykład 1234 AB. Litery są zapisywane wielkimi znakami, choć walidator akceptuje też małe i sam je ujednolica.
Powiązane narzedzia: walidator IBAN, walidator JSON i walidator XML.