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:

• Sólo REST; no dispone de versión SOAP.
• No maneja concepto de cuotas, ni franjas horarias de uso.
• Si bien, en un comienzo coexiste con la VERSIÓN 1.0, la implementación de la V2 es para, eventualmente, reemplazar íntegramente a la primera en el corto/mediano plazo.
• La lógica sanitaria y técnica en general, es exactamente igual a la VERSIÓN 1 del WS.

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.

• APP_ID: “usuario debidamente facilitado por Soporte SISA”.
• APP_KEY: “contraseña debidamente facilitada por Soporte SISA”.

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

• APP_ID: c7503eb2
• APP_KEY: 58287b17c1d82f9f909679caf1ce1926

Request: viaja en BODY, como JSON.

Parámetros de entrada

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

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.