Introduction

Files

Organization Structure API

Axis-sections
Departments
Legal-Units
Establishments

Core HR API

Employees Directory
Guides

Cleemy Expenses API

Expense-temp-items
Expense-claims
Expense-claim-items

Timmi Absences API

Timmi Office API

User-locations
Work-locations

Timmi Project API

Clients
Projects
Project services
Organizations
Financials

Timmi Settings API

UserDates
Workcycle-exceptions
Working-time-arrangement

Timmi Timesheet API

Time-entries
Timesheets
Reports
Guides

Pagga Mealvouchers API

Statutory
Computation

Pagga Remuneration API

Fixed-natures
Fixed-items
Variable-natures
Variable-items

Poplee Training API

Training-demands
Realized-trainings

Imports

Replace entitlements

Supported file formats:

CSV
- “UTF-8” encoding
- separator “;”
XSLX

Columns to fill in:

Column name	Description
`LegalEntityCode`	Employee legal entity code.
`EmployeeNumber`	Employee payroll number.
`LastName`	Last name.
`FirstName`	First name.
Account number or name (one column per account)	Value to import for the account defined in the header.

Remark: A template file can be downloaded from the import page (Credit / Debit> A group of collaborators> File import).

In the event of a malformed (or unrecognized) file, no data will be imported; the problems detected will be specified in the globalErrors field.

If successful, the number of imported lines is indicated by the “successLinesCount” field; the lines in error are detailed in the lineErrors field.

Remarks: Any import made by the API is of course available in the import history. A simulation returns the same level of information, but does not trigger an import

List of errors handled

Here is the list of fatal errors, which can be returned in the globalErrors:

Unauthorized
FileEmpty,
FileExtensionNotSupported,
ColumnsFormatNotSupported,
AccountColumnMissing,
ColumnNamesDistinct,
LineErrorForbiddenInStrictMode,

The list of line processing errors, which can be restored in the lineErrors:

AccountNotFound,
AccountsNotFound,
AccountColumnsProcessing,
LegalEntityCodesNotFound,
MissingValuesForAccount,
AccountNotAvailableForUser,
LegalEntityCodeRequired,
EmployeeNumberRequired,
LoginRequired,
LoginNotFound,
AccountNumberRequired,
LegalEntityNotFound,
EmployeeNumberNotExist,
EmployeeNumberNotInLegalEntity,
FistNameAndLastNameNotMatching,
FistNameNotMatching,
LastLameNotMatching,
FistNameAndLastNameNotMatchingEmployeeNumber,
FistNameNotMatchingEmployeeNumber,
LastLameNotMatchingEmployeeNumber,
FistNameAndLastNameNotMatchingLogin,
FistNameNotMatchingLogin,
LastLameNotMatchingLogin,
DuplicatedLine,
AmbiguousLegalEntity,
ColumnNotExists,
LegalEntityNameNotAvailable,
AccountNameNotUnique

The list of import generation errors:

UnableToCreditAccount

POST

timmi-absences

api

public

services

v1.0

leaveEntitlementsReplace

curl --request POST \
  --url https://{account}-{sandboxName}.sandbox.{server}.luccasoftware.com/timmi-absences/api/public/services/v1.0/leaveEntitlementsReplace \
  --header 'Content-Type: multipart/form-data' \
  --form 'File=<string>' \
  --form 'Description=<string>' \
  --form ReferenceDate=2023-11-07T05:31:56Z \
  --form 'EntryTypes=AutoAccruals,ManualAccruals,Regularizations'

{
  "successLinesCount": 0,
  "globalErrors": {
    "columnsFormatNotSupported": "The file must have columns 'login, lastName, firstName' or 'code, employeeNumber, lastName, firstName'."
  },
  "lineErrors": {
    "7": {
      "loginNotFound": "User login not found"
    },
    "8": {
      "duplicatedLine": "Line 8 is identical to line 23"
    },
    "9": {
      "lastLameNotMatchingLogin": "Lastname does not match to the login of this employee",
      "accountNotAvailableForUser": "The user does not have access to the account 6"
    }
  }
}

Query Parameters

strict

boolean

default:

false

In strict mode, if the import has errors, nothing is imported. Without strict mode, the lines in error are ignored and those in success are imported.

simulate

boolean

default:

false

Allows you to simulate the import. In this case, the response indicates the theoretical result of the import without any data being recorded.

Body

multipart/form-data

File

string

Description

string

Description of the entries generated by the import (visible to users in the account details).

ReferenceDate

string

Reference date (text mode). Respect the format: yyyy-MM-ddThh: mm: ss

EntryTypes

string

default:

AutoAccruals,ManualAccruals,Regularizations

Types of entries to take into account, separated by commas, from the following list: AutoAccruals, ManualAccruals, Regularisations, EntitlementsImport, Seniority, Fractionnement, TimeSavings, Comp

By default: AutoAccruals, ManualAccruals, Regularizations which correspond to the main cases of acquisition (automatic acquisition, manual adjustments, regularisations).

Response

200

application/json

Example response

successLinesCount

integer

globalErrors

object

lineErrors

object

Was this page helpful?

Import entitlements Import leaves

curl --request POST \
  --url https://{account}-{sandboxName}.sandbox.{server}.luccasoftware.com/timmi-absences/api/public/services/v1.0/leaveEntitlementsReplace \
  --header 'Content-Type: multipart/form-data' \
  --form 'File=<string>' \
  --form 'Description=<string>' \
  --form ReferenceDate=2023-11-07T05:31:56Z \
  --form 'EntryTypes=AutoAccruals,ManualAccruals,Regularizations'

{
  "successLinesCount": 0,
  "globalErrors": {
    "columnsFormatNotSupported": "The file must have columns 'login, lastName, firstName' or 'code, employeeNumber, lastName, firstName'."
  },
  "lineErrors": {
    "7": {
      "loginNotFound": "User login not found"
    },
    "8": {
      "duplicatedLine": "Line 8 is identical to line 23"
    },
    "9": {
      "lastLameNotMatchingLogin": "Lastname does not match to the login of this employee",
      "accountNotAvailableForUser": "The user does not have access to the account 6"
    }
  }
}