Social Security

Social Security

Connect your applications with social security functions.

Parameters in the HTTP header

  • Authorization (characters): API Authorization. Example: Bearer {token}
  • X-Cert-Secret (characters): Secret key associated with the client's certificate.

Base URL

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

Issues

Issues received in the Social Security API or validation errors.

Response parameters

  • success (boolean): Response "true" when everything is okay, and "false" when there are issues.
  • message (characters): The response message.
  • errors (array) : The issues captured in the API, whether from Social Security or validation errors.
    • tgss: Issues related to Social Security.
    • regimen: Validation issues.
  • maintenance (boolean): When Social Security is under maintenance.

Response

Response
{
  "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
}

Enroll an employee

Parameters

Note for TEPs (Temporary Employment Companies):

  • cesion_regimen (integer) : Regime, 4 digits. Possible values:
  • cesion_ccc (integer) : Contribution Account, 11 digits.
  • cesion_tipo (integer) : Possible values:
    • 01: Labor Enclave
    • 02: Temporary Employment Agency (TEP)
    • 03: Subcontracting of Works and Services
    • 04: Nautical Management
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
}

Response

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

Remove an enrollment record

Parameters

  • test (number (1)): For testing, add the parameter test=1. For production, it must be omitted.
  • regimen (integer): Regime, maximum 4 digits. Possible values:
  • ccc (integer): Contribution Account, maximum 11 digits.
  • dni (characters): National Identity Document.
  • nss (integer): Social Security Number, maximum 12 digits.
  • fecha_real (date): Registration date, format YYYY-MM-DD.
DELETE /alta
{
  "regimen": "0111",
  "ccc": "12345678901",
  "dni": "12345678B",
  "nss": "123456789011",
  "fecha_real": "2023-01-01"
}

Response

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

Dismiss an employee

Parameters

  • test (number (1)): For testing, add the parameter test=1. For production, it must be omitted.
  • regimen (integer): Regime, 4 digits. Possible values:
  • ccc (integer): Contribution Account, 11 digits.
  • nss (integer): Social Security Number, 12 digits.
  • identificacion (integer): Identification number, possible values: -1: National ID (DNI) -2: Passport -6: Foreigner Identification (NIE)
  • dni (string): National Identity Document.
  • situacion (integer): Situation code, 2 digits. Possible values:
  • fecha_real (date): Start date, formatted as YYYY-MM-DD.
  • fecha_vacaciones (date): Vacation date, formatted as YYYY-MM-DD. Optional.
  • indicativoSAA (integer): Mandatory field for terminations to report paid vacation, up to 3 digits. Optional.
  • duplicate (integer): Retrieve the PDF in base64 and JSON format in the response, possible values: 1 or null. Optional.
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
}

Response

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

Remove a termination record

Parameters

  • test (number (1)): For testing, add the parameter test=1. For production, it must be omitted.
  • regimen (integers): Regime, maximum 4 digits. Possible values:
  • ccc (integers): Contribution Account, maximum 11 digits.
  • dni (characters): National Identity Document.
  • nss (integers): Social Security Number, maximum 12 digits.
  • fecha_real (date): Date of baja, format YYYY-MM-DD.
DELETE /baja
{
  "regimen": "0111",
  "ccc": "12345678901",
  "dni": "12345678B",
  "nss": "123456789011",
  "fecha_real": "2023-01-01"
}

Response

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

Duplicate of an enrollment or a termination

Parameters

  • test (number (1)): For testing, add the parameter test=1. For production, it must be omitted.
  • regimen (integer): Regime, 4 digits. Possible values:
  • ccc (integer): Contribution Account, 11 digits.
  • nss (integer): Social Security Number, 12 digits.
  • startDate (date): Date, in the format YYYY-MM-DD.
  • movType (characters): Movement type, possible values:
    • ALTA
    • BAJA
