El Servicio WS400, está destinado a realizar alta de eventos a pacientes en forma nominal. Funciona de forma casi análoga a la función de Alta de Evento Nominal del SISA.

En abril de 2021, se desarrolló una versión extendida del Servicio, la VERSIÓN 2.0.

Aquellos usuarios que fueron dados de alta con anterioridad a dicha fecha seguirán disponiendo de la VERSIÓN 1.0 sin inconvenientes. No obstante, quienes deseen migrar al nuevo formato, pueden solicitar credenciales, vía mail a interoperabilidadsnvs@gmail.com y soporte@sisa.msal.gov.ar.

Para más información acerca de la nueva versión del WS400, hacer clic AQUÍ.

Información general (Versión 1.1):

Parámetros de entrada

Todos los campos son obligatorios.

^* Campos obligatorios
⁽¹⁾ Codificaciones incluidas en este documento
⁽²⁾ Codificaciones específicas del registro (ver detalle más adelante)
⁽³⁾ Codificaciones auxiliares disponibles en Agenda Sanitaria de SISA

Resultados posibles de la consulta

OK: el llamado se realizó correctamente, con resultado favorable.
ERROR_AUTENTICACION: “usuario” y/o “contraseña” incorrecto/os.
ERROR_INESPERADO: posiblemente, un error de conexión o micro corte (Cuando sucede esto, probar unos minutos después).
ERROR_DATOS: Algún parámetro es incorrecto (el cual se revelará en “Descripción”).

Ejemplo de llamado (REST) para el entorno PRODUCTIVO

EndPoint o URL: https://sisa.msal.gov.ar/sisa/services/rest/snvs/altaEventoNominal
Método: POST.
El Código viaja en Raw, como JSON.

Ejemplo de llamado (REST) para el entorno de PRUEBAS

EndPoint o URL: https://sisaqa.msal.gov.ar/sisaqa/services/rest/snvs/altaEventoNominal
Método: POST.
El Código viaja en Raw, como JSON.

Autenticación genérica, para pruebas en entorno bajo:
Usuario: “PruebasWSQA”
Clave: “facil1”

Ejemplo de construcción del body, para realizar el llamado:

{
	"usuario":"user",
	"clave":"pass",
	"altaEventoCasoNominal": {
		"idTipodoc": "1",
		"nrodoc": "34000222",
		"sexo": "F",
		"fechaNacimiento": "05-06-1989",
		"idGrupoEvento": "10",
		"idEvento": "77",
		"idEstablecimientoCarga": "10100212224552",
		"fechaPapel": "10-12-2019",
		"idClasificacionManualCaso": "22"
	}
}
	

Codificaciones Auxiliares (Entorno Productivo):

EndPoint o URL: https://apisalud.msal.gob.ar/snvsCasoNominal/v2/snvsCasoNominal/codificacionAuxiliar/evento/grupo/clasificacionmanual
Método: GET.
JSON: viaja sin cuerpo.
Autenticación: vía HEADERS.

Codificaciones Auxiliares (Entorno bajo QA de pruebas):

EndPoint o URL: : https://ws400-qa.sisa.msal.gov.ar/snvsCasoNominal/v2/snvsCasoNominal/codificacionAuxiliar/evento/grupo/clasificacionmanual
Método: GET.
JSON: viaja sin cuerpo.
Autenticación: no requiere.

Ejemplo del formato de la respuesta:

[
    {
        "grupoEvento": "Accidente por Animal Ponzoñoso - Lepidópteros - Lonomía",
        "evento": "Araneísmo sin especificar especie",
        "idEvento": 295,
        "idGrupoEvento": 183,
        "idClasificacionManual": 73,
        "clasificacionManual": "Caso sospechoso"
    },
    {
        "grupoEvento": "Accidente por Animal Ponzoñoso - Lepidópteros - Lonomía",
        "evento": "Araneísmo sin especificar especie",
        "idEvento": 295,
        "idGrupoEvento": 183,
        "idClasificacionManual": 596,
        "clasificacionManual": "Caso invalidado por epidemiología"
    }
]
	

Listado de posibles respuestas del servicio:

Resultado Exitoso:

^** Cuando el alta se realizó correctamente; siendo el “id_caso” el número de identificación del mismo, el cual debe ser usado posteriormente en la API75 Muestra Laboratorio - SNVS 2.0.

Resultados obtenidos al enviar datos erróneamente:

^** “Usuario” y/o “clave” incorrecta.

^** Existen casos en donde no se puede dar de alta un evento, porque el paciente ya tiene uno cargado (por unicidad temporal, por ejemplo; o porque se debe agregar información al evento previamente cargado, y no crear uno nuevo). Cuando es así, se muestra el ID_EVENTO_CASO en cuestión.

^** El campo “sexo” fue completado con un valor NO válido.

^** El campo “fechaNacimiento” no se completó con el formato de fecha correcto. Esto aplica de igual forma, para el campo “fechaPapel”.

^** El campo “fechaPapel” debe seguir una lógica: no puede ser mayor que la fecha del día - FECHA_APERTURA.

^** El campo “idEstablecimientoCarga” debe ser numérico, y existir en la tabla ORIGEN.
Este número, corresponde al CÓDIGO REFES del establecimiento; el mismo se puede obtener consultando en https://sisa.msal.gov.ar/sisa/ , en la sección “Agenda Sanitaria REFES REFEPS” (ubicada en el carrusel móvil del sitio).

^** Cuando haya problemas del tipo validación de datos del ciudadano: reintentar luego de unos minutos. Si el problema persiste, contactar vía mail a interoperabilidadsnvs@gmail.com, facilitando los siguientes datos de la persona en cuestión: nombre y apellido completo, fecha de nacimiento, número de documento, sexo & domicilio real/actual.

^** Cuando el error es, lisa y llanamente, “ERROR_DATOS”, es porque la sintaxis del JSON en el body no está armada correctamente.

^** El parámetro “idTipoDoc” debe ser numérico, estar habilitado y estar comprendido dentro de la siguiente tabla de codificaciones auxiliares:

^** El valor ingresado en el campo “idGrupoEvento” no es válido. Para más información, consultar las Codificaciones Auxiliares del SNVS.

El valor ingresado en el campo “idEvento” no es válido. Para más información, consultar las Codificaciones Auxiliares del SNVS.

El valor ingresado en el campo “IdClasificacionManualCaso” no es válido. Para más información, consultar las Codificaciones Auxiliares del SNVS.

Comentarios:

• El campo “IdClasificacionManualCaso” es dependiente del “idEvento”. Al mismo tiempo, éste último lo es del “idGrupoEvento”.
• Cuando hay más de un dato que se está enviando en forma errónea, el JSON de respuesta, concatena todas las leyendas en una sola, tal y como se ve en el ejemplo siguiente:

• Cuando en la respuesta del WS, el body viene vacío con un “400 Not Found”, el error seguramente esté en el EndPoint o el método elegido para hacer el llamado.

Swagger con ejemplos:

El siguiente enlace contiene un Swagger con ejemplos de llamado ya confeccionados, para interiorizar en el funcionamiento del servicio (apuntan a entornos bajos). Además, dispone de ejemplos para nueva versión 2, como también para consultar las codificaciones auxiliares del registro.

Enlace Swagger QA