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 a Closed 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:

  1. Fixed-length
  2. ANSI encoded
  3. Line endings are Windows-style CarriageReturn + LineFeed (\r\n, or 0x0D0A)
  4. File will be available in the relative directory of /AccountBalance
  5. 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 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

Property

Data Type (Length)

Alignment

Start Position

Description

Record Type

string (1)

Left

1

The flag for the header row. Will always be H.

File Name

string (50)

Left

2

The name of this request file excluding path. Will be named following this pattern: yyyyMMddhhmm_ACCOUNTBALANCE.TXT
Example: 201410210148_ACCOUNTBALANCE.TXT

Record Count

integer (10)

Right

52

The number of records represented within the file. This field is zero-padded on the left side.
Example: 0000000872

File Created Date

datetime (34)

Left

62

The date the file was created. Follows same format as API. Example: 2014-10-20T10:30:31.456-05:00
See data format guidelines

File Effective Date

datetime (34)

Left

96

The 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

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 PrimaryCustomerId for more information. This field is zero-padded on the left side.
Example: 0000000872

Customer Tag

string (50)

Left

11

The client-supplied unique identifier for the customer, aka the tag property on the customer object. This may be empty as it is an optional property.

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.
Example: 0008309285.
This is NOT an account number. It is the accountId of an account object.

Account Tag

string (50)

Left

71

The tag property of the account object.

Account Name

string (50)

Left

121

The name property of the account object.

Account Number

string (50)

Left

171

The accountNumber property of the account object.

Account Type

string (50)

Left

221

The type property of the account object.

Account Status

string (50)

Left

271

The status property of the account object.

Account Balance

integer (15)

Right

321

The accountBalance property of the account object. It is NOT the availableBalance property. This field is zero-padded on the left side, and two decimals will be assumed, e.g., 000000000000832 represents an amount of $8.32. -00000000000832 represents an amount of -$8.32.

Created Date

datetime (34)

Left

336

The createdDate property of the account object. Follows same format as API.
Example: 2014-10-20T10:30:31.456-05:00
See data format guidelines

Closed Date

datetime (34)

Left

370

The closedDate property of the account object. Follows same format as API.
Example: 2014-10-20T10:30:31.456-05:00
See data format guidelines

  • *NOTE**: Only accounts which closed on the same day as the EffectiveDate of the file will be included. Accounts which closed on previous dates will not be included.

Target Date

datetime (8)

Left

404

The targetDate property of the account object. Follows YYYYMMDD format. October 10, 2014, would be represented as 20141020.

Target Amount

integer (15)

Right

412

The targetAmount property of the account object. This field is zero-padded on the left side and two decimals will be assumed, e.g., 000000000000832 represents an amount of $8.32.

Category

string (50)

Left

427

The category property of the account object.

Subcategory

string (50)

Left

477

The subCategory property of the account object.

Target Met Date

datetime (34)

Left

527

The targetMetDate property of the account object. Follows same format as API. Example: 2014-10-20T10:30:31.456-05:00
See data format guidelines

Target Met Percent

integer (15)

Right

561

The targetMetPercent property of the account object. This field is zero-padded on the left side and two decimals will be assumed, e.g., 000000000002570 represents an amount of 25.7%.

Is Primary

boolean (1)

Left

576

The isPrimary property of the account object.

  • Y: Yes (true)
  • N: No (false).NOTE: this flag is relevant only if CustomerId matches the PrimaryCustomerId on the same line in the file.

Primary Customer ID

integer (10)

Right

577

The PrimaryCustomerId property of the account object. When CustomerId matches PrimaryCustomerId, this means the line represents the account for the primary account owner. When CustomerId does not match PrimaryCustomerId, this means the line represents the account for an alternate account owner.

Interest Rate

decimal (15)

Right

587

The interestRate property of the account object applicable for the effective date. Example: 000.01500000000 represents 1.5%

Product ID

integer (10)

Right

602

The productId property of the account object.

Available Balance

integer (15)

Right

612

The availableBalance property of the account object. This field is zero-padded on the left side and two decimals will be assumed, e.g., 000000000002130 represents an amount of $21.30. -00000000002130 represents an amount of -$21.30.

Pending Balance

integer (15)

Right

627

The pendingBalance property of the account object. This field is zero-padded on the left side and two decimals will be assumed, e.g., 000000000002130 represents an amount of $21.30. -00000000002130 represents an amount of -$21.30.

Account Lock Code

string (3)

Right

642

The accountLockStatus property of the account object. Potential values:

  • UNL: Unlocked
  • CST: Locked by customer
  • SYS: Locked by system

Account Lock Effective Date

datetime (34)

Left

645

The AccountLockCode effective date. Follows same format as API.
Example: 2014-10-20T10:30:31.456-05:00
See data format guidelines

Lock Status

string (1)

Left

679

The accountLockStatus property of the account object.
Possible values:

  • 0: - Unlocked
  • 1: - Locked

Lock Reason Type Code

string (3)

Left

680

The reason the lock was applied to the account. Possible values:

  • UNK: Unknown
  • FRD: Fraud investigation
  • ADM: Administrative
  • TMP: Temporary
  • FRZ: Freeze
  • SUS: Suspected fraud
  • CO: Credits only

Account Close Reason

string (48)

Left

683

The accountCloseReason property of the account object.

Dormancy Status

string (8)

Left

731

The dormancyStatus of the account. Possible values:

  • Inactive
  • Dormant

{ "file_type": "fixed_length" }