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

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

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:
- 0111: Régimen general
- Tabla con los códigos de régimen (opens in a new tab)
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

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

Informe de vida laboral de un afiliado

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 (opens in a new tab)
ccc (número entero) : Cuenta de cotización, 11 dígitos.
nss (número entero) : Número de Seguridad Social, 12 dígitos.

GET /life-affiliate

{
  "regimen": "0111",
  "ccc": "12345678901",
  "nss": "123456789011"
}

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:
- 0111: Régimen general
- Tabla con los códigos de régimen (opens in a new tab)
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

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

Datos del IDC del trabajador

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 (opens in a new tab)
ccc (número entero) : Cuenta de cotización, 11 dígitos.
nss (número entero) : Número de Seguridad Social, 12 dígitos.

GET /idc-info-for-nss

{
  "regimen": "0111",
  "ccc": "12345678901",
  "nss": "123456789011"
}

Respuesta

{
  "success": true,
  "message": "OK",
  "data": {
    "details": [
      {
        "fra": "2024-07-01",
        "frb": "2025-03-30",
        "contract": "421",
        "coef": null,
        "desempleo": "1",
        "MRein": null,
        "eSoc": null,
        "rlce": null,
        "col": null,
        "indice": 0   
      },
      {
        "fra": "2025-03-31",
        "frb": null,
        "contract": "109",
        "coef": null,
        "desempleo": null,
        "MRein": null,
        "eSoc": null,
        "rlce": null,
        "col": null,
        "indice": 1 
      },
      {
        "fra": "2024-07-01",
        "frb": "2025-03-30",
        "contract": "421",
        "coef": null,
        "desempleo": "1",
        "MRein": null,
        "eSoc": null,
        "rlce": null,
        "col": null,
        "indice": 2
      },
      {
        "fra": "2025-03-31",
        "frb": null,
        "contract": "109",
        "coef": null,
        "desempleo": null,
        "MRein": null,
        "eSoc": null,
        "rlce": null,
        "col": null,
        "indice": 3
      }
    ]
  }
}

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:
- 0111: Régimen general
- Tabla con los códigos de régimen (opens in a new tab)
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:
- a = Personal en trabajos exclusivos de oficina.
- Tabla con los códigos de la ocupación del trabajador (opens in a new tab)
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

