How to Process Vendor Payments Using Payment Selection in iDempiere for Retail

Payment Selection is the iDempiere process used to identify vendor invoices eligible for payment, group them into a batch, and generate vendor payments. In retail operations, it bridges Accounts Payable invoices and actual vendor settlement, supporting payment methods such as Check, Direct Deposit, and Direct Debit.

Once processed, the selected AP Invoice is automatically allocated against the generated payment and marked as Paid, directly impacting vendor balances and cash management.

Process Flow Diagram

PaymentSelection

Business Rules

  • AP Invoice must be Completed and Posted before it qualifies for payment.
  • AP Invoice must have an outstanding balance to be selected.
  • Invoice Payment Rule must match the Payment Selection Payment Rule.
  • Payment Selection Lines are generated only for eligible invoices.
  • Prepared Payments must be generated before Payment Print/Export.
  • Check payments require a Bank Account Document configuration.
  • Payment Print/Export creates the actual Payment records.
  • Successful payment processing automatically updates the invoice Paid status.
  • Processed Payment Selection Lines become read-only.
  • One Payment Per Invoice creates a separate payment for each invoice.

Prerequisites

Ensure the following configurations are completed:

  • Vendor (Business Partner) configured.
  • Purchase Order completed.
  • Material Receipt completed.
  • AP Invoice completed and posted.
  • Vendor Payment Rule configured.
  • Bank Account configured.
  • Payment Rule available for the selected Bank Account.
  • Bank Account Document configured for Check payments.

Steps to Steps Configuration

Step 1: Create Payment Selection

Create a New Payment Selection document that will be used to collect and process vendor invoices for payment.

  • Open the Payment Selection window and click New Record.
  • Select Organization, Bank Account, and Payment Date, then save to generate the document
TenthPlanet iDempiere Transaction PaymentSelection

Header Configuration

FieldSample ValueMandatoryDescription
OrganizationCDCYesOrganization processing the payment
Bank AccountVendor Payment_123456YesSource account used for payment
Payment Date16-Jun-2026YesDate the payment batch is processed
One Payment Per InvoiceUncheckedNoCreates a separate payment per invoice when enabled
Total AmountAuto CalculatedAutoSum of selected invoice amounts

Save the record.

A new Payment Selection document is successfully created.

Step 2: Generate Payment Selection Lines (Create From)

Create From retrieves vendor invoices that are eligible for payment based on the configured filters.

  • Click Create From on the Payment Selection header.
  • Set filters such as Only Due, Only Positive Balance, and Payment Rule, then click OK to pull eligible invoices.
TenthPlanet iDempiere Transaction PaymentSelection1

Create From Parameters

FieldSample ValueDescription
Business Partner GroupBlankRestrict vendor group
Business PartnerBlankRestrict specific vendor
Only DiscountUncheckedSelect discount-eligible invoices only
Only DueCheckedSelect invoices currently due
Due DateCurrent DateDue date filter
Include DisputedUncheckedInclude disputed invoices
Match RequirementNoneInvoice matching requirement
Payment RuleCheckInvoice payment method
Only Positive BalanceCheckedSelect invoices with balance due
Document TypeBlankRestrict invoice document type
Run as JobUncheckedBackground execution

Eligible AP Invoice records are added as Payment Selection Lines.

Step 3: Review Payment Selection Line

Reviewing the line confirms invoice and payment details before payment preparation.

  • Open the generated Payment Selection Line and verify Invoice, Payment Rule, Open Amount, and Payment Amount before proceeding.
FieldSample ValueMandatoryDescription
Invoice1000006_06/16/2026_14602.50AutoSelected invoice reference
Payment RuleCheckYesPayment method applied to the line
Open Amount14,602.50AutoOutstanding invoice amount
Payment Amount14,602.50YesAmount to be paid
Discount Amount0.00NoDiscount applied to the payment
Write-off Amount0.00NoAmount written off, if any
TenthPlanet iDempiere Transaction PaymentSelection2

Step 4: Prepare Payments

Prepare Payment converts the selection line into a payment instruction prior to actual payment generation.

  • Click Prepare Payment on the Payment Selection header.
  • Leave Override Payment Rule blank unless changing the method, then click OK.

Prepare Payment Parameters

FieldSample ValueMandatoryDescription
Override Payment RuleBlankNoReplaces the invoice payment rule if set
Run as JobUncheckedNoRuns the process in the background
TenthPlanet iDempiere Transaction PaymentSelection3