GET /duplicate-ta
{
  "regimen": "0111",
  "ccc": "12345678901",
  "nss": "123456789011",
  "startDate": "2023-01-01",
  "movType": "ALTA"
}

Response

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

Life work report of an affiliate

Parameters

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

Response

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

Contribution data report (IDC)

Parameters

  • regimen (integer): Regime, 4 digits. Possible values:
  • ccc (integer): Contribution Account, 11 digits.
  • nss (integer): Social Security Number, 12 digits.
  • startDate (date): Date, format YYYY-MM-DD.
GET /duplicate-idc
{
  "regimen": "0111",
  "ccc": "12345678901",
  "nss": "123456789011",
  "startDate": "2023-01-01"
}

Response

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

Update occupation

Parameters

  • test (number (1)): For testing, add the parameter test=1. For production, it must be omitted.
  • regimen (integer): Regime, 4 digits. Possible values:
  • ccc (integer): Contribution Account, 11 digits.
  • nss (integer): Social Security Number, 12 digits.
  • dni (string): National ID document.
  • fecha_real (date): Enrollment date, formatted as YYYY-MM-DD.
  • ocupacion (string): Employee occupation, optional. Possible values:
  • duplicate (integer): Retrieve the PDF in base64 and JSON format in the response, possible values are 1 or null. Optional.
PUT /occupation
{
  "test":1,
  "regimen": "0111",
  "ccc": "12345678901",
  "dni": "12345678B",
  "nss": "123456789011",
  "fecha_real": "2023-01-01",
  "ocupacion": "a",
  "duplicate": 1
}

Response

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

Update contribution group

Parameters

  • test (number (1)): For testing, add the parameter test=1. For production, it must be omitted.
  • regimen (integer): Regime, 4 digits. Possible values:
  • ccc (integer): Contribution Account, 11 digits.
  • nss (integer): Social Security Number, 12 digits.
  • dni (string): National ID document.
  • fecha_real (date): Date of registration, format YYYY-MM-DD.
  • grupo_cotizacion (integer): Contribution group, 2 digits. Possible values:
  • duplicate (integer): Get the PDF in base64 and in JSON format in the response, possible values are 1 or null. Optional.
PUT /quote-group
{
  "test":1,
  "regimen": "0111",
  "ccc": "12345678901",
  "dni": "12345678B",
  "nss": "123456789011",
  "fecha_real": "2023-01-01",
  "grupo_cotizacion": "01",
  "duplicate": 1
}

Response

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

Update professional category

Parameters

  • test (number (1)): For testing, add the parameter test=1. For production, it must be omitted.
  • regimen (integer): Regime, 4 digits. Possible values:
  • ccc (integer): Contribution Account, 11 digits.
  • nss (integer): Social Security Number, 12 digits.
  • dni (characters): National ID document.
  • fecha_real (date): Date of registration, format YYYY-MM-DD.
  • category_professional (integer): Professional category, 7 digits. Possible values:
  • duplicate (integer): Get the PDF in base64 and in JSON format in the response, possible values are 1 or null. Optional.
PUT /category-professional
{
  "test":1,
  "regimen": "0111",
  "ccc": "12345678901",
  "dni": "12345678B",
  "nss": "123456789011",
  "fecha_real": "2023-01-01",
  "category_professional": "6100305",
  "duplicate": 1
}

Response

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

Update National Classification of Occupations (CNO)

Parameters

  • test (number (1)): For testing, add the parameter test=1. For production, it must be omitted.
  • regimen (integer): Regime, 4 digits. Possible values:
  • ccc (integer): Contribution Account, 11 digits.
  • nss (integer): Social Security Number, 12 digits.
  • dni (characters): National ID document.
  • fecha_real (date): Date of registration, format YYYY-MM-DD.
  • cno (integer): National Classification of Occupations, 4 digits. Possible values:
  • duplicate (integer): Get the PDF in base64 and in JSON format in the response, possible values are 1 or null. Optional.
