Latner Documentation

How to Create Invoices Combining Multiple Rental Contracts

Combined invoices let you bill several of a customer's Rental Contracts on a single invoice, so a customer running five jobs off one account gets one document to pay instead of five.

Overview

Big customers rarely have just one contract open. When they've got gear on three sites and a new contract every time a machine goes out, a month-end run can land a pile of separate invoices on the same accounts payable desk. Combining them turns that pile into one invoice per customer, without losing sight of which contract each charge came from.

  • Combining is switched on per customer, in the customer's Billing Settings - it is not a global setting, so you can combine for the customers who ask for it and leave everyone else alone.

  • Combined invoices are only produced by Cycle Billing. Invoicing a single contract from Options › Invoice always produces its own invoice.

  • Contracts are grouped by customer, branch and site. Two more settings let you widen the grouping across sites, or narrow it to contracts sharing a Purchase Order Number.

  • Every line on the invoice keeps a link to the Rental Contract it came from, so charges stay traceable and each contract's invoiced and paid totals stay accurate.

  • You can see how many invoices a run will produce before you commit - the Cycle Billing confirmation tells you the count once the contracts have been grouped.

Before You Begin

You'll need the following in place.

Requirement

Where to Find It

Edit Customer permission

Security › Configuration › Permission Groups, Customers module - needed to change a customer's Billing Settings

Cycle Billing permission

Security › Configuration › Permission Groups, Rental module - opens the Cycle Billing screen

Preview Cycle Billing and Create Cycle Billing permissions

Security › Configuration › Permission Groups, Rental module - the Preview and Create buttons

At least two Rental Contracts for the same customer, on the same branch and site, both Active or Reserved with a Billing Status of Active

Rental › Rental Contracts

Combined Rental Invoice PDF Template ID (optional)

Security › Settings › PDF Templates

01-pdf-template-setting.png
the Combined Rental Invoice PDF Template ID setting. Leave it blank and combined invoices print on your normal Rental Invoice PDF Template

A combined invoice shows several contracts on one document, so it's worth giving it its own PDF template that groups the lines by contract. If you don't set Combined Rental Invoice PDF Template ID, Latner falls back to the Rental Invoice PDF Template and the invoice still prints - it just won't be laid out for multiple contracts.

Creating a Combined Invoice

Step 1 - Open the customer's Billing Settings

Go to Customers › Customers, open the customer, and select the Billing Settings tab at the bottom of the page. The tab holds the three settings that control how this customer's Rental Contracts are combined.

02-billing-settings-off.png
the Billing Settings tab on a customer. All three settings are off by default, so every contract is invoiced on its own

Step 2 - Turn on Combine Rental Contract Invoices

Switch Combine Rental Contract Invoices on and click Save. From now on, when this customer's contracts are invoiced through Cycle Billing they'll be gathered onto a single invoice instead of one invoice per contract.

03-combine-on-unsaved.png
Combine Rental Contract Invoices switched on. Cancel and Save appear in the card header as soon as you change a setting

Step 3 - Choose how the contracts are grouped

The other two settings on the tab narrow or widen the grouping. Leave them off and contracts combine per customer, per branch and per site.

  • Multi-Site Rental Contract Invoices - turn this on to let one invoice span several of the customer's sites. With it off, a customer with contracts on two sites gets two invoices.

  • Combine Invoices on Purchase Order Number Only - turn this on when the customer raises a Purchase Order per job and wants one invoice per PO. Only contracts carrying the same Purchase Order Number combine, and any contract without a Purchase Order Number is invoiced on its own.

Contracts never combine across branches, whatever these settings say.

Step 4 - Select the Rental Contracts in Cycle Billing

Go to Rental › Cycle Billing. Set the Branch, Invoice Type, Invoice Date and Bill To date for the run, filter down to the customer you want, and tick the contracts to invoice. You can tick the header checkbox to take everything the filters returned.

  • Invoice Type - Progress, Return or Final. A Final invoice also completes each contract it covers, provided nothing is left to bill.

  • Bill To - the date charges are calculated up to.

04-cycle-billing-selected.png
five contracts selected for one customer across two sites. Contract 12 carries a Purchase Order Number and the rest don't, which only matters if you turned on Combine Invoices on Purchase Order Number Only

Step 5 - Preview the run

