Seguridad Social

Seguridad Social

Conecta tus aplicaciones con funciones de la seguridad social.

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

Nota para ETTS (Empresas de trabajo temporal):

  • 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",
  "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 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.
  • dni (caracteres) : Documento Nacional de Identidad.
  • nss (número entero) : Número de la Seguridad Social, 12 dígitos.
  • fecha_real (date) : Fecha de alta, formato YYYY-MM-DD.
DELETE /alta
{
  "regimen": "0111",
  "ccc": "12345678901",
  "dni": "12345678B",
  "nss": "123456789011",
  "fecha_real": "2023-01-01"
}

Respuesta

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

Dar una baja

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.
  • situacion (número entero) : Números de la situación, 2 dígitos. Posibles valores:
  • fecha_real (date) : Fecha de alta, formato YYYY-MM-DD.
  • fecha_vacaciones (date) : Fecha de vacaciones, formato YYYY-MM-DD. Opcional.
  • indicativoSAA (número entero) : Campo obligatorio en bajas para la comunicación de vacaciones retribuidas, máximo 3 dígitos. 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.
POST /baja
{
  "test": 1,
  "regimen": "0111",
  "ccc": 12345678901,
  "nss": 123456789012,
  "identificacion": 1,
  "dni": "12345678A",
  "situacion": 93,
  "fecha_real": "2023-11-01",
  "fecha_vacaciones": "2024-07-15",
  "indicativoSAA": 123,
  "duplicate": 1
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

Eliminar una baja

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.
  • dni (caracteres) : Documento Nacional de Identidad.
  • nss (número entero) : Número de la Seguridad Social, 12 dígitos.
  • fecha_real (date) : Fecha de alta, formato YYYY-MM-DD.
DELETE /baja
{
  "regimen": "0111",
  "ccc": "12345678901",
  "dni": "12345678B",
  "nss": "123456789011",
  "fecha_real": "2023-01-01"
}

Respuesta

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

Duplicados de Documentos TA (Reporte Alta o Baja)

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.
  • startDate (date) : Fecha, formato YYYY-MM-DD.
  • movType (caracteres) : Tipo de movimiento, posibles valores:
    • ALTA
    • BAJA
GET /duplicate-ta
{
  "regimen": "0111",
  "ccc": "12345678901",
  "nss": "123456789011",
  "startDate": "2023-01-01",
  "movType": "ALTA"
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

Informe de vida laboral de un afiliado

Parámetros

GET /life-affiliate
{
  "regimen": "0111",
  "ccc": "12345678901",
  "nss": "123456789011"
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

Informe de datos para la cotización (IDC)

Parámetros

  • 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.
  • startDate (date) : Fecha, formato YYYY-MM-DD.
GET /duplicate-idc
{
  "regimen": "0111",
  "ccc": "12345678901",
  "nss": "123456789011",
  "startDate": "2023-01-01"
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "date": "2022-01-01", // fecha de IDC
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

Cambio de Ocupación de A.T.

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.
  • dni (caracteres) : Documento Nacional de Identidad.
  • fecha_real (date) : Fecha de alta, formato YYYY-MM-DD..
  • ocupacion (caracteres) : Ocupación del trabajador, opcional. Posibles valores:
  • duplicate (numero entero) : Obtener el PDF en base64 y en formato JSON en la respuesta, los posibles valores son 1 o null. Opcional.
PUT /occupation
{
  "test": 1,
  "regimen": "0111",
  "ccc": "12345678901",
  "dni": "12345678B",
  "nss": "123456789011",
  "fecha_real": "2023-01-01",
  "ocupacion": "a",
  "duplicate": 1
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

Cambio de Grupo de Cotizació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.
  • nss (número entero) : Número de la Seguridad Social, 12 dígitos.
  • 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, 2 dígitos. Posibles valores:
  • duplicate (número entero) : Obtener el PDF en base64 y en formato JSON en la respuesta, los posibles valores son 1 o null. Opcional.
PUT /quote-group
{
  "test": 1,
  "regimen": "0111",
  "ccc": "12345678901",
  "dni": "12345678B",
  "nss": "123456789011",
  "fecha_real": "2023-01-01",
  "grupo_cotizacion": "01",
  "duplicate": 1
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

Cambio de Categoría Profesional

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 la Seguridad Social, 12 dígitos.
  • dni (caracteres) : Documento Nacional de Identidad.
  • fecha_real (date) : Fecha de alta, formato YYYY-MM-DD..
  • category_professional (número entero) : Categoría profesional, máximo 7 dígitos. Posibles valores:
  • duplicate (número entero) : Obtener el PDF en base64 y en formato JSON en la respuesta, los posibles valores son 1 o null. Opcional.
PUT /category-professional
{
  "test": 1,
  "regimen": "0111",
  "ccc": "12345678901",
  "dni": "12345678B",
  "nss": "123456789011",
  "fecha_real": "2023-01-01",
  "category_professional": "6100305",
  "duplicate": 1
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

Cambio de C. N. Ocupación (CNO)

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.
  • dni (caracteres) : Documento Nacional de Identidad.
  • fecha_real (date) : Fecha de alta, formato YYYY-MM-DD.
  • cno (número entero) : Clasificación Nacional de Ocupaciones, máximo 4 dígitos. Posibles valores:
  • duplicate (número entero) : Obtener el PDF en base64 y en formato json en la respuesta, los posibles valores son 1 o null. Opcional.
PUT /cno
{
  "test": 1,
  "regimen": "0111",
  "ccc": "12345678901",
  "dni": "12345678B",
  "nss": "123456789011",
  "fecha_real": "2023-01-01",
  "cno": "1212",
  "duplicate": 1
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

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:
  • 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 (número entero) : Coeficiente parcial, para jornada parciales, máximo 3 dígitos. Opcional.
  • worker_collective (número entero) : Colectivo del trabajador, es obligatorio para tipos de contratos (402, 502, 407, 507), 3 dígitos, opcional. Posibles valores:
PUT /contract-coeficiente
{
  "regimen": "0111",
  "ccc": "12345678901",
  "dni": "12345678B",
  "nss": "123456789011",
  "startDate": "2023-01-01",
  "contractType": "100",
  "coeficiente": "500",
  "worker_collective": "967"
}

Respuesta

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

Consultar el número de afiliación por DNI/NIF/NIE

Parámetros

  • dni (caracteres) : Documento Nacional de Identidad.
  • apellido1 (caracteres) : Primer apellido.
  • apellido2 (caracteres) : Segundo apellido. Opcional.
GET /nss-by-ipf
{
  "dni": "12345678B",
  "apellido1": "apellido1",
  "apellido2": "apellido2"
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "name": "NOMBRE",
    "nss": "123456789012",
    "dni": "012323132X",
    "identificacion": "1"
  }
}

Consultar el DNI/NIF/NIE por el número de afiliación

Parámetros

  • nss (caracteres) : Número de Seguridad Social, 12 dígitos.
GET /ipf-by-nss
{
  "nss": "123456789011"
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "nombres": "NOMBRE",
    "apellidos": "APELLIDOS",
    "nss": "123456789012",
    "dni": "012323132X",
    "identificacion": "1"
  }
}

Consultar la situación del empleado en la empresa

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) : Solo para ETTS, empresa donde esta cedido. (Opcional)
GET /employee-situations
{
  "regimen": "0111",
  "ccc": "12345678901",
  "dni": "12345678B",
  "startDate": "2023-01-01"
}

Respuesta

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",
      "fecha_alta": "2023-12-31",
      "fecha_baja": "2023-12-31"
    }
  ]
}

Promedio de trabajadores en alta

Parámetros

  • regimen (número entero) : Régimen, 4 dígitos. Posibles valores:
  • ccc (número entero) : Cuenta de cotización, 11 dígitos.
  • startDate (date) : Fecha de inicio, formato YYYY-MM-DD.
  • endDate (date) : Fecha de fin, formato YYYY-MM-DD.
GET /plantilla-media
{
  "regimen": "0111",
  "ccc": "12345678901",
  "startDate": "2023-01-01",
  "endDate": "2023-01-01"
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

Certificado de hallarse al corriente

Parámetros

  • regimen (número entero) : Régimen, 4 dígitos. Posibles valores:
  • ccc (número entero) : Cuenta de cotización, 11 dígitos.
  • options (número) : posibles valores:
    • 1: General
    • 3: Subvenciones
    • 4: Sin deuda a una fecha
GET /cert-corriente-tgss
{
  "regimen": "0111",
  "ccc": "12345678901",
  "options": 1
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

Informe de la vida laboral de una cuenta de cotización (C.C.C.)

Parámetros

  • regimen (número entero) : Régimen, 4 dígitos. Posibles valores:
  • ccc (número entero) : Cuenta de cotización, 11 dígitos.
  • startDate (date) : Fecha de inicio, formato YYYY-MM-DD.
  • endDate (date) : Fecha de fin, formato YYYY-MM-DD.
GET /life-ccc
{
  "regimen": "0111",
  "ccc": "12345678901",
  "startDate": "2023-01-01",
  "endDate": "2023-01-01"
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

Informe de los datos de cotización y el periodo de liquidación

Parámetros

GET /idc-ccc
{
  "regimen": "0111",
  "ccc": "12345678901",
  "startDate": "2023-01-01"
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

Trabajadores de alta de una cuenta de cotización (C.C.C.)

Parámetros

  • regimen (número entero) : Régimen, 4 dígitos. Posibles valores:
  • ccc (número entero) : Cuenta de cotización, 11 dígitos.
  • options (número) : Posibles valores:
    • 1: Altas consolidadas
    • 2: Altas programadas
    • 3: Ambas
GET /employees-in-enterprise
{
  "regimen": "0111",
  "ccc": "12345678901",
  "options": 3
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "enterprise": {
      "cuenta_cotizacion": "01999999999",
      "nombre_empresa": "NOMBRE DE LA EMPRESA"
    },
    "employees": [
      {
        "nss": "289999999999",
        "identificacion": "1",
        "ipf": "09999999Q",
        "fecha_real": "31-12-2023",
        "nombres": "NOMBRE EMPLEADO",
        "situacion": "AL"
      },
      {
        "nss": "019999999990",
        "identificacion": "6",
        "ipf": "Y9999999Q",
        "fecha_real": "31-12-2023",
        "nombres": "NOMBRE EMPLEADO 3",
        "situacion": "BJ"
      },
      {
        "nss": "019999999990",
        "identificacion": "1",
        "ipf": "07777777Q",
        "fecha_real": "31-12-2023",
        "nombres": "NOMBRE EMPLEADO 2",
        "situacion": "AL"
      }
    ]
  }
}

Informe de trabajadores con altas en una cuenta de cotización (C.C.C.) [ITA]

Parámetros

GET /informe-ita
{
  "regimen": "0111",
  "ccc": "12345678901"
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

Informe de trabajadores con altas programadas en en una cuenta de cotización (C.C.C.)

Parámetros

GET /employees-with-movement-previous
{
  "regimen": "0111",
  "ccc": "12345678901"
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

Anotación de jornadas para prácticas no remuneradas

Parámetros

  • 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.
  • startDate (date) : Fecha, formato YYYY-MM-DD. El día siempre será 01
  • dia_efectivo (número entero) : Días efectivos de las prácticas. Opcional.
  • dia_previsto_itat (número entero) : Días previstos de prácticas en ITAT (Incapacidad temporal por accidente de trabajo). Opcional.
  • dia_previsto (número entero) : Días previstos de prácticas en pago directo. Opcional.
  • indicativo_practica (caracteres) : Indicativo prácticas (N- No prácticas), opcional. Posibles valores:
    • N = No prácticas.
  • no_remunerada (número (1)) : 1 = Prácticas no remuneradas, en caso contrario no enviar ningún valor. Opcional
POST /pract-no-remun
{
  "regimen": "0111",
  "ccc": 12345678901,
  "nss": 123456789012,
  "identificacion": 1,
  "dni": "12345678A",
  "startDate": "2023-01-01",
  "no_remunerada": 1,
  "dia_efectivo": 1,
  "dia_previsto_itat": 2,
  "dia_previsto": 3
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OPERACION REALIZADA CORRECTAMENTE"
}

Eliminar anotación de jornadas para prácticas no remuneradas

Parámetros

  • 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.
  • startDate (date) : Fecha, formato YYYY-MM-DD. El día siempre será 01
DELETE /pract-no-remun
{
  "regimen": "0111",
  "ccc": 12345678901,
  "nss": 123456789012,
  "identificacion": 1,
  "dni": "12345678A",
  "startDate": "2023-01-01"
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OPERACION REALIZADA CORRECTAMENTE"
}

Eliminar el tipo de cesión para ETT (Empresas de trabajo temporal)

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 alta, formato YYYY-MM-DD.
DELETE /alta
{
  "regimen": "0111",
  "ccc": "12345678901",
  "cesion_regimen": "0111",
  "cesion_ccc": "12345678901",
  "dni": "12345678B",
  "nss": "123456789011",
  "startDate": "2023-01-01"
}

Respuesta

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

Eliminar anotación de jornadas para prácticas no remuneradas

Parámetros

  • 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.
  • startDate (date) : Fecha, formato YYYY-MM-DD. El día siempre será 01
DELETE /pract-no-remun
{
  "regimen": "0111",
  "ccc": 12345678901,
  "nss": 123456789012,
  "identificacion": 1,
  "dni": "12345678A",
  "startDate": "2023-01-01"
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OPERACION REALIZADA CORRECTAMENTE"
}

Informe de Situación de un C.C.C.

Parámetros

GET /report-situation-ccc
{
  "regimen": "0111",
  "ccc": "12345678901"
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

Duplicado de documentos de empresarios

Parámetros

GET /report-duplicate-businessmen
{
  "regimen": "0111",
  "ccc": "12345678901"
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

Consulta certificados e informes de deuda

Parámetros

GET /report-certificates-debt
{
  "regimen": "0111",
  "ccc": "12345678901"
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

Régimen del Hogar

Operaciones para gestionar empleados del hogar en el sistema de la Seguridad Social.

URL base

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

Dar de alta a un empleado del hogar

Registrar un nuevo empleado en el régimen del hogar.

Parámetros

  • test (número (1)): Para pruebas, añade el parámetro test=1. Para producción se debe omitir.
  • ccc (número entero): Cuenta de cotización, 11 dígitos.
  • datos_trabajador (objeto): Información del trabajador.
    • DOC (caracteres): Documento Nacional de Identidad.
    • SEL_IPF_TIPO (número entero): Tipo de identificación, opcional. Posibles valores:
      • 1: DNI
      • 2: Pasaporte
      • 6: NIE
    • NSS (número entero): Número de Seguridad Social, 12 dígitos.
  • datos_alta (objeto): Información del alta.
    • FECHA_INI_ACTIVIDAD (fecha): Fecha de inicio de actividad, formato YYYY-MM-DD.
    • TIPO_CONTRATO (número entero): Tipo de contrato, 3 dígitos. Posibles valores:
      • 100: Contrato a tiempo completo (indefinido)
      • 200: Contrato a tiempo parcial (indefinido)
      • 300: Contrato fijo discontinuo
      • 401: Contrato temporal a tiempo completo (por obra o servicio)
      • 402: Contrato temporal a tiempo completo (por circunstancias de la producción)
      • 501: Contrato temporal a tiempo parcial (por obra o servicio)
      • 502: Contrato temporal a tiempo parcial (por circunstancias de la producción)
    • RETRIBUCION_MENSUAL (decimal): Retribución mensual.
    • PERSONA_DED_CUIDADO_FN (caracteres): Persona dedicada al cuidado de una familia numerosa, valores: "S" (Sí) o "N" (No).
    • SALARIO_ESPECIE (decimal): Salario en especie, opcional.
    • PACTO_HORAS_PRESENCIA (caracteres): Pacto de horas de presencia, opcional, valores: "S" (Sí) o "N" (No).
    • NUM_HORAS_PRESENCIA (número entero): Número de horas de presencia, opcional.
    • RET_HORAS_PRES_PACTADAS (decimal): Retribución por horas de presencia pactadas, opcional.
    • PACTO_PERNOCTA (caracteres): Pacto de pernocta, opcional, valores: "S" (Sí) o "N" (No).
    • RET_PACTO_PERNOCTA (decimal): Retribución por pacto de pernocta, opcional.

Para contratos a tiempo parcial (200, 300, 501, 502), se requieren parámetros adicionales:

  • TRABAJADOR_HOR_REG_EXT (caracteres): Trabajador por horas régimen externo, valores: "S" (Sí) o "N" (No).

  • HORAS_TM (número entero): Horas de trabajo mensual.

  • MINUTOS_TM (número entero): Minutos de trabajo mensual, opcional.

  • NUM_HORAS_TRAB_SEMANA (número entero): Horas de trabajo a la semana, opcional.

  • SALARIO_HORA (decimal): Salario por hora.

  • datos_bancarios (objeto): Información bancaria, opcional.

    • IPF_NOMBRE (caracteres): Nombre del titular de la cuenta.
    • NUMDOCUMENTO (caracteres): Número de documento.
    • IBAN (caracteres): Número de IBAN.
POST /hogar/alta
{
  "test": 1,
  "ccc": "12345678901",
  "datos_trabajador": {
    "DOC": "12345678A",
    "SEL_IPF_TIPO": 1,
    "NSS": "123456789012"
  },
  "datos_alta": {
    "FECHA_INI_ACTIVIDAD": "2023-01-01",
    "TIPO_CONTRATO": "100",
    "RETRIBUCION_MENSUAL": 1200,
    "PERSONA_DED_CUIDADO_FN": "N",
    "SALARIO_ESPECIE": 0,
    "PACTO_HORAS_PRESENCIA": "N",
    "PACTO_PERNOCTA": "N"
  },
  "datos_bancarios": {
    "IPF_NOMBRE": "NOMBRE APELLIDO",
    "NUMDOCUMENTO": "12345678A",
    "IBAN": "ES0012345678901234567890"
  }
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

Dar de baja a un empleado del hogar

Registrar la baja de un empleado del hogar.

Parámetros

  • test (número (1)): Para pruebas, añade el parámetro test=1. Para producción se debe omitir.
  • ccc (número entero): Cuenta de cotización, 11 dígitos.
  • datos_trabajador (objeto): Información del trabajador.
    • DOC (caracteres): Documento Nacional de Identidad.
    • SEL_IPF_TIPO (número entero): Tipo de identificación, opcional. Posibles valores:
      • 1: DNI
      • 2: Pasaporte
      • 6: NIE
    • NSS (número entero): Número de Seguridad Social, 12 dígitos.
  • datos_baja (objeto): Información de la baja.
    • FECHA_CESE (fecha): Fecha de cese, formato YYYY-MM-DD.
    • SEL_SELEC_CAUSA (número entero): Causa de la baja, 2 dígitos. Valores comunes:
      • 51: Dimisión voluntaria
      • 54: Finalización del contrato
      • 56: Expiración del contrato
      • 65: Despido
    • DIAS_VACACIONES (número entero): Días de vacaciones, opcional.
POST /hogar/baja
{
  "test": 1,
  "ccc": "12345678901",
  "datos_trabajador": {
    "DOC": "12345678A",
    "SEL_IPF_TIPO": 1,
    "NSS": "123456789012"
  },
  "datos_baja": {
    "FECHA_CESE": "2023-01-31",
    "SEL_SELEC_CAUSA": "51",
    "DIAS_VACACIONES": 0
  }
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

Eliminar un alta de empleado del hogar

Eliminar un alta previamente enviada para un empleado del hogar.

Parámetros

  • test (número (1)): Para pruebas, añade el parámetro test=1. Para producción se debe omitir.
  • ccc (número entero): Cuenta de cotización, 11 dígitos.
  • datos_trabajador (objeto): Información del trabajador.
    • DOC (caracteres): Documento Nacional de Identidad.
    • SEL_IPF_TIPO (número entero): Tipo de identificación, opcional. Posibles valores:
      • 1: DNI
      • 2: Pasaporte
      • 6: NIE
    • NSS (número entero): Número de Seguridad Social, 12 dígitos.
  • datos_alta (objeto): Información del alta.
    • FECHA_INI_ACTIVIDAD (fecha): Fecha de inicio de actividad a eliminar, formato YYYY-MM-DD.
DELETE /hogar/alta
{
  "test": 1,
  "ccc": "12345678901",
  "datos_trabajador": {
    "DOC": "12345678A",
    "SEL_IPF_TIPO": 1,
    "NSS": "123456789012"
  },
  "datos_alta": {
    "FECHA_INI_ACTIVIDAD": "2023-01-01"
  }
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

Actualizar un alta de empleado del hogar

Actualizar la información de un empleado del hogar previamente registrado.

Parámetros

  • test (número (1)): Para pruebas, añade el parámetro test=1. Para producción se debe omitir.
  • ccc (número entero): Cuenta de cotización, 11 dígitos.
  • datos_trabajador (objeto): Información del trabajador.
    • DOC (caracteres): Documento Nacional de Identidad.
    • SEL_IPF_TIPO (número entero): Tipo de identificación, opcional. Posibles valores:
      • 1: DNI
      • 2: Pasaporte
      • 6: NIE
    • NSS (número entero): Número de Seguridad Social, 12 dígitos.
  • datos_alta (objeto): Información del alta.
    • FECHA_ANTERIOR_ACTIVIDAD (fecha): Fecha anterior de inicio de actividad, formato YYYY-MM-DD.
    • FECHA_INICIO_ACTIVIDAD (fecha): Nueva fecha de inicio de actividad, formato YYYY-MM-DD.
    • TIPO_CONTRATO (número entero): Tipo de contrato, 3 dígitos. Mismos valores que en el alta.
    • RETRIBUCION_MENSUAL (decimal): Retribución mensual.
    • PERSONA_DED_CUIDADO_FN (caracteres): Persona dedicada al cuidado de una familia numerosa, valores: "S" (Sí) o "N" (No).
    • Otros parámetros opcionales igual que en el alta.
PUT /hogar/alta
{
  "test": 1,
  "ccc": "12345678901",
  "datos_trabajador": {
    "DOC": "12345678A",
    "SEL_IPF_TIPO": 1,
    "NSS": "123456789012"
  },
  "datos_alta": {
    "FECHA_ANTERIOR_ACTIVIDAD": "2023-01-01",
    "FECHA_INICIO_ACTIVIDAD": "2023-01-15",
    "TIPO_CONTRATO": "100",
    "RETRIBUCION_MENSUAL": 1300,
    "PERSONA_DED_CUIDADO_FN": "N"
  }
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

Obtener informe de empleado del hogar (duplicado)

Obtener un informe del alta o baja de un empleado del hogar.

Parámetros

  • test (número (1)): Para pruebas, añade el parámetro test=1. Para producción se debe omitir.
  • ccc (número entero): Cuenta de cotización, 11 dígitos.
  • datos_trabajador (objeto): Información del trabajador.
    • DOC (caracteres): Documento Nacional de Identidad.
    • SEL_IPF_TIPO (número entero): Tipo de identificación, opcional. Posibles valores:
      • 1: DNI
      • 2: Pasaporte
      • 6: NIE
    • NSS (número entero): Número de Seguridad Social, 12 dígitos.
  • TIPO_RESOLUCION (caracteres): Tipo de resolución, valores: "A" (Alta) o "B" (Baja).
  • datos_alta (objeto): Información del alta, opcional.
    • FECHA_INI_ACTIVIDAD (fecha): Fecha de inicio de actividad, formato YYYY-MM-DD, opcional.
POST /hogar/report
{
  "test": 1,
  "ccc": "12345678901",
  "datos_trabajador": {
    "DOC": "12345678A",
    "SEL_IPF_TIPO": 1,
    "NSS": "123456789012"
  },
  "TIPO_RESOLUCION": "A",
  "datos_alta": {
    "FECHA_INI_ACTIVIDAD": "2023-01-01"
  }
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}
Eliminar un certificadoErrores