Ayuda en línea > Módulo 5. - Registros Federales > Módulo 5.2. - Registros Federales asociados al ciudadano > Capítulo 5.2.13. - EPF. Registro de Enfermedades Poco Frecuentes > Instructivos API
API 550

Registro de Enfermedades Poco Frecuentes y Anomalías Congénitas.

La API 550, está destinada a realizar altas de diagnósticos en el registro de EPF, en forma nominalizada. Funciona de manera casi análoga al formulario de alta del SISA.

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

Consideraciones del servicio:

Consideraciones del Registro:

Introducción general al servicio:

Tal y como sucede en el formulario de alta de EPF en SISA, a cada ciudadano, en forma nominal, se le puede cargar no más de dos diagnósticos.

Bajo esa premisa, la API550 se desarrolló para utilizar tres EndPoints:

Para cualquiera de los tres casos, la autenticación viaja en HEADERS, de la siguiente manera:
APP_ID: usuario
APP_KEY: contraseña
Estas credenciales son ficticias y sirven sólo a modo ilustrativo.

Información general para construcción de llamados (Versión 1.0):

EndPoint 1, para carga de DIAGNÓSTICO 1:

URL de entorno productivo: https://epf.sisa.msal.gov.ar/epf/pacientes
URL de entorno bajo de pruebas: https://apisalud-qa.msal.gob.ar/epf/pacientes
Autenticación: vía HEADERS.
Método: POST
Código viaja en BODY, como JSON.

Parámetro de entrada:

Codificación SISA
Código JSON Descripción
ciudadano
apellido Apellido del ciudadano. Texto. *
nombre Nombre del ciudadano. Texto. *
tipoDocumento Código que identifica al tipo de documento. * (1)
numeroDocumento Número de documento del ciudadano. Alfanumérico (admite documentos con letras; se envía como string). *
sexo Sexo del ciudadano. Texto (valores admitidos: A - F - M - X). *
fechaNacimiento Fecha de nacimiento del paciente (formato válido DD-MM-AAAA). *
domicilio
idPais Código numérico que identifica al país de residencia. (2)
idProvincia Código numérico que identifica a la provincia de residencia. (2)
idDepartamento Código numérico que identifica al departamento de residencia. (2)
idLocalidad Código numérico que identifica a la localidad de residencia. (2)
calle Nombre de la calle. Texto.
numero Altura del domicilio (texto, puede incluir número y referencias, como piso). (2)
paisEmisionTipoDocumento Código numérico que identifica al país que emitió el documento.
seDeclaraPuebloIndigena Si se declara de pueblo indígena (valores aceptados: SI - NO).
telefono Número de teléfono (admite puntos, guiones y características regionales con paréntesis).
mail Mail (formato válido mail_mail@dominio.com).
personaACargo
tipoDocumento Código que identifica al tipo de documento del responsable a cargo. (1) (2)
numeroDocumento Número de documento del ciudadano responsable. Alfanumérico (admite documentos con letras; se envía como string). (2)
vinculo Código numérico que identifica al vínculo entre el recién nacido y el responsable a cargo. (1) (2)
diagnostico
establecimiento Código REFES del Establecimiento (numérico de 14 dígitos). *
profesional Código REFEPS del Profesional.
diagnostico ID que identifica el diagnóstico asignable al paciente * (4)
fechaDiagnostico Fecha en la que se realiza el diagnóstico *
demoraDiagnostica Demora del diagnóstico (1)
asesoramientoGenetico Asesoramiento genético (1)
casoFamilia Cantidad de casos en la familia (1)
deteccionDuranteEmbarazo Detección durante el embarazo (1)
observaciones Observaciones (comentario, en texto, de hasta 2000 caracteres).

* Campos obligatorios
(1) Codificaciones auxiliares incluidas en este documento
(2) Obligatorios en situaciones determinadas, por Ej.: para ciudadanos recién nacidos, menores de un año, o para personas no validadas con RENAPER
(3) Codificaciones Auxiliares en el carrusel móvil de SISA
(4) Codificaciones específicas del servicio. Ver apartado de “endpoint 3”.




Ejemplo de Request:


