Account Balance File
A listing of all accounts in Helix for a given program with these qualities (as of the effective date of the file):
- Successfully created and moved to an
Open
status on that date - Was in an
Open
status for that entire date - Changed from an
Open
status to aClosed
status on that date - Was in a
Closed
status with a non-zero balance on that date
Accounts in this file with a Closed
status and a zero balance will not appear in files for subsequent dates.
Account Balance File Definition
The Account Balance File is created by Helix on a daily basis. It has the following properties:
- Fixed-length
- ANSI encoded
- Line endings are Windows-style CarriageReturn + LineFeed (
\r\n
, or0x0D0A
) - File will be available in the relative directory of
/AccountBalance
- File name follows a specific, case-sensitive pattern of:
yyyyMMddhhmm_ACCOUNTBALANCE.TXT
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) | Alignment | Start Position | Description |
---|---|---|---|---|
Record Type | string (1) | Left | 1 | The flag for the header row. Will always be |
File Name | string (50) | Left | 2 | The name of this request file excluding path. Will be named following this pattern: |
Record Count | integer (10) | Right | 52 | The number of records represented within the file. This field is zero-padded on the left side. |
File Created Date | datetime (34) | Left | 62 | The date the file was created. Follows same format as API. Example: |
File Effective Date | datetime (34) | Left | 96 | The date to which the data in the file pertains. Follows same format as API. Example: |
Content Row
Property | Data Type (Length) | Alignment | Start Position | Description |
---|---|---|---|---|
Customer Id | integer (10) | Right | 1 | The unique identifier for the customer who has access to the account. See |
Customer Tag | string (50) | Left | 11 | The client-supplied unique identifier for the customer, aka the |
Account Id | integer (10) | Right | 61 | The unique identifier for the account from which funds will be withdrawn. This field is zero-padded on the left side. |
Account Tag | string (50) | Left | 71 | The |
Account Name | string (50) | Left | 121 | The |
Account Number | string (50) | Left | 171 | The |
Account Type | string (50) | Left | 221 | The |
Account Status | string (50) | Left | 271 | The |
Account Balance | integer (15) | Right | 321 | The |
Created Date | datetime (34) | Left | 336 | The |
Closed Date | datetime (34) | Left | 370 | The
|
Target Date | datetime (8) | Left | 404 | The |
Target Amount | integer (15) | Right | 412 | The |
Category | string (50) | Left | 427 | The |
Subcategory | string (50) | Left | 477 | The |
Target Met Date | datetime (34) | Left | 527 | The |
Target Met Percent | integer (15) | Right | 561 | The |
Is Primary | boolean (1) | Left | 576 | The
|
Primary Customer ID | integer (10) | Right | 577 | The |
Interest Rate | decimal (15) | Right | 587 | The |
Product ID | integer (10) | Right | 602 | The |
Available Balance | integer (15) | Right | 612 | The |
Pending Balance | integer (15) | Right | 627 | The |
Account Lock Code | string (3) | Right | 642 | The
|
Account Lock Effective Date | datetime (34) | Left | 645 | The |
Lock Status | string (1) | Left | 679 | The
|
Lock Reason Type Code | string (3) | Left | 680 | The reason the lock was applied to the account. Possible values:
|
Account Close Reason | string (48) | Left | 683 | The |
Dormancy Status | string (8) | Left | 731 | The
|
Take me to the Example Account Balance File
Updated 16 days ago