Setting up a Billing Category requires Reference Codes. These codes allow you to bill clients at the correct rates and pay staff the appropriate amount based on the services provided. Other Reference Codes are also used for Invoices, Payroll Integration, and Billing Integrations.
This topic describes how each Reference Code is determined and helps you identify where to enter the correct codes in each Reference field.
Keywords: reference codes, ref, billing category, carevision api, payroll integration, invoice references, service type id, income account, cost account, funding source, techone refcodes, employment hero refcodes, chsp refcodes, ndis refcodes, refcodes
I. Reference Table
Carevision Reference Table |
Index | Reference | Name/Description | Usage within CareVision | Notes |
0 | Ref 1 | Income Account | Activity ID (MYOB Activity Slip & MYOB Time Billing) | If left blank, this will default to the Billing Category’s Organisation Reference.
Epicor = Part Number Xero = Account Code MYOB = Activity ID credit_account |
|
|
|
1 | Ref 2 | Cost Account | Cost Centre (Payroll Metrics) | CostCode |
Payroll Category (MYOB Activity Slip & MYOB Payroll) |
2 | Ref 3 | Service Type ID (CHSP) | Service Type ID (CHSP) | DEX ID |
service type id |
3 | Ref 4 | Support Number (NDIS) | Support Number (NDIS) | claimid |
Added to the “Note” field, along with description, time, and adjustment status. (MYOB Time Billing) |
4 | Ref 5 | CaseId (QCSS) | CaseId (QCSS) | QCSS-OMS → CaseId |
5 | Ref 6 | Claim Type (NDIS) | Claim Type (NDIS) | ndis code |
claim type |
6 | Ref 7 | Type of charge | | Type of charge |
7 | Ref 8 | Job | Job (MYOB Time Billing & MYOB Payroll) | Debit_Ledger_code |
8 | Ref 9 | CREDIT_LEDGER_CODE | | CREDIT_LEDGER_CODE |
9 | Ref 10 | CREDIT_ACCOUNT | | CREDIT_ACCOUNT |
10 | Ref 11 | ROLE | | ROLE |
11 | Ref 12 | SERVICE TYPE | | SERVICE TYPE |
WIC CODE |
12 | Ref 13 | Territory ID | Territory ID - used on Epicor Clients Export | DEPT |
13 | Ref 14 | Rate Indicator | | Used to indicate which rate was applied, particularly for Time Category Billing Categories (e.g., “PH”, “WEEKDAY”). |
14 | Ref 15 | Pay Element / Sleepover Description | Sleepover Billing Category, Sleepover Category - Sleepover Description (Payroll Metrics) | |
Sleepover Billing Category, Interruptions - Pay Element (Payroll Metrics) |
Travel With Client Billing Category - Pay Element (Payroll Metrics) |
Callout Distance Billing Category - Pay Element (Payroll Metrics) |
Pay Item EarningsRateID (XERO Payroll) |
15 | Ref 16 | HACC Category | HACC export | |
|
16 | Ref 17 | Income Code Prefix | (Upcoming) Added before the Income Account, useful for Natural Accounts. | |
|
17 | Ref 18 | Cost Centre Prefix | (Upcoming) Added before the Cost Centre | |
|
18 | Ref 19 | Internal Payglobal ReasonCodes (L.MEETINGS, L.TRAINING) | | |
|
19 | Ref 20 | Payroll time type code | Aurion | |
|
20 | Ref 21 | Public Holiday Not Worked Code | Aurion | If this field is blank, PHNW will be used as the default. |
|
21 | Ref 22 | Work type external ID | KeyPay payroll Export. Value for “Work type external ID” column for “Not a broken shift” Transaction type | |
|
22 | Ref 23 | Default org travel mileage reference | Keypay Component | |
Replaces the hardcoded default value of 3643 |
23 | Ref 24 | Work type external ID (base time output) | KeyPayComponent | |
Added a default value for standard base time output instead of blank |
24 | Ref 25 | Service Type | Service Type | For SAH billing and claiming purposes |
25 | Ref 26 | Service Type | Service Type | For SAH billing and claiming purposes |
26 | Ref 27 | TechOneAR Invoice Value | Value for TechOneAR Invoice | The value entered here will be included in each client header row. |
LLDGCODE column |
If the Usage within CareVision column is empty, it indicates that the reference field is not used in the production CareVision API at the time of writing.
II. Sources of Reference Codes in CareVision
Reference codes in CareVision come from three main sources:
1. Organisation References
These are set up on the Settings > General Configuration page in the web portal.
2. Funding Source References
These are created within a funding source template and are used when setting up a client funding record. When you create a client funding record, it copies the references from the selected funding source template. After the funding record is created, it keeps its own copy of these references. If you later update the funding source template, those changes will not affect existing client funding records. This ensures each client funding record remains consistent, even if the original template is modified.
3. Line-Item References (Billing Category References)
These are defined on the Billing Category page in the user interface, under the rate settings for each billing category. Line-item references are used similarly to how rates are retrieved when calculating a line item. The process for retrieving and applying these references during calculations is the same as for rate retrieval.
III. Merging References
When generating invoices and payroll, reference codes are created by combining values from the organisation, funding source, and billing category references described above.
Income & Cost Codes
In CareVision, we recommend setting up Income and Cost Codes correctly to prevent them from being flagged during the Service Review process. Proper mapping is also required to ensure smooth processing of payroll and invoicing.
This would depend on your Chart of Accounts structure.
Combining Reference Codes for Income and Cost Codes
Income Code:
[Branch/Organisation Ref17] + [Funding Source Template Ref17] + [Billing Category Ref17] + [Branch/Organisation Ref1] + [Funding Source Template Ref1] + [Billing Category Ref1]
Cost Code:
[Branch/Organisation Ref18] + [Funding Source Template Ref18] + [Billing Category Ref18] + [Branch/Organisation Ref2] + [Funding Source Template Ref2] + [Billing Category Ref2]
If a specific reference code is not set up (for example, if the Cost Code does not include Funding Source Template Ref18), the system will still allow processing as long as:
This topic explained how Reference Codes are determined in CareVision. For more information about Reference Codes and Billing Categories, contact the CareVision Support Team.
Related Articles
How to Generate TechOne Payroll Export Files through Employment Hero Integration
This topic describes how payroll admin users and coordinators can generate TechOne payroll export files through Employment Hero integration. The payroll workflow involves three key systems, each with a distinct role in managing bookings, timesheets, ...
Guide to Updating CHSP Billing Categories
Keeping your billing categories up to date helps ensure your records stay accurate and your processes run smoothly. This document describes how to update CHSP billing categories in order to update the service type ID. Keywords: chsp, billing, ...
Sleepover Billing & Payroll
Overview CareVision provides support for scheduling, tracking, billing, and paying sleepover bookings. A sleepover booking is a booking during which the staff member may sleep when they are not working. Key terminology / concepts Sleep Period - The ...
Billing Process: Step-by-Step Guide
Billing involves invoicing clients or their plan managers for services provided. Keeping client information up to date is important to make sure the billing process is accurate and meets all requirements. This documentation guides you through the ...
NDIS Price Changes
The National Disability Insurance Scheme (NDIS) has released updated Pricing Arrangements and Price Limits, effective 1 July 2025. Keywords: ndis, price changes, support coordination, recovery coaching, therapy supports, travel claims, plan ...