ETS IntegracionHisMinsa V1.0

Oficina de Innovación y Desarrollo Tecnológico del Ministerio de Salud
Especificaciones Técnicas de Servicios
Servicio Integración HISMINSA
Control de Versiones
Seguimiento y control del documento
Número Fecha
Autor(es) Breve descripción de cambios
Versión Emisión
1 25/10/2017 José Luis Huamán Villar Versión Inicial
2 04/06/2019 Kevin Daniel Pinchi García Versión 1.1.
3 13/02/2021 Kevin Daniel Pinchi García Versión 1.2
4 24/04/2023 Kevin Daniel Pinchi García Versión 1.3
Definiciones
Las siguientes son definiciones de términos, abreviaturas y acrónimos utilizados en este documento.
Término Definición
ETS Especificaciones Técnicas de Servicios.
SOAP Transferencia de Estado Representacional -Representational State
Transfer.
XML Acrónimo de JavaScript Object Notation
HTTP Hypertext Transfer Protocol o HTTP (en español protocolo de
transferencia de hipertexto)
Página 1 de 14
Proceso: Gestión de Proyectos – NTP ISO/IEC 29110 – MINSA – OGTI – OIDT
Ultima actualización: 01 Enero 2017 v1.0
Índice de contenido
OBJETIVO ............................................................................................................................................ 3
AUDIENCIA .......................................................................................................................................... 3
DIAGRAMA DEL SERVICIO ................................................................................................................... 3
DESCRIPCION DEL SERVICIO ...............................................................................................................3
1.1. Datos generales del servicio Integración con HISMINSA .......................................................... 3
1.2. Mecanismos de seguridad ........................................................................................................4
1.3. Ubicación del servicio .............................................................................................................. 4
1.4. Especificación de cada método del servicio .............................................................................4
1.4.1. Método <Actualizar Paquete> .............................................................................................. 4
1.4.1.1. Datos de entrada del método ............................................................................................ 5
1.4.1.2. Datos de salida del método ............................................................................................... 8
1.4.1.3. Códigos/Mensajes de respuesta del método ...................................................................... 9
Página 2 de 14
OBJETIVO
Plantilla que sirve para describir los servicios web (Servicios SOAP, Servicios REST), estas
especificaciones tienen un perfil funcional y técnico alineado a la integración con los diferentes
servicios desarrollados en el sector.
AUDIENCIA
Los estándares del presente documento están dirigidos a:
Líderes de proyectos, arquitectos de software, analistas de sistemas que requieran diseñar

un nuevo servicio.
Desarrolladores de soluciones de tecnología de información que requieran consultar el
detalle de la implementación del servicio.
Directores y Líderes de proyectos que requieran compartir la funcionalidad del servicio.
DIAGRAMA DEL SERVICIO

En el diagrama se muestra la interacción con el servicio y su dependencia con otros servicios.
Página 3 de 14
DESCRIPCIÓN DEL SERVICIO

1.1. Datos generales del servicio Integración con HISMINSA
Los detalles del servicio debe contemplar la especificación funcional y técnica.
Nombre del servicio Servicio de Integración con el HISMINSA
Este servicio permite realizar la actualización de información del

Descripción del
HISMINSA desde los diferentes servicios y/o módulos del Sistema de
servicio
Información de Historias Clínicas Electrónicas.
Beneficios del
Mejorar la integración de información entre el HISMINSA y los SIHCEs.
servicio
Número de métodos 1
Clasificación del
SOAP ( ) REST(X)
servicio
Tipo de datos
XML ( ) JSON(X)
usados
1.2. Mecanismos de seguridad

Actualmente el servicio no necesita ningún método de autenticación.
1.3. Ubicación del servicio

