Sistema Intercajas

🎯

Objetivo

El Sistema Intercajas permite a clientes autorizados consultar información de afiliados y aportantes de los distintos regímenes previsionales que administran las provincias, municipios y entidades que integran el CO.FE.PRE.S.

🏢

API Beneficiarios

Consulta de afiliados y sus beneficios en las cajas adheridas.

💼

API Aportantes

Consulta de aportantes activos, escalafón y antigüedad.

🏭

Alcance federal

Cubre cajas provinciales, municipales y Organismos adheridos de todo el país.

🔒

Seguridad

Autenticación JWT obligatoria. Tokens independientes por API.

🏛

Arquitectura

El cliente interactúa con dos APIs independientes. Cada API distribuye internamente las consultas a las cajas provinciales, municipales y Organismos adheridos. Los tokens no son intercambiables entre APIs.

💻 Cliente (aplicación)

HTTP REST — JWT

↓

↙ ↘

🏢 API Beneficiarios

apirest.cofepres.org.ar

↓

Caja Prov. A Caja Prov. B Caja Mun. C + N cajas

💼 API Aportantes

apiaportantes.cofepres.org.ar

↓

Caja Prov. A Caja Prov. B Caja Mun. C + N cajas

API Beneficiarios (apires) API Aportantes (apiaportantes) Cliente externo autorizado

⚠ Independencia total: Cada API tiene su propio sistema de autenticación. Un token obtenido en la API Beneficiarios no es válido en la API Aportantes y viceversa. El cliente debe autenticarse por separado en cada API.

⚖

Marco Legal

Ley 25.326 — Protección de Datos Personales (Argentina). El acceso a datos de afiliados a través de este sistema está sujeto a las disposiciones de la Ley 25.326 y sus normas reglamentarias. El cliente que consume la API es responsable del uso apropiado de la información obtenida.

🔒

Confidencialidad

La información obtenida no puede ser divulgada a terceros no autorizados.

🎯

Finalidad

Los datos solo pueden utilizarse para la finalidad declarada en la solicitud de acceso.

📄

Registro

Todo acceso queda registrado en los logs del sistema para auditoría.

⚖

Autorización previa

Las credenciales de acceso son otorgadas previa autorización formal de COFEPRES.

⚙

Especificaciones técnicas comunes

Ambas APIs comparten las mismas convenciones de diseño.

🌐

Protocolo

HTTPS — TLS 1.2 o superior requerido.

📋

Formato

Respuestas en JSON. Content-Type: application/json.

🔒

Autenticación

JWT enviado en el header APP-TOKEN.

👤

Identificador

Las consultas usan el CUIL como parámetro principal.

📈

Sin paginación

Cada consulta devuelve todos los registros del CUIL en una sola respuesta.

📍

Versión

La versión actual no utiliza prefijo de versión en la URL.

⌛

Timeout

Se recomienda configurar un timeout de 30 segundos en el cliente.

🛡

Firewall

El acceso puede requerir habilitación de IP en el firewall de COFEPRES.

🏢

API Beneficiarios

Permite consultar si una persona (identificada por CUIL) posee uno o más beneficios en alguno de los Organismos previsionales adheridos al Co.Fe.Pre.S.

🌐

URL base

https://apirest.cofepres.org.ar

🔒

Autenticación

Header APP-TOKEN con JWT propio de esta API.

📋

Endpoint principal

GET /public/beneficiario/obtener/{CUIL}

📈

Respuesta

JSON con información obtenida de las AIs adheridas.

🔒

Autenticación

Se utiliza JSON Web Tokens (JWT). Antes de consultar por un CUIL se debe obtener un token y enviarlo como parámetro.

URL base:

URL

https://apirest.cofepres.org.ar/public/auth/autenticar

Body (JSON):

JSON

{
  "email": "usuario@ejemplo.com",
  "clave": "5f4dcc3b5aa765d61d8327deb882cf99"
}

El campo email y clave serán proporcionados por los responsables del Co.Fe.Pre.S.

