Integracion Con Central Telefónica

Integración con Central
Telefónica AVAYA
Documentación Técnica de Integración
Historial de revisiones
Fecha Versión Autor Descripción
21/03/17 1.0 Aluisio Comiran Creación del documento.
MV Integración con Central Telefónica 2

1 Resumen
1 Introducción....................................................................................................................................4
2 Integración......................................................................................................................................5
2.1 Higienización de Camas............................................................................................................5
2.2 Cobro de Llamadas Telefónicas................................................................................................6
2.3 Higienización de Camas - Registro de Atención........................................................................6
2.3.1 Mensaje.............................................................................................................................6
2.4 Higienización de Camas –Situación de la Cama........................................................................8
2.4.1 Mensaje.............................................................................................................................8
2.5 Llamadas Telefónicas - PIN.......................................................................................................9
2.5.1 Mensaje.............................................................................................................................9
2.6 Llamadas Telefónicas – Cobro de la Llamada.........................................................................10
2.6.1 Mensaje...........................................................................................................................10
3 Anexos...........................................................................................................................................11
3.1 Premisas y limitaciones..........................................................................................................11
3.2 Integración a través de Web Service......................................................................................11

1 Introducción
Este documento tene como objetvo especifcar el funcionamiento técnico de la solución de
integración entre el sistema de gestón hospitalaria SOULMV, de MV, y el sistema de gestón de
central telefónica AVAYA (equipo IP Ofce Server Editon R9.1) de la empresa NETCOM.
La necesidad del cliente es que el personal de enfermería y de apoyo (Higienización,

Mantenimiento, etc.) pueden bloquear una habitación que está en proceso de limpieza o
mantenimiento mediante la marcación de un código en el teléfono de dicha habitación a fn de
que la misma no pueda ser asignada a un nuevo paciente. Al fnalizar el trabajo el personal puede
desbloquear la habitación para que pueda ser asignada a un nuevo paciente. Además, también
existe la necesidad de manejar indicadores de disponibilidad y tempo de limpieza.
Otra funcionalidad que se debe realizar la integración de las llamadas hechas por los
pacientes, donde el cobro debe ser hecho directamente en la cuenta del paciente.
Abajo las responsabilidades de cada sistema:
SOULMV
 Registrar los datos maestros.

 Registrar el paciente.
 Registrar la atención.
 Hacer le cobro de las llamadas en la cuenta del paciente.
 Gestonar la higienización de las camas de acuerdo con las situaciones recibidas de
la central telefónica.
AVAYA
 Gestonar las llamadas del paciente.

 Gestonar los cambios de situaciones de las camas a través de la central telefónica.
 Enviar la actualización de las situaciones de las camas para MV.
 Enviar los datos de las llamadas hechas por los pacientes.

2 Integración
La integración se verifcará como bidireccional, a través de mensajes vía protocolo SOAP Web
Service. La integración es dividida en dos procesos distntos:
2.1 Higienización de Camas

El objetvo es el control de higienización de las camas.
Los procesos abajo van disparar la integración a cada cambio:
Cambios en la atención (MV  AVAYA)
 Creación de Hospitalización
 Cambio de Cama
 Alta Médica
 Alta Administratva
 Cancelación de Alta Médica
 Cancelación de Alta Administratva
Cambios en la situación de inicio y fn (AVAYA  MV)
 Aguardando Higienización
 Ropería
 Limpieza
 Post-Limpieza
 Mantenimiento

2.2 Cobro de Llamadas Telefónicas

El objetvo es hacer el cobro de las llamadas realizadas por el paciente.
El paciente va recibir un PIN que debe ser utlizado para hacer la liberación de las llamadas y
lo mismo es vinculado a su atención. Cuando una llamada es cerrada, el sistema de la central
telefónica envía para MV los datos de la llamada para hacer el cobro en la cuenta del paciente.
2.3 Higienización de Camas - Registro de Atención

