Geography
Geography
CifraHQ stores addresses using Panama's official administrative divisions: Country > Province > District > Township. These four tables are the reference Master Data that populates address fields across Customers, Vendors, Employees, and other entities. They come pre-loaded with Panama's geography but administrators can add or edit records as needed.
Where to find it
Go to Master Data > Geography, then choose the level you need:
Geography starts with the Countries list; provinces, districts, and townships drill down from here.
- Countries --
/master-data/countries - Provinces --
/master-data/provinces - Districts --
/master-data/districts - Townships --
/master-data/townships
The four levels
Countries
| Column | Description |
|---|---|
| Code | ISO alpha-2 code (e.g., PA) -- unique identifier; cannot be changed after creation |
| Alpha-3 | ISO alpha-3 code (e.g., PAN) |
| Name | English country name |
| Name (Spanish) | Spanish country name shown in Spanish-language documents |
| Subregion | Geographic subregion (e.g., Central America) |
Provinces
| Column | Description |
|---|---|
| ISO Code | Province ISO code (e.g., PA-1) |
| Name | Province name |
| Country | Parent country code |
| Cedula Code | Panama national ID prefix number for this province |
Districts
| Column | Description |
|---|---|
| Name | District name |
| Province | Parent province |
Townships
| Column | Description |
|---|---|
| Name | Township name |
| District | Parent district |
When creating a new Township, you first select the Province to filter the district list, then select the District.
Guided address entry
When you enter an address anywhere in CifraHQ -- on Customers, Vendors, or the Ship To / Bill To blocks of Quotes, Sales Orders, Invoices, and Purchase Orders -- these geography tables drive guided cascading dropdowns instead of free typing. Choose a Country and the right fields appear in order:
- Panama: Province, then District, then Township -- each list filtered by the level above.
- United States, Mexico, Canada: State, then City.
- Other countries: free-text City and State/Province.
This keeps addresses consistent and, for Panama, aligned with the official political division required for electronic invoicing. The selected names are saved into the address, so existing Reports, prints, and lists are unaffected.
Tips
- Only administrators can add, edit, or delete geography records.
- Countries also offer a View history option from the row action menu to see the change log for that record.
- Deleting a geography level that is still referenced by addresses will be rejected -- remove the references first.
Related: Customers · Vendors · Warehouses · Tenant Configuration · Tax Authorities
Was this page helpful?