Consultar la situación del empleado en la empresa

Parámetros

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.
dni (caracteres) : Documento Nacional de Identidad.
startDate opcional (date) : Fecha de alta, formato YYYY-MM-DD.
first opcional (número entero) : Si quieres obtener únicamente un registro, el más reciente, los posibles valores son 1 o null.
getConvenio opcional (número entero) : Si quieres obtener los convenios de un trabajador. los posibles valores son 1 o null.
pl_period opcional (caracteres) : Consultar las peculiaridades, formato YYYY-MM. Ejemplo: 2025-03
getDatos opcional (número entero) : Si quieres obtener el cno. los posibles valores son 1 o null.
offset opcional (número entero) : Continuación paginada. Número de registros ya devueltos en llamadas anteriores que se deben omitir. Por defecto 0. Cada llamada devuelve como máximo 10 registros; usa este valor (o continueToken) para obtener los siguientes.
continueToken opcional (caracteres) : Token de continuación devuelto en la respuesta anterior cuando limitReached es true. Si se envía, el offset se recupera automáticamente de la sesión y no es necesario reenviarlo.

GET /employee-situations


{
  "regimen": "0111",
  "ccc": "12345678901",
  "dni": "12345678B",
  "startDate": "2023-01-01"
}

La respuesta devuelve como máximo 10 registros por llamada. Si el empleado tiene más situaciones, la respuesta incluirá limitReached: true junto con un bloque continueFrom y un continueToken. Para obtener los siguientes registros, repite la petición enviando ese continueToken (o el offset indicado en continueFrom). Cuando ya no quedan más registros, la respuesta vuelve a "message": "OK" sin limitReached.

Respuesta


{
  "success": true,
  "message": "OK",
  "data": [
    {
      "nss": "999999999999",
      "identificacion": "1",
      "dni": "012323132X",
      "fnacimiento": "1999-12-31",
      "sexo": "M",
      "nombres": "NOMBRE",
      "apellidos": "APELLIDOS",
      "tlf": "699999999",
      "regimen": "0111",
      "ccc": "28199999999",
      "situacion": "01",
      "situacion_text": "ALTA NORMAL",
      "grupo_cotizacion": "04",
      "grupo_cotizacion_text": "AYUDANTES NO TITULA",
      "tipo_contrato": "300",
      "coef": "075",
      "cno":"3820",
      "category_professional":"6100745",
      "fecha_alta": "2023-12-31",
      "fecha_baja": "2023-12-31",
        "pl": [
          {
            "tramo": "1",
            "titulo": "",
            "tipo_peculiaridad": "16",
            "tipo_peculiaridad_desc": "BON.P.F.EMPL.CUANTIA",
            "colectivo_incentivado": "1839",
            "colectivo_incentivado_desc": "TRANSF.IND.FOR-HOMB",
            "porcentaje": "",
            "fecha_desde": "2026-04-01",
            "fecha_hasta": "2026-04-30",
            "fraccion_cuota": "01",
            "fraccion_cuota_desc": "CUOTA EMPRESARIAL",
            "legislacion": "0243",
            "legislacion_desc": "RDL 1/2023",
            "cuantia": "128,00"
          }
      ]
    }
  ]
}

Respuesta con resultado limitado (continuación paginada)

Cuando el empleado tiene más de 10 situaciones, la respuesta marca limitReached: true y añade los datos necesarios para continuar. Repite la petición enviando el continueToken (o el offset de continueFrom) para obtener el siguiente bloque.

Respuesta (limitada)


{
  "success": true,
  "message": "Resultado limitado a 10 registros. Puede continuar la consulta para obtener los siguientes.",
  "data": [
    {
      "nss": "999999999999",
      "dni": "012323132X",
      "regimen": "0111",
      "ccc": "28199999999",
      "situacion_text": "ALTA NORMAL",
      "tipo_contrato": "100",
      "fecha_alta": "2023-01-16"
    }
  ],
  "limitReached": true,
  "continueFrom": {
    "regimen": "0111",
    "ccc": "28199999999",
    "nss": null,
    "dni": "012323132X",
    "offset": 10,
    "continueToken": "emp_situations_0111_28199999999_012323132X"
  },
  "continueToken": "emp_situations_0111_28199999999_012323132X"
}

GET /employee-situations (siguiente bloque)


{
  "regimen": "0111",
  "ccc": "12345678901",
  "dni": "12345678B",
  "continueToken": "emp_situations_0111_28199999999_012323132X"
}