Manual de Instalación - Bridge POS 7.5 - SMB
Painel | |||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||
|
Painel | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
|
SMB - Introducción
Napse cuenta con una amplia gama de soluciones que tienen como finalidad lograr una experiencia de compra única y positiva que cumpla con las expectativas del cliente.
Con este objetivo, BRIDGE - SMB cubre las necesidades del segmento medio de retailers, ofreciéndole una solución unificada, simple de instalar y operar, y mantiene las ventajas y beneficios de todos los productos de la Suite Napse.
¿Qué es SMB? (Segmento Medio Bridge)
Las soluciones Napse se encuentran instaladas y operando en retailers de diferentes países de América Latina, permitiendo atender, por ejemplo con Bridge tiendas físicas y virtuales. La integración de nuestros clientes con Promo permite crear una experiencia de consumo personalizada, ya que con Promo es posible centralizar promociones y programas de fidelidad. Con Vtol es posible la gestión e integración de compras electrónicas y la validación de pago desde y hacia las tiendas físicas y virtuales. Mientras que con Fiscal Flow es posible emitir, controlar, gestionar, almacenar y enviar a sus clientes comprobantes electrónicos.
Todo este potencial de la Suite Napse se fusiona en una única solución: SMB, pensada para el segmento medio, simplificando la puesta en marcha, agilizando su operatoria y optimizando su rendimiento.
SMB se compone de un único instalador que dejara operativo en el la tienda del retail del segmento medio la suite de soluciones Napse, compuesta por:
- Bridge Manager Central: Actúa como BackOffice complementando la operación en tienda de los puntos de venta. Cuenta con una “Consola de administración”, encargada de brindar una herramienta centralizada de administración en la nube.
- Bridge Manager Tienda: Proporcionara todas las opciones de administración de la tienda, manejo de inventario, medios de pago, gestión de clientes, informes, monitoreo de terminales, pedidos, presupuestos, configuraciones y opciones de seguridad, de forma simplificada e intuitiva.
- Bridge POS: es la aplicación de punto de venta que integra las interfaces de usuario, con servicios asociados a la venta (servicios en línea y gestión de promociones) y las reglas de negocio personalizadas. Maneja además de las operaciones de venta y devolución, operaciones de no venta y de contabilidad de caja.
- Integración con Promo: Durante la instalación se configuraran los elementos necesarios en Promo (cloud) para la gestión de las promociones.
- Integración con Vtol: Durante la instalación se configuraran los elementos necesarios en Vtol (cloud) para la validación de las transacciones electrónicas; así como también se instalara librería EVM (Correspondiente al país en el que se instale), el cual permite simplifica la integración y la comunicación con el medio de pago de tarjetas abstrayendo a la aplicación de punto de venta de procesos como el manejo del PINPAD, reconocimiento de tarjetas (crédito/débito y otras), a comunicación e integración con Gateway de transacciones VTOL y resolver problemas de contingencia.
- Integración con Fiscal Flow: Durante la instalación se configuraran los elementos necesarios en Fiscal Flow (cloud) para la gestión de facturas electrónicas; así como también se instalara el agente de Fiscal Flow permite una operación fuera de línea ante determinadas circunstancias y de acuerdo a configuración específica.
- Integración con Director: Durante la instalación se configuraran los elementos necesarios en Director (cloud) para la gestión y administración de nuevas versiones de los productos Napse instalados (Bridge Manager, Bridge POS, EmvKit y agente de Fiscal Flow y del mismo director)
Arquitectura de alto nivel
Expandir | ||
---|---|---|
| ||
Acerca de este manual
Expandir | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||
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. 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.
|
SMBBPOS - Requerimientos de SW y HW
Expandir | ||
---|---|---|
| ||
Requerimientos mínimos como Plataformas Soportadas, hardware y software, Considerando que sean de uso dedicado para la aplicación Bridge POS.
Requerimientos de Hardware
Prerrequisitos de Software
|
SMB BPOS - Instalación de prerrequisitos
Expandir | ||
---|---|---|
| ||
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:
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:
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: |
SMB BPOS- install.properties
Expandir | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
SMB BPOS - Instalación - Windows
Expandir | |||||
---|---|---|---|---|---|
| |||||
Napse se proveerá el paquete de instalación de Bridge POS - SMB. Este paquete contendrá:
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:
|
SMB BPOS - Resultado de la instalación
Expandir | ||
---|---|---|
| ||
Terminada la instalación podrán visualizarse los siguientes servicios activos en el entorno sobre el que se haya instalado.
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
Terminada la instalación podrá visualizarse la siguiente estructura en la base de datos de MongoDB. |
SMB BPOS - Ejecución del sistema
Expandir | ||
---|---|---|
| ||
Iniciar la aplicaciónPara 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ónPara 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. |
SMB BPOS - Configuraciones
Expandir | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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 inicioEn 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 datosDeberá 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 fiscalSi 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:
Copiar el archivo dll en la ruta "...\bridge\app\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:
Archivo de configuración de carga de parámetros para Epson TMU220Dentro 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:
<param name="port" value="COM4"/>
<param name="baudRate" value="9600"/>
<param name="maxInvoiceAmount" value="25000" />
<param name="printerFirmwareName" value="Hera" />
<param name="fantasyName"> Configuración de contenido para período de inactividadPasado 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:
Configuración de logEl 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:
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 SefOrderPara 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 SupermercadoRequiere 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 PlayaRequiere 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 FlowCada 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:
Configuración para quitar algún botón del menú de operacionesSe detalla como ajustar elarchivo de configuración que se puede editar para que quede oculto un botón.
|
SMB BPOS - Desinstalación
Expandir | ||
---|---|---|
| ||
Detalle de los pasos a realizar para desinstalar la aplicación. Paso: Dar de baja los serviciosPara 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 datosSe 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 archivosEliminar manualmente los archivos que se generaron en el directorio de instalación. |
SMB BPOS - Manteamiento
Expandir | ||
---|---|---|
| ||
Depuración de archivos de logLa 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 memoriaAl 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%... |
SMB BPOS -Troubleshooting
Expandir | ||
---|---|---|
| ||
Aplicación no envía transacciones al servidor o no se conecta a la base de datos de tiendaEsto 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:
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. |