2.3.1 Mensaje
TAG XML DESCRIPCIÓN FORMATO VALORES VÁLIDOS OBL.
Atendimento Nodo con los datos de atención. *** *** ***
operacao Informa la operación que está siendo VARCHAR2(1) I – Inclusión (nuevo) SÍ
realizada con el registro. A – Alteración
(modifcación)
situacao Situación del registro de atención. VARCHAR2(2) NA - Creación de la SÍ
Atención
CC- Cambio de Cama
AM - Alta Médica
AA - Alta Administratva
CA - Cancelación de Alta
Médica
CD - Cancelación de Alta
Administratva
codigoAtendimento Código de atención. NUMBER(10) SÍ
dataAtendimento Fecha y hora de Atención. DATE YYYY-MM-DD HH:MM:SS SÍ
codigoSetor Código del sector. NUMBER(4) SÍ
descricaoSetor Descripción del sector. VARCHAR2(50) NO
codigoLeito Código de la cama. NUMBER(4) SÍ
descricaoLeito Descripción de la cama. VARCHAR2(30) NO
descricaoResumidaLeito Descripción corta de la cama. VARCHAR2(8) NO
codigoLeitoAnterior Código de la cama anterior. NUMBER(4) Es obligatorio cuando es NO
un cambio de cama.

Alta Nodo con los datos de alta. *** *** ***

dataAlta Data y hora de alta médica. DATE YYYY-MM-DD HH:MM:SS NO
cancelamentoAlta Cancelación de alta médica. VARCHAR2(1) S – SÍ NO
N – NO
codigoMotivoAlta Código del motvo de alta médica. NUMBER(2) NO
descricaoMotivoAlta Descripción del motvo. VARCHAR2(60) NO
dataAltaAdministrativa Fecha y hora de alta administratva. DATE YYYY-MM-DD HH:MM:SS NO
cancelamentoAltaAdministrativa Cancelación de alta administratva. VARCHAR2(1) S – SÍ NO
N – NO
dataAltaObito Fecha y hora de alta por óbito. DATE YYYY-MM-DD HH:MM:SS NO
Paciente Nodo con los datos del paciente. *** *** ***
codigoPaciente Código del paciente en MV. NUMBER(10) SÍ
primeiroNome Primero nombre. VARCHAR2(40) SÍ
primeroSobrenome Primero apellido. VARCHAR2(40) SÍ
segundoSobrenome Segundo apellido. VARCHAR2(40) SÍ
numeroDocumento Número del documento de NUMBER(11) SÍ
identfcación.
Acompanhante ¿Tiene acompañante? VARCHAR2(1) S – SÍ SÍ
N – NO
2.3.1.1 Ejemplo
<?xml version="1.0" encoding="ISO-8859-1"?>
<Mensagem>
<Cabecalho>
<mensagemID>1</mensagemID>
<versaoXML>1</versaoXML>
<identificacaoCliente>CMP</identificacaoCliente>
<servico>MOVIMENTO_ATENDIMENTO</servico>
<dataHora>2017-03-21 11:00:05</dataHora>
<empresaOrigem>1</empresaOrigem>
<sistemaOrigem>SOULMV</sistemaOrigem>
<empresaDestino>1</empresaDestino>
<sistemaDestino>AVAYA</sistemaDestino>
<usuario/>
<senha/>
</Cabecalho>
<Atendimento>
<operacao>I</operacao>
<situacao>NA</situacao>
<codigoAtendimento>20</codigoAtendimento>
<dataAtendimento>2017-03-21 11:00:03</dataAtendimento>
<codigoSetor>35</codigoSetor>
<descricaoSetor>NOMBRE DEL SECTOR</descricaoSetor>
<codigoLeito>145</codigoLeito>
<descricaoLeito>DESCRIPCIÓN DE LA CAMA</descricaoLeito>
<descricaoResumidaLeito>DESCRIPCIÓN CURTA DE LA
CAMA</descricaoResumidaLeito>
<codigoLeitoAnterior/>
<Alta>
<dataAlta/>
<cancelamentoAlta>N</cancelamentoAlta>
<codigoMotivoAlta/>
<descricaoMotivoAlta/>
<dataAltaAdministrativa/>
<cancelamentoAltaAdministrativa>N</cancelamentoAltaAdministrativa>
<dataAltaObito/>
</Alta>
<Paciente>
<codigoPaciente>2005</codigoPaciente>
<primeiroNome>NOMBRE DEL PACIENTE</primeiroNome>
<primeroSobrenome>PRIMERO APELLIDO</primeroSobrenome>
<segundoSobrenome>SEGUNDO APELLIDO</segundoSobrenome>
<numeroDocumento>1234567890</numeroDocumento>
<Acompanhante>N</Acompanhante>
</Paciente>
</Atendimento>
</Mensagem>

