Skip to main content
Version: Tryton 8.0 (LTS)

party

Tryton 8.0 · Reference generated from the official source code

This page combines editorial guidance with evidence extracted from the selected official branch. Always test the flow with your own permissions and configuration.

Purpose​

The Party Module is used to store and manage information about people, businesses, organisations, and associations. It allows you to save information such as contact details, addresses, identifiers and the language used by each of these different entities.

The analysis found 10 Python files, 31 XML files, 24 views, 36 actions, 11 menus, and 1 reports.

Functional user guide

Who should use it​

This module is relevant to people responsible for party processes, company configuration, and result review. Administrators should participate whenever dependencies, permissions, or sequences are introduced.

What you will be able to do​

After configuration, you will be able to identify the records added by party, execute actions in the correct state, produce its reports, and understand the information shared with other modules.

Requirements and preparation​

Before activation, verify company, currency, users, and groups. Install and configure required dependencies first. When real data exists, rehearse activation and upgrades on a restored copy.

Activate dependencies first, review company configuration, and rehearse the complete workflow before production use.

Required dependencies​

  • country — must be installed and configured before testing this module.
  • ir — must be installed and configured before testing this module.
  • res — must be installed and configured before testing this module.

Optional integrations​

  • —
  • Activate the module and sign in again to load menus and permissions.
  • Review new company configuration options and defaults.
  • Assign groups to test users using least privilege.
  • Create small, verifiable master data before bulk imports.
  • Run one complete scenario from draft to final state and inspect related records.

Module objects and concepts​

  • country.postal_code: groups 1 model(s), including country.postal_code. These records form the information users inspect or modify during the process.
  • ir.chat: groups 1 model(s), including ir.chat.channel. These records form the information users inspect or modify during the process.
  • ir.email: groups 2 model(s), including ir.email, ir.email.template. These records form the information users inspect or modify during the process.
  • party.address: groups 3 model(s), including party.address, party.address.format, party.address.subdivision_type. These records form the information users inspect or modify during the process.
  • party.category: groups 1 model(s), including party.category. These records form the information users inspect or modify during the process.
  • party.check_vies: groups 2 model(s), including party.check_vies, party.check_vies.result. These records form the information users inspect or modify during the process.
  • party.configuration: groups 3 model(s), including party.configuration, party.configuration.party_lang, party.configuration.party_sequence. These records form the information users inspect or modify during the process.
  • party.contact_mechanism: groups 2 model(s), including party.contact_mechanism, party.contact_mechanism.language. These records form the information users inspect or modify during the process.
  • party.erase: groups 2 model(s), including party.erase, party.erase.ask. These records form the information users inspect or modify during the process.
  • party.identifier: groups 1 model(s), including party.identifier. These records form the information users inspect or modify during the process.
  • party.party: groups 2 model(s), including party.party, party.party.lang. These records form the information users inspect or modify during the process.
  • party.party-party: groups 1 model(s), including party.party-party.category. These records form the information users inspect or modify during the process.
  • party.replace: groups 2 model(s), including party.replace, party.replace.ask. These records form the information users inspect or modify during the process.

Typical workflow​

  1. Select the correct company and date before creating a document.
  2. Complete master data before lines or details.
  3. Save and review the record before consuming it from another process.
  4. Review warnings, totals, related documents, and traceability.
  5. Generate the report and compare it with the record before delivery.

Actions, states, and wizards​

  • party.check_vies.result — wizard that collects data and performs party › check vies › result. Check permissions, current state, and related records before running it.
  • party.erase — wizard that collects data and performs party › erase. Check permissions, current state, and related records before running it.
  • party.replace — wizard that collects data and performs party › replace. Check permissions, current state, and related records before running it.

Controls before production​

  • Define who creates, reviews, confirms, cancels, and reads.
  • Test closed periods, unauthorized users, and incomplete data.
  • Verify numbering, currency, rounding, and time zone where applicable.
  • Document error correction without direct database edits.
  • Include its tables and files in backup and restore procedures.

Troubleshooting​

  • If a menu is missing, verify activation, module-list update, groups, and a new login session.
  • If a field rejects a value, inspect its domain, company, state, and configured dependencies.
  • If a button is hidden or disabled, check permissions and valid transitions; never change state with SQL.
  • If results differ, reproduce a minimal case and compare related records before and after.
  • Keep the full traceback, version, active modules, and minimal data needed to diagnose an error.

Developer guide

Architecture and extension points​

The package contains 31 Python classes and declares or extends 23 models. It uses Boolean, Char, Function, Integer, Many2Many, Many2One, MultiSelection, MultiValue, One2Many, Selection, Text. Developers should first determine whether a class creates a model or uses PoolMeta to extend one, preserve super() calls, and avoid duplicating dependency rules.

Registered or extended models​

  • country.postal_code
  • ir.chat.channel
  • ir.email
  • ir.email.template
  • party.address
  • party.address.format
  • party.address.subdivision_type
  • party.category
  • party.check_vies
  • party.check_vies.result
  • party.configuration
  • party.configuration.party_lang
  • party.configuration.party_sequence
  • party.contact_mechanism
  • party.contact_mechanism.language
  • party.erase
  • party.erase.ask
  • party.identifier
  • party.party
  • party.party-party.category
  • party.party.lang
  • party.replace
  • party.replace.ask

