ETTS

ETTS

ETTS (Empresas de trabajo temporal)).

Parámetros en la cabecera HTTP

  • Authorization (caracteres): Autorización de la API. Ejemplo: Bearer {token}
  • X-Cert-Secret (caracteres) : Clave secreta asociada al certificado del cliente.

URL base

https://api.saltra.es/api/v4/seg-social

Errores

Los errores recibidos en la API de Seguridad Social o errores de validación.

Parámetros de respuesta

  • success (booleano) : La respuesta "true" cuando todo esta correcto, y "false" cuando hay errores.
  • message (caracteres) : El mensaje de la respuesta.
  • errors (arreglo) : Los errores capturados en la API, ya sea de la seguridad Social o errores de validación.
    • tgss: Errores relacionados con la Seguridad Social.
    • regimen: Errores de validación.
  • maintenance (booleano) : Cuando la Seguridad Social se encuentra en mantenimiento.

Respuesta

Respuesta
{
  "success": false,
  "message": "Página no operativa, inténtelo de nuevo más tarde. StatusCode: 500",
  "status": 500,
  "data": [],
  "errors": {
    "tgss": [
      "Página no operativa, inténtelo de nuevo más tarde. StatusCode: 500"
    ],
    "regimen": ["El campo regimen es obligatorio."]
  },
  "maintenance": true
}

Dar un alta

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:
  • ccc (número entero) : Cuenta de cotización, 11 dígitos.
  • nss (número entero) : Número de Seguridad Social, 12 dígitos.
  • identificacion (número entero) : Número de identificación, posibles valores:
    • 1: DNI
    • 2: Pasaporte
    • 6: NIE
  • dni (caracteres) : Documento Nacional de Identidad.
  • fecha_real (date) : Fecha de alta, formato YYYY-MM-DD.
  • grupo_cotizacion (número entero) : Grupo de cotización, máximo 2 dígitos. Posibles valores:
  • tipo_contrato (número entero) : Tipo de contrato, 3 dígitos. Posibles valores:
  • cno (número entero) : Clasificación Nacional de Ocupaciones, máximo 4 dígitos. Posibles valores:
  • category_professional (número entero) : Categoría profesional, válido solo para Régimen de Artista (0112), 7 dígitos, Obligatorio. Posibles valores:
  • coeficiente (número entero) : Coeficiente parcial, para jornada parciales, máximo 3 dígitos. Opcional.
  • rlce (número entero) : Relación Laboral de Carácter Especial, máximo 4 dígitos, opcional. Posibles valores:
  • worker_collective (número entero) : Colectivo del trabajador, es obligatorio para tipos de contratos (402, 502, 407, 507), 3 dígitos, opcional. Posibles valores:
  • ocupacion (caracteres) : Ocupación del trabajador, opcional. Posibles valores:
  • convenio (número entero) : Convenio colectivo, 14 dígitos, opcional. Posibles valores:
  • modalidad_ctz (número entero) : Modalidad de cotización, válido para Régimen Agrario (0163), opcional, posibles valores:
    • 1: Cotización mensual
    • 2: Jornadas reales
  • fic (date) : Fecha de inicio de contrato específico, Para cambio entre cuentas de cotización dentro de la misma empresa o grupo de empresas, formato YYYY-MM-DD. Opcional.
  • sust_cause (número entero) : Causa de sustitución, 2 dígitos, opcional. Posibles valores:
  • sust_nss (número entero) : Número de Seguridad Social, 12 dígitos, obligatorio si tiene causa de sustitución. Opcional.
  • duplicate (número entero) : Obtener el PDF en base64 y en formato json en la respuesta, los posibles valores son 1 o null. Opcional.
  • obtener_idc (número entero) : Obtener el idc PDF en base64 y en formato JSON en la respuesta, los posibles valores son 1 o null. Opcional. La respuesta en la petición será mas lenta.
  • exc_ctz (número entero) : Tipo de relación laboral, 3 dígitos, opcional. Posibles valores:
  • cond_desempleado (caracteres): Condición de desempleo, opcional. Posibles valores:
  • beneficios (caracteres): Beneficios, opcional. Cuando cond_desempleado = 1 es requerido. Posibles valores:
  • fom_empl_agrario (número entero): Para Régimen Agrario, opcional. Posibles valores:
    • 1: Fomen. Empl. Agrario
    • 2: Con exceso de cotización < 30D.
  • sexo (caracteres) : Sexo, opcional. Posibles valores:
    • M: Masculino
    • F: Femenino
  • fnacimiento (fecha) : Fecha de nacimiento, opcional. Formato YYYY-MM-DD.
  • cesion_regimen (números entero) : Régimen, 4 dígitos. Posibles valores:
  • cesion_ccc (número entero) : Cuenta de cotización, 11 dígitos.
  • cesion_tipo (número entero) : Posibles valores:
    • 01: Enclave laboral
    • 02: ETT
    • 03: Subcontr. Obras-Servicios
    • 04: Gestión nautica
