DELETE

Eliminar un pago de una nómina

Scope:accounting:payrolls.write

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

Elimina un pago ya registrado en una nómina, devolviendo su importe al saldo pendiente y ajustando `payment_status` en consecuencia. El `paymentId` se obtiene del array `payments` de `GET /api/v2/payslips/{payslipId}`; no se expone en ningún otro sitio. Si la nómina tiene varios pagos, lee ese array y confirma cuál hay que eliminar antes de llamar aquí — los importes y las fechas son lo que los distingue. 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á. 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)

paymentIdstringobligatorio

ID del pago (ObjectId hexadecimal de 24 caracteres)

Petición

python

import requests

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

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

Respuestas

Respuestas exitosas

204Pago eliminado

Respuestas de error

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 encontrada, o la nómina no tiene ningún pago con ese identificadorapplication/json

409El periodo contable de la fecha del pago o de la nómina está cerrado, u otro pago se está escribiendo para esta nóminaapplication/json

object

typestring

titlestring

statusinteger

detailstring

422No se ha podido eliminar el pagoapplication/json

429Límite de solicitudes excedidoapplication/json