Configure Collections for Accounting
Choose what each collection represents in Xero or QuickBooks
Once Xero or QuickBooks is connected, you decide what each collection
First time setting up? Connect Xero or QuickBooks before following this guide.
1. Open the Accounting Pane
- In the sidebar, right-click the collection you want to configure (or open the collection and click the options menu (⋯)) and select Configure.
- In the configuration sidebar, find and click Accounting & Payments.
If no accounting integration is connected, the pane shows an empty state with a Connect Accounting button that takes you to Settings → Integrations → Accounting & Payments.
2. Select an Accounting Record Type
The first setting in the pane is Accounting record type, which lets you select what records in this collection represent in your connected accounting system - Xero or QuickBooks.
Records in this collection have no relationship to the accounting system.
Each record can be linked to a contact in the accounting system. Outstanding balances and overdue amounts appear in the record details panel.
Each record can be linked to a product or service. Sales and purchase pricing appear in the record details panel.
Track invoices created from each record's line items. Coverage, payments, and outstanding amounts appear in the record details panel.
Track bills created from each record's line items. Coverage, payments, and outstanding amounts appear in the record details panel.
Changing the type later prompts you to confirm with a Change accounting linking? dialog. For Invoices and Bills, switching away will lose any existing transaction configuration and coverage data.
3. Map Fields Between Kinabase and Your Accounting System
When you select Customers & Suppliers or Products & Services, a Synced fields section appears:
Select which fields to sync between your records and your connected accounting system.
Each row pairs an accounting system field on the left with a Kinabase field on the right. For each pair, select the sync direction:
Don't sync this field in either direction.
Pull the value from the accounting system into Kinabase. Useful for fields you maintain in Xero or QuickBooks (such as outstanding balance).
Push the Kinabase value to the accounting system. Useful for fields you maintain in Kinabase (such as a primary phone number).
Once you are happy with your inbound and outbound field mappings - changes save automatically.
Contact Fields You Can Map
- Name, Email, Phone, Status (Active / Archived)
- Is Customer, Is Supplier flags
- Street address and Mailing/PO Box address
(full address with line, city, region, postcode, country) - Accounts Receivable - Outstanding and Overdue
- Accounts Payable - Outstanding and Overdue
- Currency code
Item Fields You Can Map
- Name, Code (SKU), Description
- Unit price (sales) and Purchase price
- Sales tax code and Sales ledger code
- Purchase tax code and Purchase ledger code
- Is sold and Is purchased flags
4. Configure Invoices or Bills
When you select Invoices or Bills, three extra sections appear: line items, completion, and default codes.
4.1 Line Item Source
Select what becomes a line on the invoice or bill:
The record itself becomes a single line on the transaction. Use this for simple, one-off charges.
Each record in a chosen list (subcollection) becomes its own line. Use this when a Job has many Tasks, an Order has many Order Lines, etc.
The 'list' (or subcollection) option only appears if the collection has at least one list (or subcollection).
4.2 Completion Tracking
When you use list (subcollection) line items, you can track how much has been invoiced or billed:
A line item is "covered" as soon as it appears on at least one transaction.
Track the cumulative monetary value invoiced or billed against each line.
Track the cumulative quantity invoiced or billed against each line.
4.3 Invoice or Bill Fields
The Invoice fields or Bill fields section maps Fields from the Collection or List onto the transaction sent to the accounting system. Common mappings include:
- Description - what appears as the line description.
- Quantity - the number of units.
- Unit price - price per unit.
- Line amount - total for the line (when amount is calculated outside Kinabase).
- Tax code and Ledger code - line-level overrides.
- Attachments - supporting documents uploaded with the transaction.
For Attachments, select a Field of the File or Files type, then select Update. Other Field types are filtered out automatically. Kinabase uploads the files when it creates and links the invoice or bill, whether you create the transaction from a Record or with a Create in accounting system Automation step.
Attachments are not added retrospectively to transactions that are already linked. Xero allows up to 10 attachments per transaction and 3 MB per file. QuickBooks allows up to 20 MB of attachments in total per transaction. These limits also appear in the configuration screen.
Existing Xero connections may need to be reconnected before Kinabase can upload attachments.
4.4 Default Tax Code and Default Ledger Code
To save time when creating transactions, you can set defaults that apply when a line does not specify its own:
- Default tax code - filtered to Output tax codes for invoices, Input for bills.
- Default ledger code - filtered to Revenue accounts for invoices, Expense accounts for bills.
Both have a No default option if you'd rather choose every time.
5. Permissions
Collection configuration is restricted to System admins. End users with write access to the collection can:
- Link and unlink records to existing contacts, items, invoices, and bills.
- Sync linked records to refresh their data.
- Create new contacts, items, invoices, and bills in the accounting system from a record.
End users with read-only access can see the sidebar data but cannot link, unlink, sync, or create.
6. Use Accounting in Automations
Kinabase includes a Create in accounting system automation step. When a record is created or meets a condition, Kinabase can:
- Create a contact for the record in Xero or QuickBooks, and link it.
- Create an item for the record, and link it.
- Create an invoice or bill from configured line items, include any mapped attachments, and link it.
Configure it on the Collection's Automations as you would any other Step. The available accounting Field determines whether Kinabase creates a contact, item, invoice or bill.
For invoices, choose the Invoice status and, where available, an Invoice template. The Preview shows the Fields that will be sent to the accounting provider.
7. Real-World Examples
Connecting Kinabase to your accounting system helps streamline your day-to-day activities and align your operations and financial processes.
Related guides: Accounting & Payments overview | Connect to Xero | Connect to QuickBooks.
Need more help? Ask your System admin, or contact our support team via Help & Support.