Country State Group
| Lines of Code | 567 |
| Technical name | viin_base_state_group |
| License | OPL-1 |
| Website | https://viindoo.com/apps/modules/17.0/viin_base_state_group |
| Read description for | v 12.0 v 13.0 v 14.0 v 15.0 v 16.0 v 18.0 |
| Required Apps | Discuss (mail) Contacts (contacts) |
| Extensions | Business Trips |
Group the states your business actually reports on
State groups - West, Midwest, Northeast, South, or whatever your regions are - on the state, and on every contact through it.
Country State Group (technical name viin_base_state_group) is an Odoo 17.0 app for Odoo Community and Odoo Enterprise and Viindoo Cloud, built for sales manager, logistics, support, analyst.
At a Glance
The facts of Country State Group, version 0.1, in one place. Published by Viindoo.
How It Works
Two steps.
Define the groups
Per country - the regions your business is actually organised by.
Assign the states
Each state belongs to at most one group, which keeps the reporting unambiguous.
And the contacts follow
The group comes from the address, so nobody maintains it per contact.
What You Get
State groups, defined per country
States assigned to a group
The group on the contact, stored, through the state
Groupable and filterable like any field
Restrict-on-delete, so a group in use cannot vanish
Translatable names, for multilingual databases
More Screens
Everything below was taken on a database seeded with real business data, on this series - not a mock-up and not a screenshot from an older version.
Contacts
What This App Does Not Do
Read this before you buy. Everything below is something the app deliberately leaves to another app or to you.
Overlapping regions would make grouping ambiguous; a second dimension is a second field.
Groups live inside a country, deliberately.
It supplies the dimension; assignment rules belong to the apps that use it.
Which is honest - the group is derived, not typed.
Works Well With
Apps from the same stack, built to fit this one:
Administrative Regions
Deeper administrative hierarchies where a country needs them.
viin_administrative_regionWho Should Use Country State Group?
Sales manager
Reports by region without inventing a tag.
Logistics
Groups deliveries by the zones the fleet actually runs.
Support
Routes by region rather than by state list.
Analyst
Gets a stored dimension instead of a case statement.
Frequently Asked Questions
What does Country State Group do?
State groups - West, Midwest, Northeast, South, or whatever your regions are - on the state, and on every contact through it.
What does Country State Group not do?
One group per state. Overlapping regions would make grouping ambiguous; a second dimension is a second field. It does not group countries. Groups live inside a country, deliberately. It does not route anything. It supplies the dimension; assignment rules belong to the apps that use it. Contacts without a state have no group. Which is honest - the group is derived, not typed.
Who is Country State Group for?
Sales manager: Reports by region without inventing a tag. Logistics: Groups deliveries by the zones the fleet actually runs. Support: Routes by region rather than by state list. Analyst: Gets a stored dimension instead of a case statement.
Which Odoo version and editions does it support?
Odoo 17.0 - Odoo Community, Odoo Enterprise, Viindoo Cloud. Upgrades to a newer Odoo series are a separate purchase for that series.
What does it depend on?
It installs on top of: contacts. Odoo installs them with it.
How do I set it up?
Two steps.
What works well with it?
Administrative Regions (viin_administrative_region): Deeper administrative hierarchies where a country needs them. Sales Teams Advanced (to_sales_team_advanced): Sales regions on the documents themselves. Country Recognition (viin_partner_country_recognition): Getting the address right in the first place.
Can I try it before buying?
Yes - the Live Preview button at the top of this page opens the module's own screen on a working database.
How do I get support?
Write to apps.support@viindoo.com with your Odoo version and the technical name viin_base_state_group; pre-sales questions go to sales@viindoo.com.
See Country State Group in Action
Live demo: v17demo-int.viindoo.com/web#action=viin_base_state_group.res_state_group_action
Need help with Country State Group?
For questions, implementation support or a custom feature, contact Viindoo.
Pre-Sales & Partnership
sales@viindoo.comUpgrades to a newer Odoo series are a separate purchase for that series.
All Viindoo apps: apps.odoo.com/apps/modules/browse?author=Viindoo
Technical Requirement
Changes log
0.1 - Latest on the 17.0 line
- The state group on the contact is stored, so it can be grouped and filtered.
Installation
- Navigate to Apps.
- Search with keyword viin_base_state_group.
- Press Install.
Instruction
Instruction video: Country State Group
Concepts
- State Groups: Also known as National Region, is the division of a country into state groups according to different criteria of each country such as geographical location, language characteristics,...
Usages
1. Set up State Groups for each country
Navigate to Contacts ‣ Configuration ‣ State Groups, press Create:
Fill in the information on the view including:
- State Group Name;
- State Group Code (if have);
- Parent: Parent State Group;
- Country: Country of State Group in progress;
- States: States in the State Group in progress.
Once set up, you can access Contacts ‣ Configuration ‣ Fed. States to see the list of States by State Groups:
2. Create and manage a list of customers/vendors (partners) by State Groups
- Navigate to Contacts, press Create to create a new contact. When adding the contact's States information, the system will automatically retrieve the link to the State Groups based on the setting in step 1.
- Use the filter/group by to search and manage the list of partners by State Groups:
This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file).
You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one).
It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software.
The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.