Configuracin NewHotel-Conexflow

Verso:01

El objetivo de este documento es resumir tcnicamente los pasos a

realizar para la configuracin de la Interface de Newhotel con la
Pasarela de pagos ConexFlow

NewHotel Software SA
Av. Almirante Gago Coutinho, 70 1700-031
Lisboa | Portugal
+(351) 21 844 00 10

Interface [NewHotel ] Passarela de Pagos - Conexflow

El objetivo de este documento es definir los pasos a configurar para que se realice la interface de
[Newhotel] con la pasarela de pagos Conexflow

Instalar un WebService
WebService en
Information Services
S
(IIS) v7

Internet

Informacin para administradores de sistemas.

Si usted es un administrador de sistemas, casi toda esta informacin le es innecesaria o incompatible con
su configuracin, por lo tanto sigue una indicacin general de lo que se quiere hacer.
El webservice debe ser instalado en un directorio virtual, como aplicacin, que debe llamarse WSNewGes,
en un directorio fsico a su eleccin. Necesita del Framework de .NET v3.5 o superior. Corre en 32 o 64
bits en dependencia del cliente de Oracle que tenga
t
instalado en esa mquina.

Detalles de instalacin.
Todos los ejemplos que se muestran a continuacin son utilizando una instalacin que puede diferir de la
suya en cuanto a elementos instalados e idioma, pero las opciones son las mismas en cualquier IIS v7 por
lo que puede guiarse por la posicin de las opciones.

Prerequisitos.
Antes de pasar a instalar el webservice necesitamos tener instalados algunos elementos en el
computador.
Cliente de Oracle.
Como este programa accede a la base de datos, es necesario
necesario tener instalado un cliente de Oracle. Puede
ser cualquier plataforma del cliente (32 o 64 bits) de la versin 10r2 o superior, pero tenga esta
informacin a la mano (la plataforma) mas adelante en la configuracin.
Microsoft .NET Framework v3.5
El este componente viene entre las actualizaciones del sistema operativo, con lo que posiblemente ya
est instalada, de no estar, ir a las actualizaciones e incluirla, este es el mtodo recomendado. Otros
mtodos son: WebPlattformInstaller o el sitio de Microsoft.
Microsoft. En caso que decida bajarla directamente del
sitio, tenga en cuenta que luego debe registrarla en el IIS con el comando aspnet_iisreg.exe, mas
informacin en el sitio de Microsoft.

Instalar.
Copiar los ficheros de la aplicacin para un directorio:

Pgina 2

Interface [NewHotel ] Passarela de Pagos - Conexflow

Abrir el Internet Information Services que est en las Herramientas Admistrativas del Panel de Control y
seleccione el sitio en que quiere instalar:

En dependencia de su configuracin ah pueden aparecer ms sitios, adems del por defecto (Default
Web Site
ite en el ejemplo), para elegir cual es el correcto contacte con su administrador de sistemas o quien
quiera que haya instalado/configurado el IIS.

Pgina 3

Interface [NewHotel ] Passarela de Pagos - Conexflow

En el men de contexto del sitio elija la opcin de agregar aplicacin (Add Application en el ejemplo):

En la ventana que sale a continuacin debemos fijarnos en tres elementos importantes, el alias, el camino
fsico (Physical Path en el ejemplo) y el pool de aplicaciones (Application Pool en el ejemplo):

En el Alias tenemos que poner WSNewGes. En el camino

camino fsico tenemos que indicar el camino del
directorio donde copiamos los ficheros de la aplicacin en el inicio. En el pool de aplicaciones tenemos
que indicar el que usaremos para ejecutar el programa (mas sobre esto adelante).
Despus de esto aparecer
r un directorio virtual con el alias elegido en la lista del sitio.

Pgina 4

Interface [NewHotel ] Passarela de Pagos - Conexflow

Como elegir/configurar el pool de aplicaciones.

El pool de aplicaciones es el equivalente en el IIS a lo que sera un .exe en una aplicacin Windows. Es l
quien sirve de punto de entradaa de webservices y sitios, es l quien se encarga de ejecutar nuestro
programa.
Para ver los pools de aplicaciones que tenga instalado lo ve en el IIS (Application Pools en el ejemplo):

As que elija el apartado de pool de aplicaciones, en el panel del medio

medio le van a aparecer todas las
aplicaciones que tenga instaladas, pueden ser muchas o pocas dependiendo de su instalacin:

Para ver las caractersticas de una aplicacin, la selecciona y en las opciones que aparecern en el panel
de la derecha elije las opciones avanzadas (Advanced Settings en el ejemplo), seguidamente saldr una
ventana como la que sigue:

Pgina 5

Interface [NewHotel ] Passarela de Pagos - Conexflow

Hay tres elementos bsicos a tener en cuenta cuando se elige/configura un pool de aplicaciones: la
plataforma, la versin del framework y la identidad.
ide
La Plataforma.
Es la opcin Permitir Aplicaciones de 32 bits (Enable 32-bits
32 bits Applications en el ejemplo). Si la ponemos a
False ejecutar en 64 bits, sino a 32. Si su computador es de 32 bits esta opcin es irrelevante, en caso
contrario deber elegir
gir ah de acuerdo a como quiere que ejecute el webservice.
32 o 64 ?
El webservice puede ejecutar tanto en 32 como en 64 bits. Tiene que elegir la misma plataforma del
cliente de Oracle que est usando.
La versin del Framework.
Es la opcin versin del framework (.NET Framework Version en el ejemplo). En este caso usamos v2.0
porque las versiones 2, 3 y 3.5 del framework son todas dependientes de la 2.

