Understanding the Integration Sync Log

When an integration is enabled on TravelPerk, you can download the integration's Sync Log, which outlines the updates and errors faced during the sync.

 

Download the Sync Log

  1. Go to Account Settings
  2. Select Integrations
  3. Find the integration and click Manage
  4. Click Download XLS Log 

 

Information stored in the Integration Sync Log

Employees Update tab

In the Employee Updates tab, you can find information about any user creations, user information changes, or user assignments made during the sync process.

Sucess codes 2.png

Errors Tab

The errors tab outlines any error that caused the sync to fail for some users. Remember that not all errors need to be resolved.

Here is a scenario where no further action is required:

Hire Rescinds

Users who are hire rescinds may not have a starting date in your HR tool. They may face an error code such as 'missing_start_date.'

No action will be needed for this User. You can be assured that no account will be created for this user in TravelPerk.

 

To fix the errors and make sure the user has a TravelPerk account created, follow the steps below depending on the error code:

Error Code Step-by-Step Resolution
USER FLOW ERROR CODES
MISSING_START_DATE
  1. Check if the user has a Start Date in their profile on the HR tool
  2. Add in a start date to their profile on the HR tool and save
  3. Run a manual sync on TravelPerk
MISSING_EMAIL
  1. Check if the user has a Work Email in their profile on the HR tool
  2. Add an email to their profile on the HR tool and save
  3. Run a manual sync on TravelPerk
MISSING_FIRST_NAME
  1. Check if the user has a First Name in their profile on the HR tool
  2. Add the first name to their profile on the HR tool and save 
  3. Run a manual sync on TravelPerk
MISSING_LAST_NAME
  1. Check if the user has a Last Name in their profile on the HR tool
  2. Add the last name to their profile on the HR tool and save
  3. Run a manual sync on TravelPerk
DATE_OF_BIRTH_IS_MISSING_OR_INVALID
  1. Check if the user has a Date of Birth in their profile on the HR tool
  2. Add or edit the date of birth in their profile on the HR tool with the correct format MM/DD/YYYY and save
  3. Run a manual sync on TravelPerk
PHONE_IS_MISSING_OR_INVALID
  1. Check if the user has a Contact Number in their profile on the HR tool
  2. Add or edit the contact number in their profile on the HR tool with the correct format:
    +(area code) (phone number) and save.

    Note: The space between the area code and phone number is mandatory. 

  3. Run a manual sync on TravelPerk
SEX_IS_MISSING_OR_INVALID
  1. Check if the user has a Gender in their profile on the HR tool
  2. Add or edit the gender in their profile on the HR tool and save.

    Note: Currently, we only have the M or F options. We are working on adding more options. 

  3. Run a manual sync on TravelPerk
USER_EXISTS_IN_INVITED_STATE
  1. On TravelPerk, go to the People page
  2. Select the Invited tab
  3. Find the relevant user and click on the 3 dots
  4. Click Revoke invitation
  5. Run a manual sync on TravelPerk
USER_HAS_UPCOMING_TRIPS

The user cannot be offboarded due to upcoming trips.

When the trips are complete, run a manual sync on  TravelPerk.  

USER_DUPLICATE_EMAIL
  1. On TravelPerk, go to the People page
  2. Search using the email address
  3. Delete the duplicate user or change the email address
  4. Run a manual sync on TravelPerk
USERNAME_INVALID

The email contains invalid characters such as special characters, for example : - , !.

  1. Check the User Name field in the user's profile on the HR tool
  2. Remove any invalid characters
  3. Run a manual sync on TravelPerk
APPROVAL FLOW ERROR CODES
MANAGER_DOES_NOT_EXIST

Check the name of the direct line manager in the  Supervisor field on the user's profile on the HR tool.

  • If the direct line manager is still valid, there may be an error causing the manager's user account not to be created. Check the error log to identify this error and resolve it.

  • If the direct line manager is not valid, change the information in the Supervisor field to the correct line manager. Then, run a manual sync on TravelPerk.
GUEST_MEMBERS_REQUIRE_APPROVAL_FOR_ALL_TRIPS
  1. On TravelPerk, go to Account settings
  2. Under Travel Management, select Approval processes
  3. Make sure that the user with the Guest role is assigned to an approval process where approval requests for all in-policy and out-of-policy trips will be sent to an approver
GUEST_USERS_CANNOT_BE_APPROVERS

If the user needs to be an approver:

  1. On TravelPerk, go to the People page
  2. Find the relevant user and click on the 3 dots
  3. Click Edit Personal
  4. Change the role of the Guest to one of the other roles
  5. Run a manual sync on TravelPerk

If the User does not need to be an approver:    Ensure that the user is not indicated as a direct line manager or found in the Supervisor field on the HR  tool. 

 

Was this article helpful?