Skip to main content

Setting Up Definitiv Integration

This article takes you through connecting Definitiv with Traffio

Written by Traffio

​​Create a Connection

  1. Navigate to Integrations on the sidebar

  2. Select the Connections tab

  3. Click +New

  4. Select Definitiv from the integration dropdown list

  5. Enter Connection Name

  6. Click Create

  7. Enter the Definitiv instance URL and API key (provided by Definitiv)

  8. Click Save (this will automatically try to establish connection with the provided credentials)

  9. Choose a Definitiv Organisation

  10. Click Save

  11. Click the Sync with Definitiv button (to import payroll data)


Mapping Traffio to Definitiv

  1. Navigate to Integrations on the sidebar

  2. Select the Connections tab

  3. Click open an existing Definitiv connection

  4. Select the desired tab (employees, roles, depots, pay items, site allowance rates)

  5. Match the those listed on the left-hand side (from the Traffio system) with those on the right-hand side (e.g. Traffio person -> Definitiv employee)

  6. Click Save

  7. When maping Traffio's payable hours to Definitiv Pay Items, please note that different mappings can be created for every Payroll Category and EBA entered into Traffio.


Starting the Integration for Payroll

To begin integrating your payroll with Definitiv, please follow the steps below:

Note: You can only proceed with this if your Traffio account has payroll access. If you do not have this access, please contact your manager, who can grant you access through the access levels.

  1. Navigate to Payroll on the sidebar

  2. Select the Payroll Cost Centre tab across the top

  3. Either open an existing cost centre, or click +New to create another

  4. Choose Definitiv from the Integration Dropdown

  5. Choose your Connection

  6. Choose a Definitiv Project (this is the equivalent to a Traffio Payroll Cost Centre)

  7. Click Save

Pushing Pay Run to Definitiv

  1. Navigate to Payroll on the sidebar

  2. Select the Pay run tab

  3. Click +New

  4. Choose the Definitiv payroll cost centre.

  5. Click Push to Definitiv button for the entire pay run.

  6. Or choose a person to push individual payroll data.


    Traffio manages your Definitiv external payroll transactions

    Once this integration is connected, Traffio handles all external payroll transactions in Definitiv for you — make any changes in Traffio and re-push the pay run, and it will reconcile everything in Definitiv. Already-processed transactions are always left untouched.

Did this answer your question?