The system creates Prepared Payment records.

Step 5: Review Prepared Payment

The Prepared Payment confirms the payment instruction before the actual payment is generated.

  • Open the Prepared Payment tab and verify Business Partner, Payment Rule, and Payment Amount.
  • Processed and Printed remain unchecked at this stage.
FieldSample ValueMandatoryDescription
Business PartnerHAVELLS INDIA MARTAutoVendor receiving the payment
Payment RuleCheckAutoPayment method carried from the line
Payment Amount14,602.50AutoAmount to be paid to the vendor
Document No1000000AutoPrepared Payment reference number
ProcessedUncheckedAutoUpdates after Payment Print/Export

At this stage, no actual payment exists yet. Prepared Payment exists and is awaiting payment generation.

TenthPlanet iDempiere Transaction PaymentSelection4

Step 6: Configure Bank Account Document

A valid check sequence must exist before checks can be generated for the bank account.

  • Navigate to Bank Account Document under Cash Management.
  • Create a record with Payment Rule set to Check and assign a Current Next number for the Bank Account.
FieldSample ValueMandatoryDescription
NameVendor Check SeriesYesIdentifies the check document series
Payment RuleCheckYesRestricts the series to check payments
Current Next1000YesNext check number to be issued
Bank AccountVendor Payment_123456YesBank account linked to the series
TenthPlanet iDempiere Transaction PaymentSelection5

Step 7: Execute Payment Print/Export

This step generates the actual AP Payment from the Prepared Payment and assigns check numbers.

  • Navigate to Payment Print/Export, select the Payment Selection, and confirm the prompt to create and complete payments.
TenthPlanet iDempiere Transaction PaymentSelection6
FieldSample ValueDescription
PromptIs the payment print correct?Confirmation shown before payment creation
ActionClick YesCreates and completes the AP Payment
TenthPlanet iDempiere Transaction PaymentSelection7

Step 8: Verify the Generated AP Payment

Confirms the payment document was created and posted correctly against the vendor.

  • Open the generated Payment document and verify Document Type, Payment Amount, Tender Type, Check No, and Document Status.
FieldSample ValueMandatoryDescription
Document TypeAP PaymentAutoIdentifies the payment document type
Payment Amount14,602.50AutoAmount paid to the vendor
Tender TypeCheckAutoPayment method used
Check No1000001AutoGenerated check number
Document StatusCompletedAutoConfirms the payment is finalized
PostedYesAutoConfirms accounting entries are posted
TenthPlanet iDempiere Transaction PaymentSelection8

Step 9: Verify AP Invoice Settlement

Confirms the invoice is fully settled once the payment has been allocated.

  • Open the AP Invoice and confirm the Paid checkbox is enabled, with Document Status remaining Completed and Posted.
FieldSample ValueMandatoryDescription
Invoice1000006AutoSettled invoice reference
Grand Total14,602.50AutoTotal invoice amount
PaidCheckedAutoConfirms the invoice is fully settled
Document StatusCompletedAutoConfirms the invoice remains finalized

The AP Invoice is fully paid and removed from outstanding payables.

TenthPlanet iDempiere Transaction PaymentSelection10

Common Issues and Resolutions

IssueCauseResolution
No Payment Selection Lines generatedInvoice not eligible for paymentVerify invoice status, due date, balance, and payment rule.
Payment Selection Line not createdPayment Rule mismatchEnsure Invoice Payment Rule matches Payment Selection Payment Rule.
Prepared Payment not generatedNo Payment Selection Lines availableGenerate Payment Selection Lines first.
“No Bank Account Documents (Checks)” errorMissing Bank Account Document configurationCreate a Bank Account Document with the Check payment rule.
Payment not created after Prepare PaymentPayment Print/Export not executedExecute Payment Print/Export.
Invoice remains unpaidAP Payment not completed or allocatedVerify the Payment document status and allocation.
Check number not assignedBank Account Document sequence exhaustedUpdate Current Next on the Bank Account Document.
Payment Selection Line is read-onlyLine has already been processedCreate a new Payment Selection for additional invoices.

Next Steps

Continue periodic payment processing using Payment Selection.

  • Verify AP Payment accounting entries.
  • Reconcile the payment with the bank statement.
  • Review vendor account balances.
  • Monitor and maintain Bank Account Document sequences.