{"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-09-18T10:26:28","modified_gmt":"2026-09-18T10:26:28","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<p class=\"wp-block-paragraph\">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<h2 class=\"wp-block-heading\"><strong>Process Flow<\/strong><\/h2>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"853\" height=\"458\" src=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/05\/TenthPlanet-iDempiere-Sales-SalesRegion-ProcessFlow.png\" alt=\"\" class=\"wp-image-28159\" title=\"\" srcset=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/05\/TenthPlanet-iDempiere-Sales-SalesRegion-ProcessFlow.png 853w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/05\/TenthPlanet-iDempiere-Sales-SalesRegion-ProcessFlow-300x161.png 300w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/05\/TenthPlanet-iDempiere-Sales-SalesRegion-ProcessFlow-768x412.png 768w\" sizes=\"auto, (max-width: 853px) 100vw, 853px\" \/><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Prerequisites<\/strong><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Before starting, ensure the following configuration is complete:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Initial Tenant Setup completed successfully<\/li>\n\n\n\n<li>Organisation structure defined and active<\/li>\n\n\n\n<li>Sales Representative records created (if assigning representatives to regions)<\/li>\n\n\n\n<li>Logged in with a role that has access to the Sales Region window<\/li>\n\n\n\n<li>Required administrative permissions granted for master data creation<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Step-by-Step Configuration<\/strong><\/h2>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Step 1: Open the Sales Region Window<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Navigate to the Sales Region window<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"473\" src=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/05\/TenthPlanet-iDempiere-Masters-SalesRegion.png\" alt=\"\" class=\"wp-image-18665\" title=\"\" srcset=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/05\/TenthPlanet-iDempiere-Masters-SalesRegion.png 1024w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/05\/TenthPlanet-iDempiere-Masters-SalesRegion-300x139.png 300w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/05\/TenthPlanet-iDempiere-Masters-SalesRegion-768x355.png 768w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">The window displays all existing Sales Region records in list view.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Step 2: Create a New Record<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">To create a new Sales Region record, click the New Record button in the toolbar: New Record (+)<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A blank form opens. Enter the required field values as described below.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Field Reference<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Search Key<\/strong> \u2014 Unique short code used to identify the Sales Region across the system<\/li>\n\n\n\n<li><strong>Name<\/strong> \u2014 Descriptive name of the Sales Region displayed in transactions and reports<\/li>\n\n\n\n<li><strong>Description<\/strong> \u2014 Additional business context or notes about the region<\/li>\n\n\n\n<li><strong>Sales Representative<\/strong> \u2014 The staff member or agent responsible for this Sales Region<\/li>\n\n\n\n<li><strong>Active<\/strong> \u2014 Controls whether the record is available for use in transactions<\/li>\n\n\n\n<li><strong>Default<\/strong> \u2014 Marks this region as the default selection when no region is specified<\/li>\n\n\n\n<li><strong>Summary Level<\/strong> \u2014 Indicates whether this is a summary (parent) region grouping child records<\/li>\n\n\n\n<li><strong>Tenant<\/strong> \u2014 The client organisation this record belongs to (auto-populated)<\/li>\n\n\n\n<li><strong>Organisation<\/strong> \u2014 Defines the organisational scope of the record; use * for shared records<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Step 3: Configure Sales Region \u2014 Point S<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Enter the following values to create the Point S regional record:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><td><strong>Field<\/strong><\/td><td><strong>Value<\/strong><\/td><\/tr><\/thead><tbody><tr><td>Tenant<\/td><td>Your Tenant<\/td><\/tr><tr><td>Organisation<\/td><td>*<\/td><\/tr><tr><td>Search Key<\/td><td>10000<\/td><\/tr><tr><td>Name<\/td><td>Point S<\/td><\/tr><tr><td>Description<\/td><td>Point-S regional sales territory<\/td><\/tr><tr><td>Sales Representative<\/td><td>(None assigned)<\/td><\/tr><tr><td>Active<\/td><td>Yes<\/td><\/tr><tr><td>Default<\/td><td>No<\/td><\/tr><tr><td>Summary Level<\/td><td>No<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">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<h3 class=\"wp-block-heading\"><strong>Step 4: Configure Sales Region \u2014 OEM<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Enter the following values to create the OEM regional record:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><td><strong>Field<\/strong><\/td><td><strong>Value<\/strong><\/td><\/tr><\/thead><tbody><tr><td>Tenant<\/td><td>Your Tenant<\/td><\/tr><tr><td>Organisation<\/td><td>*<\/td><\/tr><tr><td>Search Key<\/td><td>18<\/td><\/tr><tr><td>Name<\/td><td>OEM<\/td><\/tr><tr><td>Description<\/td><td>Oem<\/td><\/tr><tr><td>Sales Representative<\/td><td>Sales Rep \u2014 OEM<\/td><\/tr><tr><td>Active<\/td><td>Yes<\/td><\/tr><tr><td>Default<\/td><td>No<\/td><\/tr><tr><td>Summary Level<\/td><td>No<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">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<h3 class=\"wp-block-heading\"><strong>Step 5: Configure Sales Region \u2014 Tracked Vehicles Sales Sector<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Enter the following values:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><td><strong>Field<\/strong><\/td><td><strong>Value<\/strong><\/td><\/tr><\/thead><tbody><tr><td>Tenant<\/td><td>Your Tenant<\/td><\/tr><tr><td>Organisation<\/td><td>*<\/td><\/tr><tr><td>Search Key<\/td><td>16<\/td><\/tr><tr><td>Name<\/td><td>TRACKED VEHICLES SALES SECTOR<\/td><\/tr><tr><td>Description<\/td><td><br><\/td><\/tr><tr><td>Sales Representative<\/td><td>(None assigned)<\/td><\/tr><tr><td>Active<\/td><td>Yes<\/td><\/tr><tr><td>Default<\/td><td>No<\/td><\/tr><tr><td>Summary Level<\/td><td>No<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">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<h3 class=\"wp-block-heading\"><strong>Step 7: Save the Record<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">After entering all required field values, save the record using the toolbar: Save (Floppy Disk icon or Alt + S)<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">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<h2 class=\"wp-block-heading\"><strong>Common Issues<\/strong><\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><td><strong>Issue<\/strong><\/td><td><strong>Resolution<\/strong><\/td><\/tr><\/thead><tbody><tr><td>Mandatory field validation error on save<\/td><td>Ensure Search Key and Name fields are populated. Both are required before the record can be saved.<\/td><\/tr><tr><td>Sales Region not visible in Business Partner location dropdown<\/td><td>Confirm the Active field is set to Yes. Inactive records are hidden from transaction dropdowns.<\/td><\/tr><tr><td>Sales Representative field is empty after assignment<\/td><td>Verify the Sales Representative record exists and is Active in the system before linking<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Next Steps<\/strong><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">After completing the Sales Region configuration, continue with the following setup topics:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Business Partner \u2014 Link the newly created Sales Regions to customer and vendor records<\/li>\n\n\n\n<li>Sales Representative \u2014 Verify representative records are active and correctly assigned to regions<\/li>\n\n\n\n<li>Price List \u2014 Configure region-specific pricing if applicable to the sales territory<\/li>\n\n\n\n<li>Sales Order \u2014 Create test orders to validate region assignment in live transactions<\/li>\n\n\n\n<li>Reporting Setup \u2014 Configure territory-level sales reports using the Sales Region dimension<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><div class=\"epyt-video-wrapper\"><iframe loading=\"lazy\"  id=\"_ytid_33027\"  width=\"800\" height=\"450\"  data-origwidth=\"800\" data-origheight=\"450\"  data-relstop=\"1\" src=\"https:\/\/www.youtube.com\/embed\/XCBGkBZrbis?enablejsapi=1&autoplay=0&cc_load_policy=0&cc_lang_pref=&iv_load_policy=1&loop=0&rel=0&fs=1&playsinline=0&autohide=2&theme=dark&color=red&controls=1&disablekb=0&\" class=\"__youtube_prefs__  no-lazyload\" title=\"YouTube player\"  allow=\"fullscreen; accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" referrerpolicy=\"strict-origin-when-cross-origin\" allowfullscreen data-no-lazy=\"1\" data-skipgform_ajax_framebjll=\"\"><\/iframe><\/div>\n","protected":false},"excerpt":{"rendered":"<p>The Sales Region window in iDempiere for Distribution is used to define geographical or operational sales territories that organize customers, [&hellip;]<\/p>\n","protected":false},"author":3,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[10,78],"tags":[],"class_list":["post-18653","post","type-post","status-publish","format-standard","hentry","category-idempiere-product","category-idempiere-sales"],"_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}]}}