Override custom logic to determine the cash book batch to use when processing sales order payments

A cash book receipt batch is either created or appended to based on static logic. Users want to specify their own logic for determining which cash book batch to append to, or to create a new cash book batch.

Step-by-step guide

Changes have been made that now allow plugins to provide custom logic to determine the cash book receipt batch to use when processing sales order payments.  We have added a new event "GetCashBookObjectForPayment" in the sales order class. In this event, a cash book can be read or a new cashbook entry prepared for subsequent use by the sales order.

Sample plugin (attached) replicates the build-in logic of either finding an existing cash book entry to append to, or creating a new cash book entry.  This applies to version 7.01.00 and higher