Entorno de pruebas / desarrollo
http://dpidesalud.minsa.gob.pe:18080/mcs-sihce-
hisminsa/integracion/v1.0/paquete/actualizar
Entorno de pruebas / calidad (de uso interno)
http://10.10.2.179:18080/mcs-sihce-hisminsa/integracion/v1.0/paquete/actualizar
Entorno de producción
http://pidesalud.minsa.gob.pe.gob.pe:18061/mcs-sihce-
hisminsa/integracion/v1.0/paquete/actualizar/
Página 4 de 14
1.4. Especificación de cada método del servicio

1.4.1. Método <Actualizar Paquete>
Nombre del método Actualizar Paquete

Descripción del Registra datos procedente de consulta externa, inmunizaciones, cred
método y otros.
Disponibilidad del
24 X 7
servicio
Ruta del método /paquete/actualizar
Método HTTP POST
Tipo de datos de
JSON (application/json)
entrada
Tipo de datos de
salida
1.4.1.1. Datos de entrada del método
Longi Es obli
Nombre Descripción Tipo tud gatorio? Valores
paciente:
idtipodoc Tipo de documento String SI

Número de
nrodocumento String SI
documento
apepaterno Apellido Paterno String SI
apematerno Apellido Materno String SI
nombres Nombres String SI

Fecha de
fechanacimiento String 8 SI AAAAMMDD
nacimiento.
Identificador de
idsexo String 1 SI M/F
sexo.
Identificador de
idpais String 3 P.E.: PER
país
Código único del
idestablecimiento String SI
establecimiento.
Identificador de
idetnia String SI
étnia
Número de historia
nrohistoriaclinica String SI
clínica.
Identificador de
idflag String SI
aplicativo.
personal_atiende:

Número de
documento
Página 5 de 14
apematerno Apellido Materno String

Fecha de
nacimiento.
Identificador de
sexo.
Identificador de
país
Código único del
establecimiento.
Identificador de
idcondicion String SI
condición
Identificador de
idprofesion String SI
profesión
personal_registra:

Número de
documento
apematerno Apellido Materno String

Fecha de
nacimiento.
Identificador de
sexo.
Identificador de
país
Código único del
establecimiento.
Identificador de
idcondicion String SI
condición
Identificador de
idprofesion String SI
profesión
cita
Edad en el
edadregistro momento del String
registro.
Financiador de la
idfinanciador String SI
atención.
Identificador del
idturno turno de la String SI
atención.
componente Componente. String
Código único del
establecimiento.
Numero de
numeroafiliacion String
afiliación.
Los años de edad
annioedad String SI
que tiene el
Página 6 de 14
paciente.
Los meses de edad

mesedad que tiene el String SI
paciente.
Los días de edadd
diaedad que tiene el String SI
paciente.
Tipo de edad al
idtipedadregistro momento del String SI A/M/D
registro.
Fecha de la
fechaatencion String 8 SI AAAAMMDD
atención
Identificador de
UPS. Cuando se
ingrese la el código
UPS 303101 de
idups nutrición, se puede String SI 303101
realizar el registro
sin pasar examen
físico.
estadoregistro Estado del registro. String SI
fgdiag Flag del sistema. String SI

