En este manual encontrará toda la información necesaria para instalar el producto Bridge POS para el Segmento Medio (SMB).

Se explicarán cada uno de los pasos de instalación, los requerimientos de hardware y software, las propiedades a ser configuradas.

El manual se encuentra dividido en los siguientes capítulos:

SMB - Introducción:

Provee una breve descripción del producto así como también una visión global del manual, brindando información sobre el contenido del mismo.

SMB BPOS - Requerimientos de SW y HW:

Informa las plataformas soportadas y los requerimientos de software y hardware para poder instalar el sistema.

SMB BPOS - Instalación de prerrequisitos:

Detalla los requisitos a cumplir previos a iniciar la instalación del producto y los pasos a realizar para cada modo de instalación disponibles.

SMB BPOS- install.properties:

Especifica cada uno de los campos que integran el archivo install.properties, necesario para la correcta ejecución de la instalación.

SMB BPOS - Instalación - Windows:

Informa cómo ejecutar el sistema sobre plataformas Windows.

SMB BPOS - Resultado de la instalación:

Detalla la estructura de directorios, base de datos, servicios luego de la instalación en cada una de las plataformas de instalación.

SMB BPOS - Ejecución del sistema:

Informa cómo acceder al punto de ventas Bridge POS.

SMB BPOS - Configuraciones:

Ajustes posteriores a la instalación del punto de ventas como ser login, operaciones básicas en el pos y distribución de mapas.

SMB BPOS - Desinstalación:

Resumen de cómo realizar la desinstalación.

SMB BPOS - Manteamiento:

Información a tener en cuenta para el mantenimiento del sistema.

SMB BPOS -Troubleshooting:

Detalle de problemas que pueden ocurrir y sus soluciones.

Requerimientos mínimos como Plataformas Soportadas,  hardware y  software, Considerando que sean de uso dedicado para la aplicación Bridge POS.

• WINDOWS 10 o superior.
  

Requerimientos de Hardware

• Memoria RAM: 8 Gb (en la Terminal)
• Procesador i5
• Placa de video – Aceleración por HW

Prerrequisitos de Software

• JVM 1.8
• NodeJS 16 o superior.
• Base de datos mongoDB 4.2 o superior (community edition)

• Java 1.8 sobre Windows

Para la  instalación JAVA sobre Windows como prerrequisito de instalación de Bridge POS se recomienda seguir los pasos expuestos en el siguiente video: 

• • Bridge - Prerrequisito - Instalación Java sobre Windows

• NodeJS sobre Windows

Se podrá ver el proceso de instalación y configuración de NodeJS como prerrequisito para la instalación de Bridge POS de productos Napse sobre plataformas Windows en el siguiente link:

• • Bridge - Prerrequisito - Instalación Node JS sobre Windows

• Mongodb 4.2, configurado como replicaSet y seguridad activada sobre Windows

Se podrá ver el proceso de instalación y configuración de MongoDB como prerrequisito para la instalación de Bridge POS de productos Napse sobre plataformas Windows en el siguiente link:

• • Bridge - Prerrequisito - Instalación Mongo DB sobre Windows

Napse se proveerá el paquete de instalación de Bridge POS - SMB. Este paquete contendrá:

• el archivo install.bat (ejecutable)
• el archivo bridge-pos-installer-x.x.x.jar (librería de instalación, donde las X corresponde a la ultima versión liberada de Bridge POS SMB.

Adicionalmente, en el directorio de instalación, deberá de colocarse el archivo ant.install.properties de la Terminal generado desde Director, para la instalación de Bridge POS-SMB sobre Windows.

Al momento de ejecutar la instalación, el directorio de instalación deberá presentar los siguientes elementos para garantizar una correcta instalación:

• WINDOWS:

• • Servicios

Terminada la instalación podrán visualizarse los siguientes servicios activos en el entorno sobre el que se haya instalado.

• • Directorios de instalación

Terminada la instalación podrá visualizarse la siguiente estructura de directorios en base a la ruta que se haya indicado al momento de la generación del .properties

• • Base de Datos

Terminada la instalación podrá visualizarse la siguiente estructura en la base de datos de MongoDB.

Iniciar la aplicación

Para iniciar la aplicación se debe ejecutar el archivo pos.bat que se encuentra en el directorio raíz de la instalación.

Detener la aplicación

Para detener la aplicación, deben presionarse en forma simultánea las teclas "CONTROL + C" dentro de la ventana donde se esté ejecutando la aplicación BridgePOS. Y luego confirmar la cancelación del proceso.

Luego de haber realizado la instalación de la aplicación Bridge POS, puede ser requerido algún cambio en los parámetros de configuración o ajustar algún parámetro por default del sistema.

Para esto se requiere primero detener la aplicación, realizar los cambios requeridos y luego volver a iniciarla.

Configuraciones de inicio

En el archivo que se utiliza para iniciar la aplicación se encuentran la mayoría de los parámetros configurados durante la instalación.

Modificando los valores del archivo, puede modificarse la configuración.

El archivo en cuestión es el siguiente, que se encuentra en el directorio de instalación:

\bridge\app\run.bat

A continuación se detalla cada parámetro configurable:

Base de datos

Deberá editarse el siguiente archivo que se encuentra la siguiente ruta, a partir del directorio de instalación:

\bridge\app\config\hibernate.cfg.xml

Los parámetros que pueden editarse son:

Configuración de impresora fiscal

Si la terminal requiere de la configuración de una impresora fiscal se deberá chequear que se encuentre configurado en el run.bat los siguientes parámetros:

1. 1. –DfiscalMode=true (de no especificarse o configurarse con un valor distinto a "true" no se iniciará la impresora fiscal)
   2. –DfiscalDriver=epson (los parámetros permitidos son Epson o Hasar)

Copiar el archivo dll en la ruta "...\bridge\app\lib"
SO 64 bits:

SO 32 bits:

Modificar el parámetro LIBRARY_PATH del run.bat quedando de la siguiente manera:
LIBRARY_PATH="lib/"

Nota: la configuración específica de las impresoras fiscales, según su modelo se podrán encontrar en el directorio pos/bridge/app/config como:

• • fiscal-epson.xml
  • fiscal-hasar. Xml

Archivo de configuración de carga de parámetros para Epson TMU220

Dentro del archivo de configuración fiscal-epson.xml que se encuentra en el directorio pos/config se debe revisar la configuración de los siguientes parámetros:

• •  Puerto que le asigne la PC para la conexión de la printer fiscal:

<param name="port" value="COM4"/>

• • Monto límite por el cual se solicitará el ingreso de un cliente al ticket (generando un ticket factura):

<param name="baudRate" value="9600"/>
<param name="maxTicketAmount" value="1000" />

• • Monto límite por el cual se podrá emitir un ticket factura (superado este límite se debería generar una factura por otro medio):

<param name="maxInvoiceAmount" value="25000" />

• • Micro código de la printer fiscal. En el caso de la Epson puede ser "Demeter" o "Hera":

<param name="printerFirmwareName" value="Hera" />

• • Ajustar de acuerdo al texto que el retailer desee imprimir:

<param name="fantasyName">
<line position="1">
     <richText bold="false" underlined="false" doubleWidth="true" doubleHeight="true">Bridge POS</richText>
</line>
<line position="2">
     <richText bold="true">Sucursal: 1 - Terminal: 10</richText>
</line>

Configuración de contenido para período de inactividad

Pasado el tiempo configurado en el parámetro IDLE_TIME_LIMINT del archivo run.bat el POS pasa a mostrar imágenes y videos que deben ser colocadas en:

Directorio de instalación\bridge\app\config\views\themes\synthesis\screensaver\img

Formatos soportados para video, audio e imágenes:

• • Video: FLV containing VP6 video and MP3 audio; MPEG-4 multimedia container with H.264/AVC (Advanced Video Coding) video compression.
  • Audio: MP3; AIFF containing uncompressed PCM; WAV containing uncompressed PCM; MPEG-4 multimedia container with Advanced Audio Coding (AAC) audio
  • Imágenes: .gif (animados también), .jpg 

Configuración de log

El archivo log4j.xml es el archivo que contiene la configuración de los archivos log del POS ubicado en el directorio \bridge\app\config.

En este archivo se puede modificar la configuración de:

• • Directorio de logs: en el parámetro File se podrá configurar/modificar el directorio donde se grabarán los archivos logs.
  • Nombre del archivo de log:
    
    • Por defecto está definido como: log.YYYY-MM-DD
    • Se define en el parámetro File
  • Nivel de log: 
    • Se puede configurar/modificar con qué nivel de detalle se registrarán las excepciones en el archivo de log.
    • Los niveles de log soportados son, en orden descendente:

1. 1. 1. 1. ALL
         2. DEBUG
         3. INFO
         4. WARN
         5. ERROR
         6. FATAL
         7. OFF
         8. TRACE

Para mayor detalle de cada uno de los niveles, referenciar el siguiente link: https://www.tutorialspoint.com/log4j/log4j_logging_levels.htm

Configuración modalidad SefOrder

Para la definición de la pantalla a utilizar en el SelfOrder, se deberá configurar desde BMC la plantilla de ventas con las categorías (botones) y artículos a vender por categoría, definiendo para la terminal de la tienda requerida.

Luego de su sincronización, la misma podrá operar con la definición que se haya generado.

Ver: Manual de Usuario - Bridge Manager/Plantillas de venta.

En caso de que se haya instalado la modalidad de punto de venta "SelfOrder", se puede observar en run.bat el parámetro: com.synthesis.bridge.selforder.XBridgeSelfOrderApplication

A diferencia de la utilizada para instalación standard de "tienda": com.synthesis.bridge.pos.XBridgePosApplication

Configuración modalidad Supermercado

Requiere configurar previo al uso de Bridge POS el teclado, ya que en esta modalidad no se visualizan botones de operaciones sino que se hace uso del teclado con las definiciones de teclas de función.

En caso de que se haya instalado la modalidad de punto de venta "Supermercado", se puede observar en run.bat el parámetro: com.synthesis.bridge.supermarket.XBridgeSupermarketApplication

A diferencia de la utilizada para instalación standard de "tienda": com.synthesis.bridge.pos.XBridgePosApplication

Configuración modalidad Playa

Requiere configurar previo al uso de Bridge POS el teclado, ya que en esta modalidad no se visualizan botones de operaciones sino que se hace uso del teclado con las definiciones de teclas de función.

En caso de que se haya instalado la modalidad de punto de venta "Playa", se puede observar en run.bat el parámetro: com.synthesis.bridge.forecourt.XBridgeForecourtApplication

A diferencia de la utilizada para instalación standard de "tienda": com.synthesis.bridge.pos.XBridgePosApplication

Para que se visualicen los botones se tiene que agregar el valor "-Dtheme=synthesis-square" antes de com.synthesis.bridge.forecourt.XBridgeForecourtApplication

Configuración Fiscal Flow

Cada instalador de producto tiene configurado por default el puerto de Fiscal Flow.

En caso de requerir realizar una modificación consultar: Fiscal Flow - Cambiar la configuración del agente sin reinstalar

Las configuraciones de Fiscal Flow ingresadas durante la instalación de Bridge POS también podrán modificarse desde el directorio instalación BridgePOS: 

• • Ejemplo: C:\synthesis\pos_\fiscalflow\config\default.json

{
"app": {
"credentials": {
"companyCode": "mirgor",
"storeCode": "7390",
"terminalCode": "25"
},
"server": {
"endPoint": "http://23.96.32.127:80",
"port": "9999",
"useProxy": false,
"proxyHost": "10.1.33.110",
"proxyPort": "80"
},
"serverFtp": {
"endPointIP": "http://23.96.32.127:80",
"endPointPort": "22"
}

}
}

{
"app": {
"credentials": {
"companyCode": "mirgor",
"storeCode": "7390",
"terminalCode": "25"
},
"server": {
"endPoint": "http://23.96.32.127:80",
"port": "9999",
"useProxy": false,
"proxyHost": "10.1.33.110",
"proxyPort": "80"
},
"serverFtp": {
"endPointIP": "http://23.96.32.127:80",
"endPointPort": "22"
}

}
}

Configuración para quitar algún botón del menú de operaciones

Se detalla como ajustar el archivo de configuración que se puede editar para que quede oculto un botón.

• Ejemplo: “Informe caja” (del menú NO VENTA) en los POS físicos (por favor, probarlo previamente en un POS de Lab) Toma el cambio de configuración luego de reiniciado el POS. Esto quita de la pantalla el botón pero no reacomoda el resto
• En el archivo selection.fxml, en la carpeta directorio de instalación\bridge\app\config\views\themes\synthesis\selection,
• En la siguiente línea agregar los parámetros visible = false y managed = true
• <Button fx:id="boxReportButton" managed="true" maxHeight="1.7976931348623157E308" maxWidth="1.7976931348623157E308" mnemonicParsing="false" onAction="#onReceivedPaymentsReport" prefHeight="120.0" prefWidth="258.0" text="INFORME CAJA" textAlignment="CENTER" visible="true" />

Detalle de los pasos a realizar para desinstalar la aplicación.

Paso: Dar de baja los servicios

Para iniciar la desinstalación, abrir la ventana de línea de comando en modo administrador:

Navegar hasta el directorio en donde se haya realizado la instalación, directorio /cmds

Ejecutar el desinstalador indicando: removeServices.bat

De esta forma, se irán dando de baja los servicios que se encuentran ejecutándose.

Ejemplo:

Si el BPOS esta instalado en la siguiente carpeta

C:\Users\carla.escalera\AMBIENTES\PLAYA7154_OFF1448TIENDA1

Con el CMD se deberá ir a la ruta C:\Users\carla.escalera\AMBIENTES\PLAYA7154_OFF1448TIENDA1\bridgeapi y ahi ejecutar el removeServices.bat

Paso: Base de datos

Se requiere remover manualmente las bases de datos creadas en la instalación.

En el caso de no utilizar el motor de base de datos para otros fines, se sugiere desinstalarla:

2) Desinstalar MongoDB (desde la opción del sistema operativo para quitar aplicaciones).

