{"id":18915,"date":"2026-06-10T11:12:25","date_gmt":"2026-06-10T11:12:25","guid":{"rendered":"https:\/\/tenthplanet.in\/idempiere\/?p=18915"},"modified":"2026-06-10T11:12:27","modified_gmt":"2026-06-10T11:12:27","slug":"configuring-payment-rules-for-business-partners-in-idempiere-retail","status":"publish","type":"post","link":"https:\/\/tenthplanet.in\/idempiere\/configuring-payment-rules-for-business-partners-in-idempiere-retail\/","title":{"rendered":"Configuring Payment Rules for Business Partners in iDempiere Retail"},"content":{"rendered":"\n

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

The Payment Rule field in the iDempiere Business Partner window defines the default payment method assigned to a customer or vendor. It determines how invoices are settled \u2014 whether by cash, cheque, bank transfer, credit card, or on-account credit. iDempiere reads this field automatically during order and payment processing to pre-fill transaction forms.<\/p>\n\n\n\n

In a retail environment, the Payment Rule drives the cashier workflow and provides a default payment method during transaction entry. Each customer account can carry a distinct rule \u2014 for example, walk-in customers may default to cash while corporate accounts use bank transfer. This removes manual selection errors during busy retail hours.<\/p>\n\n\n\n

When a sales order or AR invoice is created, iDempiere copies the Payment Rule from the Business Partner record into the transaction header. Changing the rule on the Business Partner immediately affects all subsequent transactions without any additional setup.<\/p>\n\n\n\n

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

Ensure the following configurations are completed before assigning a Payment Rule in the Business Partner window:<\/p>\n\n\n\n

    \n
  • iDempiere tenant and organization setup is complete.<\/li>\n\n\n\n
  • Chart of Accounts is configured and activated.<\/li>\n\n\n\n
  • Currency is defined and conversion rates are maintained.<\/li>\n\n\n\n
  • Payment Terms records are created (used alongside Payment Rule for invoice scheduling).<\/li>\n\n\n\n
  • Bank Account records are configured if Bank Transfer or Direct Deposit rules will be used.<\/li>\n\n\n\n
  • Payment processor integration is set up if Credit Card rule will be used.<\/li>\n\n\n\n
  • User roles with Business Partner access are assigned to relevant staff.<\/li>\n<\/ul>\n\n\n\n

    Business Rules<\/strong><\/h2>\n\n\n\n
      \n
    • Payment Rule defaults into transactions. <\/strong>When a sales order or invoice is created, iDempiere automatically copies the Payment Rule from the Business Partner record into the transaction.<\/li>\n\n\n\n
    • One Payment Rule per Business Partner. <\/strong>Each Business Partner record carries a single active Payment Rule that applies to all transactions linked to that partner.<\/li>\n\n\n\n
    • Changing the rule is prospective only. <\/strong>Updating the Payment Rule on a Business Partner does not alter existing open invoices; it affects only new transactions created after the change.<\/li>\n\n\n\n
    • Cash and Cheque rules require immediate payment. <\/strong>Business Partners with Cash or Cheque rules are expected to settle at the time of transaction, triggering immediate payment allocation workflows.<\/li>\n\n\n\n
    • Credit and Bank Transfer rules allow deferred payment. <\/strong>On-Account Credit and Direct Deposit rules enable net-term billing, allowing invoices to remain open until the payment due date.<\/li>\n\n\n\n
    • Credit Card rules trigger payment gateway integration. <\/strong>When Credit Card is selected, iDempiere can invoke configured payment processor settings to capture card details during checkout.<\/li>\n\n\n\n
    • Active Business Partner records are available for transactions. <\/strong>Inactive Business Partners cannot be selected on new orders or invoices regardless of their Payment Rule setting.<\/li>\n<\/ul>\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
      The window displays all existing Business Partner records.<\/p>\n\n\n\n
      Use the search bar at the top to locate a specific customer or vendor by name, search key, or tax ID.<\/p>\n\n\n\n
      \"TenthPlanet-iDempiere-Masters-BusinessPartner(PaymentRule)-1\"<\/figure>\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 lists all existing Business Partner records \u2014 customers, vendors, and employees.<\/p>\n\n\n\n
      Each row shows the Search Key, Name, Tax ID, and active status. Use the Filter button or the search bar to locate the record you need to update.<\/p>\n\n\n\n
      \"TenthPlanet-iDempiere-Masters-BusinessPartner(PaymentRule)-2\"<\/figure>\n\n\n\n
      Step 2: Open or Create a Business Partner Record<\/strong><\/h3>\n\n\n\n
      To edit an existing partner, click the row to open the detail form. To create a new Business Partner, click the New Record icon (+) in the toolbar. A blank form opens with mandatory fields highlighted. Complete the header fields before configuring the Payment Rule. The table below lists the key fields in the Business Partner header tab.<\/p>\n\n\n\n
      \"TenthPlanet-iDempiere-Masters-BusinessPartner(PaymentRule)-3\"<\/figure>\n\n\n\n
      Step 3: Navigate to the Payment Rule Field<\/strong><\/h3>\n\n\n\n
      The Payment Rule field is located on the Customer tab within the Business Partner form. Click the Customer tab after filling in the header fields.<\/p>\n\n\n\n
      The Customer tab contains billing, and payment configuration fields that control how iDempiere handles sales transactions for this partner.<\/p>\n\n\n\n
      \"TenthPlanet-iDempiere-Masters-BusinessPartner(PaymentRule)-4\"<\/figure>\n\n\n\n
      Step 4: Set the Payment Rule<\/strong><\/h3>\n\n\n\n
      Locate the Payment Rule drop-down on the Customer tab. Click the field to open the list of available payment options. Select the appropriate rule based on how this Business Partner settles invoices.<\/p>\n\n\n\n
      Payment Rule Options<\/strong><\/h3>\n\n\n\n
      Payment Rule Value<\/strong><\/td>iDempiere Code<\/strong><\/td>Use Case in Retail<\/strong><\/td><\/tr><\/thead>
      Cash<\/td>B<\/td>Walk-in customers paying at the counter with cash.<\/td><\/tr>
      Cheque<\/td>S<\/td>Business accounts submitting physical cheques.<\/td><\/tr>
      Credit Card<\/td>K<\/td>Customers paying by debit or credit card at POS.<\/td><\/tr>
      Direct Deposit<\/td>T<\/td>Vendors and corporate accounts paying by bank transfer.<\/td><\/tr>
      On Credit<\/td>P<\/td>Corporate or loyalty customers with approved credit limits.<\/td><\/tr>
      Mixed POS Payment<\/td>M<\/td>System determines payment handling based on configuration<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
      Field Reference \u2014 Payment Configuration Fields<\/strong><\/h3>\n\n\n\n
      Field<\/strong><\/td>Sample Value<\/strong><\/td>Description<\/strong><\/td><\/tr><\/thead>
      Payment Rule<\/td>On Credit<\/td>Default payment method applied to all transactions for this partner.<\/td><\/tr>
      Payment Term<\/td>Net 30<\/td>Defines the payment due date relative to invoice date.<\/td><\/tr>
      Credit Limit<\/td>50000.00<\/td>Maximum outstanding balance allowed for on-credit customers.<\/td><\/tr>
      Credit Used<\/td>(auto)<\/td>System-calculated field showing total open invoice balance.<\/td><\/tr>
      Credit Status<\/td>Credit OK<\/td>Automatic status based on Credit Used vs Credit Limit.<\/td><\/tr>
      Dunning<\/td>Standard<\/td>Dunning rule applied to overdue invoices for this partner.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
      Step 5: Configure the Vendor Payment Rule<\/strong><\/h3>\n\n\n\n
      If the Business Partner is also a vendor, click the Vendor tab. A separate Payment Rule field is available here. This controls how purchase invoices and vendor payments are processed \u2014 independently of the customer payment setting.<\/p>\n\n\n\n
      Sample Vendor Payment Rule Configuration<\/strong><\/h3>\n\n\n\n
      Name<\/strong><\/td>Customer Payment Rule<\/strong><\/td>Vendor Payment Rule<\/strong><\/td>Organization<\/strong><\/td>Active<\/strong><\/td><\/tr><\/thead>
      Metro Supermart<\/td>On Credit<\/td>\u2014<\/td>*<\/td>Yes<\/td><\/tr>
      Fresh Farms Supplier<\/td>\u2014<\/td>Direct Deposit<\/td>*<\/td>Yes<\/td><\/tr>
      Walk-In Customer<\/td>Cash<\/td>\u2014<\/td>HQ Store<\/td>Yes<\/td><\/tr>
      Corporate Account<\/td>On Credit<\/td>\u2014<\/td>*<\/td>Yes<\/td><\/tr>
      City Stationery Co.<\/td>Credit Card<\/td>Cheque<\/td>*<\/td>Yes<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
      Step 6: Save the Business Partner Record<\/strong><\/h3>\n\n\n\n
      Click the Save icon (disk icon in the toolbar) or Alt + S to save the record. iDempiere validates all mandatory fields before saving.<\/p>\n\n\n\n
      Once saved, the Payment Rule is immediately active. The next sales order or purchase order created for this Business Partner will automatically carry the configured payment method.<\/p>\n\n\n\n
      Step 7: Activate or Deactivate a Business Partner<\/strong><\/h3>\n\n\n\n
      The Active checkbox on the Business Partner header controls availability across all of iDempiere. Unchecking Active immediately removes the partner from all transaction lookups \u2014 no orders, invoices, or payments can reference an inactive Business Partner.<\/p>\n\n\n\n
      Use deactivation instead of deletion to preserve transaction history. Deleted records break the audit trail of historical invoices and payments.<\/p>\n\n\n\n
        \n
      • Active = Yes: <\/strong>Business Partner is available for orders, invoices, payments, and reports.<\/li>\n\n\n\n
      • Active = No: <\/strong>Business Partner is hidden from transaction windows but all historical data is retained.<\/li>\n<\/ul>\n\n\n\n
        Configuration Summary<\/strong><\/h2>\n\n\n\n
        Configuration Item<\/strong><\/td>Purpose<\/strong><\/td><\/tr><\/thead>
        Business Partner Header<\/td>Defines the partner identity \u2014 name, tax ID, organization.<\/td><\/tr>
        Customer Flag<\/td>Enables the Customer tab where Payment Rule is set.<\/td><\/tr>
        Payment Rule (Customer)<\/td>Sets the default payment method for all sales transactions.<\/td><\/tr>
        Payment Term<\/td>Defines invoice due date and discount terms.<\/td><\/tr>
        Credit Limit<\/td>Controls maximum outstanding balance for on-credit accounts.<\/td><\/tr>
        Vendor Flag<\/td>Enables the Vendor tab for purchase-side payment configuration.<\/td><\/tr>
        Payment Rule (Vendor)<\/td>Sets the default payment method for all purchase transactions.<\/td><\/tr>
        Active Flag<\/td>Controls whether the Business Partner is available for use.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
        Business Flow Overview<\/strong><\/h2>\n\n\n\n
        \n
        Business Partner \u2014 Payment Rule Configured<\/strong><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
        \u2193<\/strong><\/p>\n\n\n\n
        Sales Order Created \u2192 Payment Rule Auto-Populated<\/strong><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
        \u2193<\/strong><\/p>\n\n\n\n
        AR Invoice Generated \u2192 Payment Rule Carried Forward<\/strong><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
        \u2193<\/strong><\/p>\n\n\n\n
        Payment Allocation \u2192 Method Matches Rule<\/strong><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
        \u2193<\/strong><\/p>\n\n\n\n
        Accounting Entry Posted \u2192 AR \/ Cash \/ Bank Updated<\/strong><\/td><\/tr><\/tbody><\/table><\/figure>\n<\/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>
        Payment Rule not visible on Customer tab<\/td>Customer checkbox is unchecked on header tab.<\/td>Enable the Customer flag on the Business Partner header, then save.<\/td><\/tr>
        Wrong payment method defaults on sales order<\/td>Payment Rule on Business Partner is set incorrectly.<\/td>Update the Payment Rule on the Customer tab and save. Re-create the order.<\/td><\/tr>
        On Credit rule allows unlimited purchases<\/td>Credit Limit field is set to 0 (unlimited).<\/td>Enter an appropriate Credit Limit value on the Customer tab.<\/td><\/tr>
        Business Partner not appearing in order lookup<\/td>Active checkbox is unchecked.<\/td>Reactivate the Business Partner if it is still in use.<\/td><\/tr>
        Payment Term not respecting Payment Rule<\/td>Payment Term and Payment Rule are independent fields.<\/td>Ensure both Payment Rule and Payment Term are set correctly on the partner.<\/td><\/tr>
        Vendor invoices using wrong payment method<\/td>Vendor Payment Rule was not set on the Vendor tab.<\/td>Navigate to the Vendor tab and set the correct Payment Rule.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
        Next Steps<\/strong><\/h2>\n\n\n\n
        After configuring the Payment Rule in the iDempiere Business Partner window, proceed with:<\/p>\n\n\n\n
          \n
        • Configure Payment Terms to define invoice due dates and early payment discounts.<\/li>\n\n\n\n
        • Set up Bank Accounts and link them to the Business Partner for Direct Deposit transactions.<\/li>\n\n\n\n
        • Configure Payment Processors for Credit Card integration at point-of-sale.<\/li>\n\n\n\n
        • Define Dunning rules to automate overdue payment reminders for On Credit customers.<\/li>\n\n\n\n
        • Review the Customer Account report to validate that Payment Rules are applied correctly across all active Business Partners.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"
          Introduction The Payment Rule field in the iDempiere Business Partner window defines the default payment method assigned to a customer […]<\/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-18915","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\/18915","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=18915"}],"version-history":[{"count":5,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/18915\/revisions"}],"predecessor-version":[{"id":18926,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/18915\/revisions\/18926"}],"wp:attachment":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/media?parent=18915"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/categories?post=18915"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/tags?post=18915"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}