Field types used​

  • Boolean
  • Char
  • Function
  • Integer
  • Many2Many
  • Many2One
  • MultiSelection
  • MultiValue
  • One2Many
  • Selection
  • Text

Detected classes and public methods​

Classes: Address, AddressFormat, Category, Channel, CheckVIES, CheckVIESResult, Configuration, ConfigurationLang, ConfigurationSequence, ContactMechanism, ContactMechanismLanguage, Email, EmailTemplate, Erase, EraseAsk, EraseError, Identifier, InvalidEMail, InvalidFormat, InvalidIdentifierCode, InvalidPhoneNumber, Party, PartyCategory, PartyLang, PostalCode, Replace, ReplaceAsk, SimilarityWarning, SubdivisionType, VIESUnavailable, _ContactMechanismMixin

Methods: address_get(), autocomplete(), autocomplete_city(), autocomplete_postal_code(), check_code(), check_erase(), check_format(), check_identifier_types(), check_modification(), check_number_format(), check_similarity(), check_street_format(), check_valid_email(), check_valid_phonenumber(), compute_fields(), contact_mechanism_get(), copy(), default_addresses(), default_categories(), default_code_readonly(), default_format_(), default_get(), default_lang(), default_party(), default_party_sequence(), default_result(), default_source(), default_street_format(), default_type(), email_models(), fields_to_replace(), format_value(), format_value_compact(), get(), get_code_readonly(), get_contact_mechanism(), get_contact_mechanisms(), get_distance(), get_format(), get_full_address(), get_full_name(), get_identifier_types(), get_number_format(), get_rec_name(), get_resources(), get_street_format(), get_subdivision_types(), get_tax_identifier(), get_types(), get_value(), index_set_field(), numbers(), on_change_address(), on_change_country(), on_change_email(), on_change_notify(), on_change_other_value(), on_change_sip(), on_change_skype(), on_change_source(), on_change_street(), on_change_value(), on_change_website(), on_change_with_code(), on_change_with_street(), on_change_with_street_single_line(), on_change_with_subdivision_types(), on_change_with_type_address(), on_change_with_url(), on_modification(), order_code(), order_distance(), party_full_name(), pre_validate(), preprocess_values(), search_global(), search_rec_name(), search_street(), search_street_single_line(), search_tax_identifier(), set_contact_mechanism(), set_street(), set_value(), tax_identifier_types(), to_erase(), transition_check(), transition_erase(), transition_replace(), usages(), validate_fields()

Code map​

Detected 10 Python files, 31 XML files, and 0 explicit access files. XML connects models to views, menus, actions, and reports; access CSV files establish initial permissions.

  • __init__.py
  • address.py
  • address.xml
  • category.py
  • category.xml
  • configuration.py
  • configuration.xml
  • contact_mechanism.py
  • contact_mechanism.xml
  • country.py
  • doc/conf.py
  • exceptions.py
  • ir.py
  • ir.xml
  • message.xml
  • party.py
  • party.xml
  • view/address_form.xml
  • view/address_form_simple.xml
  • view/address_format_form.xml
  • view/address_format_list.xml
  • view/address_subdivision_type_form.xml
  • view/address_subdivision_type_list.xml
  • view/address_tree.xml
  • view/address_tree_sequence.xml
  • view/category_form.xml
  • view/category_list.xml
  • view/category_tree.xml
  • view/check_vies_result.xml
  • view/configuration_form.xml
  • view/contact_mechanism_form.xml
  • view/contact_mechanism_tree.xml
  • view/contact_mechanism_tree_sequence.xml
  • view/email_template_form.xml
  • view/erase_ask_form.xml
  • view/identifier_form.xml
  • view/identifier_list.xml
  • view/identifier_list_sequence.xml
  • view/party_form.xml
  • view/party_tree.xml
  • view/replace_ask_form.xml

Test plan​

  • Activation on an empty database and upgrade from the previous revision.
  • Create, update, copy, and delete according to state and access rights.
  • Every button, transition, and wizard with valid and invalid scenarios.
  • Applicable multi-company rules, translations, time zones, and currencies.
  • Combined installation with required and optional dependencies.
  • Backup and restore of records, attachments, and generated reports.

Compatibility and upgrades​

Keep server and modules on series 8.0. Before upgrading, compare tryton.cfg, __register__ migrations, state changes, XML IDs, and permissions. A successful build does not replace a rehearsed migration or functional data reconciliation.

Official documentation evidence​

Topics found: Design · Party · Reports · Labels · Wizards · Check VIES · Replace · Erase · Identifier · Address · Address Format · Address Subdivision Type · Contact Mechanism · Category · Configuration · Party Module · Usage · Categorising parties · Manually assigning party codes · Setting a default party language · Checking VAT numbers are valid · Merging duplicate parties together · Erasing a party's personal data

    • doc/index.rst: The Party Module is used to store and manage information about people, businesses, organisations, and associations. It allows you to save information such as contact details, addresses, identifiers and the language used by each of these different entities.
    • doc/usage.rst: The items found under the [Party] main menu item allow you to see and manage the parties on your system in a variety of different ways.

View source code