POST

Crear nóminas en bloque

Scope:accounting:payrolls.write

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

Crea nóminas en bloque para una colección de empleados dado un periodo de liquidación. La creación es asíncrona y el cuerpo de la respuesta va vacío: no hay identificador de trabajo ni endpoint para consultar el estado o el resultado.

Cuerpo de la petición

object

employee_ids[]string[]required

Empleados para los que crear una nómina (deben estar activos en la misma cuenta). Una solicitud crea una nómina por empleado

liquidation_period_start_datestring<date>required

Cualquier fecha dentro del periodo de liquidación para el que crear nóminas (ISO 8601, AAAA-MM-DD). Se usa el mes natural completo; no se admiten periodos anteriores a 2025

Petición

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())

Respuestas

Respuestas exitosas

202Creación de nóminas aceptada (cuerpo vacío)

Respuestas de error

400Solicitud incorrectaapplication/json

401API key inválida o no proporcionadaapplication/json

402La gema de Recursos Humanos no está activa para esta cuentaapplication/json

object

typestring

titlestring

statusinteger

detailstring

403Permisos insuficientesapplication/json

422La fecha de inicio del periodo de liquidación es anterior a 2025application/json

429Límite de solicitudes excedidoapplication/json