POST /alta
{
  "test": 1,
  "regimen": "0111",
  "ccc": 12345678901,
  "nss": 123456789012,
  "identificacion": 1,
  "dni": "12345678A",
  "fecha_real": "2023-01-01",
  "grupo_cotizacion": 12,
  "tipo_contrato": 402,
  "cno": 1234,
  "category_professional": 1234567,
  "coeficiente": "500",
  "rlce": 1234,
  "worker_collective": 123,
  "ocupacion": "a",
  "convenio": 12345678901234,
  "modalidad_ctz": 2,
  "fic": "2023-02-01",
  "cesion_regimen": "0111",
  "cesion_ccc": 12345678901,
  "cesion_tipo": "02",
  "duplicate": 1
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    },
    "idc": {
      // Si se envia obtener_idc = 1
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

Eliminar cesión

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:
  • ccc (número entero) : Cuenta de cotización, 11 dígitos.
  • cesion_regimen (número entero) : Régimen, 4 dígitos.
  • cesion_ccc (número entero) : Cuenta de cotización, 11 dígitos.
  • identificacion (número entero) : Número de identificación, posibles valores:
    • 1: DNI
    • 2: Pasaporte
    • 6: NIE
  • dni (caracteres) : Documento Nacional de Identidad.
  • nss (número entero) : Número de Seguridad Social, 12 dígitos.
  • startDate (date) : Fecha de cesión, formato YYYY-MM-DD.
DELETE /etts/cesion
{
  "nss": "131009999999",
  "identificacion": 1,
  "dni": "009965999X",
  "regimen": "0111",
  "ccc": "99139997999",
  "cesion_tipo": "02",
  "cesion_ccc": "28998364999",
  "cesion_regimen": "0111",
  "startDate": "2025-12-01"
}

Respuesta

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

Actualizar cesión

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:
  • ccc (número entero) : Cuenta de cotización, 11 dígitos.
  • cesion_regimen (número entero) : Régimen, 4 dígitos.
  • cesion_ccc (número entero) : Cuenta de cotización, 11 dígitos.
  • identificacion (número entero) : Número de identificación, posibles valores:
    • 1: DNI
    • 2: Pasaporte
    • 6: NIE
  • dni (caracteres) : Documento Nacional de Identidad.
  • nss (número entero) : Número de Seguridad Social, 12 dígitos.
  • startDate (date) : Fecha de cesión, formato YYYY-MM-DD.
  • endDate (date) : Fecha fin de cesión, formato YYYY-MM-DD.
PUT /etts/cesion
{
  "nss": "131009999999",
  "identificacion": 1,
  "dni": "009965999X",
  "regimen": "0111",
  "ccc": "99139997999",
  "cesion_tipo": "02",
  "cesion_ccc": "28998364999",
  "cesion_regimen": "0111",
  "startDate": "2025-12-01",
  "endDate": "2025-12-03"
}

Respuesta

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

Agregar cesión

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:
  • ccc (número entero) : Cuenta de cotización, 11 dígitos.
  • cesion_regimen (número entero) : Régimen, 4 dígitos.
  • cesion_ccc (número entero) : Cuenta de cotización, 11 dígitos.
  • identificacion (número entero) : Número de identificación, posibles valores:
    • 1: DNI
    • 2: Pasaporte
    • 6: NIE
  • dni (caracteres) : Documento Nacional de Identidad.
  • nss (número entero) : Número de Seguridad Social, 12 dígitos.
  • startDate (date) : Fecha de cesión, formato YYYY-MM-DD.
  • endDate (date) : Fecha fin de cesión, formato YYYY-MM-DD.
POST /etts/cesion
{
  "nss": "131009999999",
  "identificacion": 1,
  "dni": "009965999X",
  "regimen": "0111",
  "ccc": "99139997999",
  "cesion_tipo": "02",
  "cesion_ccc": "28998364999",
  "cesion_regimen": "0111",
  "startDate": "2025-12-01",
  "endDate": "2025-12-01"
}

Respuesta

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

Consultar cesiones y situaciones del empleado

Parámetros

  • regimen (número entero) : Régimen, 4 dígitos. Posibles valores:
  • ccc (número entero) : Cuenta de cotización, 11 dígitos.
  • dni (caracteres) : Documento Nacional de Identidad.
  • startDate (date) : Fecha de alta, formato YYYY-MM-DD. (Opcional)
  • ces (bool) : Empresas donde esta cedido. (Opcional)
GET /etts/cesion
{
  "regimen": "0111",
  "ccc": "12345678901",
  "dni": "12345678B"
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "status": 200,
  "data": [
    {
      "nss": "139991519999",
      "identificacion": "1",
      "dni": "099995999X",
      "fnacimiento": "1972-12-01",
      "sexo": "M",
      "nombres": "JOSE",
      "apellidos": "ETZ GONZALO",
      "tlf": "",
      "regimen": "0111",
      "ccc": "99132827999",
      "worker_collective": "967",
      "situacion": "01",
      "situacion_text": "ALTA NORMAL",
      "grupo_cotizacion": "09",
      "grupo_cotizacion_text": "OFICIALES 3`Y ESPEC",
      "tipo_contrato": "402",
      "coef": "",
      "fecha_alta": "2025-12-01",
      "cesions": [
        {
          "name": "JOSE ASESORES",
          "tipo": "02",
          "regimen": "0111",
          "ccc": "13991977999",
          "startDate": "2025-12-01"
        }
      ]
    }
  ]
}
Obtener resguardo de una notificaciónErrores