Latner Documentation

How to Set Up Accounting Integration Account Codes

Account Codes tell Latner which account in your accounting system each line of revenue, expense, inventory movement and depreciation journal should be posted to, so the figures that arrive in Xero, MYOB or Sage Intacct land in the right place without anyone re-coding them by hand.

Overview

Latner knows a lot about what it just invoiced - that this line was a scissor lift on hire, that one was a delivery, that one was a bag of consumables off a work order. Account Code configuration is where you turn that knowledge into your chart of accounts.

  • Account Codes are configured per accounting integration, on the integration's Configure screen.

  • Each account area has its own tab: Revenue, Expense, Inventory, Depreciation Expense and Accumulated Depreciation.

  • Within a tab, the top level is always the Line Type - the kind of thing being charged. Under each Line Type you can go narrower - all the way down to a single Equipment Number, or to a Stock Sub Group, an Admin Charge and so on.

  • The most specific Account Code that matches a line always wins, and the Line Type acts as the catch-all if nothing narrower is configured.

  • The Account Code that gets used is stored on the invoice line at the time it is resolved, so later configuration changes don't rewrite invoices you have already raised.

Before You Begin

You need an accounting integration connected before there is anything to map to.

Requirement

Where to Find It

A connected accounting integration (Xero, MYOB or Sage Intacct)

Financials › Configuration › Accounting Integration

The Accounting Integration permission

Security › Permission Groups › Financial › Configuration

A chart of accounts set up in your accounting system

Xero, MYOB or Sage Intacct

01-accounting-integrations.png
The Accounting Integrations page. Use Configure on the connected card to reach the Account Code tabs

A Company can only have one active accounting integration at a time. If you try to activate a second one, Latner blocks it so that the Account Code stored against an invoice line always points unambiguously at a single accounting system.

The Five Account Areas

Each tab covers a different kind of posting, and each has its own set of Line Types.

  • Revenue Accounts Configuration - where the money you invoice customers is recognised. Driven by Customer Invoice line types.

  • Expense Accounts Configuration - where costs from Supplier Invoices are posted. Driven by Supplier Invoice line types.

  • Inventory Accounts Configuration - the stock-on-hand (balance sheet) accounts used when you run perpetual inventory. Only Stock and Serialized Stock apply.

  • Depreciation Expense Accounts Configuration - the expense side of a depreciation journal.

  • Accumulated Depreciation Accounts Configuration - the accumulated depreciation (contra asset) side of the same journal.

The account picker is filtered to sensible accounts for the tab you are on. On the Revenue tab you'll only see Revenue accounts; on the Expense tab you'll see Asset and Expense accounts. The Depreciation tabs are not filtered, so you can pick whichever accounts your accountant uses.

What the Line Types Mean

The Line Type is the single most important thing to get right, because everything else hangs off it. These are the Line Types on the Revenue tab.

  • Asset - selling an asset out of your fleet.

  • Equipment - hiring out equipment you own.

  • Sub Hire Equipment - hiring out equipment you have sub hired in from a supplier.

  • Stock - selling stock items.

  • Serialized Stock - selling a serialized stock product.

  • Transport - delivery and pick up charges.

  • Admin - Admin Charges such as damage waiver or an environmental levy.

  • Fuel - fuel charged back to the customer.

  • Damage - damage charged to the customer. This is not damage waiver, which is an Admin Charge.

  • Labour - Labour Services charged on a Rental Contract.

  • Sanitation - Sanitation Services.

  • Package - package lines.

  • (Work Order) Stock - stock consumed on a Work Order and charged out.

  • (Work Order) Labour - labour booked to a Work Order and charged out.

  • (Work Order) Expense - expenses booked to a Work Order and charged out.

  • Operator Docket - operated hire billed through Operator Dockets.

The Expense tab uses the Supplier Invoice line types instead - Stock, (Work Order) Stock, Serialized Stock, Transport, Sub Hire, Equipment, Asset, Expense, (Work Order) Expense, Operator Docket and the finance schedule repayment types. The Inventory tab has just Stock and Serialized Stock. Both Depreciation tabs have just Equipment (for assets that are a piece of equipment) and Asset (for everything else).

11-revenue-list-hierarchy.png
The Revenue Accounts Configuration tab. Equipment Number sits at the bottom of the equipment hierarchy, so ES26001 overrides the code set against its model

Assigning an Account Code

Step 1 - Open the account area you want to configure

