Ayuda en línea > Módulo 5. - Registros Federales > Módulo 5.1. - Registros Federales de gestión general > Capítulo 5.1.2. - REFEPS. Red Federal de Registros de Profesionales de la Salud > Servicios web
WS024

Inserción de profesionales, profesiones y matrículas - Versión 2.0

El Servicio WS24 está destinado a realizar altas y modificaciones, tanto de Profesionales como de sus respectivas Matrículas, dentro de la Red Federal de Registros de Profesionales de la Salud.

Aquí presentamos la versión 2.0 del servicio, recientemente desarrollada, ofreciendo tanto una mejor performance en comparación con su predecesora, como también más robustez en lo que refiere a funcionamiento, validación y riqueza de datos, sin dejar de tener la misma lógica general y estructura de llamado.

Al igual que la versión original, este WS funciona de forma análoga al formulario de Alta del SISA. Respetando y manteniendo la misma lógica en la nomenclatura de datos y validaciones.

El uso de este servicio requiere autenticación con usuario & contraseña (APP_ID & APP_KEY, respectivamente). Para solicitar nuevas credenciales, hacerlo vía mail a soporte@sisa.msal.gov.ar.

Para aquellos usuarios activos de la versión 1.0 del WS24, no es necesario volver a firmar los formularios ni tramitar una nueva solicitud de aprobación. En estos casos, el equipo de Soporte SISA facilitará credenciales pertinentes, las cuales se asociarán al USUARIO SISA utilizados hasta la fecha con la versión previa.

Consideraciones generales:

Lógica técnico-sanitaria del Servicio:

La V2 hereda las lógicas de potestades y restricciones territoriales dependiendo del alcance geográfico del USUARIO SISA. Un usuario de alcance provincial (Operador Provincial Buenos Aires, por ejemplo), tiene potestad de acción sólo en la Provincia que tiene asociada. De igual manera, un Operador Provincial con un Establecimiento específico asignado, puede realizar altas y modificaciones sólo en la institución a la que pertenezca.

Los únicos perfiles que no pueden accionar con el WS, independientemente a su alto rango jerárquico, son los de alcance Nacional (Referente Nacional SISA, por ejemplo).

Para mantener los estándares de calidad y riqueza de datos, toda la información del profesional, a nivel nominal, es validado contra RENAPER.

Todas las codificaciones que se envíen con el WS deben estar debidamente HABILITADAS en sus respectivas tablas auxiliares de SISA. Por ejemplo: no se puede dar de alta una profesión que en SISA figure como “HABILITADO = NO”. *

* Referencia y ayuda para Codificaciones auxiliares, más adelante en el documento.

Construcción del llamado:

URL entorno productivo : https://apisalud.msal.gob.ar/refeps/v1/profesional/profesion/matricula
URL de entorno de pruebas: https://apisalud-qa.msal.gob.ar/refeps/v1/profesional/profesion/matricula
Método: POST
Autenticación: vía HEADERS.

Para el entorno QA de pruebas, se pueden utilizar las siguientes credenciales genéricas:

Request: viaja en BODY, como JSON.

Parámetros de entrada

