Skip to main content
Sparkrock's Customer Success Center

OTIP Payroll Import

Payroll Import file

The Payroll Import file is provided by OTIP based on a predefined monthly schedule. It contains data for payroll amounts for the benefit plans under the administration of OTIP and can include the following:

  • Deduction amount (Employee Share),
  • Taxable benefit amounts (e.g. ER Paid Life/AD&D),
  • Retroactive amounts for any of the above,
  • Payroll Effective Date.

Note: The payroll amounts from the file are applicable only for the month of the payroll effective date and cannot be used in subsequent months. The amount can be deducted only once for the respective month.

Instructions on how to configure your system to use the data from the file are provided later in this document.

Integration setup

You will need to add information to the ON - OTIP Provincial Plan fast tab in order to complete the integration setup.

To complete the integration setup:

  1. Open the Integration Setup page and expand the ON - OTIP Provincial Plan fast tab.

The following table includes the information required for each field on the ON - OTIP Provincial Plan fast tab.

Field Description
To Process File Folder Location The location where you will store the file provided by OTIP.
Processed File Folder Location Once the file is imported, it will be moved to the folder specified in this field.
Error Log File Folder Location If errors exist with the file, the error log will be stored in the folder specified in this field.
Delete 1 Year Old Records When this field is checked, the system will check if OTIP related employees rates more than an year old exist and delete them at the time of the new import.

The above folders can be set up on either a shared network folder or the application server itself. 

  1. A network shared folder should be in UNC format: \\Servername\folder\folder\
  2. A folder from the application server should have the following format: C:\folder\folder

Certain permissions need to be granted to these folders:

  1. The NAV app service account needs to have full permissions to these folders.
  2. Users that will be using this functionality need to have access to these folders to access the files.

Configuration package

To complete the configuration of the the OTIP Payroll Import, we provide a configuration package that has the data needed to be in place for the integration to work.

Configuration package file

The configuration package file is available for download below.


Configuration package description

The tables that are part of the configuration package are as follows:

Table ID Table Name Actions performed by the configuration package
23020250 Benefit
Importing this table:
  1. Creates a Benefit Plan with code OTIP.
  2. Attaches the Payroll Control Group OTIP (created with this package) to this plan.

Configuration considerations:

  1. If you have an existing Benefit Plan in place, you can exclude the table from the import and attach the OTIP Payroll Control Group to the existing plan after the configuration package has been uploaded and applied.
  2. If you use the new Benefit Plan, then after the package is uploaded and applied you will need to update the benefit eligible HR Positions with the new benefit code.

NOTE: Payroll control groups are attached to benefit plans. A benefit plan can be attached to an HR Position. When this position is used on an HR Request the payroll controls from that group are added to the employee as employee payroll controls.

37032309 Payroll
Importing this table:
  1. Creates the payroll controls needed for the OTIP Payroll Import integration. These payroll controls have:
    • a Monthly Schedule = 1st Pay Period,
    • Category Code = OTIP,
    • Reporting Authority Code = OTIP.
37032310 Payroll
Importing this table:
  1. Creates a Payroll Control Group OTIP.


Importing this table:

  1. Adds the OTIP related payroll controls to the OTIP payroll control group.
  2. Attaches the Payroll Posting Group OTIP to the payroll controls in that group.
    NOTE: The group excludes the employer contribution payroll controls with the exception of the flat rate employer deduction control. For more information, please refer to Employer Deductions. In the event of OTIP changing their policy to exclude employer contributions from the data provided, these payroll controls can be added to the payroll control group and used.
37032322 Payroll

Importing this table:

  1. Creates a code for OTIP Payroll Posting Group
    Note: After applying the configuration package you need to link this posting group to your G/L accounts. If you would like to use existing payroll posting group and existing G/L Accounts you need to update the payroll posting group on the payroll control codes under the payroll control group OTIP.


Importing this table:

  1. Creates a Reporting Authority OTIP.
    NOTE: The reporting authority is used when you have Liabilities to AP. It allows you to link a vendor to the payroll control through the reporting authority. It is also used as a filter in the Payroll Response file.
37032344 Payroll

Importing this table:

  1. Creates the Payroll Rates applicable to OTIP together with the reference links to the columns in the Payroll Import file.
    NOTE: In the event of OTIP changing their format, the references on the payroll rates will have to be updated. Integration XRef refers to the deduction code from the OTIP file, the Integration Index refers to the file column that holds the respective deduction amount.
37032346 Base
Importing this table:
  1. Earnings base amount is brought to Distribute Employer Costs by dimension based on all earnings.


Importing this table:
  1. As above, contains only the details for the Earnings base amount code
37032349 Payroll
Importing this table:
  1. Creates the calculation methods for the OTIP related payroll controls. 
37032350 Payroll
Importing this table:
  1. Adds the method steps for the above calculation methods.
    Note: The method step used in the configuration package is 2608 AMOUNT IS EMP RATE PPSD is suitable for pay cycles that start at the beginning of a month, e.g. monthly or semi-monthly. If you have a bi-weekly pay cycle, please change your method step to 2703 AMOUNT IS EMP RATE PPED .


Category Code