Click Preview. Latner calculates the charges without writing anything, fills in the Preview Sub Total for the run and a Preview Invoice Amount against each contract, and enables the Download and Create buttons. Use Download if you want the numbers as a PDF or CSV to check before you bill.

05-preview.png
the preview total for the run. Create stays disabled until a preview has been generated

Step 6 - Create the invoices

Click Create. The confirmation tells you exactly how many invoices will be produced once the customer's combine settings have grouped the contracts - five contracts across two sites becomes two invoices here, not five. Check the count, the dates and the totals, then click Confirm.

06-create-confirm.png
the confirmation for a combined run. The invoice count is the number of invoices after grouping, not the number of contracts selected

Step 7 - Check the combined invoice

Open the invoice from Customers › Customer Invoices. On a combined invoice the Details tab shows an extra Rental Contract column, so you can see which contract every charge belongs to - equipment, fuel, damage waiver and environmental levy lines are all stamped with their own contract.

07-combined-invoice-lines.png
one invoice covering three Rental Contracts. The Rental Contract column only appears on combined invoices, and each number links back to its contract

After Creation

  • The invoice is created in Completed status when Default Rental Contract Customer Invoices to Completed is on (Security › Settings › Customers), and in Open status when it isn't. Completed invoices from a cycle billing run are pushed to your accounting integration in one batch at the end of the run.

  • The invoice appears on the Invoices tab of every Rental Contract it covers, not just one of them.

  • Each contract is credited with its own lines. Total Invoiced (incl.) and Total Paid (incl.) on the contract reflect that contract's share of the combined invoice, and a payment against the invoice is attributed to each contract pro-rata by its share of the lines.

  • The invoice header takes the Purchase Order Numbers of the contracts it covers, separated by commas. The site is the lowest-numbered contract's site when the group spans several.

  • The sales rep on the header is the rep every contract in the group shares. If the contracts have different reps the header is left blank, but each line still carries its own contract's rep for reporting.

  • Contracts that had nothing to bill for the period, or whose charges net to a credit, are simply left off the invoice.

A combined invoice can only be cancelled while it is still the latest invoice for every contract it covers. Once any one of those contracts has been invoiced again, cancelling is refused with You can only cancel the latest invoice related to a Rental Contract. If you need to correct it after that point, raise a credit note against the combined invoice instead.

FAQs

I turned the setting on but my contracts still invoiced separately. Why?

Check that the contracts really are in the same group. They combine only when they share the same customer, the same branch and the same site - and if Combine Invoices on Purchase Order Number Only is on, the same Purchase Order Number as well. Turn on Multi-Site Rental Contract Invoices if you want one invoice across sites. Also check you invoiced through Rental › Cycle Billing; invoicing a contract from its own Options › Invoice never combines.

Can I combine contracts from different branches onto one invoice?

No. Branch is always part of the grouping, so contracts on different branches are always invoiced separately even with every combine setting turned on.

One of my contracts has no Purchase Order Number and it was invoiced on its own. Is that a bug?

No - that's Combine Invoices on Purchase Order Number Only doing its job. With that setting on, a contract with a blank Purchase Order Number has nothing to match against, so it never combines with anything and gets its own invoice. Either fill in the contract's Purchase Order Number or turn the setting off.

How do I credit one contract's charges off a combined invoice?

Raise a credit note from the combined invoice and include only the lines belonging to that contract. The credit note keeps each line's contract link, so it credits the right contract and shows on that contract's Invoices tab. See How to Create Credit Note from Customer Invoice.

A contract I selected didn't appear on the invoice at all. Where did it go?

A contract is left off when it has nothing to bill for the period, or when its own charges net to a negative amount. Its Billing Status must also be Active - a contract on hold is skipped - and its status must be Active or Reserved. Run a Preview first and check the contract's Preview Invoice Amount; a blank means there is nothing to charge.

Does combining change the way the contract is reported on?

No. Each contract is attributed its own lines, so its invoiced, credited and paid totals are the same as they would be on a single-contract invoice. A payment against the combined invoice is split across the contracts in proportion to their lines, and once the invoice is fully paid each contract's paid total matches its invoiced total exactly.

What happens if I turn the setting off later?

Invoices already created stay exactly as they are. From the next cycle billing run onwards, the customer's contracts are invoiced one at a time again.