Créer un département

POST

/api/payroll/departments

Crée un département de paie avec sa fréquence, ses premières dates de période et ses comptes de banque et de salaire net. Avec copy_gl_accounts_from, la ventilation comptable d'un département existant est copiée juste après la création ; si la copie échoue, le département est quand même créé et gl_copy indique l'erreur (rejouer via PATCH /by-id/{id}/gl-accounts). Si Acomba refuse la création, vérifiez la fréquence, le format d'heures, les périodes, les dates et les comptes.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

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

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 'https://relay.exostack.cloud//api/payroll/departments' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "bank_account_id": 175,
    "code": 3,
    "copy_gl_accounts_from": {
        "code": 1
    },
    "description": "Rénovation",
    "first_pay_period_pay_date": "2026-01-01T00:00:00-05:00",
    "first_pay_period_start_date": "2025-12-21T00:00:00-05:00",
    "frequency": 1,
    "hour_format": 2,
    "net_income_account_id": 23,
    "number_of_periods_annual": 53,
    "number_of_periods_taxable": 53,
    "sort_key": "RENOVATION"
}'

Response Example

{
    "action": "updated",
    "code": 1,
    "description": "Chantier",
    "fields_changed": [
        "number_of_periods_taxable"
    ],
    "id": 1,
    "propagated_to": [
        {
            "code": 2,
            "description": "Rénovation",
            "from": 52,
            "id": 2,
            "to": 53
        }
    ],
    "warnings": []
}

Modified at 2026-10-10 14:01:59

Lister les départements

Lire un département par ID