Fecha de la última
fechaultimaregla regla. Formato String NO 20230117
YYYYMMDD
ID de la condición
de la gestante.
Intege
idcondiciongestante Valores: NO 1
r
1: Gestante
2: Puerpera
Condición del
paciente en el
establecimiento.
idtipcondestab valores: String 1 NO N
N: Nuevo
C: Continuador
R: Ringresante
Condición del
paciente en el
servicio.
idtipcondserv valores: String 1 NO N
N: Nuevo
C: Continuador
R: Ringresante
items String
Código del ítem
codigo String SI
según el tipo.
tipoitem Tipo de ítem. String SI CX, …
Tipo de
tipodiagnostico String SI
diagnóstico.
Código del lote de
codigolote String NO 202012348
la vacuna.
fechasolicitud Fecha de solicitud. String 8 AAAAMMDD
Página 7 de 14
Fecha del
fecharesultado String 8 AAAAMMDD
resultado.
labs String
codigo Código del lab. String SI
valor Valor del lab. String SI
examenfisico String
Peso al momento
peso String SI
del registro.
Talla al momento
talla String SI
del registro.
Hemoglobina al
hemoglobina momento del String SI
registro.
Perímetro
perimetrocefalico encefálico del String SI 30
paciente
Perímetro
perimetroabdomi
addominal del String SI 100
nal
paciente
Peso antes de la
pesopregestacion
gestación en String 20 NO 60.5
al
kilogramos.
Diagrama del objeto de entrada
{
"cita": {
"numeroafiliacion": "",
"fechaatencion": "20191011",
"estadoregistro": "A",
"items": [
{
"labs": [
{
"codigo": "",
"valor": "0"
}
],
"tipodiagnostico": "D",
"codigo": "M170",
“codigolote”:”202012348”,
"tipoitem": "CX"
},
{
"labs": [
{
"codigo": "",
"valor": "0"
}
],
"tipodiagnostico": "D",
“codigolote”:”202012348”,
"codigo": "M706",
"tipoitem": "CX"
Página 8 de 14
}
],
"idups": "322301",
"idestablecimiento": "5945",
"diaedad": "13",
"edadregistro": "60",
"idturno": "M",
"idtipedadregistro": "A",
"fgdiag": "11",
"mesedad": "10",
"componente": "",
"idfinanciador": "2",
"annioedad": "",
"fechaultimaregla":"20230117",
"idcondiciongestante":1,
"idtipcondestab":"N",
"idtipcondserv":"N",
"examenfisico": {
"peso": "0.00",
"talla": "0.00",
"hemoglobina": "0.00",
"perimetrocefalico":"30",
"perimetroabdominal":"100",
"pesopregestacional":"60.5"
}
},
"personal_registra": {
"nrodocumento": "10130417",
"apematerno": "ESTELA",
"idpais": "51",
"idprofesion": "29",
"fechanacimiento": "19750711",
"nombres": "ROBERTO ANGEL",
"idtipodoc": "1",
"apepaterno": "TELLO",
"idsexo": "M",
"idcondicion": "8"
},
"personal_atiende": {
"apematerno": "MADRID",
"idpais": "51",
"idprofesion": "29",
"nombres": "VICTOR HUGO",
"idtipodoc": "1",
"apepaterno": "CAMARGO",
"idsexo": "M",
"idcondicion": "7"
},
"paciente": {
"apematerno": "MACOTELA",
"idflag": "3",
"nombres": "JOSEFINA",
"nrohistoriaclinica": "0855762",
"idtipodoc": "1",
"apepaterno": "FERNANDEZ",
"idetnia": "80",
Página 9 de 14
"idestablecimiento": "5945",
"idpais": "51",
"idsexo": "F"
}
}
1.4.1.2. Datos de salida del método
Nombre Descripción Tipo Longitud Valores

Indica si el envió de Revisar los códigos
estado información se registró String de error/mensajes
correctamente. de respuesta.
Describe el
descripcion mensaje/error generado String
si es necesario.
Indica el nro de cita
idCita String
generada
Diagrama del objeto de salida
1.4.1.3. Códigos/Mensajes de respuesta del método
Código Descripción del mensaje

Información registrada correctamente. (Debe aparecer también id de la
OK
cita generada).
ERROR Si ha ocurrido un error en la trama.
Página 10 de 14
1.5. Especificación de cada método del servicio

1.5.1. Método <Consultar periodo de apertura>
Nombre del método Consulta periodo de apertura

Descripción del Permite consultar si el periodo de apertura de la cita a enviar se
método encuentra habilitado.
Disponibilidad del
24 X 7
servicio
Ruta del método /integracion/v1.0/consulta-periodo-apertura/
Método HTTP GET
Tipo de datos de
Path Variable
entrada
Página 11 de 14
Tipo de datos de
salida
Longi Es obli
Fecha a consultar.
fecha Formato: String 8 SI 20200101
YYYYMMDD
http://<<ip_servidor>>18080/mcs-sihce-hisminsa/integracion/v1.0/consulta-
periodo-apertura/20200101

