{"id":17633,"date":"2026-01-29T12:00:14","date_gmt":"2026-01-29T12:00:14","guid":{"rendered":"https:\/\/tenthplanet.in\/idempiere\/?p=17633"},"modified":"2026-01-29T12:00:17","modified_gmt":"2026-01-29T12:00:17","slug":"how-customer-locations-and-contract-prices-work-in-idempiere","status":"publish","type":"post","link":"https:\/\/tenthplanet.in\/idempiere\/how-customer-locations-and-contract-prices-work-in-idempiere\/","title":{"rendered":"How Customer Locations and Contract Prices Work in iDempiere"},"content":{"rendered":"\n

This guide explains how Customer Locations<\/strong> and Contract Prices<\/strong> work together in iDempiere to control delivery, billing, and customer-specific pricing. Though configured separately, both apply automatically during sales orders, shipments, and invoices without manual intervention.<\/p>\n\n\n\n

Customer Locations<\/strong><\/h2>\n\n\n\n

Customer Locations represent all valid addresses associated with a customer. Each location can serve a different purpose in the sales lifecycle, such as delivery, invoicing, or payment settlement. A single customer can have multiple locations, and each location can be activated or deactivated independently.<\/p>\n\n\n\n

When a Sales Order is created, iDempiere selects the appropriate customer location based on its address roles. These roles determine where goods are shipped<\/strong>, where invoices are sent<\/strong>, and which address is used for financial settlement<\/strong>.<\/p>\n\n\n\n

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

Each location is tied directly to the Business Partner and becomes selectable in Sales Orders, Shipments, and Invoices.<\/p>\n\n\n\n

Key Location Configuration<\/h3>\n\n\n\n
    \n
  • Name<\/strong>
    Logical name for the address (e.g., Chennai, Bangalore Warehouse)<\/li>\n\n\n\n
  • Address<\/strong>
    Full postal address used on documents and logistics<\/li>\n\n\n\n
  • Ship Address<\/strong>
    Used for Shipment and Delivery<\/strong> documents<\/li>\n\n\n\n
  • Invoice Address<\/strong>
    Used for Invoice generation<\/strong><\/li>\n\n\n\n
  • Pay-From Address<\/strong>
    Used when customer makes payments<\/li>\n\n\n\n
  • Remit-To Address<\/strong>
    Used for accounting settlement references<\/li>\n\n\n\n
  • Sales Region<\/strong>
    Used for regional reporting and sales analysis<\/strong><\/li>\n\n\n\n
  • Active<\/strong>
    Controls whether the address is selectable in transactions<\/li>\n<\/ul>\n\n\n\n

    A customer location marked as Ship Address<\/strong> will automatically appear in the Sales Order shipping section. If multiple locations exist, users can choose the appropriate one for per order.<\/p>\n\n\n\n

    Contract Prices<\/strong><\/h2>\n\n\n\n

    Contract Prices define customer-specific pricing agreements<\/strong> for products. These prices override the standard price list when a Sales Order is created for the customer. Contract Prices are optional but critical when pricing differs by customer, volume, or agreement.<\/p>\n\n\n\n

    Contract Prices are evaluated after the Price List<\/strong> and before manual price overrides<\/strong>, ensuring consistent pricing enforcement.<\/p>\n\n\n\n

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

    Each Contract Price is linked to a specific Customer + Product<\/strong> combination and can be time-bound.<\/p>\n\n\n\n

    Key Contract Price Configuration<\/h3>\n\n\n\n
      \n
    • Product<\/strong>
      The product for which the special price applies<\/li>\n\n\n\n
    • Valid From \/ Valid To<\/strong>
      Controls the effective period of the contract price<\/li>\n\n\n\n
    • Price Override Type<\/strong>
      Determines how pricing is applied (fixed price or discount)<\/li>\n\n\n\n
    • Break Value<\/strong>
      Quantity threshold for volume-based pricing<\/li>\n\n\n\n
    • Active<\/strong>
      Controls whether the contract price is applied<\/li>\n<\/ul>\n\n\n\n

      Once saved, the Contract Price requires no manual selection. iDempiere automatically applies it during Sales Order line entry if conditions match.<\/p>\n\n\n\n

      How These Two Work Together in Sales Flow<\/strong><\/h2>\n\n\n\n

      When a Sales Order is created, iDempiere first resolves the Customer Location<\/strong> to determine logistics and billing addresses. Immediately after, it evaluates Contract Prices<\/strong> to determine the correct product pricing. If a matching Contract Price exists for the selected product and date range, the system replaces the standard price list value automatically. The user does not need to select or confirm the contract price manually.<\/p>\n\n\n\n

      This ensures that delivery, billing, and pricing rules are consistently enforced<\/strong> across all downstream documents such as Shipment, Invoice, and Payment.<\/p>\n\n\n\n

      Purpose and Use Cases<\/strong><\/h2>\n\n\n\n

      Customer Locations allow businesses to manage customers with multiple branches, warehouses, or billing offices<\/strong> without duplicating customer records. Contract Prices enable sales teams to honor negotiated pricing while maintaining centralized price control.<\/p>\n\n\n\n

      Common use cases include:<\/p>\n\n\n\n

        \n
      • Supplying goods to different branch locations under one customer<\/li>\n\n\n\n
      • Offering special prices to key customers or distributors<\/li>\n\n\n\n
      • Managing regional delivery and billing requirements<\/li>\n\n\n\n
      • Preventing pricing errors during order entry<\/li>\n<\/ul>\n\n\n\n

        Outcome<\/strong><\/h2>\n\n\n\n

        Once Customer Locations and Contract Prices are correctly configured:<\/p>\n\n\n\n

          \n
        • Sales Orders automatically use the correct delivery and invoice address<\/strong><\/li>\n\n\n\n
        • Product prices are applied accurately without manual overrides<\/strong><\/li>\n\n\n\n
        • Shipments and invoices remain consistent and audit-ready<\/strong><\/li>\n\n\n\n
        • Sales teams work faster with zero pricing ambiguity<\/strong><\/li>\n\n\n\n
        • Accounting and logistics operate on clean, structured master data<\/strong><\/li>\n<\/ul>\n\n\n\n

          This setup ensures that customer-specific logistics and pricing are enforced by the system<\/strong>, not dependent on user judgement.<\/p>\n\n\n\n

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

          This guide explains how Customer Locations and Contract Prices work together in iDempiere to control delivery, billing, and customer-specific pricing. […]<\/p>\n","protected":false},"author":19,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[38],"tags":[],"class_list":["post-17633","post","type-post","status-publish","format-standard","hentry","category-master"],"acf":[],"_links":{"self":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/17633","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\/19"}],"replies":[{"embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/comments?post=17633"}],"version-history":[{"count":0,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/17633\/revisions"}],"wp:attachment":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/media?parent=17633"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/categories?post=17633"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/tags?post=17633"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}