{"id":18653,"date":"2026-05-29T11:07:03","date_gmt":"2026-05-29T11:07:03","guid":{"rendered":"https:\/\/tenthplanet.in\/idempiere\/?p=18653"},"modified":"2026-05-29T11:07:05","modified_gmt":"2026-05-29T11:07:05","slug":"how-to-configure-sales-region-in-idempiere","status":"publish","type":"post","link":"https:\/\/tenthplanet.in\/idempiere\/how-to-configure-sales-region-in-idempiere\/","title":{"rendered":"How to Configure Sales Region in iDempiere"},"content":{"rendered":"\n

The Sales Region window in iDempiere for Distribution enables organizations to define and manage sales territories, supporting regional reporting, sales performance analysis, customer segmentation, and distribution planning.<\/p>\n\n\n\n

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

The Sales Region window in iDempiere for Distribution is used to define geographical or operational sales territories that organize customers, sales activities, and distribution operations. Sales Regions help distribution companies segment markets, assign responsibility to sales teams, and analyze performance across different territories. By associating customers and transactions with specific regions, organizations can improve sales tracking, commission management, demand forecasting, and regional reporting. This structure provides greater visibility into market performance and supports more effective planning and decision-making throughout the distribution network.
<\/p>\n\n\n\n

Note: <\/strong>Sales Regions are foundational master data. They should be configured before creating Business Partners or entering Sales Orders that require regional classification.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

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

Before starting, ensure the following configuration is complete:<\/p>\n\n\n\n

    \n
  • Initial Tenant Setup completed successfully<\/li>\n\n\n\n
  • Organisation structure defined and active<\/li>\n\n\n\n
  • Sales Representative records created (if assigning representatives to regions)<\/li>\n\n\n\n
  • Logged in with a role that has access to the Sales Region window<\/li>\n\n\n\n
  • Required administrative permissions granted for master data creation<\/li>\n<\/ul>\n\n\n\n

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

    To open the Sales Region window, navigate using the iDempiere menu: <\/p>\n\n\n\n

    Menu \u2192 Quote to invoice \u2192 Sales and Marketing \u2192 Sales Region<\/p>\n\n\n\n

    The window displays all existing Sales Region records in a list view. Use the search bar or scroll to locate an existing record, or proceed to create a new record.<\/p>\n\n\n\n

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

    Step 1: Open the Sales Region Window<\/strong><\/h3>\n\n\n\n

    Navigate to the Sales Region window<\/p>\n\n\n\n

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

    The window displays all existing Sales Region records in list view.<\/p>\n\n\n\n

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

    To create a new Sales Region record, click the New Record button in the toolbar: New Record (+)<\/p>\n\n\n\n

    A blank form opens. Enter the required field values as described below.<\/p>\n\n\n\n

    Field Reference<\/strong><\/h3>\n\n\n\n
      \n
    • Search Key<\/strong> \u2014 Unique short code used to identify the Sales Region across the system<\/li>\n\n\n\n
    • Name<\/strong> \u2014 Descriptive name of the Sales Region displayed in transactions and reports<\/li>\n\n\n\n
    • Description<\/strong> \u2014 Additional business context or notes about the region<\/li>\n\n\n\n
    • Sales Representative<\/strong> \u2014 The staff member or agent responsible for this Sales Region<\/li>\n\n\n\n
    • Active<\/strong> \u2014 Controls whether the record is available for use in transactions<\/li>\n\n\n\n
    • Default<\/strong> \u2014 Marks this region as the default selection when no region is specified<\/li>\n\n\n\n
    • Summary Level<\/strong> \u2014 Indicates whether this is a summary (parent) region grouping child records<\/li>\n\n\n\n
    • Tenant<\/strong> \u2014 The client organisation this record belongs to (auto-populated)<\/li>\n\n\n\n
    • Organisation<\/strong> \u2014 Defines the organisational scope of the record; use * for shared records<\/li>\n<\/ul>\n\n\n\n

      Step 3: Configure Sales Region \u2014 Point S<\/strong><\/h3>\n\n\n\n

      Enter the following values to create the Point S regional record:<\/p>\n\n\n\n

      Field<\/strong><\/td>Value<\/strong><\/td><\/tr><\/thead>
      Tenant<\/td>Your Tenant<\/td><\/tr>
      Organisation<\/td>*<\/td><\/tr>
      Search Key<\/td>10000<\/td><\/tr>
      Name<\/td>Point S<\/td><\/tr>
      Description<\/td>Point-S regional sales territory<\/td><\/tr>
      Sales Representative<\/td>(None assigned)<\/td><\/tr>
      Active<\/td>Yes<\/td><\/tr>
      Default<\/td>No<\/td><\/tr>
      Summary Level<\/td>No<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

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

      The Point S region represents a specific Distribution channel or partner network territory. Linking this region to business partners ensures all transactions, orders, and reports are correctly attributed to the Point S sales territory for performance tracking and operational review.<\/p>\n\n\n\n

      Step 4: Configure Sales Region \u2014 OEM<\/strong><\/h3>\n\n\n\n

      Enter the following values to create the OEM regional record:<\/p>\n\n\n\n

      Field<\/strong><\/td>Value<\/strong><\/td><\/tr><\/thead>
      Tenant<\/td>Your Tenant<\/td><\/tr>
      Organisation<\/td>*<\/td><\/tr>
      Search Key<\/td>18<\/td><\/tr>
      Name<\/td>OEM<\/td><\/tr>
      Description<\/td>Oem<\/td><\/tr>
      Sales Representative<\/td>Sales Rep \u2014 OEM<\/td><\/tr>
      Active<\/td>Yes<\/td><\/tr>
      Default<\/td>No<\/td><\/tr>
      Summary Level<\/td>No<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

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

      This region is associated with the OEM channel managed by A. Pirazzi. By assigning a dedicated Sales Representative to this region, the organisation can track OEM-specific performance, commissions, and order volume independently from other sales territories.<\/p>\n\n\n\n

      Step 5: Configure Sales Region \u2014 Tracked Vehicles Sales Sector<\/strong><\/h3>\n\n\n\n

      Enter the following values:<\/p>\n\n\n\n

      Field<\/strong><\/td>Value<\/strong><\/td><\/tr><\/thead>
      Tenant<\/td>Your Tenant<\/td><\/tr>
      Organisation<\/td>*<\/td><\/tr>
      Search Key<\/td>16<\/td><\/tr>
      Name<\/td>TRACKED VEHICLES SALES SECTOR<\/td><\/tr>
      Description<\/td>
      <\/td><\/tr>
      Sales Representative<\/td>(None assigned)<\/td><\/tr>
      Active<\/td>Yes<\/td><\/tr>
      Default<\/td>No<\/td><\/tr>
      Summary Level<\/td>No<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

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

      This region defines the third commercial sector for tracked vehicles. It groups a segment of the tracked vehicles market under a separate territory identifier, enabling granular sales analysis and facilitating future assignment of a dedicated Sales Representative.<\/p>\n\n\n\n

      Step 7: Save the Record<\/strong><\/h3>\n\n\n\n

      After entering all required field values, save the record using the toolbar: Save (Floppy Disk icon or Alt + S)<\/p>\n\n\n\n

      The record is saved and assigned a unique system identifier. It is now available for use in transactions and business partner assignments.<\/p>\n\n\n\n

      Important: <\/strong>If a mandatory field is left empty, iDempiere will display a validation error. Ensure Search Key and Name are populated before saving.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

      Configuration Examples<\/strong><\/h2>\n\n\n\n

      The following Sales Region records have been configured as part of this setup:<\/p>\n\n\n\n

      Search Key<\/strong><\/td>Name<\/strong><\/td>Description<\/strong><\/td>Sales Representative<\/strong><\/td>Active<\/strong><\/td><\/tr><\/thead>
      sovam<\/td>Point S<\/td>Point-S territory<\/td>\u2014<\/td>Yes<\/td><\/tr>
      18<\/td>OEM<\/td>Oem<\/td>Sales Rep \u2014 OEM<\/td>Yes<\/td><\/tr>
      21<\/td>OEM TRACKED VEHICLES<\/td>Oem<\/td>Sales Rep \u2014 OEM<\/td>Yes<\/td><\/tr>
      16<\/td>16 – TRACKED VEHICLES SALES SECTOR 3<\/td>
      <\/td>      		\u2014<\/td>Yes<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

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

      Sales Regions are integrated into the Distribution transaction flow to ensure every sale is attributed to the correct territory. The diagram below illustrates how the Sales Region record flows through key business processes:<\/p>\n\n\n\n

      By maintaining accurate Sales Region data, finance and sales management teams can generate territory-level revenue reports, monitor representative performance, and identify growth opportunities by region.<\/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 Search Key and Name fields are populated. Both are required before the record can be saved.<\/td><\/tr>
      Sales Region not visible in Business Partner location dropdown<\/td>Confirm the Active field is set to Yes. Inactive records are hidden from transaction dropdowns.<\/td><\/tr>
      Sales Representative field is empty after assignment<\/td>Verify the Sales Representative record exists and is Active in the system before linking.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

      Best Practices<\/strong><\/h2>\n\n\n\n
        \n
      • Use concise, meaningful Search Keys that reflect the territory code or channel abbreviation<\/li>\n\n\n\n
      • Prefix numeric Search Keys with the region number for easy identification in dropdowns (e.g., 16, 18, 21)<\/li>\n\n\n\n
      • Always populate the Description field with the full business name or context for future reference<\/li>\n\n\n\n
      • Set Organisation to<\/strong> * when the Sales Region should be accessible across all organisations<\/li>\n\n\n\n
      • Assign a Sales Representative at the time of region creation to avoid orphaned territories<\/li>\n\n\n\n
      • Avoid using Summary Level unless the region is a parent grouping of child Sales Regions<\/li>\n\n\n\n
      • Review and deactivate obsolete regions rather than deleting them to preserve historical transaction data<\/li>\n<\/ul>\n\n\n\n

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

        After completing the Sales Region configuration, continue with the following setup topics:<\/p>\n\n\n\n

          \n
        • Business Partner \u2014 Link the newly created Sales Regions to customer and vendor records<\/li>\n\n\n\n
        • Sales Representative \u2014 Verify representative records are active and correctly assigned to regions<\/li>\n\n\n\n
        • Price List \u2014 Configure region-specific pricing if applicable to the sales territory<\/li>\n\n\n\n
        • Sales Order \u2014 Create test orders to validate region assignment in live transactions<\/li>\n\n\n\n
        • Reporting Setup \u2014 Configure territory-level sales reports using the Sales Region dimension<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"

          The Sales Region window in iDempiere for Distribution enables organizations to define and manage sales territories, supporting regional reporting, sales […]<\/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-18653","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\/18653","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=18653"}],"version-history":[{"count":0,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/18653\/revisions"}],"wp:attachment":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/media?parent=18653"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/categories?post=18653"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/tags?post=18653"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}