Contract change (type/coefficient)

Parameters

• test (number (1)) : For testing, add the test=1 parameter. It must be omitted in production.
• regimen (integer) : Scheme, 4 digits. Possible values:
  • 0111: General Scheme
  • Table of scheme codes (opens in a new tab)
• ccc (integer) : Contribution account code, 11 digits.
• nss (integer) : Social Security number, 12 digits.
• dni (string) : National identity document.
• startDate (date) : Change date, format YYYY-MM-DD..
• contractType (integer) : Contract type, 3 digits.
• coeficiente optional (integer) : Part-time coefficient, for part-time working hours, maximum 3 digits.
• worker_collective optional (integer) : Worker collective; mandatory for contract types (402, 502, 407, 507), 3 digits. Possible values:
  • 967: TC production circumstances
  • Table of worker occupation codes (opens in a new tab)
• rlce optional (integer) : Special Employment Relationship (R.L.C.E.), 4 digits. If omitted, the worker keeps the one already registered at TGSS. Example:
  • 9941: Subsidised coaches/instructors (Law 7/2024)
• tgss_inactividad optional (string) : Inactivity type from the RED System contract change screen (ATR45). It is sent to TGSS as is, and TGSS rejects invalid values. Possible values: see the table of inactivity types. The most common:
  • 1: period of inactivity
  • 2 / 3: full / partial strike
  • 5: absence from work
  • 6: registration without pay
  • Z: non-contributory inactivity / leave
• ⚠️

  tgss_inactividad is not preserved. If omitted or empty ("" / null), it is sent empty to TGSS and the worker's current inactivity type is removed. Unlike rlce, omitting it does NOT keep the current value: to keep an existing inactivity you must resend its code, and to clear it, send it empty.

• tgss_ctp_huelga optional (integer) : Strike/ERE activity CTP ("CTP Actvid. Huelga/ERE") from the RED System contract change screen (ATR45). 1 to 3 digits: they are the thousandths of the coefficient, because TGSS shows a fixed "0," in front (for example, 750 = 0.750). Saltra left-pads it with zeros to 3 digits before sending it: 75 = 0.075, 5 = 0.005. A 0 counts as empty.
• ⚠️

  tgss_ctp_huelga is not preserved. Same as tgss_inactividad: if omitted or empty ("" / null), it is sent empty to TGSS and the worker's current strike/ERE CTP is removed. To keep it you must resend its value, and to clear it, send it empty.

• tgss_ctp_inicial optional (integer) : Initial CTP ("CTP Inicial") from the RED System contract change screen (ATR45). Different from tgss_ctp_huelga. 1 to 3 digits: they are the thousandths of the coefficient, because TGSS shows a fixed "0," in front (for example, 750 = 0.750). Saltra left-pads it with zeros to 3 digits before sending it: 75 = 0.075, 5 = 0.005.
• tgss_ctp_inicial is preserved. If omitted or empty ("" / null), it is not sent and TGSS keeps the initial CTP the worker already has. Unlike tgss_inactividad and tgss_ctp_huelga, omitting it does not clear it. To remove it, send 000 (0 or 00 also work: they are padded to 000).

• reduccion_jornada optional (string) : Working-day reduction (reason) from the RED System contract change screen (ATR45), 3 digits. It is only sent if TGSS shows that field for the given contract type/coefficient; if the screen does not show it, it is ignored without error. Possible values (examples):
  • 001: care of a minor
  • 002: care of a disabled person
  • 004: shared responsibility for infant care
  • Table of working-day reduction codes (opens in a new tab)
• reduccion_jornada is preserved. If omitted or empty, it is not sent and TGSS keeps the working-day reduction the worker already has. Unlike tgss_inactividad and tgss_ctp_huelga, omitting it does not clear it.

• If neither contractType nor coeficiente is sent (for example, to change only rlce), the part-time coefficient is kept.

{
  "regimen": "0111",
  "ccc": "12345678901",
  "dni": "12345678B",
  "nss": "123456789011",
  "startDate": "2023-01-01",
  "contractType": "100",
  "coeficiente": "500",
  "worker_collective": "967",
  "rlce": "9941",
  "reduccion_jornada": "001"
}

Response

{
  "success": true,
  "message": "OK"
}

Inactivity types

Possible values of tgss_inactividad (TGSS table; the descriptions are the official TGSS abbreviations):