2.3.1.2 Traducciones da datos

Información Responsable por el Descripción
mapeo
Sectores AVAYA Código de los sectores.
Camas AVAYA Código de las camas.
Motivo de Alta AVAYA Código de los motvos de alta.
2.3.1.3 Web Service

Información Descripción
Web Service: Defnido por AVAYA
Método: Defnido por AVAYA
Servicio: Defnido por AVAYA
Dirección: MV  AVAYA
Observación: -
2.3.1.4 Disparo de la integración

 Al crear una atención del tpo Hospitalización”.
 Al cambiar la situación de la atención.
2.4 Higienización de Camas –Situación de la Cama

2.4.1 Mensaje
Atendimento Nodo con los datos de *** *** ***
atención.
operacao Informa la operación que está VARCHAR2(1) A – Alteración (modifcación) SÍ
siendo realizada con el
registro.
situacaoLeito Situación de la cama. VARCHAR2(1) A – Acompañante SÍ
O – Ocupación por un paciente
V – Disponible
L – En limpieza
PL – Post-Limpieza
EH – En Higienización
RO – Ropería
PH – Para Higienización
I – Ocupación por infección
R – Ocupación por reserva
M – En Mantenimiento, Reforma o Intermitdo
ramal Número del ramal de la cama. VARCHAR2(8) SÍ
2.4.1.1 Ejemplo
<Mensagem>
<Cabecalho>
<servico>ATUALIZA_STATUS_LEITO</servico>
<sistemaOrigem>AVAYA</sistemaOrigem>
<sistemaDestino>SOULMV</sistemaDestino>
<usuario></usuario>
<senha></senha>
</Cabecalho>
<Leito>
<operacao>A</operacao>

<situacaoLeito>M</situacaoLeito>
<ramal>7164</ramal>
</Leito>
</Mensagem>

mapeo
Situación AVAYA Situación de la cama.
Ramal MV Número del ramal.
2.4.1.3 Web Service

Web Service: http://<ip>:<puerta>/jintegra_core/services/WebservicePadrao?wsdl
Método: processar(String)
Servicio: ATUALIZA_STATUS_LEITO
Dirección: AVAYA  MV
Observación: -

 Al cambiar la situación de la cama.
2.5 Llamadas Telefónicas - PIN

2.5.1 Mensaje
PIN Nodo con los datos del PIN. *** *** ***
situacao Informa la situación del PIN. VARCHAR2(1) A – Actvado SÍ
D – Inactvado
codigoPIN Número del PIN. NUMBER(15) SÍ
codigoAtendimento Código de atención. NUMBER(10) SÍ
2.5.1.1 Ejemplo
<Mensagem>
<Cabecalho>
<servico>MANUTENCAO_PIN</servico>
<sistemaDestino>AVAYA</sistemaDestino>
<usuario></usuario>
<senha></senha>
</Cabecalho>
<PIN>
<situacao>A</situacao>
<codigoPIN>12345</codigoPIN>
<codigoAtendimento>272922</codigoAtendimento>
</PIN>
</Mensagem>

mapeo
PIN AVAYA Número de los PIN.
Situación AVAYA Situación del PIN en la atención.

2.5.1.3 Web Service

Web Service: Defnido por AVAYA.
Método: Defnido por AVAYA.
Servicio: Defnido por AVAYA.
Dirección: MV  AVAYA
Observación: -

 Al registrar una atención.
 Al realizar un alta administratva.
2.6 Llamadas Telefónicas – Cobro de la Llamada

