Skip to main content
POST
Create a fixed item

Headers

Authorization
string
required

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

Body

application/json
amount
number<double>
required

The amount of the fixed item, in the currency of the work contract's establishment for a monetary nature, a quantity otherwise.

Example:

3000

natureId
integer<int32>
required

Unique identifier of the fixed nature; it cannot change once the item exists.

Example:

1

workContractId
integer<int32>
required

Unique identifier of the employee's work contract.

Example:

1481

amendmentId
integer<int32>
required

Identifier of the work contract amendment; 0 for the original contract.

Example:

0

periodStart
string<date>
required

The first day on which the fixed item applies, returned as startsOn.

Example:

"2026-01-01"

comment
string | null

A free comment explaining or justifying the fixed item, 140 characters at most.

Maximum string length: 140
Example:

"Annual salary review"

periodEnd
string<date> | null

The last day on which the fixed item applies, returned as endsOn; omit it for an open-ended item.

Example:

"2026-12-31"

Response

Created

A fixed remuneration item

id
integer<int32>

Unique identifier of the fixed remuneration item

amount
number<double>

The amount of the fixed remuneration item. Depending on the nature of the fixed item, the amount can be either a quantity or a monetary value.

startsOn
string<date>

The first day on which the fixed remuneration item applies.

endsOn
string<date> | null

The last day on which the fixed remuneration item applies.

comment
string | null

You can attach a comment to explain or justify the fixed item

Example:

"First-half salary increase"

natureId
integer<int32>

The nature id of the fixed remuneration item

nature
object

The nature of the fixed remuneration item

workContractId
integer<int32>

A fixed item must be linked to a work contract.

workContract
object

The work contract linked to the fixed item.