{
    "ciudadano": {
        "apellido": "Pérez",
        "nombre": "Julio Enrique",
        "tipoDocumento": "1",
        "numeroDocumento": "28123987",
        "sexo": "m",
        "fechaNacimiento": "31-12-1990",
        "domicilio": {
            "idPais": 200,
            "idProvincia": 2,
            "idDepartamento": 77,
            "idLocalidad": 6490020,
            "calle": "Avenida Mitre",
            "numero": "345 PB Dpto 3 Bis. # sin timbre # "
        },
        "paisEmisionTipoDocumento": 225,
        "seDeclaraPuebloIndigena": "No",
        "telefono": "(011)15-1234-9876",
        "mail": "mail_de_ejemplo@dominio.com",
        "personaACargo": {
            "tipoDocumento": null,
            "numeroDocumento": null,
            "vinculo": null
        }
    },
    "diagnostico": {
        "establecimiento": 50580352360000,
        "profesional": 541038210000,
        "diagnostico": 10322,
        "fechaDiagnostico": "31-12-2020",
        "demoraDiagnostica": null,
        "asesoramientoGenetico": null,
        "casoFamilia": null,
        "deteccionDuranteEmbarazo": null,
        "observaciones": "Comment hasta 2K caract Admite caract. extraños - / () #$ ¿? 0º"
    }
}

EndPoint 2, para carga de DIAGNÓSTICO 2:

URL de entorno productivo: https://epf.sisa.msal.gov.ar/epf/pacientes/70
URL de entorno bajo de pruebas: https://apisalud-qa.msal.gob.ar/epf/pacientes/70
Autenticación: vía HEADERS.
Método: PUT
Código viaja en BODY, como JSON.

Parámetro de entrada:

Codificación SISA
Código JSON Descripción
establecimiento2 Código REFES del Establecimiento (numérico de 14 dígitos). *
profesional2 Código REFEPS del Profesional.
fechaDiagnostico2 Fecha en la que se realiza el diagnóstico *
diagnostico2 ID que identifica el diagnóstico asignable al paciente * (4)

* Campos obligatorios
(4) Codificaciones específicas del servicio. Ver apartado de “endpoint 3”.

Ejemplo de Request:


{
    "establecimiento2": 50580352360000,
    "profesional2": 541038210000,
    "fechaDiagnostico2": "28-02-2021",
    "diagnostico2": 10323
}
	

Consideración para EndPoint de Diagnóstico 2:

EndPoint 3, para Consulta de Codificaciones Auxiliares:

URL de entorno productivo: https://epf.sisa.msal.gov.ar/epf/diagnosticos
URL de entorno bajo de pruebas: https://apisalud-qa.msal.gob.ar/epf/diagnosticos
Autenticación: vía HEADERS.
Método: GET

Este Llamado no tiene BODY. Simplemente con hacer SEND se obtiene el listado de codificaciones auxiliares para poder utilizar de forma correcta los otros dos Endpoints.

Para aquellos usuarios que deseen realizar pruebas en entorno bajo, pueden utilizar las siguientes credenciales genéricas:
APP_ID: WSQA_WS550_ID
APP_KEY: WSQA_WS550_KEY

CODIFICACIONES AUXILIARES para este servicio:

tipoDocumento
Código Nombre Detalle
1 DNI Documento Nacional de Identidad
5 DE Documento extranjero o pasaporte
9 IND Indocumentado
demoraDiagnostica
Código Detalle
1 Menor a 1 año
2 1 a 5 años
3 Mayor a 5 años
4 Pesquisa Neonatal
asesoramientoGenetico
Código Detalle
1 Si
2 No
3 No sabe
casoFamilia
Código Detalle
1 Caso aislado
2 Caso familiar
deteccionDuranteEmbarazo
Código Detalle
1 Malformaciones mayores en ecografía obstétrica
2 Alteraciones de la cantidad de líquido anmiótico
3 Restricción de crecimiento intrauterino
4 Diagnóstico genético durante el embarazo
5 Otras
vinculo
Código Detalle
1 Padre
2 Madre
3 Tutor o encargado
4 Hermano/a
5 Otro familiar
6 Otro parentesco
7 Hijo/a
8 Abuelo/a
10 Tío/a
11 Primo/a
12 Nieto/a
13 Conyuge
14 Conviviente
15 Padre biológico
16 Madre biológica