DELETE

Delete a payslip

Scope:accounting:payrolls.write

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

Deletes a payslip (nómina). Draft payslips are deleted permanently; posted payslips reverse their ledger entries. This deletes a PAYSLIP, NOT a salary record (registro salarial) — use DELETE /api/v2/salary-records/{id} for those. Never call this endpoint when the user asks to delete a salary record, and never call the salary-record endpoint when the user asks to delete a payslip.

Parameters

Path parameters

payslipIdstringrequired

Payslip ID (24-character hexadecimal ObjectId)

Request

python

import requests

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

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

Responses

Success responses

204Resource deleted

Error responses

401Invalid or missing API keyapplication/json

403Insufficient permissionsapplication/json

404Payslip not foundapplication/json

409The accounting period of the payslip date is closedapplication/json

object

typestring

titlestring

statusinteger

detailstring

429Rate limit exceededapplication/json