Skip to main content

BTR International Integration

Written by Carlo Arazas

The BTR International integration allows integration for Move Management and Destination Services.

Connecting BTR International to Workia

Click on your Profile icon on the top right corner to open the drop-down menu, hover over "Settings" and click on the Connections setting to open the Connections screen.

On the Connections screen, look for BTR International and click Connect.

Once you have opened the connection settings screen, you will be prompted to input the Supplier Connection Key. Click Connect to proceed with the connection!

šŸ’”Note: This connection needs a key. If you do not have one, you can contact [email protected] to request one.

Initiating a BTR International service

Once the connection is successfully established, you can initiate BTR International services directly from your case record.

When initiating a specific service, key details such as employee information, passport data, case specifics, and, if applicable, spouse and dependent details, are mapped and sent to BTR International.

Below is a list of available fields. Mandatory fields are marked with an asterisk (*) and must be completed for the service to work.

Case

  • Start Date*

  • End Date*

  • Status*

  • Origin Country*

  • Origin State/Province*

  • Origin City

  • Case Type*

  • Owner*

  • Billing Entity*

  • Comment

Employee

  • First Name*

  • Middle Name

  • Last Name*

  • Email*

  • Gender

  • Date of Birth*

  • Citizenship*

  • Marital Status*

Spouse

  • First Name*

  • Middle Name

  • Last Name*

  • Relationship*

  • Is Accompanying

Dependent

  • First Name*

  • Last Name*

  • Relationship*

  • Is Accompanying*

Documents

HRIS Integration Updates to Cases

Employee-level fields

These live on the employee record itself, not on any individual case

  • First Name, Middle Name, Last Name

  • Gender

  • Marital Status

  • Employee Number

  • Date of Birth

  • Employee Address (Country)

  • Phone Number

  • Email

  • Annual Base Salary, Base Pay Effective Date, Base Pay Currency

  • Hire Date

  • Employee Status

  • Termination Date

šŸ’”Note: When HRIS updates one of these, it updates the employee record directly, so the change shows up on all of that employee's cases, regardless of case status.

Case-level fields

These are tied to the specific case, not the employee as a whole:

  • Home Legal Entity, Host Legal Entity

  • Home Cost Center, Host Cost Center

  • Bonus Amount, Bonus Currency

  • Job Grade

  • Job Title

šŸ’”Note: These update on all of the employee's active cases, but not on cases that are completed, cancelled, or repatriated. So if an employee has one active case and one completed case, a new Cost Center would update the active case only — the completed case stays as it was.

Did this answer your question?