Modifier une fonction d'un employé

PATCH

/api/payroll/employees/by-id/{id}/functions/by-id/{function_cp}

Modifie partiellement une fonction : seuls les champs envoyés sont écrits, et les règles propres à chaque champ sont décrites dans le corps de la requête. Envoyez unique (lu dans la fonction) pour vérifier que l'identifiant désigne toujours la même fonction. Changer is_active recalcule l'état de l'employé (actif tant qu'au moins une de ses fonctions l'est). Les valeurs qu'Acomba ne conserve pas sont listées dans warnings, et la modification est inscrite au journal d'audit de la paie.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Successful Response

Bodyapplication/json

🟠400

🟠401

🟠404

🟠409

🟠422

🔴500

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff --request PATCH 'https://relay.exostack.cloud//api/payroll/employees/by-id//functions/by-id/' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "ccq": {
        "annex": "C3"
    },
    "rates": [
        {
            "amount": 39.75,
            "code": 102
        }
    ],
    "region": 6,
    "unique": 2087
}'

Response Example

{
    "_links": {
        "ccq": "/api/payroll/employees/by-id/42/functions/ccq",
        "employee": "/api/payroll/employees/by-id/42",
        "functions": "/api/payroll/employees/by-id/42/functions",
        "self": "/api/payroll/employees/by-id/42/functions/by-id/412"
    },
    "action": "updated",
    "employee": {
        "code": "1042",
        "id": 42,
        "name": "Tremblay Marie"
    },
    "fields_changed": [
        "ccq.annex",
        "rates.102"
    ],
    "function": {
        "allocated_tips": {
            "index": 0,
            "rate": 0
        },
        "arrival_date": "2026-01-05T00:00:00Z",
        "ccq": {
            "annex": "C4",
            "bonus_lines": [
                {
                    "bonus_line": 104,
                    "percentage": 10,
                    "salary_line": 102,
                    "slot": 1
                }
            ],
            "occupation": 370,
            "region": 6,
            "sector": "C",
            "status": "E",
            "taxable_social_amount": 0,
            "taxable_social_benefits": 0,
            "union": "FTQ"
        },
        "conditions": {
            "ccq": {
                "active": true,
                "checked": true,
                "sector_active": true
            },
            "csst": {
                "active": true,
                "checked": true,
                "sector_active": true
            },
            "fss": {
                "active": true,
                "checked": true,
                "sector_active": true
            },
            "hourly_wage": {
                "active": true,
                "checked": true,
                "sector_active": true
            }
        },
        "department": {
            "code": 2,
            "description": "Rénovation",
            "id": 2
        },
        "description": "Charpentier-menuisier",
        "fss_exemption": false,
        "fss_exemption_rate": 0,
        "function_cp": 412,
        "index": 1,
        "is_active": true,
        "is_deleted": false,
        "is_used": true,
        "order": 1,
        "payroll_entry": true,
        "project": {
            "code": "0",
            "id": 1
        },
        "rates": [
            {
                "amount": 38.5,
                "code": 102,
                "effective_amount": 38.5,
                "label": "Salaire régulier horaire",
                "source": "amount",
                "table_index": 0
            },
            {
                "amount": 0,
                "code": 105,
                "effective_amount": 1.25,
                "label": "Prime de quart",
                "source": "table",
                "table": 3,
                "table_index": 2
            }
        ],
        "reference": 1,
        "region": 13,
        "sensitive": {},
        "specific_union": false,
        "unique": 2087,
        "updated_at": "2026-10-05T14:12:09Z",
        "user_fields": [
            {
                "format": "hours",
                "index": 2,
                "label": "Heures de formation",
                "scope": "function",
                "value": 7.5
            }
        ],
        "vacation_calculation_method": 2,
        "worked_hours": [
            {
                "code": 101,
                "hours": 40
            }
        ]
    },
    "warnings": []
}

Modified at 2026-10-09 19:59:12

Lire une fonction d'un employé

Lire les soldes de banques RH d'un employé par ID