Pgina 6

Interface [NewHotel ] Passarela de Pagos - Conexflow

La Identidad.
La identidad es la cuenta de Windows que va a usarse para ejecutar la aplicacin, esta
es eleccin va a
afectar los permisos que se le dan. Es la opcin Identidad (Identity en el ejemplo). Hay varios valore
predefinidos que se pueden usar: Sistema local, servicio local, servicio de red y la del pool de aplicaciones.
Adems de eso se puede poner
ner una cuenta especfica.
Por defecto viene con la del pool pero puede cambiarse si detectamos que los permisos no son
suficientes.

Final.
Cuando todo lo anterior est hecho ya el webservice est listo para ser usado. Para probar si la
configuracin funciona,
ona, seleccionamos el directorio virtual que fue creado al inicio y en el panel del
centro, en el borde inferior, seleccionamos la vista de contenido (Content View en el ejemplo):

Ah seleccionamos el archivo WSNewgesCreditCard.asmx y en el men de contexto

contexto (o en el panel de la
derecha) se elige la opcin Explorar (Browse en el ejemplo):

Pgina 7

Interface [NewHotel ] Passarela de Pagos - Conexflow

A continuacin deber salirnos una ventana del browser instalado con esta informacin:

En este punto ya el webservice est instalado y listo para ser configurado/usado.

configurado/

Consideraciones a tener en la configuracin del webservice:

Algunas consideraciones a tener en cuenta es que el nombre del webservice es fijo : wsnewges y la
maquina adonde est instalado tiene que tener abierto el puerto 80.
Consideraciones a tener en la configuracin del webservice:

Codigo de la Empresaa ConexFlow (dado fornecido por ConexFlow):

<setting name="EnterpriseID" serializeAs="String">

<value>00000111</value>
</setting>

Codigo de la Loja/tienda
/tienda ConexFlow (dado fornecido por ConexFlow):

<setting name="StoreID" serializeAs="String">

<value>0111</value>
</setting>

Pgina 8

Interface [NewHotel ] Passarela de Pagos - Conexflow

Nombre del Servio ORACLE (NewGes)

<setting name="NGSRV" serializeAs="String">

<value>NGES</value>
</setting>

Usuario NewGes ORACLE

setting name="NGUID" serializeAs="String">

<setting
<value>NGE</value>
</setting>

Password para o usurio Newges Oracle

<setting name="NGPWD" serializeAs="String">

<value>nge</value>
</setting>

Tiempo para Timeout de la Conexione al VisualPlugin

VisualPlugin (en segundos, por defecto 30 segundos)

<setting name="ConnectionTimeOut" serializeAs="String">

<value>30</value>
</setting>

Tempo para Timeout de la Operacin (en segundos, por defecto 360 segundos)

<setting name="TransactionTimeOut" serializeAs="String">

se
<value>360</value>
</setting>

Pgina 9

Interface [NewHotel ] Passarela de Pagos - Conexflow

Configurar NewGes
NewGes para interface con
Conexflow
Para esta implementacin de debe tener una version de Newges >=25-05-2012.
>=

Configuracin de los Devices Conexflow (PinPads) en NewGes.

Abrir
brir el Gestor de Newges e cargar en las configura cones de los hoteles :

Seleccionar la tab de credit card

Insertar los dados referentes a la conexione a la base

se de dados de Newhotel: Servicio Oracle, User Oracle
e Password (1). Cargar e Testar. Seleccionar el Hotel de la lista de Hoteles (2). Cargar en Insertar (3).

Pgina
10

Interface [NewHotel ] Passarela de Pagos - Conexflow

Seleccionar el registro del cuadro (1) que se acabo de insertar de forma a salir el botn Conexflow
abajo (2).
Cargar enConexflow.

Pgina
11

Interface [NewHotel ] Passarela de Pagos - Conexflow

Lista y Mantenimiento de los dados do los devices Conexflow.

a) Para Visualizar los datos seleccionar el registro que se pretende del cuadro(1),
cuadro
de manera a que
los dados aparezcan en los campos enseados abajo.

b) Para Modificar los datos,

os, despus de seleccionar el registro
ro del cuadro (punto
(pu
a)), alterar la
informacin colocada en la seccin Info (1) y para terminar cargar en Modify (3).
c) Para Insertar un nuevo
vo registro,
regist llenar los campos de la seccin Info (1), garantiendo que lo ID
es nico e que todava no existe en nengn registro del cuadro.. Para guardar los dados, cargar en
Insert (2)

Para borrar un de los registros del cuadro,

cuadro bastar selecciona-lo
lo y cargar en el botn

Pgina
12

Interface [NewHotel ] Passarela de Pagos - Conexflow

Configuracines en el Pms Front Office

para interface con Conexflow
En el PMS se debe configurar lass siguientes pantallas
En el men Utilitarios Parmetros Generales Asientos:
Marcar el parmetro que dice Verificacin
Verificacin de Tarjetas de Crdito y de seguida Newges - ConexFlow

ce Host ConexFlow se debe poner: el nombre o el ip de maquina

ma
adonde est
De seguida adonde dice
instalado el Webservice.
En el men utilitarios Parmetros
Parmetros Dispositivos ConexFlow

Pgina
13

Interface [NewHotel ] Passarela de Pagos - Conexflow

Se identifican las Estaciones de trabajo , todas las maquinas
maquinas que tienen un dispositivo Conexflow
C
conectado.
Y adonde dice
ice Dispositivos,
Conexflow)

por cada mquina se asocia

cia al Dipositivos conexflow (PinPAD

Pgina
14