Map street, suburb, city and postcode to the fields expected by the form. Suburb is not the same as Region; preserve leading zeros in four-digit postcodes.
The example below illustrates field layout using a fictional street. It is not a verified mailing address.
Address layout example
Te Aro
WELLINGTON 6011
NEW ZEALAND
| Field label | Meaning |
|---|---|
| Street address | Street address |
| Suburb | Suburb |
| City / Town | City / town |
| Postcode | Four-digit postcode |
How do Suburb, City and Region differ?
Suburb is a more local area description, City or Town identifies the settlement, and Region describes a larger area. Do not duplicate one value across all three merely to satisfy required fields. List the fields accepted by the receiving system and add a dedicated fixture when generated records lack Suburb.
How should I test a leading-zero postcode?
Use 0622 as a format-preservation case and compare browser input, API output and CSV import results. If it becomes 622, locate the conversion step. Keeping four digits is a syntax requirement; it does not prove that a generated street and house number match that postcode for delivery.
Do street fixtures cover rural addresses?
No. Rural delivery and PO Box addresses have different information requirements and cannot be represented by appending a random Unit field. Keep urban street, missing optional Suburb, rural delivery and PO Box cases separate. Prepare the latter two from the NZ Post guidance for the receiving system.
Regression checklist
- Store Suburb separately from City instead of copying Region into it
- Keep 0622 at four digits after import and export
- Missing optional Suburb data must not discard street, city or postcode
What the generator currently covers
The generator does not currently provide a separate Suburb field. Region is a configured area, not a suburb. Prepare separate rural-delivery and PO Box fixtures where needed.
Try the New Zealand address generator