{"id":18833,"date":"2026-06-10T04:35:20","date_gmt":"2026-06-10T04:35:20","guid":{"rendered":"https:\/\/tenthplanet.in\/idempiere\/?p=18833"},"modified":"2026-06-10T08:18:58","modified_gmt":"2026-06-10T08:18:58","slug":"how-to-configure-business-partner-employee-in-idempiere-for-retail","status":"publish","type":"post","link":"https:\/\/tenthplanet.in\/idempiere\/how-to-configure-business-partner-employee-in-idempiere-for-retail\/","title":{"rendered":"How to Create an Employee in iDempiere Using the Business Partner Window"},"content":{"rendered":"\n

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

The Business Partner window in iDempiere is the central master record for all external and internal parties \u2014 including employees. Unlike standalone HR or payroll systems that maintain a separate Employee Master, iDempiere consolidates employee identity data directly within the Business Partner framework. Employee-specific attributes such as payroll numbers and commission IDs are stored here, acts as the central reference for employee-related data within iDempiere.<\/p>\n\n\n\n

In a retail environment, this window is used to register store staff, field sales representatives, cashiers, and any other personnel who interact with transactions. Retail businesses rely on this window to capture employee addresses (for dispatch or correspondence), link employees to commission structures, and grant system access through the Contact (User) sub-tab.<\/p>\n\n\n\n

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

Ensure the following configurations are completed before configuring Business Partner (Employee) in iDempiere:<\/p>\n\n\n\n

    \n
  • Organization is set up and active in iDempiere.<\/li>\n\n\n\n
  • Business Partner Group for employees is created (e.g., “Employees” or “Staff”) to enable correct accounting defaults.<\/li>\n\n\n\n
  • Location \/ Address master data (City, Region, Country) is configured if employee addresses are required.<\/li>\n\n\n\n
  • User roles and access profiles are defined if the employee will be granted system login access via the Contact (User) sub-tab.<\/li>\n<\/ul>\n\n\n\n

    Business Rules<\/strong><\/h2>\n\n\n\n

    The following business rules apply to Business Partner (Employee) configuration in iDempiere:<\/p>\n\n\n\n

      \n
    • Each employee must be registered as a Business Partner with the Employee flag enabled. This distinguishes employee records from customer or vendor records in iDempiere.<\/li>\n\n\n\n
    • Payroll Number is stored in the Business Partner record as a reference identifier. It must be unique per employee and align with the payroll system in use.<\/li>\n\n\n\n
    • Employee Commission Number (Commission ID) is captured in the Business Partner record to link the employee to commission calculation rules configured elsewhere in iDempiere.<\/li>\n\n\n\n
    • Employee address is managed through the Location sub-tab. Each employee may have one or more addresses (home, correspondence) linked to their Business Partner record.<\/li>\n\n\n\n
    • Contact details and system login credentials are managed through the Contact (User) sub-tab. This is the iDempiere equivalent of a User Master \u2014 it grants the employee access to the system if required.<\/li>\n\n\n\n
    • Active records are available for use in transactions. Inactive records are excluded from lookups and order processing.<\/li>\n\n\n\n
    • Setting Organization = * (asterisk) makes the employee record available across all branches and stores. Organization-specific records are visible only within their assigned branch.<\/li>\n\n\n\n
    • Duplicate employee records must be avoided. Each employee should have a single Business Partner record to prevent data inconsistency across transactions and reports.<\/li>\n\n\n\n
    • Employee records must not be deleted once referenced in transactions. Deactivate the record instead to preserve historical data integrity.<\/li>\n<\/ul>\n\n\n\n

      Note:<\/strong> In some ERP systems, Employee Master is a separate module. In iDempiere, employee identity, address, and contact data are fully managed within the Business Partner window \u2014 no separate Employee Master window exists. Payroll numbers and commission IDs are captured as reference fields within this same window.<\/p>\n\n\n\n

      Navigation<\/strong><\/h2>\n\n\n\n
      Menu \u2192 Partner Relations \u2192 Business Partner Rules \u2192 Business Partner<\/strong><\/code><\/pre>\n\n\n\n
      \"TenthPlanet-iDempiere-Masters-BusinessPartner(Employee)-1\"<\/figure>\n\n\n\n
      The window displays all existing Business Partner records. Use the search bar to filter records by name, ID, or employee status. Ensure the Employee checkbox is visible in the search results or apply a filter for Employee = Yes to narrow the list to staff records only.<\/p>\n\n\n\n
      Step-by-Step Configuration<\/strong><\/h2>\n\n\n\n
      Step 1: Open the Business Partner Window<\/strong><\/h3>\n\n\n\n
      The window opens and displays a list of all existing Business Partner records \u2014 customers, vendors, and employees are all stored here.<\/p>\n\n\n\n
      Use the search bar at the top to locate an existing employee record or confirm that the employee does not already exist before creating a new one. This prevents duplicate records.<\/p>\n\n\n\n
      \"TenthPlanet-iDempiere-Masters-BusinessPartner(Employee)-2\"<\/figure>\n\n\n\n
      Step 2: Create a New Employee Record<\/strong><\/h3>\n\n\n\n
      Click the New Record icon (+<\/strong>) in the toolbar or press Alt+N<\/strong>. A blank Business Partner form opens. This is the main tab where the core employee identity is captured.<\/p>\n\n\n\n
      The Employee checkbox must be enabled to classify this Business Partner as a staff member. This flag distinguishes the record from customer or vendor entries and controls which transactions and reports include this record.<\/p>\n\n\n\n
      \"TenthPlanet-iDempiere-Masters-BusinessPartner(Employee)-3\"<\/figure>\n\n\n\n
      Field Reference \u2014 Business Partner Main Tab<\/strong><\/h3>\n\n\n\n
      Field<\/strong><\/td>Sample Value<\/strong><\/td>Description<\/strong><\/td><\/tr><\/thead>
      Name<\/td>Ravi Kumar<\/td>Full legal name of the employee.<\/td><\/tr>
      Name 2<\/td>R. Kumar<\/td>Secondary name or alias, used for display purposes.<\/td><\/tr>
      Search Key<\/td>EMP-001<\/td>Unique identifier for the employee record. Use a consistent naming convention such as EMP-XXX.<\/td><\/tr>
      Business Partner Group<\/td>Employees<\/td>Assigns the employee to the correct accounting and reporting group. Must be pre-configured.<\/td><\/tr>
      Employee<\/td>\u2714 Checked<\/td>Flags this Business Partner as an employee. Required for employee-specific processing.<\/td><\/tr>
      Organization<\/td>* or Specific Branch<\/td>Set to * to share across all branches or assign to a specific store location.<\/td><\/tr>
      Active<\/td>\u2714 Checked<\/td>Controls whether this record is available in transactions. Uncheck to deactivate without deleting.<\/td><\/tr>
      Sales Representative<\/td>\u2714 Checked (if applicable)<\/td>Enable if the employee earns commission on sales. Links the employee to commission rules.<\/td><\/tr>
      Tax ID<\/td>PANABCDE1234F<\/td>Applicable tax identification number for the employee. Required for payroll tax compliance.<\/td><\/tr>
      Description<\/td>Store Cashier \u2013 Chennai Branch<\/td>Internal notes or role description for reference.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
      Step 3: Capture Payroll Number and Commission ID<\/strong><\/h3>\n\n\n\n
      iDempiere does not provide dedicated Payroll Number and Commission Number fields out of the box in the Business Partner window. These identifiers are managed as follows in a retail iDempiere setup:<\/p>\n\n\n\n
        \n
      • Payroll Number: <\/strong>\n
          \n
        • Preferred approach:<\/strong> Use a custom field or attribute<\/strong> if your iDempiere implementation supports it, as this provides better structure and reporting flexibility.<\/li>\n\n\n\n
        • Alternative approach:<\/strong> Store it in the Search Key<\/strong> field using a consistent payroll-aligned format (e.g., PAY-2024-001) when no custom field is available.<\/li>\n<\/ul>\n<\/li>\n\n\n\n
        • Commission Number \/ Commission ID: <\/strong>
          Enable the Sales Representative checkbox on the main tab. The employee is then assignable to Commission Run records under the Commission window (typically Quote-To-Invoice(Sales) > Sales and Marketing<\/strong> > Commission<\/strong>). The Business Partner record itself serves as the commission identity reference.<\/li>\n\n\n\n
        • Additional Reference Fields: <\/strong>If your iDempiere instance supports custom attributes or global attributes, a system administrator can add Payroll Number and Commission No as dedicated fields. Confirm with your implementation team.<\/li>\n<\/ul>\n\n\n\n
          Step 4: Add Employee Address via Location Sub-Tab<\/strong><\/h3>\n\n\n\n
          Click the Location sub-tab within the Business Partner window. This sub-tab stores all physical addresses associated with the employee \u2014 home address, correspondence address, or branch assignment.<\/p>\n\n\n\n
          Click New Record (+) within the Location tab to add an address. Each address entry is linked to this employee’s Business Partner record and can be flagged by type (Ship To, Bill To, Remit To, etc.).<\/p>\n\n\n\n
          \"TenthPlanet-iDempiere-Masters-BusinessPartner(Employee)-4\"<\/figure>\n\n\n\n
          Field Reference \u2014 Location Sub-Tab<\/strong><\/h3>\n\n\n\n
          Field<\/strong><\/td>Sample Value<\/strong><\/td>Description<\/strong><\/td><\/tr><\/thead>
          Name<\/td>Home Address \u2013 Ravi Kumar<\/td>Label for this address entry. Use a descriptive name to distinguish multiple addresses.<\/td><\/tr>
          Address 1<\/td>No. 12, Anna Nagar<\/td>First line of the street address.<\/td><\/tr>
          Address 2<\/td>Near Metro Station<\/td>Second address line for additional details.<\/td><\/tr>
          City<\/td>Chennai<\/td>City name. Must match the pre-configured city master if validation is active.<\/td><\/tr>
          Region \/ State<\/td>Tamil Nadu<\/td>State or region. Select from the pre-configured list.<\/td><\/tr>
          Postal Code<\/td>600040<\/td>PIN or ZIP code.<\/td><\/tr>
          Country<\/td>India<\/td>Country of the address.<\/td><\/tr>
          Active<\/td>\u2714 Checked<\/td>Only active addresses are available in transaction lookups.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
          Step 5: Add Employee Contact and System User via Contact (User) Sub-Tab<\/strong><\/h3>\n\n\n\n
          Click the Contact (User) sub-tab. This sub-tab is used to maintain users within the system \u2014 either internal users or Business Partner contacts. It captures personal contact details and is used to manage system access for the employee, including login credentials and role assignment when required.<\/p>\n\n\n\n
          Click New Record (+) within the Contact tab. One employee can have multiple contacts listed, but typically one primary contact is maintained per employee.<\/p>\n\n\n\n
          \"TenthPlanet-iDempiere-Masters-BusinessPartner(Employee)-5\"<\/figure>\n\n\n\n
          Field Reference \u2014 Contact (User) Sub-Tab<\/strong><\/h3>\n\n\n\n
          Field<\/strong><\/td>Sample Value<\/strong><\/td>Description<\/strong><\/td><\/tr><\/thead>
          Name<\/td>Ravi Kumar<\/td>Contact name \u2014 typically the employee’s full name.<\/td><\/tr>
          Title<\/td>Mr.<\/td>Salutation or title prefix.<\/td><\/tr>
          Description<\/td>Store Cashier<\/td>Role or position description for internal reference.<\/td><\/tr>
          Email Address<\/td>ravi.kumar@store.com<\/td>Official email address. Used for system notifications if access is granted.<\/td><\/tr>
          Phone<\/td>+91-9876543210<\/td>Primary contact number.<\/td><\/tr>
          Notification Type<\/td>E-Mail<\/td>Method by which this contact receives system alerts.<\/td><\/tr>
          Password<\/td>\u2022\u2022\u2022\u2022\u2022\u2022\u2022\u2022<\/td>Set a temporary password if creating a system user. Employee must change on first login.<\/td><\/tr>
          Active<\/td>\u2714 Checked<\/td>Only active contacts are displayed in transaction dropdowns.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
          Retail Tip:<\/strong> Not all employees require system access. Only create a Login \/ User ID if the employee will directly interact with iDempiere \u2014 for example, cashiers using POS terminals or store managers running reports.<\/p>\n\n\n\n
          Step 6: Save the Employee Record<\/strong><\/h3>\n\n\n\n
          After filling in the main tab and all applicable sub-tabs (Location and Contact), click the Save icon (disk icon) in the toolbar or press Alt+S<\/strong>.<\/p>\n\n\n\n
          The record is saved immediately and becomes available across iDempiere \u2014 in sales orders, commission runs, POS sessions, and all reports that reference Business Partners with the Employee flag.<\/p>\n\n\n\n
          Step 7: Activate or Deactivate the Employee Record<\/strong><\/h3>\n\n\n\n
          The Active checkbox on the main tab controls whether the employee record is available in transactions. When Active is checked, the employee appears in all relevant dropdowns and reports. When unchecked, the record is hidden from transaction lookups but remains in the database for historical reference.<\/p>\n\n\n\n
            \n
          • Deactivate an employee record when the staff member leaves the organisation \u2014 do not delete the record.<\/li>\n\n\n\n
          • Deactivating the record prevents new transactions from being assigned to the employee while preserving all past transaction history.<\/li>\n\n\n\n
          • Reactivate the record if an employee returns or was deactivated in error.<\/li>\n<\/ul>\n\n\n\n
            \"TenthPlanet-iDempiere-Masters-BusinessPartner(Employee)-6\"<\/figure>\n\n\n\n
            Configuration Summary<\/strong><\/h2>\n\n\n\n
            Configuration Item<\/strong><\/td>Purpose<\/strong><\/td><\/tr><\/thead>
            Business Partner (Main Tab)<\/td>Stores core employee identity, payroll reference, and commission flag.<\/td><\/tr>
            Employee Checkbox<\/td>Classifies the Business Partner as an employee in iDempiere.<\/td><\/tr>
            Search Key (Payroll Reference)<\/td>Unique reference aligning the record with the external payroll system.<\/td><\/tr>
            Sales Representative Flag<\/td>Enables commission tracking and links employee to Commission Run records.<\/td><\/tr>
            Location Sub-Tab<\/td>Stores home and correspondence addresses for the employee.<\/td><\/tr>
            Contact (User) Sub-Tab<\/td>Captures personal contact details and optional system login credentials.<\/td><\/tr>
            Business Partner Group<\/td>Groups employees for accounting defaults and report segmentation.<\/td><\/tr>
            Organization = *<\/td>Makes the employee record available across all branches and stores.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
            Business Flow Overview<\/strong><\/h2>\n\n\n\n
            \n
            Business Partner (Employee) Record Created<\/strong><\/td><\/tr>
            \u2193<\/td><\/tr>
            Location and Contact Sub-Tabs Configured<\/strong><\/td><\/tr>
            \u2193<\/td><\/tr>
            Employee Linked to Sales Orders \/ POS \/ Commission Runs<\/strong><\/td><\/tr>
            \u2193<\/td><\/tr>
            Transactions Consume Employee Reference<\/strong><\/td><\/tr><\/tbody><\/table><\/figure>\n<\/div><\/div>\n\n\n\n
            Common Issues and Resolutions<\/strong><\/h2>\n\n\n\n
            Issue<\/strong><\/td>Cause<\/strong><\/td>Resolution<\/strong><\/td><\/tr><\/thead>
            Employee not appearing in transaction dropdowns<\/td>Active checkbox is unchecked<\/td>Open the Business Partner record and check the Active flag. Save and retry the transaction.<\/td><\/tr>
            Duplicate employee records found<\/td>Employee was created more than once with different Search Keys<\/td>Deactivate the duplicate record. Merge transaction history if required. Standardise the naming convention going forward.<\/td><\/tr>
            Address not saving in Location sub-tab<\/td>Mandatory fields (Address 1, City, Country) are incomplete<\/td>Ensure all required fields are filled before saving. Country must be selected from the pre-configured list.<\/td><\/tr>
            Contact (User) sub-tab not visible<\/td>User does not have access to the Contact sub-tab due to role restrictions<\/td>System Administrator must grant access to the Contact sub-tab via Role configuration.<\/td><\/tr>
            Employee address not appearing in delivery documents<\/td>Address entry in Location sub-tab is not flagged correctly (Ship To not enabled)<\/td>Edit the Location record and enable the appropriate address type flag for the intended use.<\/td><\/tr>
            Record cannot be deleted \u2014 system shows an error<\/td>The employee Business Partner is referenced in existing transactions<\/td>Do not delete the record. Deactivate it by unchecking the Active flag to preserve transactional integrity.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
            Next Steps<\/strong><\/h2>\n\n\n\n
            After completing Business Partner (Employee) configuration in iDempiere, proceed with:<\/p>\n\n\n\n
              \n
            • Commission Configuration \u2014 Set up commission rules and link employees flagged as Sales Representatives to the appropriate commission plans.<\/li>\n\n\n\n
            • User Role Configuration \u2014 Define and assign role-based access profiles for employees who require iDempiere system access.<\/li>\n\n\n\n
            • Business Partner Group Configuration \u2014 Review and refine Employee group accounting defaults to ensure correct ledger postings for staff-related transactions.<\/li>\n\n\n\n
            • POS Terminal Configuration \u2014 Assign employee Business Partners to POS terminals where cashier login and per-employee transaction tracking is required.<\/li>\n\n\n\n
            • HR \/ Payroll Integration (if applicable) \u2014 Map the Search Key (Payroll Reference) field to the external payroll system’s employee ID for reconciliation and reporting.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"
              Introduction The Business Partner window in iDempiere is the central master record for all external and internal parties \u2014 including […]<\/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-18833","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\/18833","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=18833"}],"version-history":[{"count":18,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/18833\/revisions"}],"predecessor-version":[{"id":18878,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/18833\/revisions\/18878"}],"wp:attachment":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/media?parent=18833"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/categories?post=18833"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/tags?post=18833"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}