025234: Purchase order payment allocation #105632
1. Overview
KCSL have added an option that will allow users to allocate 'prepayments' to Purchase Orders. Upon posting of the associated Purchase Invoice, Khaos Control will attempt to allocate these payments to the invoice.
2. Specification
Khaos Control will be modified to add an option such that:
1. A new "Supplier Prepayments" screen will be added to allow managing prepayments with the following tabs:
Tab 1:
- Select a supplier
- Populates a grid below with Purchase Orders, by default will return all not-fully-delivered Purchase Orders for the selected supplier, however will allow viewing fully delivered Purchase Orders and filtering by date range. The grid shows Purchase Order details plus total of linked payments.
- When a PO is selected, a second grid will be populated with a list of payments linked to that PO, along with the user who linked it and the date the link was made.
- A third grid shows a list of payments available to link to the Purchase Order. Payments may be dragged onto the second grid to link them to the selected Purchase Order
- It will be possible to remove items from the second grid to unlink the payment from the Purchase Order.
Tab 2: Reports
- Grid listing Purchase Orders with basic details (PO code, date), PO total, and total of linked payments.
- Filters on supplier, PO date range, link date, and user who made link.
- Will return one row per PO/payment (i.e. a PO with three payments will have three rows in the report grid), and columns for PO Total, Payment Amount, Total Payments Amount, Outstanding Amount (zero if full amount linked).
- Will allow grouping by PO code to roll up data by PO (i.e. a PO with three payments will have only one row in the report grid showing the sum of the linked payments).
In addition, the existing Purchase Order screen will be modified such that there will be a new header tab containing a read-only grid detailing any payments that are linked to the open PO, so the user can see when a PO has associated payments.
When a Purchase Invoice is issued, if the PI came from a PO with linked payments, linked payments will be allocated to the PI where possible, starting with oldest link. If the PI amount and total of linked payments does not match, the PI may not be fully paid or allocated, however it will be possible to manually allocate further payments as at present.
Note: credit notes related to purchases will be included as part of this development - in terms of being able to use to allocate and being shown in the reporting.
3. Configuration
An updated application and changelog will be provided. A hidden option will be enabled to enable this functionality. No further configuration is required.4. Usage - New Screens.
The [ Supplier | Supplier Prepayments ] tab
This tab consists of three grids: the PO grid, the Prepay Allocations grid, and the Available Credits/Payments grid. This screen allows you to pre-allocate payments to Purchase Orders.
- Shows a list of Purchase Orders that can have prepayments allocated to them.
- Can be filtered on using the filters at the top of the screen.
- Will filter by PO date for the last three months, and only show non-fully delivered POs.
- Contains the following columns:
- Supplier.
- PO code.
- PO date - this is the date the PO was created.
- PO total - the order total of the PO.
- Alloc Amount - the total of the prepayments that have been allocated to this PO. Note, this column requires a screen refresh (using the refresh button or by clicking 'Go') to update.
- Has two right-click options: Goto Supplier and Goto Purchase Order.
The bottom-left 'Prepay Allocations' grid:
- Shows a list of payments that have been pre-allocated to the PO selected in the top grid.
- This will populate based on the PO selected in the top grid.
- Contains the following columns:
- Source Code - the Source # against the payment in [ Supplier | Detail | Statement ].
- Source Amount - the total of the payment.
- Alloc User - the Khaos Control user that allocated the payment to the selected PO.
- Alloc Date - the date that the payment was allocated to the selected PO. It is this date that will be used when attempting to allocate payments to a Purchase Invoice.
- Has one right-click option: Remove prepayment(s).
- This can be used on one line, or used on multiple green-selected lines.
- This will remove the prepayment from the selected PO/from the 'Prepay Allocations' grid.
- Shows a list of payments and credits that are available to allocate to the PO selected in the top grid.
- This will populate based on the PO selected in the top grid.
- Contains the following columns:
- Date - the date that the payment was created.
- Ref - the Source # against the payment in [ Supplier | Detail | Statement ].
- Amount - the total of the payment.
- Remaining - the total amount of the payment that has not already been allocated to a Purchase Invoice. Note that this does not keep track of the total already pre-allocated to a PO, only actual allocations to Purchase Invoices.
- Has one right-click option: Add Prepayment(s).
- This can be used on one line, or used on multiple green-selected lines.
- This will add the prepayment to the selected PO/to the 'Prepay Allocations' grid.
- Note that you can also drag-and-drop payments from this grid to the 'Prepay Allocations' grid.
The Report tab:
This tab shows a report of Purchase Orders and their allocated pre-payments.
The filters include:
- PO date range - filters on the date a PO was created.
- Supplier.
- Alloc User - filters on the user that allocated a pre-payment.
- Alloc Date - filters on the date that a pre-payment was allocated.
- Roll Up - controls whether individual pre-payments are shown for a PO, or all pre-payments are rolled up into one result.
The Purchase Order | Prepayments tab
5. Usage - Purchase Invoices.
Once pre-payments have been allocated using the new [ Supplier | Supplier Prepayments ] tab, Khaos Control will attempt to allocate payments when the associated Purchase Invoice(s) are posted.- A purchase order is created.
- The supplier for the PO either already has unallocated payments/credits, or some are created.
- A user pre-allocates those payments to that purchase order using the new [ Supplier | Supplier Prepayments ] tab.
- The purchase order is then booked in and the purchase invoice is created.
- The purchase invoice is posted. At this point, Khaos Control attempts to allocate the pre-allocated payments to the purchase invoice, started from the oldest linked pre-allocation.
- Regardless of whether allocation succeeds or fails, the purchase invoice will post.
- Allocation may fail if, for example, the payment has already been allocated elsewhere.
- If the pre-allocation amount is less than the full price of the PI, Khaos Control will allocate all the available pre-allocations,
- If the pre-allocation amount is more than the full price of the PI, Khaos Control will allocate the full amount of the PI, starting with the oldest pre-allocation link.
- Posting the invoice does not remove pre-allocation links on the associated PO, or other POs.
- Payments that are pre-allocated to a PO cannot be edited or deleted. The pre-allocation links must be removed first.