Importing this table:
  1. Creates OTIP as a payroll control category and assigns it to the Payroll Controls. Can be used for additional filtering. 


Other setup

After the configuration package has been imported and applied additional configuration needs to be completed.

  1. Configure the Integration Setup as described earlier in this document.
  2. Review the OTIP related payroll controls and get familiar with which payroll control codes are applicable to your organization.
  3. Adjust your method steps based on your pay cycles
    • For pay cycles that start at the beginning of the month, e.g. monthly or semi-monthly, please use method step 2608 AMOUNT IS EMP RATE PPSD (a rate within the month where Pay Period Start Date falls). This is the method step included in the configuration package.
    • For bi-weekly pay cycles, please use method step 2703 AMOUNT IS EMP RATE PPED (a rate within the month where Pay Period End Date falls). You have to update your OTIP payroll controls either manually or by updating the configuration package provided.
  4. Add the OTIP related Payroll Controls to the applicable Calculation Orders.
  5. Link the OTIP Payroll Posting Group to G/L accounts. Or if you would like to use existing Payroll Posting Group and existing G/L Accounts, you need to update the Payroll Posting Group on the Payroll Control Codes under the payroll control group OTIP.
  6. For existing employees, the OTIP related Payroll Controls need to be attached to all employees that participate in the OTIP plan with Attach Payroll Control Group report.
  7. Attach the OTIP Benefit Plan to the Benefit Eligible Positions if you would like to use the new plan created by us. In the event you are using your own plan ensure that the Payroll Control Group on that plan is updated with the OTIP related Payroll Controls.
  8. If you would like to use Liability to AP, you need to link the OTIP Vendor to the Reporting Authority from the employer card. Otherwise you can manually create invoices for the reporting authority.
  9. If you would like to use a monthly schedule different from 1st Pay Period you should make the necessary adjustments.
    If you want to use the Lump Sum Employer Payroll Control provided, you need to:
  10. Add the employer rate OTIP ER to the relevant employers and assign the amount.
  11. Update the calculation order(s) with payroll control OTIP-ELHT ER.
    NOTE: It is expected that the OTIP HRIS Import has been set up before configuring the Payroll Import.

Employer deductions

As a result of the change to how OTIP handles employer contribution (lump sum per month) we have added an optional Employer Rate OTIP ER and Payroll Control Code OTIP-ELHT ER that you can use if you would like to allocate cost per employee per month based on a flat rate. This deduction might not reconcile to the lump sum you pay monthly as the number of employees can fluctuate but still provides you with an opportunity to do an approximate allocations for employer contributions.

To set this up:

  1. You have to add the employer rate to the employer and specify an amount.
  2. You have to make sure the reporting authority for this payroll control is blank or different from OTIP.
  3. You have to make sure the employer deduction payroll control is added as employee payroll control to the affected employees.
    NOTE: The employer deduction payroll control is added to the OTIP Payroll Control Group and the OTIP Benefit Plan as part of the configuration package update.
  4. You need to add the employer deduction payroll control to your calculation order(s).

Running the Payroll Import

You will need to run the Payroll Import report to have the information contained into it uploaded into your system.

To complete the import:

  1. Store the file provided by OTIP in the To Process File Order Location folder specified on the Integration Setup.
  2. Open the OTIP Payroll Import page.
  3. Add a Checkmark to Populate Payroll Deductions ONLY if you are generating a Payroll Response File from our system and you would like to only load the deductions information into the OTIP Payroll Deductions page.
  4. Click OK.
  5. A message will display if previous records exist on the Payroll Deductions page. Click Yes to replace them.
  6. Once the file is imported you will see a message that indicates that the file was successfully processed. Click OK.
  7. The file will be moved to Processed File Order Location folder specified on the Integration Setup.

With the import of the data coming from the Payroll Import the following records are being updated:

  1. OTIP ID is added to newly hired employees as reported in the HRIS Export.
  2. Employee Pay Rates are added per employee for the respective month. This data is then used for Payroll Calculations.
  3. The Payroll Deductions page is updated with the information from the file. It will be used as part of the payroll response process to send back comparison between the deductions sent by OTIP and the actual deductions during the respective month.

Processing the Payroll

Once you have all data imported and any additional configuration completed you are ready to run your payroll. Depending on how you have configured the monthly schedule on your payroll controls, the deduction amounts will be calculated in total in a pay cycle with a pay cycle period start date within the month to which the deductions apply. By default we are configuring the monthly schedule to be 1st Pay Period.

Finding Employee Rates 

Sparkrock provides two method steps that are used to find an employee rate that falls within the month of the payroll journal posting date. 

  • AMT IS EE RATE IN MO (Amount is Employee Rate for Entire Month based on Pay Date, Function No. 2704): If multiple rates are found, use the last one (or most recent date. For example, if rates from 3/25 and 3/5 are found, use the one from 3/25).
  • EXCEPT IF START>15 (Raise the Exception if Employee is not active at the 15th of the Month using PP End, Function No. 2705): If the assignment starts ON or AFTER the 15th of the month, the exception flag will fire. It looks at the oldest assignment. Note that the calculation start and end dates are used to determine if the assignment is active, but the assignment start/end dates are used to determine the 15th of the month rule.


  • Was this article helpful?