{"id":18635,"date":"2026-05-29T11:04:57","date_gmt":"2026-05-29T11:04:57","guid":{"rendered":"https:\/\/tenthplanet.in\/idempiere\/?p=18635"},"modified":"2026-05-29T11:04:59","modified_gmt":"2026-05-29T11:04:59","slug":"how-to-configure-business-partner-group-in-idempiere","status":"publish","type":"post","link":"https:\/\/tenthplanet.in\/idempiere\/how-to-configure-business-partner-group-in-idempiere\/","title":{"rendered":"How to Configure Business Partner Group in iDempiere"},"content":{"rendered":"\n

The Business Partner Group window in iDempiere for Distribution helps categorize customers, suppliers, carriers, and employees, enabling consistent accounting defaults, transaction processing, reporting, and operational control across distribution activities.<\/p>\n\n\n\n

Introduction<\/strong><\/h2>\n\n\n\n

The Business Partner Group window in iDempiere for Distribution is used to classify business partners into categories that support efficient distribution operations and financial management. Distribution organizations commonly create groups for retail customers, wholesale customers, suppliers, logistics providers, and internal staff. By assigning a business partner to the appropriate group, the system automatically applies predefined accounting settings, payment terms, credit controls, and transaction rules. This standardization reduces manual setup, improves data accuracy, and ensures consistent processing throughout the distribution supply chain.<\/p>\n\n\n\n

Prerequisites<\/strong><\/h2>\n\n\n\n

Before starting, ensure the following configuration steps have been completed:<\/p>\n\n\n\n

    \n
  • Initial Tenant Setup completed successfully<\/li>\n\n\n\n
  • Accounting Schema configured with a valid Chart of Accounts<\/li>\n\n\n\n
  • Account Elements (Receivables and Payables GL accounts) are defined<\/li>\n\n\n\n
  • Organization structure is set up with at least one active organization<\/li>\n<\/ul>\n\n\n\n

    Note: <\/strong>Ensure the Chart of Accounts is fully created before creating Business Partner Groups, as each group requires valid GL account assignments for Receivables, Payables, and Write-Off accounts.<\/p>\n\n\n\n

    Navigation<\/strong><\/h2>\n\n\n\n

    To locate the Business Partner Group window in iDempiere, follow the menu path below:<\/p>\n\n\n\n

    Menu \u2192 Partner Relation \u2192 Business Partner Rules \u2192 Business Partner Group<\/p>\n\n\n\n

    The window displays all existing Business Partner Group records in a grid view. From this view you can create new records, search existing ones, and review associated accounting configurations.<\/p>\n\n\n\n

    Step-by-Step Configuration<\/strong><\/h2>\n\n\n\n

    Step 1: Open the Business Partner Group Window<\/strong><\/h3>\n\n\n\n

    Navigate to the Business Partner Group window using the menu path<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    Step 2: Create a New Record<\/strong><\/h3>\n\n\n\n

    To create a new Business Partner Group, click the New Record button in the toolbar: New Record (+)<\/p>\n\n\n\n

    The form will clear and present empty fields ready for data entry.<\/p>\n\n\n\n

    Field Purpose Reference<\/strong><\/h3>\n\n\n\n
      \n
    • Search Key \/ Value<\/strong> \u2014 Short, unique code used to identify the group in lookups and reports<\/li>\n\n\n\n
    • Name<\/strong> \u2014 Descriptive name displayed when assigning a Business Partner to this group<\/li>\n\n\n\n
    • Description<\/strong> \u2014 Optional longer description providing business context for the group<\/li>\n\n\n\n
    • Organization<\/strong> \u2014 Defines whether the record is shared across all organizations (*) or restricted<\/li>\n\n\n\n
    • Active<\/strong> \u2014 Controls whether the group is available for selection in transactions<\/li>\n<\/ul>\n\n\n\n

      Step 3: Configure Distribution Customer Group<\/strong><\/h3>\n\n\n\n

      This group is used for all walk-in Distribution customers and point-of-sale transactions. Enter the following values:<\/p>\n\n\n\n

      Field<\/strong><\/td>Value<\/strong><\/td><\/tr><\/thead>
      Organization<\/td>*<\/td><\/tr>
      Search Key<\/td>Distribution-CUST<\/td><\/tr>
      Name<\/td>Distribution Customer<\/td><\/tr>
      Description<\/td>Walk-in customers and POS counter sales<\/td><\/tr>
      Active<\/td>Yes<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

      Purpose<\/strong><\/h3>\n\n\n\n

      The Distribution Customer group drives the posting of all counter sales invoices to the correct receivables sub-ledger. Assigning all walk-in partners to this group ensures that sales tax, payment term defaults (typically immediate \/ cash), and dunning rules are applied uniformly across POS transactions.<\/p>\n\n\n\n

      Step 4: Configure Wholesale Customer Group<\/strong><\/h3>\n\n\n\n

      This group is used for registered wholesale buyers and corporate accounts that purchase on credit terms. Enter the following values:<\/p>\n\n\n\n

      Field<\/strong><\/td>Value<\/strong><\/td><\/tr><\/thead>
      Organization<\/td>*<\/td><\/tr>
      Search Key<\/td>WHOLE-CUST<\/td><\/tr>
      Name<\/td>Wholesale Customer<\/td><\/tr>
      Description<\/td>Registered wholesale buyers on credit terms<\/td><\/tr>
      Active<\/td>Yes<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

      Purpose<\/strong><\/h3>\n\n\n\n

      The Wholesale Customer group enables a separate receivables stream for credit account buyers. This allows Finance to produce aged debtor reports segmented by retail versus wholesale exposure and apply differentiated credit limits and payment terms (for example, Net 30 or Net 60) at group level.<\/p>\n\n\n\n

      Step 5: Configure Vendor Group<\/strong><\/h3>\n\n\n\n

      This group is used for all product suppliers and merchandise vendors. Enter the following values:<\/p>\n\n\n\n

      Field<\/strong><\/td>Value<\/strong><\/td><\/tr><\/thead>
      Organization<\/td>*<\/td><\/tr>
      Search Key<\/td>VENDOR<\/td><\/tr>
      Name<\/td>Merchandise Vendor<\/td><\/tr>
      Description<\/td>Product suppliers and merchandise vendors<\/td><\/tr>
      Active<\/td>Yes<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

      Purpose<\/strong><\/h3>\n\n\n\n

      The Merchandise Vendor group centralises all trade payables for goods purchased for resale. Separating merchandise vendors from service vendors and freight carriers allows Procurement to track outstanding purchase orders and goods receipt notes against the correct payables account and generate accurate creditor aging reports.<\/p>\n\n\n\n

      Step 8: Save Record<\/strong><\/h3>\n\n\n\n

      After entering all required field values, click the Save button in the toolbar to persist the record:<\/p>\n\n\n\n

      A confirmation message will appear in the status bar indicating that the record has been saved successfully. The record will now be available for selection when creating or editing a Business Partner.<\/p>\n\n\n\n

      Note: <\/strong>The Business Partner Group record has been created successfully and is now available for assignment to Business Partners in the Relation Management module.<\/p>\n\n\n\n

      Business Flow Overview<\/strong><\/h2>\n\n\n\n

      Business Partner Groups are foundational master data that influence the entire order-to-cash and procure-to-pay cycles in iDempiere. The flow below illustrates where the group assignment takes effect:<\/p>\n\n\n\n

      At each posting stage, iDempiere resolves the GL accounts to debit and credit by reading the accounting configuration attached to the Business Partner Group. This means that all partners in the same group consistently post to the same sub-ledger accounts, ensuring accurate financial reporting without manual account selection at transaction time.<\/p>\n\n\n\n

      Validation<\/strong><\/h2>\n\n\n\n

      After creating Business Partner Groups, perform the following validation checks to confirm correct configuration:<\/p>\n\n\n\n

        \n
      • Open Business Partner Group window and verify all five groups appear in the Field<\/li>\n\n\n\n
      • Verify each group has the correct Default Receivable or Payable Account assigned<\/li>\n\n\n\n
      • Create a test Business Partner and assign the Distribution Customer group; confirm the receivables account defaults correctly on the Accounting tab<\/li>\n\n\n\n
      • Confirm the Active flag is set to Yes for all groups intended for live use<\/li>\n<\/ul>\n\n\n\n

        Note: <\/strong>After validation, run a Cache Reset from System Admin \u2192 General Rules \u2192 Cache Reset to ensure the new group records are available to all active sessions without requiring a system restart.<\/p>\n\n\n\n

        Common Issues<\/strong><\/h2>\n\n\n\n
        Issue<\/strong><\/td>Resolution<\/strong><\/td><\/tr><\/thead>
        Mandatory field validation error on save<\/td>Ensure Name and Search Key fields are populated. Both are required fields.<\/td><\/tr>
        Business Partner Group not visible in BP form<\/td>Confirm the Active flag is set to Yes and perform a Cache Reset.<\/td><\/tr>
        Duplicate Search Key error<\/td>Each Search Key must be unique within the tenant. Rename the duplicate record before saving.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

        Best Practices<\/strong><\/h2>\n\n\n\n
          \n
        • Define Business Partner Groups before creating any Business Partners to avoid the need for mass updates later<\/li>\n\n\n\n
        • Use Organization = * for all groups to ensure availability across all organization units in a multi-org setup<\/li>\n\n\n\n
        • Maintain a one-to-one mapping between each Business Partner Group and a dedicated GL sub-account to support granular financial reporting<\/li>\n\n\n\n
        • Document the intended Write-Off Account for each group in your Chart of Accounts reference guide to ensure consistency during period-end processing<\/li>\n\n\n\n
        • Periodically review inactive groups and archive or delete records that are no longer in use to keep the lookup list clean<\/li>\n<\/ul>\n\n\n\n

          Next Steps<\/strong><\/h2>\n\n\n\n

          After completing the Business Partner Group<\/strong> setup, continue with the following configuration topics:<\/p>\n\n\n\n

            \n
          • Business Partner in iDempiere for Distribution<\/li>\n\n\n\n
          • Payment Terms in iDempiere for Distribution<\/li>\n\n\n\n
          • Price List in iDempiere for Distribution<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"

            The Business Partner Group window in iDempiere for Distribution helps categorize customers, suppliers, carriers, and employees, enabling consistent accounting defaults, […]<\/p>\n","protected":false},"author":3,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[67,68],"tags":[],"class_list":["post-18635","post","type-post","status-publish","format-standard","hentry","category-retail","category-masters"],"acf":[],"_links":{"self":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/18635","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/comments?post=18635"}],"version-history":[{"count":0,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/18635\/revisions"}],"wp:attachment":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/media?parent=18635"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/categories?post=18635"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/tags?post=18635"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}