Integration to tamigo

With the API integration to tamigo you can import and update employee data from Emply to tamigo. You can also specify a job to run daily, at a specific time.

Setting up the integration

The integration between Emply and tamigo is set up in tamigo.

1. Go to the plugin page in tamigo

The plugin page looks like this:

2. Specify the following:

• Emply API key
• Emply API customer name
• Emply API export ID
• Create daily import job

Emply API key

To generate you API key in Emply, go to Settings > Integrations > API > '+ New API key'. Or open an existing API key, and copy the API key.

Emply API customer name: Your company name, you use in Emply

Emply API export ID

Go to Settings > Integrations > Export > '+ New export' > select 'JSON Package'.

Give the export an internal description, enable 'Employee' and select the data for your JSON package. You can click on the 'Keywords' button, to insert the keywords directly.

Below you see an example of the export file. The first section 'Employees' are mandatory data to insert in your JSON package. 'CustomFields' are custom fields you choose yourself. Later in the article mapping of the fields will be explained.

{
  "Employees": [
     {
         "FirstName": "[form.masterdata.firstname]",
         "LastName": "[form.masterdata.lastname]",
         "WageNumber": "[element.employeenumber]",
         "CPR": "[form.masterdata.cpr_number]",
         "DateOfBirth": "[form.masterdata.dateofbirth]",
         "Gender": "[form.masterdata.gender]",
         "Email": "[form.masterdata.e_mail]",
         "Department": "[payroll.primary.department]",
         "Position": "[payroll.primary.jobtitle]",
         "StartDate": "[payroll.primary.employment_date]",
         "WageModel": "[element.wagemodel]",
         "ContractHoursWeek": "[form.masterdata.contracthours/week]",
         "HourlySalaryMonthlySalary": "[form.masterdata.Wagegroup]",
         "Telephone": "[form.masterdata.telephone(mobile)]",
         "Address": "[form.masterdata.address]",
         "City": "[form.masterdata.city]", 
         "AccountNo": "[form.masterdata.account_no.]",
         "RegNo": "[form.masterdata.reg._no.]",
          "CustomFields":
         [ {
              "Name": "example_1",
              "Value": "[form.stamdata.example.1]"
           },
            {
              "Name": "example_2",
              "Value": "[form.stamdata.example.2]"
            }
}
 

When you have set up your JSON export, copy the GUID at the bottom of the setup, which is the export ID you will need for the setup in tamigo.

Create daily import job

Here you choose between 'No' (default) or 'Yes'.

If 'Yes', a daily import job is set up, and you can specify the exact time for this tamigo job to run.

Mapping Emply data to tamigo fields

The data imported from Emply is mapped to tamigo fields as explained here:

Custom fields

Below you have an overview of all custom fields that can be used in the JSON package you set up in Emply.

All custom fields have the same name in API as in UI. They are passed in as an object with name CustomColumns.