2.6.1 Mensaje
TarifadorEletronico Nodo con los datos del cobro. *** *** ***
ramal Código del ramal. VARCHAR2(8) SÍ
tipoLigacao NUMBER(4) Código del tpo de llamada. SÍ
pin Número del PIN. NUMBER(15) SÍ
chamada Nodo do los datos de la llamada. *** *** ***
dataRealizacao Fecha y hora de la llamada. DATE YYYY-MM-DD HH:MM:SS SÍ
ddd Código de la ciudad. VARCHAR2(5) NO
ddi Código del país. VARCHAR2(5) NO
numero Número del teléfono. VARCHAR2(50) SÍ
valorLigacao Valor de la llamada. NUMBER(20,2) SÍ
duracao Nodo con la duración de la llamada. *** *** ***
minuto Minutos. NUMBER(12,0) SÍ
segundo Segundos. NUMBER(12,0) SÍ
2.6.1.1 Ejemplo
<Mensagem>
<Cabecalho>
<servico>TARIFADOR</servico>
<sistemaOrigem>AVAYA</sistemaOrigem>
<sistemaDestino>SOULMV</sistemaDestino>
<usuario/>
<senha/>
</Cabecalho>
<TarifadorEletronico>
<ramal>7159</ramal>
<tipoLigacao>1</tipoLigacao>
<pin>12345</pin>
<chamada>
<dataRealizacao>2017-03-21 10:06:15</dataRealizacao>
<duracao>
<minuto>2</minuto>
<segundo>35</segundo>
</duracao>
<ddd>2</ddd>
<ddi>507</ddi>
<numero>66190499</numero>
<valorLigacao>2,16</valorLigacao>

</chamada>
</TarifadorEletronico>
</Mensagem>

mapeo
PIN AVAYA Número de los PIN.
Ramal MV Código del ramal.
Tipo de llamada AVAYA Código de los tpos de llamada.
2.6.1.3 Web Service

Web Service: http://<ip>:<puerta>/jintegra_core/services/WebservicePadrao?wsdl
Método: processar(String)
Servicio: TARIFADOR
Dirección: AVAYA  MV
Observación: -

 Al cerrar una llamada.
3 Anexos
3.1 Premisas y limitaciones
 Ambiente de prueba: Es necesario un ambiente de prueba para los testeos de envió e
recibimiento de mensajes.
 Tomcat: El servidor de aplicación Tomcat debe estar en la versión 6.x o superior.
 Documentos terceros: Para el desarrollo de MV, es necesaria la documentación de AVAYA.
 Comunicación entre los servidores: El cliente debe proporcionar el acceso para la
comunicación entre los servicios.
 Traducción de datos: Una planilla en adjunto con los datos de traducción entre los
sistemas debe ser hecha, donde debe existr una versión para la base de simulación y otra
para producción.
3.2 Integración a través de Web Service

El sistema AVAYA deberá presentar un Web Service, el cual será consumido, y recibirá los
mensajes, usando los formatos XML's establecidos por MV. Estos mensajes se remitrán pela
camada de integración de la MV para que las integraciones de datos puedan ser realizadas. El Web
Service que esté disponible debe poseer un único método que recibirá un string y responderá un
string. Este string de entrada y salida será correspondiente al mensaje XML que será procesado.
MV dejará disponible un Web Service, el cual deberá ser consumido por la capa de
integración de AVAYA y los mensajes, a través del XML establecidos por MV, esté será enviado
para el Web Service de la MV. El Web Service disponible tendrá un método único que recibirá un
string y responderá un string. Esa string será correspondiente el mensaje XML que será procesada.
Después de implantado el proceso de integración, el WSDL de MV estará disponible en la URL:
http://<ip>:<puerta>/jintegra_core/services/WebservicePadrao?wsdl

donde:
<ip> → corresponde al IP donde se encuentra instalado el servidor de aplicación TOMCAT

en cliente.
<puerta> → corresponde a la puerta donde fue confgurado y instalado el servidor de

aplicación TOMCAT en cliente.
La estructura de los archivos XML utlizados en las comunicaciones tene un conjunto de

elementos chamados de informaciones administratvas, que se utlizadas para proveer una
correcta gestón y procesamiento de los datos.
Eses campos que hacen parte de un agrupamiento superior chamado cabecalho

