The integration between Figures and Lucca allows you to automatically synchronize employee data from Lucca to your Figures account, enabling daily data updates.
This guide aims to assist you in setting up this integration correctly and efficiently.
API Key creation
⚠️ Make sure you have administrator access to the Lucca platform and to your Figures account.
Follow the instructions provided in the Lucca documentation to create your API key.
The permissions you need to grant to your API key depend on the module you are using to store compensation data in Lucca: Pagga Compensation or HR Folder.
Specific permissions for Pagga Compensation
Co-workers section
✅ View the Lucca employee data
(this permission provides access to employee administrative information such as Name, First Name, Work Location, Job Title, etc.)
Pagga Compensation section
✅ Consult individual situations
(this permission provides access to employee compensation information in Pagga Compensation)
Specific permissions for HR File
Co-workers section
✅ View the Lucca employee data
(this permission provides access to employee administrative information such as Name, First Name, Work Location, Job Title, etc.)
✅ View the personnel file > My HR Info
(this permission provides access to employee compensation information in HR File)
💡 To enable integration if you are not using Pagga, salaries need to be saved in the HR file in the format shown in the screenshot below:
Setting up the integration in Figures
Go to Data & integrations in your Figures account
Search for "Lucca" in the list and click Connect.
3. Provide URL and API Key: On the Lucca section, provide the URL of the Lucca platform (in the format https://xxxx.ilucca.net) as well as the API key you previously created in Lucca. If wanted, you can also choose to anonymize employee data sent to Figures. Then click save.
4. Once the integration is saved for the first time, you'll have the option to add custom fields for seniority level, employee number, or variable bonus. You can select these details from the same Integration / Lucca / Connect tab.
Since July 2024, we have added the Remuneration items field that allows you to choose the exact field value from when you want Figures to get the information from your Personio for the Base Salary, Variable bonus, or any other bonus (by clicking on Add new remuneration items) and select its frequency (every month, every quarter, every year).
5. Save to Complete: Once all information is provided, make sure to save in order to finalize the synchronization. Updates will automatically occur every 24 hours, but you can also manually trigger a synchronization if needed by clicking the red link below:
6. Automatic synchronization: Once information is provided, data will automatically synchronize between Lucca and Figures. Employees will appear in Figures with an "unmapped" status.
7. Complete missing information:
To finalize mapping, fill in missing information in the Mapping tab to establish correspondence between your data and Figures' data. Once all information is filled, automatic mapping of future employees will be possible if information is already completed in Figures.
You can also access each employee's file from the Imported Employees tab. A file will open to complete mandatory missing information (marked with *).