Академический Документы
Профессиональный Документы
Культура Документы
Propósito
El siguiente documento describe los aspectos técnicos del Servicio Web integrado del SITEDS
(WSSITEDS) perteneciente a la Superintendencia. Dicho servicio es necesario para que las
IPRESS accedan y consuman los Servicios Web de Negocios (WSN) del SITEDS Cliente
ofrecidos por la Superintendencia.
Al usar especificaciones y protocolos estándares (XML, WSDL, SOAP y MTOM) el cliente puede
estar desarrollado en cualquier lenguaje de programación.
Para que una IPRESS esté autorizada a usar un WSN de la Superintendencia, deberá
realizar su registro en la página de servicios de la Superintendencia
(http://www.susalud.gob.pe/servicios) solicitando el acceso al WSSITEDS. Una vez
finalizado exitosamente dicho trámite, la IPRESS quedará registrada en el servicio como Entidad
autorizada para usar el WSSITEDS.
Para que una IPRESS pueda consumir efectivamente un WSN de la Superintendencia, deberá
escoger el método Web que crea conveniente según la funcionalidad que desea obtener, pasarle
los parámetros correspondientes y si la llamada al método es correcta, éste devuelve una trama
de respuesta con la información solicitada. El detalle de este proceso se tratará más adelante.
En la actualidad, los Web Services de la Superintendencia, no están incluidos en un UDDI
(Universal Description Discovery Integration) de acceso externo, por lo tanto para acceder a los
servicios que ofrece la Superintendencia, es necesario utilizar WSDL (Web Services Definition
Language) según la URL definida por Superintendencia. A partir del WSDL la IPRESS puede
construir un Aplicativo Cliente, para poder consumir el WSN correspondiente.
Referencias
Para mejor entendimiento de la presente especificación, se recomienda estar familiarizado con
los siguientes estándares:
XML, http://www.w3.org/TR/xml/
SOAP, http://www.w3.org/TR/soap12-part1/
WSDL, http://www.w3.org/TR/wsdl20-primer/
MTOM, http://www.w3.org/TR/soap12-mtom/
1. LISTADO DE OPERACIONES DEL SERVICIOS WEB
El Servicio Web publicado basa su definición en 5 operaciones que responden a las
funcionalidades críticas de los componentes servidores del SITEDS para Rímac EPS, Pacífico
EPS, Mapfre EPS, PositivaSanitas EPS, Rímac Asistencia Médica, Pacífico Seguros y Mapfre
Seguros. A continuación se describe brevemente cada una de ellas:
Operación 1 GetConsultaxNombre
Descripción Entrega como información el listado de asegurados coincidentes con el criterio
de consulta solicitada. Por Ejemplo, al ser consultado pacientes por el apellido
paterno Polo este entrega como resultado todos los asegurados que coincidan
con el apellido paterno Polo.
Operación 2 GetConsultaxCodigo
Descripción Entrega como resultado los datos generales del asegurado, así como también
las coberturas, preexistencias, etc. del asegurado de acuerdo a su contrato de
plan de salud, en la Entidad Vinculada donde desea atenderse. Por ejemplo, el
asegurado Juan Pérez, código 01452896, de sexo masculino, de número de
documento de identidad 40178380, etc.
Operación 3 GetNumAutorizacion
Descripción Entrega como resultado un código único de autorización la atención del
asegurado para la cobertura seleccionada. Por Ejemplo, código 012546 para la
autorización de la atención del asegurado Juan Pérez se atiende por la cobertura
de Emergencia Medica de código 52.
Operación 4 GetOtrosDatos
Descripción Entrega como resultado los datos adicionales, exclusiones, etc. del asegurado
o las observaciones que existen sobre su atención.
Operación 5 GetFoto
Descripción Entrega como resultado la foto del asegurado solicitado en formato binario
estándar MTOM.
2. MENSAJES DE ENTRADA PARA LAS OPERACIONES DEL SERVICIO WEB
Los mensajes de entrada (parámetros de entrada) para las operaciones del Servicio
Web serán transmitidos a través de una estructura XML.
<nombre_operacion>
<Operacion_Parametro_1>XXXXXX</Operacion_Parametro_1>
<Operacion_Parametro_2>XXXXXX</Operacion_Parametro_2>
<Operacion_Parametro_3>XXXXXX</Operacion_Parametro_3>
.
.
.
<Operacion_Parametro_n>XXXXXX</Operacion_Parametro_n>
</nombre_operacion>
* R = Rímac, P = Pacífico, M = Mapfre, RAM = Rímac Asistencia Médica, PPS = Pacífico Seguros, MS = Mapfre Seguros, C = PositivaSanitas, LPS:
La Positiva Seguros
Tag XML root: GetConsultaxCodigo Aplica EPS? Aplica Seguros?
Nombre del tag XML Descripción Tipo Valores R*,RAM* P* M* C* PPS* MS* LPS*
Entidad_Codigo Código de String Código de Registro
Registro de la de la EPS
EPS a quien se proporcionada por
realiza la la SI SI SI SI SI SI SI
consulta. SUPERINTENDEN
Ejemplo: 060027A CIA. Ver Anexo A,
Tabla 16
EVinculada_Codigo Código de String Código de Registro
Registro SUPERINTENDEN
SUPERINTENDE CIA de la IPRESS.
NCIA de la Ver en SI SI SI SI SI SI SI
IPRESS www.susalud.gob.p
Ejemplo: e
980005C
EVinculada_Ruc RUC de la String RUC de la IPRESS
IPRESS.
SI SI SI SI SI SI SI
Ejemplo:
20100162742
Asegurado_Codigo Código de String Código del
asegurado que se asegurado
desea consultar. SI SI SI SI SI SI SI
Ejemplo:
06000201
Asegurado_Plan Código del Plan String Código del Plan de
Opcional
de Salud del Salud del
(puede ir
asegurado que se asegurado NO NO SI NO SI NO
en
desea consultar.
blanco)
Ejemplo: 16
Asegurado_Poliza Número de póliza String Número de póliza
del asegurado del asegurado
que se desea
NO NO NO NO SI NO SI
consultar.
Ejemplo:
DFA07899
Asegurado_Producto Código de String Código de Producto
Producto del del asegurado SI (sólo para
asegurado que se la versión 7.5
NO NO NO SI NO NO
desea consultar. como
Ejemplo: mínimo)
FULLSALUD
Asegurado_Identificador Número de String Número de
Identificador del Identificador del Opcional
asegurado que se asegurado (puede ir
NO NO NO NO NO NO
desea consultar. en
Ejemplo: blanco)
00000013184052
Asegurado_Certificado Número de String Número de
certificado del certificado del
asegurado que se asegurado. NO NO NO NO SI NO SI
desea consultar.
Ejemplo: 1
Asegurado_IdPoliza Identificador de String Identificador de
Opcional
póliza del póliza del
(puede ir
asegurado que se asegurado. NO NO NO NO NO NO
en
desea consultar.
blanco)
Ejemplo: 11
Asegurado_Parentesco Código de String Código de
SI (sólo para
parentesco del parentesco del
la versión 7.5
asegurado que se asegurado. Ver NO NO NO SI NO NO
como
desea consultar. Anexo A, Tabla 11
mínimo)
Ejemplo: 1
Asegurado_TAtencion Código de tipo de String Código de tipo de
atención del atención del
asegurado que se asegurado. Ver NO NO NO NO SI NO NO
desea consultar. Anexo A, Tabla 17
Ejemplo: 2
Asegurado_VersionPlan Código de la String Código de la Opcional
versión del Plan versión del Plan del (puede ir
NO NO NO NO NO NO
del asegurado asegurado. en
que se desea blanco)
consultar.
Ejemplo: 1
Asegurado_Ramo Código Ramo del String Código Ramo del Opcional
asegurado que se asegurado. (puede ir
NO NO NO NO NO NO
desea consultar. en
Ejemplo: 1 blanco)
Asegurado_CodCliente Código interno del String Código interno del SI (sólo para
Cliente Cliente la versión 7.5
NO NO NO NO NO NO
(Empleadora del (Empleadora del como
Asegurado). Asegurado). mínimo)
WSSiteds_Version Versión de la String Versión de la Trama
Trama SITEDS SITEDS para
para Rímac. Rímac. Ver Anexo Opcional (puede ir en blanco)
Ejemplo: “75”, A, Tabla 20.
“76”,”81” ,”91”
Tabla 2.2: Estructura XML de los mensajes de entrada para la operación 2
* R = Rímac, P = Pacífico, M = Mapfre, RAM = Rímac Asistencia Médica, PPS = Pacífico Seguros, MS = Mapfre Seguros, C = PositivaSanitas, LPS:
La Positiva Seguros
Tag XML root: GetNumAutorizacion Aplica EPS? Aplica Seguros?
Nombre del tag
Descripción Tipo Valores R*, RAM* P* M* C* PPS* MS* LPS*
XML
Entidad_Codigo Código de Registro de la String Código de Registro de
EPS a quien se realiza la la EPS proporcionada
consulta. por la
SI SI SI SI SI SI SI
Ejemplo: 060027A SUPERINTENDENCIA
. Ver Anexo A, Tabla
16
EVinculada_Codigo Código de Registro String Código de Registro
SUPERINTENDENCIA de SUPERINTENDENCIA
la Entidad Vinculada. de la Entidad SI SI SI SI SI SI SI
Ejemplo: 980005C Vinculada. Ver en
www.susalud.gob.pe
EVinculada_Ruc RUC de la Entidad String RUC de la Entidad
Vinculada. Vinculada SI SI SI SI SI SI SI
Ejemplo: 20100162742
Asegurado_Codigo Código de asegurado que String Código del asegurado
se desea consultar. SI SI SI SI SI SI SI
Ejemplo: 06000201
Asegurado_Plan Código del Plan del String Código del Plan de
Asegurado que se desea Salud del asegurado.
SI SI SI SI NO SI NO
consultar.
Ejemplo: 16
Asegurado_Cobertur Código de la Cobertura. String Código de la
a Ejemplo: 47 Cobertura. Ver Anexo SI SI SI SI SI SI NO
A, Tabla 1
Asegurado_Solicitud Solicitud de beneficios del String Solicitud de beneficios Opcion
NO NO NO NO NO NO
Asegurado. del asegurado. al
(puede
ir en
blanco
)
Asegurado_Estado Estado del Asegurado String Estado del Asegurado
NO NO SI NO NO SI NO
Ejemplo: 1 Ver Anexo A, Tabla 6
Asegurado_Moneda Moneda. String Moneda
NO NO SI NO NO SI NO
Ejemplo: PEN Ver Anexo A, Tabla 10
Servicio_Calif Servicio brindado en la String Ver Anexo A, Tabla 2
Cobertura. NO NO SI NO NO SI NO
Ejemplo: ZU
Asegurado_Benefici Código de beneficio del String Código de beneficio
NO NO NO NO SI NO NO
o asegurado. del asegurado.
Asegurado_Poliza Código de Póliza del String Código de Póliza del
asegurado que se desea asegurado.
NO NO NO NO SI NO SI
consultar. Ejemplo:
3192985
Asegurado_Produc Código de Producto del String Código de Producto SI (sólo para
to asegurado que se desea del asegurado. la versión 7.5
NO NO NO SI NO NO
consultar. Ejemplo: como
FULLSALUD mínimo)
Asegurado_IdPlan Identificador de Plan. Identificador de Plan.
Ejemplo: 13801 Viene en la operación
NO NO NO NO NO NO NO
2:
GetConsultaxCodigo
Asegurado_DetPlan Número de Detalle de Plan. Número de Detalle de
Ejemplo: 165 Plan. Viene en la
NO NO NO NO NO NO NO
operación 2:
GetConsultaxCodigo
Asegurado_Certifica Número de certificado del String Número de certificado
do asegurado que se desea del asegurado. NO NO NO NO SI NO SI
consultar. Ejemplo: 1
Asegurado_Parent Código de parentesco del String Código de parentesco SI (sólo para
esco asegurado que se desea del asegurado. Ver la versión 7.5
NO NO NO SI NO NO
consultar. Ejemplo: 1 Anexo A, Tabla 11 como
mínimo)
Asegurado_TAtencio Código de tipo de atención String Código de tipo de
n del asegurado que se atención del
NO NO NO NO SI NO NO
desea consultar. Ejemplo: 2 asegurado. Ver Anexo
A, Tabla 17
Asegurado_CodCli Código interno del Cliente String Código interno del SI (sólo para
ente (Empleadora del Cliente (Empleadora la versión 7.5
NO NO NO NO NO NO
Asegurado). del Asegurado). como
mínimo)
WSSiteds_Version Versión de la Trama String Versión de la Trama
SITEDS para Rímac. SITEDS para Rímac.
Opcional (puede ir en blanco)
Ejemplo: “731”, “75”, Ver Anexo A, Tabla 20.
“76”,”81” ,”91”
Tabla 2.3: Estructura XML de los mensajes de entrada para la operación 3
* R = Rímac, P = Pacífico, M = Mapfre, RAM = Rímac Asistencia Médica, PPS = Pacífico Seguros, MS = Mapfre Seguros, C = PositivaSanitas, LPS:
La Positiva Seguros
* R = Rímac, P = Pacífico, M = Mapfre, RAM = Rímac Asistencia Médica, PPS = Pacífico Seguros, MS = Mapfre Seguros, LPS: La Positiva Seguros
* R = Rímac, P = Pacífico, M = Mapfre, RAM = Rímac Asistencia Médica, PPS = Pacífico Seguros, MS = Mapfre Seguros
2.1. AUTENTICACION DE USUARIOS
Para poder consumir cada Operación del WSSITEDS, además de los parámetros de
entrada mencionados en el punto 2, se debe pasar por una autenticación por cabecera SOAP,
para la cual se debe enviar un usuario y una contraseña (registrados en la Web de Servicios
de la SUPERINTENDENCIA), a la cabecera SOAP de la solicitud del Servicio Web.
Cada campo de la trama será limitado por un asterisco ‘*’ y cada fila del listado de
coberturas y preexistencias será limitado por un ‘~’.
Nota: Para las cabeceras de cada tabla se representa a Rímac EPS con R, Pacífico EPS
con P, Mapfre EPS con M, Rímac Asistencia Médica con RAM, Pacífico Seguros con PPS
, Mapfre Seguros con MS, PositivaSanitas con C y Positiva Seguros LPS
3.1. Trama de respuesta para la Operación 1: GetConsultaxNombre
Las siguientes tablas contienen los valores necesarios para generar la trama de
consulta/respuesta de los Servicios Web. La última versión de estas tablas pueden
encontrarse en el archivo sitedscliente.mdb que viene con el instalador del SITEDS en la
página http://www.susalud.gob.pe/servicios. Se indicarán los nombres de las tablas del
sitedscliente.mdb entre paréntesis.
C1 AUDIFONOS
XD AVION INTERNACIONAL
57 AVION NACIONAL
F1 CAPITACION
D5 CENTRO SALUD
DA CENTRO SALUD EN OFICINA
FN CENTRO SALUD EN OFICINA DESCENTRALIZADO
W6 CESAREA
WA CESAREA/PARTO MULTIPLE/COMPLICACIONES
DM CHEQUEO GENERAL
ZW CHEQUEO GINECOLOGICO
8 CIRUGIA AMBULATORIA
ZB CIRUGIA CATASTROFICA PRIMER TOPE
ZC CIRUGIA CATASTROFICA SEGUNDO TOPE
DK COB. ALTO RIESG-BENEF.VITAL.ONCOL,CARDIOL
30 COBERTURA GENERAL DEL PLAN DE SALUD
D2 COMPLICACIONES EMBARAZO AMBULATORIO
D3 COMPLICACIONES EMBARAZO HOSPITALARIO
W8 COMPLICACIONES EN EMBARAZO Y PUERPERIO
W9 COMPLICACIONES ORGANICAS EMBARAZO
CU CONDICIONES ESPECIALES
CONSULTA (AMBULATORIO 1 -
XW M.INT/PEDIATR./GINECOLG.)
CONSULTA (AMBULATORIO 2 - OTRAS
XX ESPECIALIDADES)
3 CONSULTA AMBULATORIA
YL CONSULTA DE REEVALUACION QUIROPRACTICO
ZT CONSULTA GERIATRICA
C4 CONSULTA MAD ESPECIALISTA
XQ CONSULTA PSICOLOGICA
DJ CONSULTA VARIAS
YU CONSULTAS A DOMICILIO
WD CONSULTAS PRE/POST NATALES
A4 CONSULTAS PSIQUIATRICAS
C6 CONTINUACION DE EMERGENCIA ACCIDENTAL
DX CONTINUIDAD DE COBERTURA
WG CONTROL DE SALUD
68 CONTROL DEL NIÑO SANO - 1 AÑO
65 CONTROL DEL NIÑO SANO
WC CONTROL POST - NATAL
EA CONTROL POST HOSPITALARIO
WB CONTROL PRE - NATAL
XK COSTO FIJO/TOPICOS
AO CRISTALES
CT DELIVERY DE MEDICINAS
WP DENTAL - NIVEL 1
WQ DENTAL - NIVEL 2
WR DENTAL - NIVEL 3
WS DENTAL - NIVEL 4
WT DENTAL - NIVEL 5
CC DEPORTES NO PROFESIONALES
CW DESAMPARO FAMILIAR - SEGUROS
YV DESAMPARO SUBITO FAMILIAR
DESGRAVAMEN DE PENSIONES PENDIENTES DE
CJ P
WM DESPISTAJES (VARIOS)
WL DESPISTAJES DE CANCER
XG DIABETES MELLITUS
FS Diabetes SP (Sin Protocolo Estándar)
FT Dislipidemia SP (Sin Protocolo Estándar)
FD EDUCACION PARA LA SALUD
86 EMERGENCIA
E1 EMERGENCIA A DOMICILIO
51 EMERGENCIA ACCIDENTAL
FB EMERGENCIA ALO RIMAC
52 EMERGENCIA MEDICA
EE EMERGENCIA OBSTETRICA
EB EMERGENCIA OBSTÉTRICA AMBULATORIA
Y3 ENCORE ASMA A DOMICILIO
Y2 ENCORE ASMA EN CLINICA
YF ENCORE DIABETES A DOMICILIO
YE ENCORE DIABETES EN CLINICA
Y1 ENCORE HTA A DOMICILIO
Y0 ENCORE HTA EN CLINICA
Y5 ENCORE RINITIS A DOMICILIO
Y4 ENCORE RINITIS EN CLINICA
ZP ENDODONCIA
DI ENFERMEDADES CONG. DEL RECIEN NACIDO
X4 ENFERMEDADES CONGENITAS
Z4 ENFERMEDADES CONGENITAS AMBULATORIO
Z6 ENFERMEDADES CONGENITAS EMERGENCIA
Código Descripción
EM CORREO ELECTRONICO
EX ANEXO TELEFONICO
FX FAX
HP TELEFONO DEL HOGAR
TE TELEFONO
WP TELEFONO DE TRABAJO
Código Descripción
1 AUTORIZACIÓN DE CONSULTA DE ELEGIBILIDAD
2 AUTORIZACIÓN DE CARTAS DE GARANTÍA
Código Descripción
1 SIN PROCEDIMIENTOS
2 TIENE PROCEDIMIENTOS
10. Tabla de Moneda (Moneda)
Código Descripción
0 NINGUNO
PEN SOLES
USD DOLARES
Código Descripción
0000 TODOS
0001 TITULAR MASCULINO
0002 TITULAR FEMENINO
0003 ESPOSO
0004 ESPOSA
0005 HIJO
0006 HIJA
0007 ABUELO
0008 ABUELA
0009 TIO
0010 TIA
0011 HERMANA
0012 HERMANO
0013 PADRE
0014 MADRE
0015 HEREDEROS LEGALES
0016 SOBRINO
0017 SOBRINA
0018 NIETO
0019 NIETA
0020 ACREEDOR
0021 SUEGRA
0022 SUEGRO
0023 HIJASTRA
0024 HIJASTRO
0025 CONVIVIENTE MASCULINO
0026 CONVIVIENTE FEMININO
0027 SIN DECLARAR
Código Descripción
4001 ASISTENCIA MEDICA COLECTIVAS
4002 FORMACION LABORAL
4003 INTERSALUD
4004 RED SALUD
4005 PREFERENCIAL
4006 TOTAL SALUD
4007 SALUD DE ORO
4008 SUPRA
4009 SEGURIVIAJE
4010 ASISTENCIA MEDICA MONT
4011 FULLSALUD
4012 PREFERENCIAL INTERNACIONAL
4013 INTERSALUD PLUS
4014 ASISTENCIA MEDICA INDIVIDUAL
4015 CONTINENTAL ONCOLOGICO
4016 RED SALUD HOSPITALARIO
4017 ONCOLOGICO WIESE
4018 ONCOLÓGICO RIMAC
4019 SEGUROS FALABELLA SALUD
4020 REHDER CORPORATIVO
4021 ASISTENCIA MEDICA CORPORATIVO
TRADICIONAL
4022 ASISTENCIA MEDICA CORPORATIVO NO
TRADICIONAL
4023 CAFAE ONCOLOGICO
4024 ONCOLOGICO COLECTIVO
4025 ONCOLOGICO PF
4026 CONTINENTAL VIAJES
4027 ONCOLOGICO UNIPLAN
4028 CORPORATIVAS
4029 ONCOLOGICO FV.
4030 FALABELLA SALUD TOTAL
4031 PRODUCTO EX ROYAL
4032 RENTA HOSPITALARIA - INTERBANK
4033 ENFERMEDADES Y ACCIDENTES DE ALTO
COSTO
4034 ONCOLOGICO PF
4035 RENTA HOSPITALARIA - CITIBANK
4036 SALUD PLAN CONTINUIDAD EMPRESAS
4037 RENTA HOSPITALARIA BBVA
4038 SALUD RED PREFERENTE
4039 INDEMNIZATORIO ENF GRAVES BBVA
4040 INDEMNIZATORIO ENF GRAVES FALABELLA
4041 SALUD CONTINUIDAD INDIVIDUAL
6201 CONTINENTAL SALUD
9001 ACCIDENTES PERSONALES - NOMINATIVO
9002 ACCIDENTES PERSONALES INDIVIDUALES
9003 ACCIDENTES SEGURO VIDA B
9004 SEGURO ACCIDENTES BBVA
9005 FALABELLA SOAT PLUS
9006 ACCIDENTES PERSONALES
9007 SEPELIO
9008 FALABELLA ACCIDENTES BASICO
9009 SEPELIO GRUPAL - PARQUE DEL RECUERDO
9010 SEPELIO GRUPAL - SCOTIABANK
9011 SEPELIO INDIV. TELEMARKETING
RENTHABILIDAD
9012 SEPELIO INDIV. TELEMARKETING BBVA
9101 ACCIDENTES DE ESTUDIANTES
9201 ACCIDENTES DE PASAJEROS DE VEHICULOS
PUBLICOS
9251 ACCIDENTES DE PASAJEROS DE VEHICULOS
PARTICULARES
9301 ACCIDENTES PERSONALES - PLANILLAS
9401 ACCIDENTES POR VIAJE
9501 GARANTIA ADUANERA
Código Descripción
01 RUC
02 LE/DNI
03 NIT
04 CE
05 CI
06 PASAPORTE
07 LM
08 DPI
Código Descripción
980002A Rímac EPS
980004A Pacífico EPS
060027A Mapfre Peru EPS
000005G Rimac Asistencia Médica
000003G Pacífico Seguros
000006G Mapfre Seguros
980006A Rímac EPS Contingencia
990005A Pacífico EPS Contingencia
090032A PositivaSanitas EPS
Código Descripción
A Ambulatoria
H Hospitalaria
M Todos
Código Descripción
1 Datos adicionales
2 Observaciones/Condiciones
3 Exclusiones
4 Procedimientos especiales
6 PreExistencias
7 Otras restricciones
8 Observaciones de cobertura
Código Descripción
EXISTEN COPAGOS DIFERENCIADOS PARA
2 ESTOS PROCEDIMIENTOS
LA COBERTURA SOLO CUBRE ESTOS
3 PROCEDIMIENTOS
LA COBERTURA EXCLUYE ESTOS
4 PROCEDIMIENTOS
Código Descripción
731 Versión 7.3.1 de la Trama SITEDS para Rímac
75 Versión 7.5 de la Trama SITEDS para Rímac
76 Versión 7.6 de la Trama SITEDS para Rímac
81 Versión 8.0 de la Trama SITEDS
91 Versión 9.1 de la Trama SITEDS