3) Borrar la carpeta donde se encuentra instalado MongoDB, dado que mantiene configuraciones previas y no se elimina automáticamente al desinstalar.

Paso: Eliminar archivos

Eliminar manualmente los archivos que se generaron en el directorio de instalación.

Depuración de archivos de log

La aplicación registra diversos eventos dentro del archivo de log, los cuales, con el pasar del tiempo, aumentarán su tamaño progresivamente.

Es por ello que es necesario realizar un cierto mantenimiento, consistente en la depuración de los mismos periódicamente.

Los archivos correspondientes al directorio de logs podrán ser eliminados sin afectar el comportamiento de la aplicación Bridge POS.

Los mismos se encuentran en la siguiente ruta, a partir del directorio de instalación:

\bridge\app\log

Asignación de memoria

Al operar el POS se puede detectar que es requerido asignarle más memoria.

Deberá editarse el siguiente archivo que se encuentra en la siguiente ruta, a partir del directorio de instalación:

\bridge\app\run.bat

Agregando el parámetro -Xmx512m en la última línea ejecutable, quedando de la siguiente manera:

"C:/Program Files/Java/jre1.8.0_25/bin/java" %DEBUG_OPTIONS% -Xmx512m -cp %CLASSPATH%...

Aplicación no envía transacciones al servidor o no se conecta a la base de datos de tienda

Esto puede ser producido por problemas de conectividad con el servidor.

Uno de las posibles soluciones es asociar el nombre del servidor (NombreServidor) con la dirección ip del mismo (IPServidor).

A continuación se enumeraran los pasos a seguir para solucionar el problema:

1. Obtener nombre de dominio e IP del servidor.
2. Editar el fichero "C:\Windows\System32\drivers\etc\host" (con permiso de administrador) 
3. Agregar la línea " IPServidorNombreServidor"
4. Guardar fichero.

Ejemplo:

C:\Windows\System32\drivers\etc

Se debe abrir el archivo en Modo administrador y editarlo. Agregar la línea 13.90.230.178 LNXPROMOCON02 y guardar el archivo.