Codificación SISA
profesional
Código JSON Ob Tipo dato Valores aceptados (Ejemplos) Descripción
nombre SI STR Nombre del Profesional.
apellido SI STR Apellido del Profesional.
tipoDocumento SI NUM Único valor aceptado: 1 Código que identifica al tipo de documento.
numeroDocumento SI NUM Número de documento.
sexo SI STR [F, M, X] Sexo del profesional.
fechaNacimiento SI DATE DD-MM-AAAA Fecha de nacimiento del Profesional.
idPaisNacimiento SI NUM Consultar codificaciones Auxiliares. Código numérico que identifica al país de Nacimiento.
idLocalidadNacimiento NUM Consultar codificaciones Auxiliares. Código numérico que identifica a la localidad de Nacimiento del Profesional.
idPais SI NUM Consultar codificaciones Auxiliares. Código numérico que identifica al país de Nacionalidad.
email STR mail_mail@dominio.com Mail del profesional.
email2 STR mail_mail@dominio.com Mail alternativo.
habilitado SI STR SI, NO Indicador: si está HABILITADO.
Profesión
Código JSON Ob Tipo dato Valores aceptados (Ejemplos) Descripción
titulo SI STR Título de la Formación de Posgrado del profesional.
idInstitucionFormadora SI NUM Id que corresponde a la Institución de Formación.
fechaTitulo SI DATE DD-MM-AAAA Fecha del Título.
idProfesionReferencia SI NUM Consultar codificaciones Auxiliares. Id que identifica la Profesión de Referencia.
idInstitucionSede NUM Consultar codificaciones Auxiliares. Id de la Sede de la Institución de Formación.
revalida SI STR SI, NO Indicador: si hay REVALIDA.
idInstitucionRevalida NUM Consultar codificaciones Auxiliares. Id de la Institución donde se hizo la REVALIDA.
fechaRevalida DATE DD-MM-AAAA Fecha del Revalida.
Matricula
Código JSON Ob Tipo dato Valores aceptados (Ejemplos) Descripción
codigo SI STR Código de Matricula.
fecha SI DATE DD-MM-AAAA Fecha de Matriculación.
fechaFin DATE DD-MM-AAAA Fecha de Fin de la vigencia de la Matricula si existiera.
libro STR Libro.
folio STR Folio.
acta STR Acta.
expediente STR Expediente.
rematriculacion SI STR Único valor aceptado: NO
idProfesion SI NUM Consultar codificaciones Auxiliares. Id que identifica la de profesión Matriculada.
idProvincia SI NUM Consultar codificaciones Auxiliares. Id que identifica la de Provincia en la que se está matriculando.
comentario STR Comentario de hasta 2000 caracteres.
Emisor
Código JSON Ob Tipo dato Valores aceptados (Ejemplos) Descripción
idOrigen NUM Id que indica el Colegio de Matriculación que gestiona la matricula.
Domicilio
Código JSON Ob Tipo dato Valores aceptados (Ejemplos) Descripción
calle NO STR Calle del Domicilio del Profesional.
calleNro STR Altura de la Calle del Profesional.
piso STR Piso.
dpto STR Consultar codificaciones Auxiliares. Departamento.
idPais SI NUM Consultar codificaciones Auxiliares. Id del Pais del Domicilio.
idProvincia SI NUM Consultar codificaciones Auxiliares. Id de la provincial.
idLocalidad NUM Consultar codificaciones Auxiliares. Id de la Localidad.
cp STR Código Postal.
tieneTelefono STR SI, NO Indicador: si tiene teléfono.
idTipoTelefono1 NUM Consultar codificaciones Auxiliares. Id del tipo de teléfono.
telefono1 STR Nro. de teléfono.
idTipoTelefono2 NUM Consultar codificaciones Auxiliares. Id del tipo de teléfono.
telefono2 STR Nro. de teléfono.
idTipoTelefono3 NUM Consultar codificaciones Auxiliares. Id del tipo de teléfono.
telefono3 STR Nro. de teléfono.
idTipoTelefono4 NUM Consultar codificaciones Auxiliares. Id del tipo de teléfono.
telefono4 STR Nro. de teléfono.

Ejemplo de Request:


{
    "profesional": {
        "nombre": "RAÚL",
        "apellido": "GONZÁLEZ BLANCO",
        "tipoDocumento": 1,
        "numeroDocumento": 99999999,
        "sexo": "M",
        "fechaNacimiento": "31-12-1980",
        "idPaisNacimiento": 200,
        "idPais": 200,
        "email": "mail_mail@dominio.com",
        "email2": null,
        "habilitado": "SI"
    },
    "profesion": {
        "titulo": "Auxiliar en Enfermería",
        "idInstitucionFormadora": 1172,
        "fechaTitulo": "15-05-1988",
        "idProfesionReferencia": 32,
        "idInstitucionSede": null,
        "revalida": "NO",
        "idInstitucionRevalida": null,
        "fechaRevalida": null
    },
    "matricula": {
        "codigo": "4090",
        "fecha": "20-09-2018",
        "fechaFin": null,
        "libro": "",
        "folio": "",
        "acta": "",
        "expediente": "",
        "rematriculacion": "NO",
        "idProfesion": 183,
        "idProvincia": 2,
        "idSituacion": 1,
        "comentario": "String alfanumérico de hasta 2000 caracteres.",
        "emisor": {
            "idOrigen": null,
            "domicilio": {
                "calle": "Avenida Corrientes",
                "calleNro": "789",
                "piso": null,
                "dpto": null,
                "cp": null,
                "idPais": 200,
                "idProvincia": 2,
                "idLocalidad": ""
            },
            "tieneTelefono": "SI",
            "idTipoTelefono1": 1,
            "idTipoTelefono2": "",
            "telefono1": "(011) 15-8877-2211",
            "telefono2": "Sin dato."
        }
    }
}

Aquellos datos que no sean obligatorios se pueden enviar de la siguiente manera:

  • Como null
  • Con comillas vacías (“”).
  • Borrando la etiqueta entera.

Ejemplo de respuesta Exitosa (200_OK):


{
    "timestamp": "04-07-2023 12:20:24",
    "resultado": "OK",
    "idProfesional": 20099999,
    "idProfesion": 1039548,
    "idMatricula": 91889988,
    "codigoProfesional": "941066778899"
}

Ejemplo de respuesta con errores (400_Bad_request):


{
    "status": "BAD_REQUEST",
    "timestamp": "13-08-2023 23:52:20",
    "resultado": "ERROR_DATOS",
    "description": "Errores de argumentos: [{altaPPMRequestDto=La fecha del titulo debe estar contenida entre los 16 años del Profesional y la fecha de hoy.}]",
    "errors": {
        "altaPPMRequestDto": "La fecha del titulo debe estar contenida entre los 16 años del Profesional y la fecha de hoy."
    }
}

Codificaciones Auxiliares:

Para las codificaciones de carácter geográfico:

Para las codificaciones específicas del Registro REFEPS:

Codificaciones Públicas (en carrusel móvil) / Codificación REFEPS.

  • Para descargar una Colección de Postman de ejemplo, clic aquí.