POST

Aprobar una nómina

Scope:accounting:payrolls.write

https://api.holded.com/api/v2/payslips/{payslipId}/approve

Aprueba una nómina en borrador: deja de ser borrador y se contabiliza. Las nóminas son lo que vende la gema de Recursos Humanos, así que este endpoint la exige activa en la cuenta y responde 402 si no lo está. No es idempotente: aprobar una nómina ya aprobada responde 409 en vez de dar por bueno algo que no ha ocurrido. También responde 409 si el periodo contable de la fecha está cerrado, o si es una gratificación cuyas bases acumuladas han cambiado desde que se calculó — esa hay que regenerarla antes de aprobarla. Una nómina no es un registro salarial: si pides aquí el id de un registro salarial, la respuesta es 404 indicando el recurso que sí lo sirve.

Parámetros

Parámetros de ruta

payslipIdstringobligatorio

ID de la nómina (ObjectId hexadecimal de 24 caracteres)

Petición

python

import requests

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

response = requests.post(url, headers=headers)
print(response.json())

Respuestas

Respuesta

json

{
  "status": "approved"
}

Respuestas exitosas

200Nómina aprobadaapplication/json

object

statusstring

Enum:approved

Respuestas de error

400El identificador de la nómina no es válidoapplication/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

404Nómina no encontradaapplication/json

409La nómina no se puede aprobar en su estado actualapplication/json

object

typestring

titlestring

statusinteger

detailstring

422No se ha podido aprobar la nóminaapplication/json

429Límite de solicitudes excedidoapplication/json