Example of Loading US Balance Initialization Lines

In this example, you create balance initialization records to initialize an employee’s federal and provincial-level balances.

When initializing year-to-date balances, you also initialize any related balances. For example, when initializing Federal Tax Withheld balance, related balances such as Federal Tax Subject and Federal Tax Gross may also need to be initialized, depending on your business needs.

Use the InitializeBalanceBatchHeader.dat file to create the batch header.

METADATA|InitializeBalanceBatchHeader|LegislativeDataGroupName|BatchName|UploadDate MERGE|InitializeBalanceBatchHeader|US LDG|Balance Init Group A|2021/02/05

In this example, a number of balances are initialized for the same employee.

The employee is identified by their payroll relationship number, employment terms number and assignment number.

Attribute Value
PayrollRelationshipNumber 8191951
TermNumber ET8191951
AssignmentNumber E8191951

The employee’s payroll and tax reporting unit must also be specified on every initialize balance line.

Attribute Value
PayrollName Vision US Weekly
TaxUnitName US Tax Reporting Unit

Load these details to initialize the YTD salary balance to 6000:

Attribute Value
LineSequence 1
BalanceName Vision US Salary
DimensionName Assignment Tax Unit Year to Date
AreaOne
Value 6000

Load these details to initialize the QTD salary balance to 6000

Attribute Value
LineSequence 2
BalanceName Vision US Salary
DimensionName Assignment Tax Unit Quarter to Date
AreaOne
Value 6000

Load these details to initialize the YTD Federal Income Tax (FIT) Withheld balance

Attribute Value
LineSequence 3
BalanceName FIT Withheld
DimensionName Relationship Tax Unit Year to Date
AreaOne
Value 954.06

Load these details to initialize the QTD FIT Withheld balance

Attribute Value
LineSequence 4
BalanceName FIT Withheld
DimensionName Relationship Tax Unit Quarter to Date
AreaOne
Value 954.06

Load these details to initialize the Year-to-Date (YTD) Medicare Employee Withheld balance.

Attribute Value
LineSequence 5
BalanceName Medicare Employee Withheld
DimensionName Relationship Tax Unit Year to Date
AreaOne
Value 87

Load these details to initialize the QTD Medicare Employee Withheld balance.

Attribute Value
LineSequence 6
BalanceName Medicare Employee Withheld
DimensionName Relationship Tax Unit Quarter to Date
AreaOne
Value 87

Load these details to initialize the YTD SIT Withheld balance.

Attribute Value
LineSequence 7
BalanceName SIT Withheld
DimensionName Relationship Tax Unit, State Year to Date
AreaOne
Value 264.00

Load these details to initialize the Quarter-to-Date (QTD) SIT Withheld balance.

Attribute Value
LineSequence 7
BalanceName SIT Withheld
DimensionName Relationship Tax Unit, State Quarter to Date
AreaOne
Value 264.00
Use the InitializeBalanceBatchLine.dat file to initialize the YTD and QTD values for these balances, with the details defined above:
  • Salary
  • FIT Withheld
  • Medicare Employee Withheld
  • SIT Withheld
METADATA|InitializeBalanceBatchLine|LegislativeDataGroupName|BatchName|LineSequence|PayrollRelationshipNumber|TermNumber|AssignmentNumber|PayrollName|TaxUnitName|BalanceName|DimensionName|AreaOne|Value|UploadDate 
MERGE|InitializeBalanceBatchLine|US LDG|Balance Init Group A|1|8191951|ET8191951|E8191951|Vision US Weekly|US Tax Reporting Unit|Vision US Salary|Assignment Tax Unit Year to Date||6000| 
MERGE|InitializeBalanceBatchLine|US LDG|Balance Init Group A|2|8191951|ET8191951|E8191951|Vision US Weekly|US Tax Reporting Unit|Vision US Salary|Assignment Tax Unit Quarter to Date||6000| 
MERGE|InitializeBalanceBatchLine|US LDG|Balance Init Group A|3|8191951|ET8191951|E8191951|Vision US Weekly|US Tax Reporting Unit|FIT Withheld|Relationship Tax Unit Year to Date||954.06| 
MERGE|InitializeBalanceBatchLine|US LDG|Balance Init Group A|4|8191951|ET8191951|E8191951|Vision US Weekly|US Tax Reporting Unit|FIT Withheld|Relationship Tax Unit Quarter to Date||954.06| 
MERGE|InitializeBalanceBatchLine|US LDG|Balance Init Group A|5|8191951|ET8191951|E8191951|Vision US Weekly|US Tax Reporting Unit|Medicare Employee Withheld|Relationship Tax Unit Year to Date||87| 
MERGE|InitializeBalanceBatchLine|US LDG|Balance Init Group A|6|8191951|ET8191951|E8191951|Vision US Weekly|US Tax Reporting Unit|Medicare Employee Withheld|Relationship Tax Unit Quarter to Date||87| 
MERGE|InitializeBalanceBatchLine|US LDG|Balance Init Group A|7|8191951|ET8191951|E8191951|Vision US Weekly|US Tax Reporting Unit|SIT Withheld|Relationship Tax Unit,State Year to Date|6|264.00| 
MERGE|InitializeBalanceBatchLine|US LDG|Balance Init Group A|8|8191951|ET8191951|E8191951|Vision US Weekly|US Tax Reporting Unit|SIT Withheld|Relationship Tax Unit,State Quarter to Date|6|264.00|
Note: When initializing specific balances, you may also need to initialize any related balances. This is simply an example to illustrate the process. For example, when initializing Federal Tax Withheld balance, related balances such as Federal Tax Subject and Federal Tax Gross may also need to be initialized, depending on your business needs.