Trial Balance File
A listing of all accounts within a bank of record with these qualities (as of the effective date of the file):
- All customer accounts in an
Open
status - All customer accounts which have a non-zero balance
- All program accounts
Trial Balance File Definition
The Trial Balance File is created by Helix on a daily basis. It has the following properties:
- Exactly one tab-delimited header line.
- Zero or more tab-delimited content lines.
- A tab character (
\t
, or0x09
) embedded in actual text content will be replaced with a space character (" ", or0x20
) during file generation - This file is tab-delimited to help reduce the size of file as it may grow considerably over time and possibly contain large sections of empty columns.
- ANSI encoded
- Line endings are Windows-style CarriageReturn + LineFeed (
\r\n
, or0x0D0A
) - File will be available in the relative directory of
/TrialBalanceFiles/Daily
- File name follows a specific, case-sensitive pattern of:
yyyyMMddhhmm_{BANKNAME}_TrialBalanceExport_{PRODUCTCATEGORY}.TXT
where{BANKNAME}
is the name of the bank, and{PRODUCTCATEGORY}
is eitherDDA
orSavings
.
Format Disclaimer
Helix reserves the right to append new field(s) to the end of any Header or Content line without notice. This is to allow new data points to be added as needed in a timely fashion.Implementation Note
Your code should be written such that unexpected characters after the "last" field but prior to the end of each line should be ignored. That is, if the file is documented as being 872 bytes per line, receiving a file with 984 bytes per line should not disrupt your processing. This applies to both Header and Content lines.File Name Disclaimer
The date in file name should be used as a guideline for human eyes only. Any date-related programmatic dependencies should rely on theFileCreatedDate
orFileEffectiveDate
contained within the header line of each file, as these will be precise to the second and will be in the appropriate timezone.
Header Row
Property | Data Type (Length) | Tab Offset | Description |
---|---|---|---|
File Name | string (50) | 0 | The name of this request file excluding path. |
Record Count | integer (10) | 1 | The number of records represented within the file. This field is zero-padded on the left side. |
File Created Date | datetime (34) | 2 | The date the file was created. Follows same format as API. |
File Effective Date | datetime (34) | 3 | The date to which the data in the file pertains. Follows same format as API. |
Content Row
Property | Data Type (Max Length) | Tab Offset | Description |
---|---|---|---|
Program Name | string (50) | 0 | The name of the program with which the line item is associated. |
Client Name | string (50) | 1 | The name of the client with which the line item is associated. |
Customer ID | integer (10) | 2 | The |
First Name | string (64) | 3 | The |
Middle Name | string (64) | 4 | The |
Last Name | string (128) | 5 | The |
Full Name | string (256) | 6 | A nicely formatted concatenation of the |
Account Created Date | datetime | 7 | The |
Account Name | string (50) | 8 | The |
Account Number | string (17) | 9 | The |
Effective Date Ending Balance | decimal | 10 | The |
Effective Date Interest Accrued | decimal | 11 | The interest accrued for the account on the day of the |
Period Average Daily Balance | decimal | 12 | The average daily balance for the account from the beginning of the period through the |
Period Interest Accrued | decimal | 13 | The interest accrued for the account from the beginning of the period through the |
Period Rounded Interest Accrued | decimal | 14 | The rounded interest accrued for the account from the beginning of the period through the |
Period Interest Paid | decimal | 15 | The total amount of interest paid (including manual interest adjustments) on the account from the beginning of the period through the |
Year To Date Interest Paid | decimal | 16 | The total amount of interest paid (including manual interest adjustments) on the account from the beginning of the year through the |
Interest Rate | decimal | 17 | The Annual Percentage Rate (configured in Helix Admin) used during interest calculations on the account that was effective on the |
Beneficiary Count | integer (10) | 18 | The number of active beneficiaries the customer had effective on the |
Product Name | string (100) | 19 | The |
Tax ID | string (30) | 20 | The |
Account ID | integer (10) | 21 | The |
Product ID | integer (10) | 22 | The unique identifier of the product of which the account is associated. |
Bank End Of Day Balance | decimal | 23 | The |
Business Legal Name* | string (300) | 24 | The |
DBA* | string (200) | 25 | The |
Tax ID Type | string (50) | 26 | The |
Account Status | string (50) | 27 | The |
Legal Name 1 | string(100) | 28 | The |
Legal Name 2 | string(100) | 29 | The |
*Property relates to business account functionality. Use of business account functionality requires approval from Q2 and your bank partner.
Take me to the Example Trial Balance File
Updated 8 days ago