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:

  1. Exactly one tab-delimited header line.
  2. Zero or more tab-delimited content lines.
  3. A tab character (\t, or 0x09) embedded in actual text content will be replaced with a space character (" ", or 0x20) during file generation
  4. 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.
  5. ANSI encoded
  6. Line endings are Windows-style CarriageReturn + LineFeed (\r\n, or 0x0D0A)
  7. File will be available in the relative directory of /TrialBalanceFiles/Daily
  8. 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 either DDA or Savings.

🚧

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 the FileCreatedDate or FileEffectiveDate 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

PropertyData Type (Length)Tab OffsetDescription
FileNamestring (50)0The name of this request file excluding path.
Example:
201410210148_EXAMPLEBANK_TrialBalanceExport_DDA.TXT
RecordCountinteger (10)1The number of records represented within the file. This field is zero-padded on the left side.
Example: 0000000872
FileCreatedDatedatetime (34)2The date the file was created. Follows same format as API.
Example: 2014-10-20T10:30:31.456-05:00
See data format guidelines
FileEffectiveDatedatetime (34)3The date to which the data in the file pertains. Follows same format as API.
Example: 2014-10-19T23:59:59.999-05:00
See data format guidelines

Content Row

PropertyData Type (Max Length)Tab OffsetDescription
ProgramNamestring (50)0The name of the program with which the line item is associated.
ClientNamestring (50)1The name of the client with which the line item is associated.
CustomerIdinteger (10)2The customerId property of the customer object.
FirstNamestring (64)3The firstName property of the customer object.
MiddleNamestring (64)4The middleName property of the customer object.
LastNamestring (128)5The lastName property of the customer object.
FullNamestring (256)6A nicely formatted concatenation of the firstName, middleName and lastName properties of the customer object.
AccountCreatedDatedatetime7The createdDate property of the account object. Follows same format as API.
Example: 2014-10-20T23:59:59.999-05:00
See data format guidelines
AccountNamestring (50)8The name property of the account object.
AccountNumberstring (17)9The accountNumber property of the account object.
EffectiveDateEndingBalancedecimal10The accountBalance property of the account object as of the FileEffectiveDate in the file header. Always contains two digits of precision to the right of the decimal. Follows same format as API for monetary values.
Example 13.00
EffectiveDateInterestAccrueddecimal11The interest accrued for the account on the day of the FileEffectiveDate in the file header. Always contains four digits of precision to the right of the decimal. Follows same format as API for Interest values.
Example: 0.0020
PeriodAverageDailyBalancedecimal12The average daily balance for the account from the beginning of the period through the FileEffectiveDate in the file header. Always contains two digits of precision to the right of the decimal. Follows same format as API for monetary values.
Example: 13.00
PeriodInterestAccrueddecimal13The interest accrued for the account from the beginning of the period through the FileEffectiveDate in the file header. Always contains four digits of precision to the right of the decimal. Follows same format as API for Interest values.
Example: 0.0020
PeriodRoundedInterestAccrueddecimal14The rounded interest accrued for the account from the beginning of the period through the FileEffectiveDate in the file header. Always contains two digits of precision to the right of the decimal. Follows same format as API for Interest values.
Example: 0.01
PeriodInterestPaiddecimal15The total amount of interest paid on the account from the beginning of the period through the FileEffectiveDate in the file header. Always contains two digits of precision to the right of the decimal. Follows same format as API for monetary values.
Example: 13.00
YearToDateInterestPaiddecimal16The total amount of interest paid on the account from the beginning of the year through the FileEffectiveDate in the file header. Always contains two digits of precision to the right of the decimal. Follows same format as API for monetary values.
Example: 13.00
InterestRatedecimal17The Annual Percentage Rate (configured in Helix Admin) used during interest calculations on the account that was effective on the FileEffectiveDate in the file header. Always contains eleven digits of precision to the right of the decimal. Follows same format as API for monetary values.
Example: 0.00957389763
BeneficiaryCountinteger (10)18The number of active beneficiaries the customer had effective on the FileEffectiveDate in the file header.
ProductNamestring (100)19The name property of the customer object.
TaxIdstring (30)20The taxId property of the customer object.
AccountIdinteger (10)21The accountId property of the account object.
ProductIdinteger (10)22The unique identifier of the product of which the account is associated.
BankEndOfDayBalancedecimal23The accountBalance property of the account object as of the endOfBankDay time, which is the balance used for any interest-bearing account. Always contains two digits of precision to the right of the decimal. Follows same format as API for monetary values.
Example: 13.00
BusinessLegalName*string (300)24The businessLegalName property of the customer object.
DBA*string (200)25The doingBusinessAs property of the customer object.
TaxIdTypestring (50)26The taxIdType property of the customer object.
AccountStatusstring (50)27The status property of the account object.
legalName1string(100)28The legalName1 property of the account object.
legalName2string(100)29The legalName2 property of the account object.

*Property relates to business account functionality. Use of business account functionality requires approval from Q2 and your bank partner.

{ "file_type": "tab_delimited" }