Sistema Intercajas
Plataforma de consulta de beneficiarios y aportantes en los Organismos adheridos al Co.Fe.Pre.S.
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.
⚠ 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
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.
https://apirest.cofepres.org.ar/public/auth/autenticar
{
"email": "usuario@ejemplo.com",
"clave": "5f4dcc3b5aa765d61d8327deb882cf99"
}
El campo email y clave serán proporcionados por los responsables del Co.Fe.Pre.S.
{
"status": "ok",
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}
{
"status": "error",
"mensaje": "Credenciales inválidas"
}
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:https://apirest.cofepres.org.ar/public/beneficiario/obtener/{CUIL}
APP-TOKEN: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... Content-Type: application/json
| Parámetro | Tipo | Descripción |
|---|---|---|
CUIL |
string | CUIL del beneficiario a consultar (sin guiones) |
{
"status": "ok",
"beneficiario": {
"cuil": "20123456789",
"numeroDocumento": "12345678",
"tipoDocumento": "DNI",
"apellidoNombres": "GARCíA, JUAN CARLOS",
"sexo": "M",
"fechaNacimiento": "1975-03-15",
"beneficios": [
{
"caja": "Caja Provincial de Santa Fe",
"tipoBeneficio": "01",
"detalleTipoBeneficio": "01",
"detalleEscalafon": "02",
"fechaAfiliacion": "2005-06-01",
"activo": true
}
]
}
}
{
"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.
https://apiaportantes.cofepres.org.ar/api/autenticar
{
"email": "usuario@ejemplo.com",
"clave": "5f4dcc3b5aa765d61d8327deb882cf99"
}
El campo email y clave serán proporcionados por los responsables del Co.Fe.Pre.S.
{
"status": "ok",
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}
APP-TOKEN. Al expirar se recibe HTTP 401.
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:https://apiaportantes.cofepres.org.ar/api/certificacion/obtener/{CUIL}
APP-TOKEN: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... Content-Type: application/json
{
"status": "ok",
"aportante": {
"cuil": "20123456789",
"documento": "12345678",
"apellidoNombres": "GARCíA, JUAN CARLOS",
"sexo": "M",
"fechaNacimiento": "1975-03-15",
"escalafon": "02",
"antiguedadEscalafon": "15 años"
}
}
{
"status": "ok",
"aportante": null
}
Campos de respuesta — Aportantes
| Campo | Tipo | Descripción |
|---|---|---|
cuil | string | CUIL del aportante consultado |
documento | string | Número de documento |
apellidoNombres | string | Apellido y nombres en mayúsculas |
sexo | string | M = masculino, F = femenino |
fechaNacimiento | date | Formato YYYY-MM-DD |
escalafon | string | Código de escalafón |
antiguedadEscalafon | string | Antigüedad en el escalafón (texto descriptivo) |