(encabezado). Abajo tenes una lista de informaciones que se compone este encabezado:
TAG DESCRICIÓN
<mensagemID> Identfcador del mensaje. Será enviado un número secuencial generado por la capa de integración.
<versaoXML> Utlizado para informar la versión de la estructura del XML. Esta información es muy importante, porque
versiones diferentes pueden generar elementos diferentes.
<identificacaoCliente> Identfcación de la empresa responsable en generar el XML. Ej.: RUT.
<servico> Identfca el servicio del Web Service que será utlizado. Ej.: PEDIDO_EXAME.
<dataHora> Fecha y hora que el mensaje fue generado. Ejemplo: 2014-05-28 14:06:22
<empresaOrigem> Identfca cual empresa fue responsable en generar el archivo XML. Este campo será precargado con el
código de la empresa (unidad de negocio) del SOULMV.
<sistemaOrigem> Identfca el sistema/módulo que está enviando las informaciones.
<empresaDestino> Identfca el código de la empresa que recibe el mensaje. Caso no exista este controle el valor por
defecto es 1.
<sistemaDestino> Identfca el sistema que recebará el mensaje que está siendo procesada.
<usuario> Identfcación del usuario de servicio. No utlizada. Valor por defecto: USER.
<senha> Contraseña del usuario de servicio. No utlizada. Valor por defecto: PASS.
Ejemplo del encabezado para una integración de registro de una solicitud:
<Cabecalho>
<identificacaoCliente>89987812</identificacaoCliente>
<servico>SOLICITACAO</servico>
<sistemaDestino>OMNICELL</sistemaDestino>
<usuario>USER</usuario>
<senha>PASS</senha>
</Cabecalho>

Integracion Con Central Telefónica

Încărcat de

Informații document

Drepturi de autor

Formate disponibile

Partajați acest document

Partajați sau inserați document

Opțiuni de partajare

Vi se pare util acest document?

Este necorespunzător acest conținut?

Drepturi de autor:

Formate disponibile

Integracion Con Central Telefónica

Încărcat de

Drepturi de autor:

Formate disponibile

Integración con Central

MV Integración con Central Telefónica 2

MV Integración con Central Telefónica 3

La necesidad del cliente es que el personal de enfermería y de apoyo (Higienización,

Abajo las responsabilidades de cada sistema:

 Registrar los datos maestros.

 Gestonar las llamadas del paciente.

MV Integración con Central Telefónica 4

2.1 Higienización de Camas

Los procesos abajo van disparar la integración a cada cambio:

Cambios en la atención (MV  AVAYA)

Cambios en la situación de inicio y fn (AVAYA  MV)

MV Integración con Central Telefónica 5

2.2 Cobro de Llamadas Telefónicas

2.3 Higienización de Camas - Registro de Atención

MV Integración con Central Telefónica 6

Alta Nodo con los datos de alta. *** *** ***

MV Integración con Central Telefónica 7

2.3.1.2 Traducciones da datos

2.3.1.3 Web Service

2.3.1.4 Disparo de la integración

2.4 Higienización de Camas –Situación de la Cama

MV Integración con Central Telefónica 8

2.4.1.2 Traducciones da datos

2.4.1.3 Web Service

2.4.1.4 Disparo de la integración

2.5 Llamadas Telefónicas - PIN

2.5.1.2 Traducciones da datos

MV Integración con Central Telefónica 9

2.5.1.3 Web Service

2.5.1.4 Disparo de la integración

2.6 Llamadas Telefónicas – Cobro de la Llamada

MV Integración con Central Telefónica 10

2.6.1.2 Traducciones da datos

2.6.1.3 Web Service

2.6.1.4 Disparo de la integración

3.2 Integración a través de Web Service

MV Integración con Central Telefónica 11

<ip> → corresponde al IP donde se encuentra instalado el servidor de aplicación TOMCAT

<puerta> → corresponde a la puerta donde fue confgurado y instalado el servidor de

La estructura de los archivos XML utlizados en las comunicaciones tene un conjunto de

Eses campos que hacen parte de un agrupamiento superior chamado cabecalho

Ejemplo del encabezado para una integración de registro de una solicitud:

MV Integración con Central Telefónica 12

S-ar putea să vă placă și

Alta Nodo con los datos de alta. * * ***