Go to Financials › Configuration › Accounting Integration, click Configure on the connected integration, then pick the tab you want: Revenue Accounts Configuration, Expense Accounts Configuration, Inventory Accounts Configuration, Depreciation Expense Accounts Configuration or Accumulated Depreciation Accounts Configuration.

The table lists the Accounting Area on the left and the Account Code currently assigned on the right. Anything without a code yet is simply blank.

Step 2 - Click Assign Account Code

The Add Account Code Config dialog opens with three fields. Leave Scope on Invoice Line Type to set a catch-all for a whole Line Type.

  • Scope - how narrowly this Account Code applies. Required.

  • Line Type - which kind of charge. Required, and only shown when the Scope is Invoice Line Type.

  • Account Code - the account in your accounting system. Required.

06-line-type-options.png
The Line Type list on the Revenue tab, from Asset through to Operator Docket

Step 3 - Choose the account

The Account Code field searches your accounting system's chart of accounts live, showing the Code, Name and Description of each account so you can tell two similarly named accounts apart.

07-account-code-picker.png
Searching the chart of accounts. The Code, Name and Description come straight from the connected accounting system

Step 4 - Save

Click Save. The new row appears in the table straight away. To change an Account Code later, double-click its row, or tick it and use the toolbar options to update or delete it.

When you edit an existing Account Code the Scope, Line Type and record fields are locked - only the Account Code itself can be changed. If you picked the wrong scope, delete the row and add a new one.

Assigning at a More Specific Level

A single account for all equipment hire is fine to start with, but most businesses want to split revenue further. Change the Scope and the dialog swaps the Line Type field for a picker for that record instead.

10-scope-equipment-number.png
Choosing the Equipment Number scope replaces the Line Type field with a picker that searches your equipment by number

Each Line Type has its own chain of scopes, listed here from narrowest to broadest. Latner walks down the chain and uses the first one that has an Account Code against it.

  • Equipment - the individual Equipment Number, then Equipment Model, then Equipment Class, then Equipment Category, then the Equipment Line Type.

  • Sub Hire Equipment - Sub Hire Class, then Sub Hire Category, then the Line Type.

  • Serialized Stock - the individual Serialized Stock product, then Serialized Stock Model, Class and Category, then the Line Type.

  • Stock - Stock Sub Group, then Stock Group, then the Line Type.

  • Transport - Transport Type within a fulfilment, then Transport Fulfillment (internal or external), then the Line Type.

  • Admin - the specific Admin Charge, then the Line Type.

  • Fuel - Fuel Type, then the Line Type.

  • Labour - Labour Service, then the Line Type.

  • Sanitation - Sanitation Service, then the Line Type.

  • Operator Docket - Equipment Number, then Equipment Model, Class or Category (or Sub Hire Class and Category when the docket is against sub hired equipment), then the Line Type.

  • Asset, Package and Damage - Line Type only.

Equipment Number is the narrowest scope there is, and it applies to Revenue only. Reach for it when one machine needs to be recognised somewhere different to the rest of its model - a unit on a particular contract, say, or one bought into a different revenue stream. The Expense, Inventory and Depreciation tabs stop at Equipment Model.

The Work Order line types add a second dimension. (Work Order) Stock, (Work Order) Labour and (Work Order) Expense can each be split by Work Order Type, so a rebuild can post somewhere different to a routine service even when the same stock item is used.

On the Depreciation tabs the chain is Equipment Model, then Equipment Class, then Equipment Category, then Asset Group, then the Line Type - so you can depreciate a category of machines to one account and everything else to another.

The table only shows the narrower rows you have actually configured, plus their parents. That's deliberate - listing every Equipment Model and Stock Sub Group in your business would make the screen unusable. Use Assign Account Code to add the ones you need.

Splitting by Branch, Invoice Source and Rental Type

Three optional settings add extra dimensions on top of the scope hierarchy. They all live on the Integration Settings tab, under the Account Codes module.

  • Set Revenue/Expense Account Codes per Branch - when enabled, Revenue and Expense Account Codes can be set on a per Branch basis.

  • Set Revenue Account Codes per Invoice Source - when enabled, Revenue Account Codes can be set on a per Invoice Source basis (Rental Contract, Sales Order, Work Order).

  • Set Revenue Account Codes per Rental Type - when enabled, Revenue Account Codes can be set on a per Rental Type basis for Rental Contract invoicing.

16-account-codes-settings.png
The Account Codes module on the Integration Settings tab, where the three extra dimensions are switched on

