Instalación del facturador Puerto Rico – Simphony

Oracle® Hospitality Simphony
FIP – Peurto Rico
Guia de Instalacion
Release 2.7
July 2016
Copyright © 2016, Oracle and/or its affiliates. All rights reserved.
This software and related documentation are provided under a license agreement containing
restrictions on use and disclosure and are protected by intellectual property laws. Except as
expressly permitted in your license agreement or allowed by law, you may not use, copy,
reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or
display any part, in any form, or by any means. Reverse engineering, disassembly, or
decompilation of this software, unless required by law for interoperability, is prohibited.
The information contained herein is subject to change without notice and is not warranted to be
error-free. If you find any errors, please report them to us in writing.
If this software or related documentation is delivered to the U.S. Government or anyone licensing it
on behalf of the U.S. Government, then the following notice is applicable:
U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated
software, any programs installed on the hardware, and/or documentation, delivered to U.S.
Government end users are "commercial computer software" pursuant to the applicable Federal
Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication,
disclosure, modification, and adaptation of the programs, including any operating system,
integrated software, any programs installed on the hardware, and/or documentation, shall be
subject to license terms and license restrictions applicable to the programs. No other rights are
granted to the U.S. Government.
This software or hardware is developed for general use in a variety of information management
applications. It is not developed or intended for use in any inherently dangerous applications,
including applications that may create a risk of personal injury. If you use this software or
hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe,
backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its
affiliates disclaim any liability for any damages caused by use of this software or hardware in
dangerous applications.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be
trademarks of their respective owners.
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC
trademarks are used under license and are trademarks or registered trademarks of SPARC
International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or
registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open
Group.
This software or hardware and documentation may provide access to or information about content,
products, and services from third parties. Oracle Corporation and its affiliates are not responsible
for and expressly disclaim all warranties of any kind with respect to third-party content, products,
and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle
Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to
your access to or use of third-party content, products, or services, except as set forth in an
applicable agreement between you and Oracle.
Micros Simphony FIP - Puerto Rico
Guía de Instalación
Aplica a
Micros Simphony 2.7
Impresoras compatibles con Micros
Importante: La información
remarcada en amarillo
nueva
o
actualizada
será
Tabla de Contenido
Extension Application ........................... 2
Variables IVU Loto – Headers y Trailers ......... 4
CAL Packages .................................... 5
Configuración del FIP ........................... 7
Micros IVU Loto Service ........................ 11
Configuración del Servicio ..................... 11
Pg.
1
Extension Application
1) Copiar el package completo a una carpeta dentro del
Application Server.
2) Abrir EMC.
3) Seleccionar el Scope deseado para la configuración de
los
Extension Applications
(puede
ser
a
nivel
Enterprise, Property o RVC).
4) Ir a la solapa Setup y luego en el grupo Custom
Content elegir la opción Extension Application.
5) Crear un nuevo registro. Ingresar “FI” (sin comillas)
en el campo Name y en el campo Description.
6) Ir al modo visual Form View haciendo doble click sobre
el botón a la izquierda del número de registro
(campo #)
7) Insertar los Application Content como se muestra en la
imagen, a partir de los archivos copiados en el
paso 1)
- Figura 1 -
Hay dos tipos de archivos que se deben agregar como
Application Content: el SIM (Content Type 19 - SimScript) y
las DLL (Content Type 3 - DLL). El registro 5 de la Figura
1 muestra el registro correspondiente a la carga del
archivo FIPPuertoRico.isl, donde en el campo Option Bits se
puede ver que hay un bit seleccionado (al presionar el
botón de los puntos suspensivos se muestra el diálogo
Extension Application Content Options donde para el caso
del archivo FIPPuertoRico.isl se deberá seleccionar el bit
Main SIM Content.
Al generar un nuevo Application Content de tipo SIM
Script, se deberá luego insertar el código, para lo cual se
procede a hacer doble click sobre el registro recientemente
Pg. 2
agregado (el 4 de la Figura 1) desplegando así la solapa
Designer. Primero debemos elegir el Content Type de tipo
SimScript, luego a la derecha encontraremos el link Import
from file,
que una vez clickeado sobre él, se abrirá el
cuadro
de
diálogo
para
ubicar
el
archivo
.isl
correspondiente.
En la Figura 2 se puede apreciar la solapa Designer
del Application Content del código SIM.
- Figura 2 -
Pg.
3
Se debe especificar además el nombre de cada archivo en el
campo Disk File Name.
Al agregar todas las dll y el SIM a nivel BD, esto
debería generar en los clientes activos (luego de un
refresh / update de la BD cliente) una carpeta:
x:\Micros\Simphony\WebServer\wwwroot\EGateway\Handlers\
ExtensionApplications\FI\,
donde finalmente aparecerán copiados todos los archivos
correspondientes a los Application Content Agregados
(exceptuando el .isl).
Variables IVU Loto – Headers y Trailers
Para que los datos obtenidos de Nº de IVU Loto y Fecha
de Transacción puedan ser impresos en el header / trailer,
éstos deben ser configurados para aceptar los datos e
incluirlos en la impresión. Para ello se deben utilizar dos
variables predefinidas que serán incluidas en las líneas de
header/trailer de los tipos de cupones deseados (Guest
Check,
Customer
Recipt,
etc.).
Las
variables
son:
@@ivu_loto y @@ivu_loto_date, que serán reemplazadas al
momento de la impresión por los datos Nº de IVU Loto y
Fecha de Transacción, respectivamente.
Pg.
4
CAL Packages
Para
el
caso
del
archivo
de
configuración
FIPPuertoRico.dll.config se debe generar un CAL Package.
Desde la solapa Home y a nivel Enterprise, acceder a la
solapa Setup y luego seleccionar la opción CAL Packages.
Una vez allí, crear un nuevo registro al que se podrá
llamar FIP Puerto Rico. El campo Platform Type debe indicar
la plataforma del cliente (tipo de terminal), por ejemplo
Win32 Client si la terminal tiene un sistema operativo
Windows Embedded POSReady 2009. Finalmente indicar el
nombre de la carpeta desde donde se copiarán los archivos
hacia el cliente, en nuestro caso puede ser FIPPuertoRico
(ver Figura 3). Una vez generado procedemos a la pantalla
en formato Form View.
- Figura 3 -
Pasar a la vista de tipo Form View para poder agregar
en el área de Deployments los paquetes a copiar. Desde el
link Add se permite el agregado de nuevos paquetes. Se debe
agregar uno nuevo cuyo Deployment Type indique el Scope de
la instalación: si es a nivel Property / Enterprise o bien
para un Host Específico, a indicar luego, en el campo
Service Host. El campo Action to Take debe decir Install.
Pg.
5
Una vez configurado, generar
FIPPuertoRico2.0 dentro de la ruta:
una
carpeta
llamada
x:\MICROS\Simphony\EgatewayService\CAL\Win32\Packages,
donde deberán ser copiados los archivos de configuración y
de comandos CAL: FIPPuertoRico.dll.config y setup.dat
respectivamente. El archivo de configuración se encuentra
dentro de la carpeta:
FIP\Application Content\Wxx,
donde xx indica la plataforma (W32 o Wce); mientras que el
archivo de comandos CAL se ubica dentro de la carpeta:
FIP\CAL\
Finalmente se debe correr la instalación CAL del lado
del cliente para que también se copie el archivo de
configuración.
Pg.
6
Configuración del FIP
El archivo de configuración de los parámetros del FIP
es el FIPPuertoRico.dll.config. Se detallan a continuación
los campos que lo componen.
Sección “Options”
 IN_DEBUG_MODE:
Si
se
activa, el
FIP
escribirá
información extra de depuración en el log de errores
del FIP. Ingrese “true” para activar, “false” para
desactivar.
Nota: esta
soporte.
opción
solo
debe
ser
activada
por
personal
de
 SHOW_VERSION: Si se activa, el FIP mostrará por
pantalla la versión del assembly cada vez que se
inicialice la terminal. Ingrese “true” para activar,
“false” para desactivar.
 TAX_IS_INCLUSIVE:
Especifica
si
los
impuestos
configurados en la BD de Micros son de tipo
“Inclusive” o no. Ingrese “true” para activar, “false”
para
desactivar.
(Esta
opción
debería
estar
desactivada si se están utilizando impuestos de tipo
“Add On”).
 PRINT_MERCHANT_COPY_RECEIPT: Determina si debe ser
impresa o no una copia del recibo de IVU Loto para la
tienda. Ingrese “true” para activar, “false” para
desactivar.
Sección “IVU LOTO”
 REQSERVER_SERVER_IP: Dirección IP del servidor donde
está corriendo Micros IVU Loto Service.
 REQSERVER_SERVER_PORT: Puerto de escucha del servicio
Micros IVU Loto Service. Por default 7511.
 REQSERVER_RESPONSE_TIMEOUT: Tiempo máximo de espera de
respuesta con el Nro. de IVU Loto proveniente desde el
servicio Micros IVU Loto Service.
Pg.
7
 IVU_LOTO_OFF: Activa o desactiva la solicitud de
generación de Nro. de IVU Loto. Ingrese “true” para
desactiva IVU Loto, “false” para dejarlo activo.
 DATE_FORMAT: Formato de fecha utilizado para
impresión de la fecha de transacción de un Nro.
Loto. El formato puede ser definido siguiendo
standards de formato aceptado en el lenguaje C#.
default el valor es MMM dd yyyy hh:mm:ss
Ej.: Jan 13 2014 10:07:51 PM.
la
IVU
los
Por
tt.
 USE_CHECKOPENTIME_AS_TRANSACTION_DATE: Si se active,
se utiliza la fecha de creación del cheque de micros
como fecha de transacción del Nro. IVU Loto, caso
contrario se utiliza le fecha del sistema al momento
de imprimir el cheque. Ingrese “true” para activar,
“false” para desactivar.
 MERCHANT_ID / END_MERCHANT_ID: Identificado de Tienda
por RVC. Se pueden definir distintos MerchantIDs para
diferentes RVC. El formato de configuración es el
siguiente:
MERCHANT_ID
<MerchantID 1>=<RVC1_1>; <RVC1_2>;…; <RVC1_n>
…
<MerchantID k>=<RVCk_1>; <RVCk_2>;…; <RVCk_m>
END_MERCHANT_ID
 TERMINAL_PASSWORD / END_TERMINAL_PASSWORD:
Identificador de las claves y sus correspondientes
terminales. Se puede tener una clave para una sola
terminal, o bien una clave para múltiples terminales.
Formato:
TERMINAL_PASSWORD
<PASSWORD_1> = <WS OBJ_NUM 1>;…;<WS OBJ_NUM m>
…
<PASSWORD_k> = <WS OBJ_NUM n>;…;<WS OBJ_NUM z>
END_TERMINAL_PASSWORD
 IVU_SHOW_FAILURE_MESSAGE:
Si
se
activa,
serán
mostrados por pantalla todos los mensajes de error
ante cualquier falla en la generación de un Nro. IVU
Loto. Ingrese “true” para activar, “false” para
desactivar.
Pg.
8
 FIRST_TENDER_ALWAYS: Si se activa, será enviado
siempre el primer tender encontrado en la solicitud de
generación de un Nro. de IVU Loto. Caso contrario se
enviará siempre el tender IVU Loto con valor UNKNOWN
(6). Ingrese “true” para activar, “false” para
desactivar.
 IVU_TENDER_CASH_OBJ_NUM_LIST: Listado de todos los
tenders de Micros que se corresponderán con el tender
de IVU LOTO de tipo CASH.
Formato:
<Tender OBJ_NUM 1>; … ; <Tender OBJ_NUM n>
 IVU_TENDER_DEBIT_OBJ_NUM_LIST: Listado de
tenders de Micros que se corresponderán con
de IVU LOTO de tipo DEBIT.
Formato:
<Tender OBJ_NUM 1>; … ; <Tender OBJ_NUM n>
 IVU_TENDER_CREDIT_OBJ_NUM_LIST: Listado de
tenders de Micros que se corresponderán con
de IVU LOTO de tipo CREDIT.
Formato:
<Tender OBJ_NUM 1>; … ; <Tender OBJ_NUM n>
todos los
el tender
todos los
el tender
 IVU_TENDER_ATH_OBJ_NUM_LIST: Listado de todos los
tenders de Micros que se corresponderán con el tender
de IVU LOTO de tipo ATH.
Formato:
<Tender OBJ_NUM 1>; … ; <Tender OBJ_NUM n>
 IVU_TENDER_EBT_OBJ_NUM_LIST: Listado de todos los
tenders de Micros que se corresponderán con el tender
de IVU LOTO de tipo EBT.
Formato:
<Tender OBJ_NUM 1>; … ; <Tender OBJ_NUM n>
 IVU_TENDER_UNSPECIFIED_CARD_OBJ_NUM_LIST: Listado de
todos los tenders de Micros que se corresponderán con
el tender de IVU LOTO de tipo UNSPECIFIED.
Formato:
<Tender OBJ_NUM 1>; … ; <Tender OBJ_NUM n>
 IVU_TENDER_UNKNOWN_CARD_OBJ_NUM_LIST: Listado de todos
los tenders de Micros que se corresponderán con el
tender de IVU LOTO de tipo UNKNOWN.
Pg.
9
Formato:
<Tender OBJ_NUM 1>; … ; <Tender OBJ_NUM n>
 TIME_ZONE_OFFSET: Valor de offset en horas para
adicionar a la fecha de transacción y convertirla de
UTC/GMT a Local Time. Un monto cero significará que la
conversión a Local Time será automática por sistema.
Pg.
10
Micros IVU Loto Service
Se debe instalar al servicio Micros IVU Loto Service
en algún servidor con conexión a Internet y accesible desde
todas las terminales. Este será el encargado de recibir
desde las terminales las solicitudes de generación del Nro.
de IVU LOTO, conectarse al Web Service para su obtención y
luego devolver el resultado a la terminal de origen.
Para instalarlo basta con ejecutar el archivo Setup.exe que
se encuentra dentro de la carpeta IVULotoService, en el
package de distribución.
Una vez instalado el servicio, el puerto por default de
escucha será el 7511. Si se requiere, este puede ser
modificado
en
el
archivo
de
configuración
IVULotoService.exe.config, ubicado en la carpeta de la
unidad donde está instalado el sistema operativo (por lo
general c:\>). Basta con cambiar el valor del campo
SERVER_TCP_PORT y luego reiniciar el servicio Micros IVU
Loto Service. Luego deberá hacerse lo propio con la
configuración del cliente.
NOTA: Es muy importante que todas las terminales tengan
acceso irrestricto al servidor donde se instale Micros IVU
Loto Service, por lo que en caso de existir un Firewall,
éste debe permitir el acceso de entrada y salida hacia el
puerto de escucha del servicio (por default el 7511, pero
puede ser modificado tanto en el cliente como en el
servicio). En caso de no poder establecerse la conexión
entre un terminal y el servicio, se recomienda probar
primero desactivando el firewall para ver si el problema
está en las restricciones del acceso al servidor.
Configuración del Servicio
El archivo de configuración (formato XML) del servicio
Micros IVU Loto Service se ubica en la carpeta de
instalación del mismo, que será en el disco root del
sistema operativo Windows; por lo tanto si el S.O está
instalado en el disco c:\, entonces la ruta completa del
archivo será:
c:\FIP\IVULoto\IVULotoService\IVULotoService.exe.config
Pg.
11
El archivo permite configurar los siguientes parámetros:
 IN_DEBUG_MODE: Si se activa, habilita un mayor nivel
de mensajes registrados en el log provenientes desde
el módulo cliente del web service TxPort. “True” para
activar, “False” para desactivar.
 SERVER_TCP_PORT: Puerto de escucha para la recepción
de solicitudes de generación de Nro. de IVU Loto
proveniente desde las terminales. Por default 7511. Si
se modifica este valor, deberá hacerse lo propio desde
el lado cliente.
 TXPORT_SERVER_URL: URL de acceso al web service TXPORT
de generación de Nro. IVU Loto. Su valor por default
es: https://txportwst.txhubpr.com:8443/txserver/1.
 VERBOSITY_LEVEL: Especifica el nivel de registro de
eventos en el archivo LOG. Posibles valores aceptados:
“0” o “5”. Cuando el nivel es el menor, sólo se
registran mensajes de error. Cuando se sube el nivel
al valor máximo, se registran eventos de tipo
informativos.
NOTA: Cualquier modificación a estos parámetros requerirá
que el servicio Micros IVU Loto Service sea reiniciado.
Pg.
12