Countries, Provinces, and States
Keep account, billing, and shipping address regions consistent for invoices, tax, delivery, and reporting.
Countries, provinces, and states are part of the account address data used by billing, tax, shipping, and reporting workflows.
In MyPetParlor App, address fields can appear on the main account address, billing-info address, invoice address, and shipping address records. Keeping these values consistent helps your team avoid invoice and delivery confusion.
Address Region Fields#
The account billing domain commonly uses these location fields.
| Field | What it means |
|---|---|
| Country | The country associated with the account, billing, or shipping address. |
| Region or province | The province, state, or regional subdivision inside the country. |
| Town or city | The city or town for the address. |
| Suburb | A local suburb or neighbourhood. |
| Postal code | The postal or ZIP code for the address. |
| Location | Coordinate data where captured by address workflows. |
Where These Fields Appear#
| Record | Region usage |
|---|---|
| Account address | The main address stored against the account. |
| Billing address | The address linked to billing info or invoices. |
| Invoice address | The address snapshot shown on invoice records. |
| Shipping address | The delivery or service-destination address. |
| Business entity | The business billing entity can also have tax and display addresses. |
Why Consistency Matters#
Consistent country and region values help with:
- Correct invoice display.
- Tax and VAT handling.
- Payment verification and billing-info validation.
- Shipping and service-location communication.
- Reporting by country or region.
- Matching customers to the right business entity where location-based billing rules are used.
Current Product Support#
The account and billing models store country and region values as address fields. The backend can persist those values for account, billing, invoice, and shipping address records.
The current product does not yet provide a full central reference-data manager for countries, provinces, and states in the Accounts help workflow. Where address forms use text entry, your team should agree on consistent spelling and formatting.
Recommended Formatting#
Use one consistent convention for each region.
| Example decision | Recommended approach |
|---|---|
| Country names | Use the same country name format across accounts, such as South Africa. |
| Province names | Use the full province name unless your team has a documented abbreviation standard. |
| Postal codes | Capture postal codes without extra words or punctuation. |
| Missing data | Leave optional fields blank instead of entering placeholders such as N/A, unless your tenant process requires a placeholder. |
Future Implementation Notes#
A complete address reference-data workflow should include:
- Country selectors.
- Province/state selectors based on the selected country.
- Address validation rules.
- Consistent country codes where payment gateways or tax systems require them.
- Reporting that normalises region values.