Once any of them is enabled, the matching Branch, Invoice Source and Rental Type selectors appear above the Account Code table. Pick a combination and you are now looking at - and adding to - the codes for it. Leave them empty and you are looking at the default codes that apply when nothing more specific matches.

19-revenue-branch-source-selectors.png
With the settings enabled, Branch, Invoice Source and Rental Type selectors appear above the table

How Latner Picks the Account Code

Two rules decide which of your Account Codes ends up on an invoice line, and they apply in this order.

  1. The most specific scope always wins. An Account Code set against a particular Equipment Model with no branch is used in preference to a branch-specific Account Code set against the Equipment Line Type, because the Equipment Model is a narrower scope than the Line Type.

  2. Within the same scope, the most specific dimension wins. The Account Code matching the invoice's branch is used; if no branch-specific code is configured for that scope, the code with no branch set is the fallback. Invoice Source and Rental Type work the same way, Rental Type matching the type of the Rental Contract being invoiced.

The same explanation is available in the app - click the information icon beside the selectors.

20-priority-info.png
The in-app Priority explanation, available from the information icon

The Other Account Areas

Expense, Inventory and Depreciation work exactly the same way - Assign Account Code, choose a Scope, choose an account - only the Line Types and the available scopes differ.

12-expense-accounts.png
The Expense Accounts Configuration tab, driven by Supplier Invoice line types

The Inventory tab is only used when perpetual inventory is switched on for the integration (Enable Inventory Control (Stock on Hand) and Enable Serialized Inventory Control (Stock on Hand) on the Integration Settings tab). With it on, stock and serialized stock purchases post to the inventory account you nominate here rather than straight to expense, and the cost is released when the stock is sold.

13-inventory-accounts.png
The Inventory Accounts Configuration tab, used when perpetual inventory is enabled

The two Depreciation tabs are the two sides of the same journal, so configure them as a pair. Anything you code on Depreciation Expense should have a matching entry on Accumulated Depreciation.

14-depreciation-accounts.png
The Depreciation Expense tab. Both depreciation tabs offer just the Equipment and Asset line types

After You Have Configured Account Codes

  • New invoice lines resolve their Account Code when the invoice is completed and synced, and the resolved code is stored on the line.

  • Because the code is stored, changing your configuration later does not retrospectively change invoices that have already been synced.

  • A single line can be re-coded without touching the configuration, using Override Account Code on the invoice line. For an invoice that has already synced, Latner pushes just the new account code across.

  • If a line type has no Account Code anywhere in its chain, the sync will fail with an error about the missing account. Check the Integration Syncs tab at the bottom of the invoice for the message.

Removing the connection to an accounting integration deletes all of its configuration, Account Code mappings included. If you are troubleshooting a connection, use Reconnect rather than removing and re-adding it.

FAQs

I only see Line Type rows in the table. Where are the Equipment Models?

The table only lists rows you have configured, plus their parents. Use Assign Account Code, set the Scope to Equipment Model and pick the model - it will then appear indented under its Class and Category. The same goes for a single Equipment Number, which appears indented under its model.

Can I set an Account Code for one specific machine?

Yes. On the Revenue Accounts Configuration tab use Assign Account Code, set the Scope to Equipment Number and search for the machine by its number. It then becomes the narrowest match for that unit and takes priority over the codes set against its Equipment Model, Class and Category. There is an (Operator Docket) Equipment Number scope as well, for operated hire billed through Operator Dockets.

I set a branch-specific Account Code but a different one was used. Why?

Scope beats branch. If the line matched a narrower scope - say an Equipment Model - that scope's Account Code is used even though your branch-specific code was set against the broader Line Type. Set the branch-specific code at the same scope the line is matching.

Where do I code damage waiver?

Damage waiver is an Admin Charge, so it is covered by the Admin Line Type - or by an Account Code set against that specific Admin Charge. The Damage Line Type is for damage recharged to a customer.

I changed an Account Code. Will my old invoices move?

No. The Account Code is stored on each invoice line when it is resolved, so existing invoices keep the code they were synced with. Use Override Account Code on the line if a specific invoice needs correcting.

Do I have to configure the Inventory tab?

Only if you run perpetual inventory. Leave Enable Inventory Control (Stock on Hand) off and stock costs post to the Expense accounts instead.

Can I configure Account Codes for two accounting systems at once?

No. A Company can only have one active accounting integration, and Account Codes belong to that integration. Deactivate the existing one before activating a different type.