PUT /cno
{
  "test":1,
  "regimen": "0111",
  "ccc": "12345678901",
  "dni": "12345678B",
  "nss": "123456789011",
  "fecha_real": "2023-01-01",
  "cno": "1212",
  "duplicate": 1
}

Response

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

Update employment contract or rate

Parámetros

  • test (number (1)): For testing, add the parameter test=1. For production, it must be omitted.
  • regimen (integer): Regime, 4 digits. Possible values:
  • ccc (integer): Contribution Account, 11 digits.
  • nss (integer): Social Security Number, 12 digits.
  • dni (characters): National Identity Document.
  • startDate (date): Date of change, formatted as YYYY-MM-DD.
  • contractType (integer): Contract type, 3 digits.
  • coeficiente (integer): Partial coefficient for part-time work, up to 3 digits, optional.
  • worker_collective (integer): Worker's collective; required for contract types (402, 502, 407, 507), up to 3 digits, optional. Possible values:
PUT /contract-coeficiente
{
  "regimen": "0111",
  "ccc": "12345678901",
  "dni": "12345678B",
  "nss": "123456789011",
  "startDate": "2023-01-01",
  "contractType": "100",
  "coeficiente":"500",
  "worker_collective":"967"
}

Response

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

Query affiliation number by DNI/NIF/NIE

Parameters

  • dni (characters): National ID document.
  • apellido1 (characters): First surname.
  • apellido2 (characters): Second surname. Optional.
GET /nss-by-ipf
{
  "dni": "12345678B",
  "apellido1": "apellido1",
  "apellido2": "apellido2"
}

Response

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

Query DNI/NIF/NIE by affiliation number

Parameters

  • nss (characters): Social Security Number, maximum 12 digits.
GET /ipf-by-nss
{
  "nss": "123456789011"
}

Response

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

Query employee's situation in the company

Parameters

  • regimen (integer) : Regime, 4 digits. Possible values:
  • ccc (integer) : Contribution Account, 11 digits.
  • dni (characters) : National Identity Document.
  • startDate (date) : Enrollment date, formatted as YYYY-MM-DD. (Optional)
  • ces (bool) : For temporary employment agencies only, indicating the company to which the worker is seconded. (Optional)
GET /employee-situations
{
  "regimen": "0111",
  "ccc": "12345678901",
  "dni": "12345678B",
  "startDate": "2023-01-01"
}

Response

Response
{
  "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"
    }
  ]
}

Average number of active employees

Parameters

  • regimen (integer): Regime, maximum 4 digits. Possible values:
  • ccc (integer): Contribution Account, maximum 11 digits.
  • endDate (date): End date, format YYYY-MM-DD.
  • startDate (date): Start date, format YYYY-MM-DD.
GET /plantilla-media
{
  "regimen": "0111",
  "ccc": "12345678901",
  "startDate": "2023-01-01",
  "endDate": "2023-01-01"
}

Response

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

Certificate of Social Security Compliance

Parameters

  • regimen (integer) : Regimen, 4 digits. Possible values:
  • ccc (integer) : Contribution Account Code (CCC), 11 digits.
  • options (number) : posibles valores:
    • 1: General
    • 3: Subvenciones
    • 7: Sin deuda a una fecha
GET /cert-corriente-tgss
{
  "regimen": "0111",
  "ccc": "12345678901",
  "options": 1
}

Response

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

Employment history report of a Contribution Account (C.C.C.)

Parameters

  • regimen (integer): Regime, 4 digits. Possible values:
  • ccc (integer): Contribution Account, 11 digits.
  • startDate (date): Start date, format YYYY-MM-DD.
  • endDate (date): End date, format YYYY-MM-DD.
GET /life-ccc
{
  "regimen": "0111",
  "ccc": "12345678901",
  "startDate": "2023-01-01",
  "endDate": "2023-01-01"
}

Response

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

Contribution Data and Settlement period report (C.C.C.)