{
  "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:
- 0111: Régimen general
- Tabla con los códigos de régimen (opens in a new tab)
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:
- 03: Jefes administrativos y de taller
- Tabla con los códigos de grupo de cotización (opens in a new tab)
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

{
  "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:
- 0111: Régimen general
- Tabla con los códigos de régimen (opens in a new tab)
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:
- 0000301: Capitán inspector
- Tabla con los códigos de la categoría profesional (opens in a new tab)
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

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

Cambio 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:
- 0111: Régimen general
- Tabla con los códigos de régimen (opens in a new tab)
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:
- 0011: Oficiales de las fuerzas armadas
- Tabla con los códigos de ocupación (opens in a new tab)
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

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

Obtener 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:
- 0111: Régimen general
- Tabla con los códigos de régimen (opens in a new tab)
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.

GET /cno

{
  "test": 1,
  "regimen": "0111",
  "ccc": "12345678901",
  "dni": "12345678B",
  "nss": "123456789011",
}

Respuesta

{
  "success": true,
  "message": "OK",
  "data": {
    "cno": "9999"
  }
}

Obtener Grupo de cotización, cno y categoria 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:
- 0111: Régimen general
- Tabla con los códigos de régimen (opens in a new tab)
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.

GET /category-occupation-gc

{
  "test": 1,
  "regimen": "0111",
  "ccc": "12345678901",
  "dni": "12345678B",
  "nss": "123456789011",
}

Respuesta

{
  "success": true,
  "message": "OK",
  "data": {
    "trabajador": {
        "NA1NumSegSocialSinDC": "",
        "IP2TipoDocIPF": "1",
        "NA5NumSegSocialCompleto": "661958374675",
        "IP3DocIPF": "37562775x",
        "IP9NumDoc": "37562775x",
        "NOMBRE_COMPLETO": "PAZ PANTOJA , LEIRE",
        "ipfPsaf": {
            "IP2tipo": "1",
            "IP3numero": "37562775x"
        },
        "tipoDescrip": "D.N.I."
    },
    "cuentaCotizacion": {
        "CC2Empleador": "",
        "CC6Empleador": "",
        "CC3_solicitante": "",
        "CC4_solicitante": "",
        "CC2_solicitante": "",
        "CF2Cuenta": "",
        "CF3Cuenta": "",
        "CF2_solicitante": "",
        "CF3_solicitante": "",
        "RAZ_solicitante": "",
        "CC1EmpresaAut": "011239890056164"
    },
    "contrato": {
        "caracteristicasContrato": "2",
        "coeficienteContrato": "0",
        "coeficienteTiempoParcial": "0",
        "coeficienteTiempoParcialInicialReduccionJornada": "0",
        "contratoTrabajoSPEE": "0",
        "cuantiaGlobalBonificada": "0",
        "excluidoCensoAgrario": "0",
        "excluidoDesempleo": "",
        "exclusionCotizacion": "0",
        "fechaCambioContrato": "08/09/2012",
        "gradoMinusvalia": "0",
        "modalidadCotizacion": "0",
        "nafSustituido": "0",
        "tipoContrato": {
            "codigo": "100",
            "desCorta": "IND.T.COMP.ORDINARIO",
            "desLarga": "INDEFINIDO.TIEMPO COMPLETO.ORDINARIO"
        }
    },
    "categoriaProfesional": {
        "fechaCambioCategoriaProfesional": "08/09/2012",
        "categoriaProfesional": {
            "codigo": "6000327",
            "desCorta": "ART CIR VA FOL TE/MU",
            "desLarga": "ARTIST CIRCO VAR FOLKLORE"
        }
    },
    "claveSituacionPeriodo": {
        "claveSituacion": {
            "codigo": "01",
            "desCorta": "ALTA NORMAL",
            "desLarga": "ALTA NORMAL"
        }
    },
    "grupoCotizacion": {
        "fechaCambioGrupo": "08/09/2012",
        "grupoCotizacion": {
            "codigo": "08",
            "desCorta": "OFICIALES 1` Y 2`",
            "desLarga": "OFICIALES 1` Y 2`"
        },
        "indCotizacionMensual": ""
    },
    "ocupacion": {
        "epigrafe": "0",
        "fechaCambioOcupacion": "08/09/2012",
        "ocupacion": {
            "codigo": "D",
            "desCorta": "CONSTRUC. EN GENERAL",
            "desLarga": "CONSTRUCCION EN GENERAL, INST. EN OBRAS"
        }
    }
  }
}

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 (opens in a new tab)
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:
- 967: CT circunstancias de la producción
- Tabla con los códigos de la ocupación del trabajador (opens in a new tab)

PUT /contract-coeficiente

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

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

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

{
  "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:
- 0111: Régimen general
- Tabla con los códigos de régimen (opens in a new tab)
ccc (número entero) : Cuenta de cotización, 11 dígitos.
dni (caracteres) : Documento Nacional de Identidad.
startDate (date) : Opcional. Fecha de alta, formato YYYY-MM-DD.
getConvenio (número entero) : Opcional. Si quieres obtener los convenios de un trabajador. los posibles valores son 1 o null.
pl_period (caracteres) : Opcional, Consultar las peculiaridades, formato YYYY-MM. Ejemplo: 2025-03

GET /employee-situations

{
  "regimen": "0111",
  "ccc": "12345678901",
  "dni": "12345678B",
  "startDate": "2023-01-01",
  "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

{
  "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:
- 0111: Régimen general
- Tabla con los códigos de régimen (opens in a new tab)
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

{
  "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:
- 0111: Régimen general
- Tabla con los códigos de régimen (opens in a new tab)
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

{
  "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:
- 0111: Régimen general
- Tabla con los códigos de régimen (opens in a new tab)
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

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

regimen (número entero) : Régimen, 4 dígitos. Posibles valores:
- 0111: Régimen general
- Tabla con los códigos de régimen (opens in a new tab)
ccc (número entero) : Cuenta de cotización, 11 dígitos.
startDate (date) : Fecha de inicio, formato YYYY-MM-DD.

GET /idc-ccc

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

Respuesta

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

Informe de Datos para la Cotización/Trabajadores por Cuenta Ajena-Información por Relación Laboral

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 (opens in a new tab)
ccc (número entero) : Cuenta de cotización, 11 dígitos.
startDate (date) : Fecha de inicio, formato YYYY-MM-DD.
endDate (date) : Fecha de inicio, formato YYYY-MM-DD.
nss (número entero) : Número de Seguridad Social, 12 dígitos.

GET /report-idc-rl-by-nss

{
  "regimen": "0111",
  "ccc": "12345678901",
  "nss": "289999999999",
  "startDate": "2025-01-01",
  "endDate": "2025-12-31"
}

Respuesta

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

Obtener listado de TA

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 (opens in a new tab)
ccc (número entero) : Cuenta de cotización, 11 dígitos.
nss (número entero) : Número de Seguridad Social, 12 dígitos.

GET /ta-info-for-nss

{
  "regimen": "0111",
  "ccc": "12345678901",
  "nss": "289999999999"
}

Respuesta

{
  "success": true,
  "message": "OK",
  "data": [
      {
          "indice": 2,
          "documentoTA": "CAMBIO DE CONTRATO",
          "date": "2023-02-01",
          "contractType": "100"
      },
      {
          "indice": 1,
          "documentoTA": "ALTA (SIT.ACTUAL)",
          "date": "2023-01-16",
          "st": "01",
          "gc": "02",
          "contractType": "200",
          "coeficiente": "0,500"
      }
  ]
}

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:
- 0111: Régimen general
- Tabla con los códigos de régimen (opens in a new tab)
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

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

regimen (número entero) : Régimen, 4 dígitos. Posibles valores:
- 0111: Régimen general
- Tabla con los códigos de régimen (opens in a new tab)
ccc (número entero) : Cuenta de cotización, 11 dígitos.

GET /informe-ita

{
  "regimen": "0111",
  "ccc": "12345678901"
}

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

regimen (número entero) : Régimen, 4 dígitos. Posibles valores:
- 0111: Régimen general
- Tabla con los códigos de régimen (opens in a new tab)
ccc (número entero) : Cuenta de cotización, 11 dígitos.

GET /employees-with-movement-previous

{
  "regimen": "0111",
  "ccc": "12345678901"
}

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:
- 0111: Régimen general
- Tabla con los códigos de régimen (opens in a new tab)
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

{
  "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:
- 0111: Régimen general
- Tabla con los códigos de régimen (opens in a new tab)
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

{
  "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:
- 0111: Régimen general
- Tabla con los códigos de régimen (opens in a new tab)
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

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

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

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 (opens in a new tab)

GET /report-situation-ccc

{
  "regimen": "0111",
  "ccc": "12345678901"
}

Respuesta

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

Duplicado de documentos de empresarios

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 (opens in a new tab)

GET /report-duplicate-businessmen

{
  "regimen": "0111",
  "ccc": "12345678901"
}

Respuesta

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

Consulta certificados e informes de deuda

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 (opens in a new tab)

GET /report-certificates-debt

{
  "regimen": "0111",
  "ccc": "12345678901"
}

Respuesta

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

Afiliación de NAF

Inscripción de número de afiliación, este método se encuentra en fase beta.

Parámetros

dni (caracteres) : Documento Nacional de Identidad.
identificacion (número entero) : Número de identificación, posibles valores:
- 1: DNI
- 2: Pasaporte
- 6: NIE
name (caracteres) : Nombre.
surname (caracteres) : Primer apellido.
lastSurname (caracteres) : Segundo apellido, si lo tiene.
country (número entero) : Nacionalidad. Posibles valores:
- 724: España
- Tabla con los códigos de nacionalidad (opens in a new tab)
sexo (caracteres) : Sexo, posibles valores:
- M: Masculino
- F: Femenino
fnacimiento (fecha) : Fecha de nacimiento. Formato YYYY-MM-DD.
fatherName (caracteres) : Nombre del padre.
motherName (caracteres) : Nombre de la madre.
phoneCode (número entero) : Código de teléfono. Ejemplo: 34
phone (número entero) : Número de teléfono.
streetType (caracteres) : Tipo de calle, posibles valores:
- CL: Calle
streetName (caracteres) : Nombre de la calle.
streetNumber (caracteres) : Número de la calle.
bis (caracteres) : Bis.
block (caracteres) : Bloque.
stairs (caracteres) : Escalera.
floor (caracteres) : Piso.
door (caracteres) : Puerta.
postalCode (caracteres) : Código postal, máximo 5 dígitos.
city (número entero) : Ciudad. Posibles valores:
- 13044: Fuente el Fresno
- Tabla con los códigos de municipio (opens in a new tab)

POST /assignment-nss

{
  "dni": "12345678A",
  "identificacion": 1,
  "name": "Juan",
  "surname": "Perez",
  "lastSurname": "Garcia",
  "country": 724,
  "sexo": "M",
  "fnacimiento": "2023-01-01",
  "fatherName": "Juan",
  "motherName": "Perez",
  "phoneCode": 34,
  "phone": 123456789,
  "streetType": "CL",
  "streetName": "Calle 1",
  "streetNumber": "1",
  "bis": "",
  "block": "",
  "stairs": "",
  "floor": "4",
  "door": "A",
  "postalCode": "13044",
  "city": 13044
}

Respuesta

{
  "success": true,
  "message": "OK",
  "data": {
    "nss": "123456789012",
    "identity": "1",
    "dni": "12345678A"
  }
}

Consulta Convenios

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 (opens in a new tab)
ccc (número entero) : Cuenta de cotización, 11 dígitos.

GET /anotaciones-causa-peculiaridades

{
  "test": 1,
  "regimen": "0111",
  "ccc": "12345678901"
}

Respuesta

{
  "success": true,
  "message": "OK",
  "data": {
      "list": [
          {
              "startDate": "2024-10-08",
              "endDate": null,
              "convenio": "66006994423467",
              "convenio_descripcion": "GESTORIAS ESPECIALES DE PRACTICAS"
          },
          {
              "startDate": "2023-05-08",
              "endDate": null,
              "convenio": "60557956030733",
              "convenio_descripcion": "GESTORIAS ADMINISTRATIVAS"
          }
      ]
  }
}

Consulta Convenios Colectivos múltiples por trabajador

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 (opens in a new tab)
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.

GET /convenios-colectivos-por-trabajador

{
  "test": 1,
  "regimen": "0111",
  "ccc": "12345678901",
  "nss": 123456789012,
  "identificacion": 1,
  "dni": "12345678A"
}

Respuesta

{
  "success": true,
  "message": "OK",
  "data": {
      "list": [
          {
              "startDate": "2024-10-08",
              "endDate": null,
              "convenio": "66006994423467",
              "convenio_descripcion": "GESTORIAS ESPECIALES DE PRACTICAS"
          },
          {
              "startDate": "2023-05-08",
              "endDate": null,
              "convenio": "60557956030733",
              "convenio_descripcion": "GESTORIAS ADMINISTRATIVAS"
          }
      ]
  }
}

Consulta de CCCs Asignados a una Autorización

Parámetros

test (número (1)) : Para pruebas, añade el parámetro test=1. Para producción se debe omitir.
authorized_num (número entero) : Opcional. Número de autorización, requerido cuando el usuario tiene mas de un autorizado. Al realizar la petición devuelve los autorizados si tiene mas de un autorizado con el status 428

GET /ccc-asignados

{
  "test": 1,
  "authorized_num": "999252",
}

Respuesta OK

Respuesta

{
    "success": true,
    "message": "OK",
    "status": 200,
    "data": {
        "authorized_num": "257020",
        "pagination": {
            "next": false
        },
        "list": [
            {
                "regimen": "0138",
                "ccc": "96372899466",
                "razSoc": "Partida de Naranjo",
                "ccc_type": "S Secundario",
                "startDate": "2024-01-21",
                "code_situacion": "02",
                "ccc_situacion": "ALTA",
                "ccc_es_practica": "SI"
            },
            {
                "regimen": "0111",
                "ccc": "20120294786",
                "razSoc": "Empresa Bautista e Hija",
                "ccc_type": "S Secundario",
                "startDate": "2024-10-25",
                "code_situacion": "06",
                "ccc_situacion": "ALTA POR REINICIO",
                "ccc_es_practica": "SI"
            }
        ]
    }
}

Respuesta status 428

Respuesta

{
    "success": false,
    "message": "Existen más de una autorización, por favor especifique la autorización a consultar {authorized_num}.",
    "status": 428,
    "data": {
        "list": [
            {
                "numero": "194114",
                "razSoc": "Vanegas-Burgos"
            },
            {
                "numero": "631504",
                "razSoc": "Viajes Tovar S. de H."
            },
            {
                "numero": "843705",
                "razSoc": "Corporación Juárez"
            },
            {
                "numero": "928612",
                "razSoc": "Serrato de Quintanilla"
            },
            {
                "numero": "875039",
                "razSoc": "Armenta y Candelaria"
            }
        ]
    }
}

Anotación de convenio colectivo

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 (opens in a new tab)
ccc (número entero) : Cuenta de cotización, 11 dígitos.
startDate (date) : Fecha desde, formato YYYY-MM-DD.
endDate (date) : Opcional. Fecha hasta, formato YYYY-MM-DD.

POST /anotaciones-causa-peculiaridades

{
  "test": 1,
  "regimen": "0111",
  "ccc":"13991977999",
  "convenio":"99009995011999",
  "startDate":"2026-01-22",
}

Respuesta OK

Respuesta

{
    "success": true,
    "message": "3365* ALTA REALIZADA",
    "status": 200,
    "data": []
}

Convenios Colectivos múltiples por trabajador

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 (opens in a new tab)
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 desde, formato YYYY-MM-DD.
endDate (date) : Opcional. Fecha hasta, formato YYYY-MM-DD.

POST /convenios-colectivos-por-trabajador

{
  "test": 1,
  "regimen": "0111",
  "ccc":"13991977999",
  "convenio":"99009995011999",
  "startDate":"2026-01-22",
  "nss": "123456789012",
  "dni": "12345678A",
}

Respuesta OK

Respuesta

{
    "success": true,
    "message": "3408* OPERACION REALIZADA CORRECTAMENTE",
    "status": 200,
    "data": []
}

Obtener Duplicado de Certificados de Maternidad/Paternidad

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 (opens in a new tab)
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 de inicio de parte, formato YYYY-MM-DD.

GET /recema/report

{
  "test": 1,
  "regimen": "0111",
  "ccc":"13991977999",
  "startDate":"2026-01-22",
  "nss": "123456789012"
}

Respuesta OK

Respuesta

{
    "success": true,
    "message": "3408* OPERACION REALIZADA CORRECTAMENTE",
    "status": 200,
    "data": {
      "file": {
        "contentType": "application/pdf",
        "name": "document.pdf",
        "content": "base64"
      },
      "data": {
            "ccc": "869893612194697",
            "naf": "834171524647",
            "fechaInicio": "27/04/2025",
            "fechaFin": "11/09/2026",
            "fechaGrabacion": "12/02/2026",
            "motivo": "2",
            "codIpf": "690924946F",
            "razonSocial": "AIR COBO Y FLIA.",
            "codLocalidad": "980824948",
            "cp": "13719",
            "codProvincia": "12",
            "provincia": "SANTA CRUZ DE TENERIFE",
            "tipoVia": "AV",
            "nombreVia": "PRAZA RAEL",
            "numVia": "37",
            "domicilio": "CALLE AMAYA, 815, 2º B, 36740, L' RAEL DE SAN PEDRO",
            "fechaEnvio": "16/01/2026",
            "id": "9968172"
        }
    }
}

Eliminar un certificado Errores