Ubiqod by Skiply 🤝 An activity tracking and customer feedback solution

What does this integration allow?

Would you like all or some of your employees to clock in and out using a physical badge reader? This is possible thanks to our partner Skiply, which offers various types of badge readers and sends the clocked-in times to Timmi Temps.

Specifically:

Employees clock in and out on a Skiply badge reader, and as soon as a time period is complete (in and out), it is sent to Timmi Temps and appears in the timesheet.
Employees can view the clocked-in times in their timesheets, complete them for days when they were not on site (e.g., remote work), and add comments before submitting their timesheets for approval.
Timmi Temps automatically calculates overtime and other variable pay elements, and raises alerts in case of any anomalies.

Connector operation and setup with Skiply

This integration has been developed by Skiply

How the integration works

- - Solutions involved: Timmi Timesheet
  - Type of integration: API
  - Integration direction: Ubiqod to Lucca
  - Integration frequency: Direct (as soon as clock-out is enabled)
  - Setting up the integration: you are free to save your URL and API key in your Ubiqod account

Synchronized data

During the data synchronization process, Ubiqod will transfer and retrieve the following data:

- the start and end of time submissions

And retrieve the following employee data

- Last name,
- First name,
- Contract start date
- Contract end date

Setting up the integration in Lucca

To activate the badging option on the employee file, you need to modify the time entry option in the relevant regulation. To do this, go to Configure> Time entry option > Prefilling feature > select "no prefilling - virtual badging sustem".

To set up integration, go to your Lucca space:

Click on the little rocket at the top right of your Lucca space
Select the "🔌Integrations" field
Search for the relevant application
Follow the instructions to create your pre-configured API key
The technical contact must be the e-mail address of your contact at the publisher.
The API key will be created automatically with the permissions required to set up the integration.
Send the generated API key and URL to the publisher, following the steps below

The connection steps to be completed in Ubiqod

1. Log in to your Ubiqod account.

2. Configure your Lucca connector:

Go to the Connectors page.
- Create a new Lucca type connector - Timmi Timesheet.
  - Enter the URL of your Lucca instance in the "URL" field (for example https://test.ilucca.net).
  - Enter the API key you generated in the "API Key" field.

You can edit the maximum transition time if you want to limit a transition time (between 1 and 24 hours).

Depending on your time zone, you can edit the time zone used to save the transition date (UTC by default, which means that no time zone is applied).

Notes about the interface: You can create a QR interface to integrate QR codes and Ubiqod Keys, or an IoT interface to integrate Skiply smart boxes (such as Clock S…).

Only apply the part of the file that corresponds to your use case.

3. Create your QR interface (for QR Codes and Ubiqod Keys):

Go to the Interfaces page, in the "PIN codes list" tab.
- Create a new PIN codes list.
  - Each code has a reference corresponding to the user’s PIN code, a label and a list of external references.
  - Fill in the list of external references for each reference by clicking the link icon.
  - Create the reference "Lucca: User ID". The value to be linked corresponds to the user ID in the Lucca platform (you can get this from the HR file URL in the list of employees for your instance)

You can create as many PIN codes as there are users to be integrated.
Note: Each PIN code must have its reference set to Lucca or their data will not be saved.

Go to the Interfaces tab.
- Create a new QR interface "Radio button".
  - Add PIN protection and link the PIN codes list you just created.
  - Create two buttons: one for arrival and one for departure. The references for both buttons must match those configured in your Lucca connector.

4. Create your IoT interface

Go to the Interfaces page, in the "Badge list" tab.
- Create a new badge list.
  - Each badge has a reference corresponding to the user’s badge number, a label and a list of external references.
  - Fill in the list of external references for each reference by clicking on the link icon.
Create the Lucca reference: User ID.
The value to be linked corresponds to the user ID in the Lucca platform (you can get this from the HR file URL in the list of employees for your instance)

You can create as many badges as there are users to be integrated.
Note: Each one must have its reference set to Lucca or their data will not be saved.

Go to the Interfaces tab.
- Create a new IOT interface.
  Note: In our example, we will create an interface for Clock S. Clock R and Clock ST are also compatible with this integration.
  - Link the list of badges you just created.
  - Link two buttons: one for Arrival and one for Departure. The references for both buttons must match those configured in your Lucca connector.

Link your settings with your tracker
- Go to the Trackers page, in the tab corresponding to the tracker to be created / modified (QOD, IoT or Ubiqod Key).
- Create or modify your tracker to display the edit page.
- Add the interface and connector you created to your tracker.

Assigning Lucca employees to Ubiqod badges

Navigate to the Connectors page.
- Select the Lucca - Timmi Temps connector you have created.
  - Go to "Configure PIN and badge lists" and click on Configure.
  - Select the badge list you want to modify. A dropdown tab will open, allowing you to directly associate a Lucca employee with a specific badge.
    This option can also be used to quickly and easily reassign old badges to new employees.

Limitations

The integration with Ubiqod has some limits, such as:

You must link the Lucca user reference with your PIN code or IoT badge to integrate your user properly with Lucca.
You cannot have two successive arrivals or departures for the same Lucca user.

If you encounter any of these limits, the data will not be sent to your Lucca instance. However, you will receive an email from Ubiqod telling you that your connector has received an error.

Data that could not be sent will be displayed in red in the connector log.

By clicking on … → View details → Server response, you should be able to see the cause of the error. This will allow you to fix it if necessary.

This erroneous data can then be replayed to send it back to your Lucca instance without editing the user’s arrival or departure date.