Indica si el periodo se
encuentra habilitado.
mensaje String 1 1
1: SI
0: NO
{
"mensaje": "1"
}

ERROR Ha ocurrido un error al consultar la fecha.
Página 12 de 14
1.5.2. Método <Listar Periodos>
Nombre del método Listar periodos.

Descripción del Permite listar los meses del año que se encuentra habilitado para el
método envío de data al HISMINSA.
Disponibilidad del
24 X 7
servicio
Ruta del método /integracion/v1.0/listar-periodos
Método HTTP GET
Tipo de datos de
Path Variable
entrada
Tipo de datos de
salida
Página 13 de 14
Longi Es obli
NInguno
http://<<ip_servidor>>18080/mcs-sihce-hisminsa/integracion/v1.0/listar-
periodos

Indica si la consulta ha
codigo String 4 0000
sido satisfactoria
periodos Lista de periodos
anio Año String 4 2020
mes Mes String 2 4
{
"codigo": "0000",
"periodos": [
{
"anio": "2020",
"mes": "8"
}]}

0000 Consulta satisfactoria.
9000 Ha ocurrido un error al consultar la fecha.
Página 14 de 14

ETS IntegracionHisMinsa V1.0

Cargado por

Información del documento

Título original

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

ETS IntegracionHisMinsa V1.0

Cargado por

Copyright:

Formatos disponibles

Oficina de Innovación y Desarrollo Tecnológico del Ministerio de Salud

Especificaciones Técnicas de Servicios

Servicio Integración HISMINSA

Líderes de proyectos, arquitectos de software, analistas de sistemas que requieran diseñar

DIAGRAMA DEL SERVICIO

DESCRIPCIÓN DEL SERVICIO

Nombre del servicio Servicio de Integración con el HISMINSA

Este servicio permite realizar la actualización de información del

1.2. Mecanismos de seguridad

1.3. Ubicación del servicio

Entorno de pruebas / calidad (de uso interno)

1.4. Especificación de cada método del servicio

Nombre del método Actualizar Paquete

Ruta del método /paquete/actualizar

Método HTTP POST

1.4.1.1. Datos de entrada del método

idtipodoc Tipo de documento String SI

apematerno Apellido Materno String SI

nombres Nombres String SI

idtipodoc Tipo de documento String SI

apepaterno Apellido Paterno String SI

apematerno Apellido Materno String

nombres Nombres String SI

idtipodoc Tipo de documento String SI

apematerno Apellido Materno String

nombres Nombres String SI

Los meses de edad

estadoregistro Estado del registro. String SI

fgdiag Flag del sistema. String SI

codigo Código del lab. String SI

valor Valor del lab. String SI

Diagrama del objeto de entrada

1.4.1.2. Datos de salida del método

Nombre Descripción Tipo Longitud Valores

Diagrama del objeto de salida

1.4.1.3. Códigos/Mensajes de respuesta del método

Código Descripción del mensaje

1.5. Especificación de cada método del servicio

Nombre del método Consulta periodo de apertura

Ruta del método /integracion/v1.0/consulta-periodo-apertura/

Método HTTP GET

1.5.1.1. Datos de entrada del método

Diagrama del objeto de entrada

1.5.1.2. Datos de salida del método

Nombre Descripción Tipo Longitud Valores

Diagrama del objeto de salida

1.5.1.3. Códigos/Mensajes de respuesta del método

Código Descripción del mensaje

1.5.2. Método <Listar Periodos>

Nombre del método Listar periodos.

Ruta del método /integracion/v1.0/listar-periodos

Método HTTP GET

1.5.2.1. Datos de entrada del método

Diagrama del objeto de entrada

1.5.2.2. Datos de salida del método

Nombre Descripción Tipo Longitud Valores

Diagrama del objeto de salida

1.5.2.3. Códigos/Mensajes de respuesta del método

Código Descripción del mensaje

También podría gustarte