Skip to main content
GET

Get salary record form data

Scope:accounting:payrolls.read
https://api.holded.com/api/v2/salary-records/form-data

Returns the defaults needed to create a salary record: the top-level result/counterpart account (`default_accounting_account_id`, e.g. "465 Remuneraciones pendientes de pago") and the default payroll lines (`default_lines`) with the accounting account, tax key and description per line type, resolved from the account's payroll scheme. Call this before creating a salary record and use the returned accounting account IDs — never ask the user for them. They come from here, or from the employee's `payroll_accounts` when configured (employee-specific accounts take precedence). Amounts in `default_lines` are placeholders ("0") and must be replaced with the amounts the user provides.

Request

python
import requests

url = "https://api.holded.com/api/v2/salary-records/form-data"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

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

Responses

Response

json
{
  "default_accounting_account_id": "507f1f77bcf86cd799439013",
  "default_lines": [
    {
      "type": "salary",
      "amount": "0",
      "accounting_account_id": "507f1f77bcf86cd799439014",
      "tax_key": "e_salario",
      "description": "Salario"
    }
  ]
}

Success responses

200Salary record creation defaultsapplication/json
object
default_accounting_account_idstring | null

Default top-level accounting account for the salary record: the result/counterpart account where the net payable is posted (e.g. "465 Remuneraciones pendientes de pago"). Use it as `accounting_account_id` when creating, unless the employee has its own `payroll_accounts.result` configured.

default_lines[]object[]

Default payroll lines from the account payroll scheme. One entry per line type with the accounting account, tax key and description already resolved — copy them verbatim into the create request. The "0" amounts are NOT usable values: you MUST ask the user for the real amount of every line and replace each "0" before creating. Never submit a line with amount "0".

typestring

Line type (e.g. salary, retention, tax, companytax)

amountstring

Placeholder amount, always "0"

accounting_account_idstring | null

Default accounting account for this line type

tax_keystring | null

Default tax key for this line type (e.g. e_salario, e_retencion). Copy it verbatim into the create request.

descriptionstring | null

Default line description (concept label, e.g. "Salario", "Total S.S."). Copy it verbatim into the create request.

Error responses

401Invalid or missing API keyapplication/json
403Insufficient permissionsapplication/json
429Rate limit exceededapplication/json