{"id":18583,"date":"2026-05-27T10:32:30","date_gmt":"2026-05-27T10:32:30","guid":{"rendered":"https:\/\/tenthplanet.in\/idempiere\/?p=18583"},"modified":"2026-06-05T05:58:34","modified_gmt":"2026-06-05T05:58:34","slug":"how-to-configure-the-warehouse-and-locators-in-idempiere-for-retail","status":"publish","type":"post","link":"https:\/\/tenthplanet.in\/idempiere\/how-to-configure-the-warehouse-and-locators-in-idempiere-for-retail\/","title":{"rendered":"How to Configure the Warehouse and Locators in iDempiere for Retail"},"content":{"rendered":"\n

Learn how to configure Warehouse and Locators in iDempiere for retail inventory management, stock transfers, and multi-store operations.<\/p>\n\n\n\n

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

The Warehouse<\/strong> window in iDempiere is used to create inventory storage locations for purchasing, stock transfers, inventory management, and sales operations. A Warehouse<\/strong> defines where inventory is stored, while a Locator<\/strong> defines the exact storage position inside the warehouse.<\/p>\n\n\n\n

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

Before starting, ensure the following are completed:<\/p>\n\n\n\n

    \n
  • Initial Tenant Setup completed successfully<\/li>\n\n\n\n
  • Organizations created and configured<\/li>\n\n\n\n
  • Warehouse address details are available<\/li>\n<\/ul>\n\n\n\n

    Business Rules<\/strong><\/h2>\n\n\n\n
      \n
    • Each warehouse must contain at least one active locator before inventory transactions begin.<\/li>\n\n\n\n
    • Reservation Locator should be assigned to define the default inventory storage location.<\/li>\n\n\n\n
    • In Transit warehouse should only be used for stock transfer movements between locations.<\/li>\n\n\n\n
    • Disallow Negative Inventory should remain enabled to avoid stock inconsistencies during retail operations.<\/li>\n\n\n\n
    • Replenishment rules should be configured before running automated stock movement or reorder processes.<\/li>\n<\/ul>\n\n\n\n

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

      Step 1: Open the Warehouse Window<\/h3>\n\n\n\n

      In iDempiere, navigate to:<\/p>\n\n\n\n

      Menu \u2192Material Management and Pricing<\/strong> \u2192Material Management Rules \u2192Warehouse & Locators<\/strong><\/p>\n\n\n\n

      The window displays all warehouse records available under the tenant.<\/p>\n\n\n\n

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

      Click New Record (+)<\/strong> to begin entering warehouse information.<\/p>\n\n\n\n

      Use unique warehouse Search Keys and Names to avoid duplicate warehouse creation and improve inventory management clarity.<\/p>\n\n\n\n

      Disclaimer:<\/strong> All data in this document are illustrative samples and not intended for real-world use.<\/p>\n\n\n\n

      Field Reference<\/strong><\/p>\n\n\n\n

      Field<\/strong><\/td>Purpose<\/strong><\/td><\/tr>
      Search Key<\/td>Short code used to identify the warehouse<\/td><\/tr>
      Name<\/td>Warehouse name displayed in transactions<\/td><\/tr>
      Description<\/td>Additional warehouse information<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

      Retail Warehouse Structure<\/strong><\/h2>\n\n\n\n

      Retail businesses commonly maintain multiple warehouse types based on operational requirements.<\/p>\n\n\n\n

      Warehouse Type<\/th>Business Usage<\/th><\/tr><\/thead>
      Godown<\/td>Main inventory storage location<\/td><\/tr>
      Selling Floor<\/td>Inventory available directly for customer sales<\/td><\/tr>
      InTransit Warehouse<\/td>Temporary inventory movement during stock transfers<\/td><\/tr>
      Return Warehouse<\/td>Returned or damaged product handling<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

      Step 3: Configure CDC Godown Warehouse<\/strong><\/h3>\n\n\n\n

      Enter the following details for the main central distribution warehouse:<\/p>\n\n\n\n

      Field<\/strong><\/td>Value<\/strong><\/td><\/tr>
      Organization<\/td>CDC<\/td><\/tr>
      Search Key<\/td>CDCGD<\/td><\/tr>
      Name<\/td>CDC Godown<\/td><\/tr>
      Description<\/td>Central Distribution Center Main Inventory Warehouse<\/td><\/tr>
      Address<\/td>POTS Head Office, No.145, GST Road, Guindy Industrial Estate, Chennai – 600032<\/td><\/tr>
      Element Separator<\/td>–<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

      Enable: \u2714 Disallow Negative Inventory<\/strong><\/p>\n\n\n\n

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

      Step 4: Configure CDC InTransit Warehouse<\/h3>\n\n\n\n

      Enter the following details for the transit warehouse:<\/p>\n\n\n\n

      Field<\/strong><\/td>Value<\/strong><\/td><\/tr>
      Organization<\/td>CDC<\/td><\/tr>
      Search Key<\/td>CDCIT<\/td><\/tr>
      Name<\/td>CDC InTransit Warehouse<\/td><\/tr>
      Description<\/td>Temporary warehouse used during stock transfers<\/td><\/tr>
      Source Warehouse<\/td>CDC Godown<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

      Enable: \u2714 In Transit<\/strong><\/p>\n\n\n\n

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

      Step 5: Configure CDC Return Warehouse<\/strong><\/h3>\n\n\n\n
      Field<\/strong><\/td>Value<\/strong><\/td><\/tr>
      Organization<\/td>CDC<\/td><\/tr>
      Search Key<\/td>CDCRT<\/td><\/tr>
      Name<\/td>CDC Return Warehouse<\/td><\/tr>
      Description<\/td>Warehouse for returned and damaged inventory<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
      \"\"<\/figure>\n\n\n\n

      Step 6: Configure Store Warehouses<\/h3>\n\n\n\n

      Create warehouses based on each store’s operations. Refer to the tables below.<\/p>\n\n\n\n

      Chennai Store<\/h4>\n\n\n\n
      Organization<\/strong><\/td>Search Key<\/strong><\/td>Name<\/strong><\/td><\/tr>
      Chennai Store<\/td>CHNSF<\/td>Chennai Selling Floor<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

      Pondicherry Store<\/h4>\n\n\n\n
      Organization<\/strong><\/td>Search Key<\/strong><\/td>Name<\/strong><\/td><\/tr>
      Pondicherry Store<\/td>PDYGD<\/td>Pondicherry Godown<\/td><\/tr>
      Pondicherry Store<\/td>PDYSF<\/td>Pondicherry Selling Floor<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

      Trivandrum Store<\/h4>\n\n\n\n
      Organization<\/strong><\/td>Search Key<\/strong><\/td>Name<\/strong><\/td><\/tr>
      Trivandrum Store<\/td>TVMGD<\/td>Trivandrum Godown<\/td><\/tr>
      Trivandrum Store<\/td>TVMSF<\/td>Trivandrum Selling Floor<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

      Warehouse Purpose Reference<\/h4>\n\n\n\n
      Warehouse Type<\/strong><\/td>Purpose<\/strong><\/td><\/tr>
      Godown<\/td>Stores inventory locally before moving stock to selling areas<\/td><\/tr>
      Selling Floor<\/td>Inventory available directly for customer sales<\/td><\/tr>
      InTransit Warehouse<\/td>Virtual warehouse used during stock movement in iDempiere<\/td><\/tr>
      Return Warehouse<\/td>Stores returned products for review and further processing<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
      \"\"<\/figure>\n\n\n\n

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

      Click Save<\/strong> after entering all warehouse details. Proceed to configure locators once saved.<\/p>\n\n\n\n

      Step 8: Create a Locator<\/h3>\n\n\n\n

      Navigate to Warehouse \u2192 Locator<\/strong> tab, then click New Record (+)<\/strong>.<\/p>\n\n\n\n

      Only one locator is configured initially for each warehouse to keep the setup simple.<\/p>\n\n\n\n

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

        \n
      • Locator Type: <\/strong>Storage<\/li>\n\n\n\n
      • Relative Priority: <\/strong>100<\/li>\n\n\n\n
      • Enable: <\/strong>Default & Active<\/li>\n<\/ul>\n\n\n\n

        Step 9: Configure Locator Values<\/h3>\n\n\n\n

        Use the following locator structure for each iDempiere warehouse:<\/p>\n\n\n\n

        Warehouse<\/strong><\/td>Locator Name<\/strong><\/td><\/tr>
        CDC Godown<\/td>Godown Locator<\/td><\/tr>
        CDC InTransit Warehouse<\/td>InTransit Locator<\/td><\/tr>
        CDC Return Warehouse<\/td>Return Locator<\/td><\/tr>
        Chennai Selling Floor<\/td>Selling Locator<\/td><\/tr>
        Pondicherry Godown<\/td>Godown Locator<\/td><\/tr>
        Pondicherry Selling Floor<\/td>Selling Locator<\/td><\/tr>
        Trivandrum Godown<\/td>Godown Locator<\/td><\/tr>
        Trivandrum Selling Floor<\/td>Selling Locator<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

        Note: <\/strong>The locator acts as the default inventory storage location inside each warehouse. Additional locators can be created later if separate storage zones are required.<\/p>\n\n\n\n

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

        Step 10: Configure the Reservation Locator<\/h3>\n\n\n\n

        Return to the warehouse header record and select the created locator in the Reservation Locator<\/strong> field. Click Save<\/strong>.<\/p>\n\n\n\n

        This links the locator as the default warehouse storage location in iDempiere.<\/p>\n\n\n\n

        Step 11: Configure Replenishment Rules<\/strong><\/h3>\n\n\n\n

        Navigate to:<\/strong> Warehouse \u2192 Replenish Tab<\/p>\n\n\n\n

        Configure replenishment rules to maintain inventory availability based on minimum and maximum stock levels.<\/p>\n\n\n\n

        Common Replenishment Types:<\/p>\n\n\n\n

        Type<\/th>Usage<\/th><\/tr><\/thead>
        Manual<\/td>Replenishment handled manually<\/td><\/tr>
        Reorder Below Minimum Level<\/td>Generates replenishment when stock falls below minimum quantity<\/td><\/tr>
        Maintain Maximum Level<\/td>Maintains inventory up to defined maximum quantity<\/td><\/tr>
        Custom<\/td>Business-specific replenishment handling<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

        This configuration helps retail businesses automate inventory planning and stock movement between warehouses.<\/p>\n\n\n\n

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

        Step 12: Inventory Flow Overview<\/h3>\n\n\n\n

        Inventory movement in iDempiere follows the structure below:<\/p>\n\n\n\n

        Purchase Flow:<\/strong><\/p>\n\n\n\n

        Purchase \u2192 CDC Godown \u2192 InTransit \u2192 Store Godown \u2192 Selling Floor \u2192 Customer Sale<\/p>\n\n\n\n

        Return Flow:<\/strong><\/p>\n\n\n\n

        Customer Return \u2192 CDC Return Warehouse<\/p>\n\n\n\n

        Common Issues and Resolutions<\/strong><\/h2>\n\n\n\n
        Issue<\/strong><\/td>Resolution<\/strong><\/td><\/tr>
        Mandatory field validation error while saving<\/td>Verify all required fields are populated<\/td><\/tr>
        Reservation Locator unavailable<\/td>Create and save the locator first before assigning<\/td><\/tr>
        Locator not available for selection<\/td>Save the locator record before assigning it to a warehouse<\/td><\/tr>
        Changes not reflected in iDempiere<\/td>Execute Cache Reset and log in again if required<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

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

        After completing the Warehouse and Locator setup in iDempiere, continue with the following configurations:<\/p>\n\n\n\n

          \n
        1. Calendar Year & Period<\/li>\n\n\n\n
        2. Product Category Setup<\/li>\n\n\n\n
        3. Product Setup<\/li>\n<\/ol>\n\n\n\n

          <\/p>\n","protected":false},"excerpt":{"rendered":"

          Learn how to configure Warehouse and Locators in iDempiere for retail inventory management, stock transfers, and multi-store operations. Introduction The […]<\/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-18583","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\/18583","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=18583"}],"version-history":[{"count":2,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/18583\/revisions"}],"predecessor-version":[{"id":18720,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/18583\/revisions\/18720"}],"wp:attachment":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/media?parent=18583"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/categories?post=18583"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/tags?post=18583"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}