Parameters

  • regimen (integer) : Regime, 4 digits. Possible values:
  • ccc (integer) : Contribution Account, 11 digits.
  • startDate (date) : Start date, formatted as YYYY-MM-DD.
GET /idc-ccc
{
  "regimen": "0111",
  "ccc": "12345678901",
  "startDate": "2023-01-01"
}

Response

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

Active employees of a Contribution Account Code (C.C.C.)

Parameters

  • regimen (integer): Regime, 4 digits. Possible values:
  • ccc (integer): Contribution account, 11 digits.
  • options (number): - options (number): Possible values:
    • 1: Consolidated registrations
    • 2: Scheduled registrations
    • 3: Both
GET /employees-in-enterprise
{
  "regimen": "0111",
  "ccc": "12345678901",
  "options": 3
}

Response

Response
{
  "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"
      }
    ]
  }
}

Report of active employees in a Contribution Account (C.C.C.) (ITA)

Parameters

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

Response

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

Report of employees with scheduled hires in a Contribution Account (C.C.C.)

Parameters

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

Response

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

Record of days for unpaid internships

Parameters

  • regimen (integer) : Regimen, 4 digits. Possible values:
  • ccc (integer) : Contribution Account, 11 digits.
  • nss (integer) : Social Security Number, 12 digits.
  • identificacion (integer) : Identification number, possible values: -1: National ID (DNI) -2: Passport -6: Foreigner Identification (NIE)
  • dni (string) : National Identity Document.
  • startDate (date) : Date, format YYYY-MM-DD. The day will always be 01.
  • dia_efectivo (integer) : Effective internship days. Optional.
  • dia_previsto_itat (integer) : Scheduled ITAT internship days (ITAT: Temporary Disability due to a work accident). Optional.
  • dia_previsto (integer) : Scheduled Direct Payment Internship Days. Optional.
  • indicativo_practica (string) : Internship Indicator (N = No Internship), optional. Possible values:
    • N = No Internship.
  • no_remunerada (number (1)) : 1 = Unpaid internship, if not unpaid, do not send any value. Optional
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
}

Response

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

Delete record of days for unpaid internships

Parameters

  • regimen (integer) : Regimen, 4 digits. Possible values:
  • ccc (integer) : Contribution Account, 11 digits.
  • nss (integer) : Social Security Number, 12 digits.
  • identificacion (integer) : Identification number, possible values: -1: National ID (DNI) -2: Passport -6: Foreigner Identification (NIE)
  • dni (string) : National Identity Document.
  • startDate (date) : Date, format YYYY-MM-DD. The day will always be 01.
DELETE /pract-no-remun
{
  "regimen": "0111",
  "ccc": 12345678901,
  "nss": 123456789012,
  "identificacion": 1,
  "dni": "12345678A",
  "startDate": "2023-01-01"
}

Response

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

Delete transfer type for Temporary Employment Agencies

Parameters

  • test (number (1)) : For testing, add the parameter test=1. For production, this must be omitted.
  • regimen (integer) : Regimen, 4 digits. Possible values:
  • ccc (integer) : Contribution Account, 11 digits.
  • cesion_regimen (integer) : Regimen, 4 digits.
  • cesion_ccc (integer) : Contribution Account, 11 digits.
  • identificacion (integer) : Identification number, possible values: -1: National ID (DNI) -2: Passport -6: Foreigner Identification (NIE)
  • dni (string) : National Identity Document.
  • nss (integer) : Social Security Number, 12 digits.
  • startDate (date) : Registration date, format YYYY-MM-DD.
DELETE /alta
{
  "regimen": "0111",
  "ccc": "12345678901",
  "cesion_regimen": "0111",
  "cesion_ccc": "12345678901",
  "dni": "12345678B",
  "nss": "123456789011",
  "startDate": "2023-01-01"
}

Response

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

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"
    }
  }
}
Delete a certificateIssues