TFN Generator for Testing
Use your approved synthetic fixture to generate pass and fail test cases locally, then download labelled checks without exposing a client TFN.
Local nine-digit format only. Provider acceptance needs its own test.
Add an approved fixture
Add an approved synthetic fixture to prepare labelled local format checks.
Labelled cases
| Case | Value | Expected label | Rule outcome |
|---|---|---|---|
| No rows to display. | |||
Use an Approved Synthetic Fixture
This TFN generator builds labelled test cases from a synthetic fixture your software provider approves. It changes that supplied fixture to test local format refusals. It never makes up a random or fake TFN, and it issues no numbers.
A fixture is a made-up test value approved for a particular non-production environment. Your provider expects this valid TFN number for testing to pass its nine-digit format check. Keep its approval and intended environment with your test plan.
Use a dummy or sample TFN only if it comes from an official or provider-approved source for your test environment.
The ATO’s payment summary instructions list codes made up of nine ones, nine threes or nine zeros for specific reporting situations. The tool refuses those reporting codes as fixtures.
The ATO’s developer specifications direct registered software providers to its TFN algorithm guidance.
Your provider’s test instructions decide which synthetic values its environment accepts. A passing local checksum cannot establish that the ATO issued a number or that it identifies a person.
Enter only the approved fixture and confirm its testing approval. The tool refuses an unconfirmed source or one that fails its local nine-digit rules.
The fixture stays in browser memory. This page sends no fixture to Tax Genie, the ATO or another service. It saves none in browser storage or the page address.
Create Accepted and Rejected Cases
Choose All cases to generate every test TFN number: the approved source, an empty entry, a missing digit, an extra digit, an unsupported character and a number-rule failure.
Format selects the first four malformed cases. Number rule keeps the approved source and the number-rule failure.
Accepted means that the approved source passes this local format check. Each rejected case names the rule it exercises.
The empty case assumes a required field. An optional TFN field needs a separate expected outcome. The missing-digit case tests a nine-digit field, with separate handling needed for eight-digit records.
The number-rule case changes the final digit and confirms a checksum failure before including it. The unsupported-character case replaces that digit with a letter.
A form can refuse the letter or visibly remove it and recheck what remains. A masked entry typed as a row of Xs tests the same rule. Record which behaviour your form promises.
Set different accepted-case and rejected-case labels to match your test plan. The labels describe your expected format outcome. Actual provider acceptance, ATO issuance and identity remain separate questions.
Check the Form Without Real Client Data
Download JSON saves the labelled cases on your device. Values remain strings, so leading zeros and empty entries survive the download. Keep the file in your isolated test environment and use fictional client records.
- Confirm that the target environment cannot lodge, send client messages or update real records. Disable its outgoing connections or use provider-approved test endpoints.
- Enter each labelled case and compare the visible response with its expected rule. Check keyboard entry and paste, then correct a refused entry using the approved source.
- Follow the fictional record through saving, staff review and correction. Confirm which staff can reveal the test value and whether those actions appear in the activity record.
- Check page addresses, requests, browser storage and error logs for unintended exposure. Inspect exports, emails and generated documents against your practice’s TFN handling requirements.
- Record the observed result against each case. Clear fixtures removes the source and cases from this page. Reloading or returning through browser history also clears them. Remove downloaded copies when your test-retention rules allow it.
Use the related guides below to check real-client details or find the ATO application steps for a client who needs a TFN.