Respuesta exitosa (HTTP 200):

JSON

{
  "response": "true",
  "result": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "message": "",
  "errors":[]
}

Error credenciales (HTTP 401):

JSON

{
  "response": "false",
  "result": null,
  "message": "Credenciales inválidas",
  "errors":[]
}

Usar el token en el header APP-TOKEN de las siguientes solicitudes. Al expirar se recibe HTTP 401.

📋

Consulta

Consulta de beneficiarios por CUIL. Requiere el token JWT obtenido en el paso de autenticación.

Devuelve la información del beneficiario y todos sus beneficios en las cajas adheridas.

URL completa:

URL

https://apirest.cofepres.org.ar/public/beneficiario/obtener/{CUIL}

Headers requeridos:

Headers

APP-TOKEN: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
Content-Type: application/json

Parámetro de ruta:

Parámetro	Tipo	Descripción
`CUIL`	string	CUIL del beneficiario a consultar (sin guiones)

Respuesta exitosa (HTTP 200):

JSON

{
  0:{
    "idOrganismo": 123,
    "nombreOrganismo": "Caja Provincial de xxxxxxxxxxx",
    "estado": "true", 
    "resultado": {
      "cuil": "xxxxxxxxxxx",
      "numeroDocumento": "xxxxxxxx",
      "tipoDocumento": "DNI",
      "apellidoNombres": "XXXXXXX, XXXXXXX XXXXX",
      "sexo": "M",
      "fechaNacimiento": "1975-03-15",
      "beneficios": [
        {
          "caja": "Caja Provincial de xxxxxxxx",
          "tipoBeneficio": "01",
          "detalleTipoBeneficio": "01",
          "detalleEscalafon": "02",
          "fechaAfiliacion": "2005-06-01",
          "activo": true
        }
      ]
    }
  },
  1:{
    "idOrganismo": 456,
    "nombreOrganismo": "Caja Municipal de xxxxxxxxxxx",
    "estado": "true", 
    "resultado": null
  },
  2:{
    "idOrganismo": 456,
    "nombreOrganismo": "Caja Municipal de xxxxxxxxxxx",
    "estado": "true", 
    "resultado": null
  }
}

Sin resultados (HTTP 200):

JSON

{
  "status": "ok",
  "beneficiario": null
}

💼

API Aportantes

Permite consultar si una persona es aportante activa en alguno de los Organismos adheridos al Co.Fe.Pre.S., junto con su escalafón y antigüedad.

🌐

URL base

https://apiaportantes.cofepres.org.ar

🔒

Autenticación

Header APP-TOKEN con JWT propio de esta API.

📋

Endpoint principal

GET /api/aportante/obtener/{CUIL}

📈

Respuesta

Datos del aportante con escalafón y antigüedad.

🔒

Autenticación

Se utiliza JWT. Antes de consultar por un CUIL se debe obtener un token de la API de Aportantes y enviarlo como parámetro.

URL base:

URL

https://apiaportantes.cofepres.org.ar/api/autenticar

Body (JSON):

JSON

{
  "email": "usuario@ejemplo.com",
  "clave": "5f4dcc3b5aa765d61d8327deb882cf99"
}

El campo email y clave serán proporcionados por los responsables del Co.Fe.Pre.S.

Respuesta exitosa (HTTP 200):

JSON

