POST

Aprovar una nòmina

Scope:accounting:payrolls.write

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

Aprova una nòmina en esborrany: deixa de ser esborrany i es comptabilitza. Les nòmines són el que ven la gemma de Recursos Humans, així que aquest endpoint l'exigeix activa al compte i respon 402 si no ho està. No és idempotent: aprovar una nòmina ja aprovada respon 409 en comptes de donar per bo allò que no ha passat. També respon 409 si el període comptable de la data està tancat, o si és un rebut retroactiu (`gratificacion_no_cuantificable` o `atrasos`) amb les bases acumulades canviades des que es va calcular — aquell s'ha de regenerar abans d'aprovar-lo. Una nòmina no és un registre salarial: si demanes aquí l'id d'un registre salarial, la resposta és 404 indicant el recurs que sí que el serveix.

Paràmetres

Paràmetres de ruta

payslipIdstringobligatori

ID de la nòmina (ObjectId hexadecimal de 24 caràcters)

Petició

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

Respostes

Resposta

json

{
  "status": "approved"
}

Respostes exitoses

200Nòmina aprovadaapplication/json

object

statusstring

Enum:approved

Respostes d'error

400L'identificador de la nòmina no és vàlidapplication/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

404Nòmina no trobadaapplication/json

409La nòmina no es pot aprovar en el seu estat actualapplication/json

object

typestring

titlestring

statusinteger

detailstring

422No s'ha pogut aprovar la nòminaapplication/json

429Límit de sol·licituds exceditapplication/json