Import entitlements

curl --request POST \
  --url https://{host}/timmi-absences/api/public/services/v1.0/leaveEntitlementsImport \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'File=<string>' \
  --form 'Description=<string>' \
  --form ReferenceDate=2023-11-07T05:31:56Z

{
  "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"
    }
  }
}

Imports

Import 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

leaveEntitlementsImport

Import entitlements

curl --request POST \
  --url https://{host}/timmi-absences/api/public/services/v1.0/leaveEntitlementsImport \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'File=<string>' \
  --form 'Description=<string>' \
  --form ReferenceDate=2023-11-07T05:31:56Z

{
  "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"
    }
  }
}

Headers

Authorization

string

required

API key. Value must be formatted like so: lucca application={api_key}.

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<date-time>

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

Response

Example response

successLinesCount

integer

globalErrors

object

lineErrors

object

Get a SickLeaveCertificate

Replace entitlements

Documentation

Files

Organization Structure API

Core HR API

Expenses API

Invoices API

Absences API

Office API

Project API

Time Settings API

Timesheet API

Mealvouchers API

Compensation API

Training API

Import entitlements

Headers

Query Parameters

Body

Response