{
  "status": "ok",
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

Usar el token en el header APP-TOKEN. Al expirar se recibe HTTP 401.

Credenciales inválidas (HTTP 200):

JSON

{
  "result": "false",
  "response": false,
  "message": "Credenciales inválidas",
  "error": "Email o contraseña incorrectos"
}

📋

Consulta

Consulta de aportantes por CUIL. Requiere el token JWT obtenido en el paso de autenticación de esta API.

Devuelve la información del aportante, su escalafón y antigüedad en el sistema.

URL completa:

URL

https://apiaportantes.cofepres.org.ar/api/certificacion/obtener/{CUIL}

Headers requeridos:

Headers

APP-TOKEN: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
Content-Type: application/json

Respuesta exitosa con información del aportante (HTTP 200):

JSON

{
0: {
    "idOrganismo": "123",
    "nombreOrganismo": "CAJA DE JUBILACIONES Y PENSIONES DE XXXXXXXXXXXX",
    "estado": true,
    "resultado": {
      "cuil": "xxxxxxxxxxx",
      "documento": "xxxxxxxx",
      "apellidoNombres": "XXXXXXX, XXXX XX",
      "sexo": "M",
      "fechaNacimiento": "1975-03-15",
      "edad": 48,
      "aportes": [
        {
          "escalafon": "MÉDICO",
          "antiguedad": "25 años y 6 meses (hasta la fecha de emisión del certificado).",
          "inicioServicio": "2001-01-15",
          "finServicio": "CONTINÚA"
        },
        {
          "escalafon": "POLICIAL",
          "antiguedad": "23 años y 4 meses.",
          "inicioServicio": "1999-01-01",
          "finServicio": "2022-05-01"
        },
    ]
  },
1: {
    "idOrganismo": "456",
    "nombreOrganismo": "CAJA DE JUBILACIONES Y PENSIONES DE XXXXXXXXXXX",
    "estado": true,
    "resultado": null
  },
2: {
    "idOrganismo": "678",
    "nombreOrganismo": "CAJA DE JUBILACIONES Y PENSIONES DE XXXXXXXXXXXX",
    "estado": true,
    "resultado": null
  },
}

Además del Organismo donde se encontró el Aportante se obtiene la totalidad de Organismos intervinientes en la consulta con el campo resultado en null.

Respuesta exitosa sin información de aportantes (HTTP 200):

JSON

{
0: {
    "idOrganismo": "456",
    "nombreOrganismo": "CAJA DE JUBILACIONES Y PENSIONES DE XXXXXXXXXXX",
    "estado": true,
    "resultado": null
  },
1: {
    "idOrganismo": "678",
    "nombreOrganismo": "CAJA DE JUBILACIONES Y PENSIONES DE XXXXXXXXXXXX",
    "estado": true,
    "resultado": null
  },......
}

En el caso de no encontrarse información del aportante, se obtiene la totalidad de Organismos intervinientes en la consulta con el campo resultado en null.

📋

Campos de respuesta del Aportante

Campo	Tipo	Descripción
`cuil`	string	CUIL del aportante consultado
`numeroDocumento`	string	Número de documento
`tipoDocumento`	string	1 = DNI, 2 = LC, 3 = LE, 4 = OTRO
`apellidoNombres`	string	Apellido y nombres
`sexo`	string	M = masculino, F = femenino
`fechaNacimiento`	date	Formato YYYY-MM-DD
`edad`	integer	Edad del aportante
`aportes`	array	[ { "escalafon": "DOCENTE", "antiguedad": "10 AÑOS Y 10 MESES", "inicioServicio": "2010-01-01", "finServicio": "2020-11-27" }, { "escalafon": "POLICIAL", "antiguedad": "11 AÑOS Y 1 MES (hasta la fecha de emisión del certificado)", "inicioServicio": "2012-05-15", "finServicio": "CONTINUA" } ]

Objetivo

API Beneficiarios

API Aportantes

Alcance federal

Seguridad

Arquitectura

Marco Legal

Confidencialidad

Finalidad

Registro

Autorización previa

Especificaciones técnicas comunes

Protocolo

Formato

Autenticación

Identificador

Sin paginación

Versión

Timeout

Firewall

API Beneficiarios

URL base

Autenticación

Endpoint principal

Respuesta

Autenticación

POST /public/auth/autenticar Autenticación API Beneficiarios

Consulta

GET /public/beneficiario/obtener/{CUIL} Consulta beneficiario por CUIL

API Aportantes

URL base

Autenticación

Endpoint principal

Respuesta

Autenticación

POST /api/autenticar Autenticación API Aportantes

Consulta

GET /api/certificacion/obtener/{CUIL} Consulta aportante por CUIL

Campos de respuesta del Aportante