Poradnik praktyczny
Jak generować testowy NIP do testów formularza?
Test formularza powinien sprawdzać jego zachowanie, a nie korzystać z danych kontrahentów. Generator przygotowuje ciągi do kontroli technicznych. Zacznij od odizolowania środowiska: nawet wymyślony numer może pokrywać się z NIP, który został komuś nadany.
Odłącz test od rzeczywistych usług
Używaj osobnej aplikacji testowej bez połączenia z fakturowaniem, płatnościami, rejestracją rzeczywistych kont i usługami urzędowymi. Sam napis „test” w nazwie środowiska nie wystarcza, jeśli wysyłka lub integracja nadal prowadzi do produkcji. Sprawdź konfigurację przed wygenerowaniem zestawu.
Nie kopiuj NIP z bazy klientów, faktur ani zrzutów logów. Generator nie potwierdza, że wynik jest nieprzydzielony, i nie korzysta z zarezerwowanej puli. Nie wyszukuj wygenerowanych numerów w rzeczywistych usługach tylko po to, aby sprawdzić, czy „działają”.
Wybierz wielkość zestawu i cel testu
Potwierdź użycie wyłącznie w izolowanych testach, wybierz od 1 do 20 wartości oraz tryb sumy kontrolnej. Domyślny brak potwierdzenia blokuje generowanie. Tryb zgodny służy testowi pozytywnemu, a celowo błędny — odrzuceniu przez kontrolę ostatniej cyfry.
Oba tryby zachowują długość i format generatora. Tryb błędny zmienia tylko ostatnią cyfrę, więc nie zastępuje testów pustego pola, liter, prefiksu PL, zbyt krótkiego wpisu ani niedozwolonego formatu. Zaplanuj te przypadki osobno z jasnym oczekiwanym komunikatem.
Zrozum, co generator zapewnia
Wariant pozytywny przechodzi lokalny format i sumę kontrolną używane przez walidator. Algorytm generatora pomija podstawy z resztą 10. Wariant negatywny zmienia cyfrę kontrolną o 1 modulo 10, nie naprawiając ani nie zmieniając innych danych.
W jednym zestawie wartości są różne, ale osobne zestawy mogą się powtarzać. Losowe ziarno powstaje w pamięci przeglądarki przy wysłaniu formularza; nie wpisujesz go w interfejsie. To nie usługa globalnej unikalności, generator tajnych tokenów ani nadawanie urzędowych numerów.
Źródło: MF / CIRFMF — SDK KSeF, algorytm cyfry kontrolnej NIP (kod zweryfikowany 30.09.2026); MF / CIRFMF — SDK KSeF, wzorzec formatu NIP (kod zweryfikowany 30.09.2026).
Przykładowe przypadki pozytywne i negatywne
Dla testowej podstawy 101000000 suma ważona wynosi 13, a reszta 2. Zatem 1010000002 przechodzi lokalną kontrolę, a 1010000003 ma celowo błędną ostatnią cyfrę. Tabela jest stałym przykładem; kolejne kliknięcie generatora nie musi zwrócić tych wartości.
W teście automatycznym przechowuj opis celu obok ciągu i sprawdzaj komunikat walidacji, nie samo powodzenie wysłania. Jeżeli pozytywny przypadek zostaje odrzucony, porównaj reguły aplikacji z zakresem tego generatora. Wszystkie przykłady mogą pokrywać się z nadanymi numerami.
| Zgodny ciąg | Błędna suma | Cyfra kontrolna |
|---|---|---|
| 1010000002 | 1010000003 | 2 |
| 1010000019 | 1010000010 | 9 |
| 1010000025 | 1010000026 | 5 |
Kopiowanie, reset i ponowne użycie zestawu
Wybierz „Kopiuj” świadomie. Skopiowany tekst zawiera oznaczenie danych testowych, tryb i ostrzeżenie oraz wartości w osobnych wierszach. Jeśli test wymaga samych cyfr, wydziel je dopiero w odizolowanym pliku i zachowaj informację o przeznaczeniu obok przypadków.
Formularz nie zapisuje zestawu w adresie, analityce ani trwałej pamięci. „Wyczyść” usuwa wynik i resetuje potwierdzenie; odświeżenie nie odtwarza zestawu. Jeśli potrzebujesz powtarzalnego testu, zachowaj własny oznaczony plik testowy, nie oczekuj tego samego wyniku po kolejnym generowaniu.
Oddziel test formularza od sprawdzenia firmy
Zaliczenie testu sumy kontrolnej nie sprawdza firmy, nadania NIP, statusu VAT ani rachunku. Oficjalne sprawdzenie kontrahenta jest innym procesem. Źródła MF i KAS opisują kontrole identyfikatora oraz wykaz VAT, nie dopuszczają naszych danych testowych do rzeczywistych transakcji.
Dobrze przygotowany zestaw obejmuje sukces, błąd ostatniej cyfry, format oraz wymagane pole. Test integracji urzędowej wymaga warunków i danych udostępnionych przez operatora jej środowiska testowego. Nie traktuj zgodnej wartości z lokalnego generatora jako takiej zgody lub danych integracyjnych.
Źródło: MF — kontrola struktury identyfikatorów, nie potwierdzenie nadania; KAS — jak korzystać z wykazu podatników VAT (odrębne sprawdzenie).
Najczęściej zadawane pytania
Czy dane testowe są na pewno nieprzydzielone?
Nie. Generator nie sprawdza rejestrów ani nie korzysta z potwierdzonej puli zarezerwowanych numerów. Zbieżność z nadanym identyfikatorem jest możliwa, więc poprawna suma kontrolna nie pozwala używać wartości poza izolowanym testem.
Czy błędny tryb tworzy wszystkie rodzaje błędów NIP?
Nie. Zmienia tylko cyfrę kontrolną. Puste pola, nieprawidłową długość, litery i niedozwolony format testuj oddzielnie; inaczej nie wiadomo, która kontrola spowodowała odrzucenie.
Czy kolejne zestawy nigdy się nie powtarzają?
Powtórzenia między zestawami są możliwe. Unikalność dotyczy tylko jednego zestawu do 20 wartości. Do powtarzalnego testu zapisz oznaczony plik we własnym izolowanym środowisku.
Czy numer trafia do analityki lub pamięci przeglądarki?
Formularz i wynik pozostają lokalnie, bez zapisu w adresie, localStorage, sessionStorage lub analityce. Kopiowanie i druk są działaniami użytkownika. Zwykłe wejście na stronę nadal powoduje żądanie do hostingu; zadbaj też o urządzenie i schowek.
Źródła urzędowe i zakres
Wyłącznie do izolowanych testów formularzy i automatycznych testów oprogramowania. Generator nie nadaje NIP ani PESEL. Nie gwarantujemy, że wartości są nieprzydzielone: mogą pokrywać się z numerami rzeczywistych osób lub firm. Odłącz środowisko od produkcji, płatności, faktur i usług urzędowych; nie używaj danych klientów.
Narzędzia opisane w poradniku
Walidator NIP
Sprawdź strukturę NIP i cyfrę kontrolną lokalnie, bez weryfikacji nadania lub właściciela.
Generator testowego NIP
Utwórz od 1 do 20 testowych ciągów NIP z poprawną lub celowo błędną sumą kontrolną.
Generator testowego PESEL
Utwórz od 1 do 20 testowych ciągów PESEL z poprawną lub celowo błędną sumą kontrolną.