Cambio de Contrato(Tipo/Coeficiente)

Parámetros

• test (número (1)) : Para pruebas, añade el parámetro test=1. Para producción se debe omitir.
• regimen (número entero) : Régimen, 4 dígitos. Posibles valores:
  • 0111: Régimen general
  • Tabla con los códigos de régimen 
• ccc (número entero) : Cuenta de cotización, 11 dígitos.
• nss (número entero) : Número de Seguridad Social, 12 dígitos.
• dni (caracteres) : Documento Nacional de Identidad.
• startDate (date) : Fecha de cambio, formato YYYY-MM-DD..
• contractType (número entero) : Tipo de contrato, 3 dígitos.
• coeficiente opcional (número entero) : Coeficiente parcial, para jornada parciales, máximo 3 dígitos.
• worker_collective opcional (número entero) : Colectivo del trabajador, es obligatorio para tipos de contratos (402, 502, 407, 507), 3 dígitos. Posibles valores:
  • 967: CT circunstancias de la producción
  • Tabla con los códigos de la ocupación del trabajador 
• rlce opcional (número entero) : Relación Laboral de Carácter Especial (R.L.C.E.), 4 dígitos. Si se omite, se conserva el que tenga el trabajador en la TGSS. Ejemplo:
  • 9941: Entrenadores/monitores bonificados (Ley 7/2024)
• tgss_inactividad opcional (caracteres) : Tipo de inactividad de la pantalla de cambio de contrato (ATR45) del Sistema RED. Se envía tal cual a la TGSS, que rechaza los valores no válidos. Posibles valores: ver la tabla de tipos de inactividad. Los más habituales:
  • 1: periodo de inactividad
  • 2 / 3: huelga total / parcial
  • 5: ausencia del trabajo
  • 6: alta sin retribución
  • Z: inactividad no cotizada / permiso
• tgss_inactividad no se conserva. Si se omite o va vacío ("" / null), se envía vacío a la TGSS y se elimina el tipo de inactividad que tuviera el trabajador. A diferencia de rlce, omitirlo NO conserva el valor actual: para mantener una inactividad existente hay que reenviar su código, y para quitarla, enviarlo vacío.

• tgss_ctp_huelga opcional (número entero) : CTP Actvid. Huelga/ERE de la pantalla de cambio de contrato (ATR45) del Sistema RED. De 1 a 3 dígitos: son las milésimas del coeficiente, porque la TGSS pone un «0,» fijo delante (por ejemplo, 750 = 0,750). Saltra rellena con ceros a la izquierda hasta 3 dígitos antes de enviarlo: 75 = 0,075, 5 = 0,005. Es el coeficiente de la jornada trabajada: obligatorio con tgss_inactividad = 3 (huelga parcial), no se admite con 2 (huelga total) y nunca puede ser 0/000 (si no se trabaja ninguna parte de la jornada, es huelga total: tipo 2 sin CTP). Ver Reglas de la huelga.
• tgss_ctp_huelga no se conserva. Igual que tgss_inactividad: si se omite o va vacío ("" / null), se envía vacío a la TGSS y se elimina el CTP de huelga/ERE que tuviera el trabajador. Para mantenerlo hay que reenviar su valor, y para quitarlo, enviarlo vacío.

• tgss_ctp_inicial opcional (número entero) : CTP Inicial de la pantalla de cambio de contrato (ATR45) del Sistema RED. Distinto de tgss_ctp_huelga. De 1 a 3 dígitos: son las milésimas del coeficiente, porque la TGSS pone un «0,» fijo delante (por ejemplo, 750 = 0,750). Saltra rellena con ceros a la izquierda hasta 3 dígitos antes de enviarlo: 75 = 0,075, 5 = 0,005.
• tgss_ctp_inicial sí se conserva. Si se omite o va vacío ("" / null), no se envía y la TGSS mantiene el CTP inicial que tuviera el trabajador. A diferencia de tgss_inactividad y tgss_ctp_huelga, omitirlo no lo borra. Para quitarlo, envía 000 (también 0 o 00, que se rellenan a 000).

• reduccion_jornada opcional (caracteres) : Reducción de jornada (motivo) de la pantalla de cambio de contrato (ATR45) del Sistema RED, 3 dígitos. Solo se envía si la TGSS muestra ese campo para el tipo de contrato/coeficiente indicado; si la pantalla no lo muestra, se ignora sin error. Posibles valores (ejemplos):
  • 001: cuidado de menor
  • 002: cuidado de persona con discapacidad
  • 004: corresponsabilidad en el cuidado del lactante
  • Tabla con los códigos de reducción de jornada 
• reduccion_jornada sí se conserva. Si se omite o va vacío, no se envía y la TGSS mantiene la reducción de jornada que tuviera el trabajador. A diferencia de tgss_inactividad y tgss_ctp_huelga, omitirlo no la borra.

• Si no se envían ni contractType ni coeficiente (por ejemplo, para cambiar solo el rlce), el coeficiente de tiempo parcial se conserva.

Reglas de la huelga

Antes de enviar nada a la TGSS, la API comprueba el CTP de huelga según el tipo de inactividad y responde 422 (sin comunicar el trámite) en estos casos:

Los códigos se comparan sin ceros a la izquierda (02 es 2). Con el resto de tipos de inactividad (ERE/ERTE de reducción o suspensión) el CTP de huelga no se valida aquí: lo decide la TGSS.

Fin de la huelga. El ATR45 no tiene fecha de fin: la huelga se termina con otro cambio, con la fecha de fin como startDate y sin tgss_inactividad ni tgss_ctp_huelga (la TGSS los borra). Si el trabajador tiene su contrato en Saltra (se busca por el ccc entre las cuentas de tu empresa o, si eres un despacho, de las empresas que gestionas), el cambio queda guardado en él con su fecha y el fin de la huelga queda en el histórico como una entrada vacía: el periodo de huelga se conserva y el valor vigente queda vacío. Si no se encuentra el contrato, la respuesta es la misma y no se guarda nada en Saltra.

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

Respuesta

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

Tipos de inactividad

Valores posibles de tgss_inactividad (tabla de la TGSS; las descripciones son las abreviaturas oficiales):