POST

Crear nòmines en bloc

Scope:accounting:payrolls.write

https://api.holded.com/api/v2/payslips

Crea nòmines en bloc per a una col·lecció d'empleats donat un període de liquidació. La creació és asíncrona i el cos de la resposta va buit: no hi ha identificador de treball ni cap endpoint per consultar l'estat o el resultat.

Cos de la petició

object

employee_ids[]string[]required

Empleats per als quals crear una nòmina (han d'estar actius al mateix compte). Una sol·licitud crea una nòmina per empleat

liquidation_period_start_datestring<date>required

Qualsevol data dins del període de liquidació per al qual crear nòmines (ISO 8601, AAAA-MM-DD). S'utilitza el mes natural complet; no s'admeten períodes anteriors a 2025

Petició

python

import requests

url = "https://api.holded.com/api/v2/payslips"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

payload = {
    "employee_ids": [
        "507f1f77bcf86cd799439011",
        "507f1f77bcf86cd799439012"
    ],
    "liquidation_period_start_date": "2026-01-01"
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())

Respostes

Respostes exitoses

202Creació de nòmines acceptada (cos buit)

Respostes d'error

400Sol·licitud incorrectaapplication/json

401API key no vàlida o no proporcionadaapplication/json

402La gemma de Recursos Humans no està activa per a aquest compteapplication/json

object

typestring

titlestring

statusinteger

detailstring

403Permisos insuficientsapplication/json

422La data d'inici del període de liquidació és anterior a 2025application/json

429Límit de sol·licituds exceditapplication/json