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.
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.
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.
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 (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”.
{ "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º" } }
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.
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”.
{ "establecimiento2": 50580352360000, "profesional2": 541038210000, "fechaDiagnostico2": "28-02-2021", "diagnostico2": 10323 }
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
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 |