DIRECTOR Multiempresa - Manual de usuario 2.0 - SMB

1. Acerca de este manual

1.1 Propósito y alcance.  

El presente manual tiene por finalidad la capacitación de los usuarios que deseen utilizar la consola de administración del producto Director.
Brinda la información necesaria, con el nivel suficiente de detalle para que el usuario pueda monitorear el estado del sistema, así como también obtener información sobre el procesamiento de operaciones y realizar las tareas de administración correspondientes.

1.2 Referencias tipográficas

En este manual se utilizarán las siguientes convenciones:

2. Introducción

2.1 ¿Qué es Director?

Director es una solución de Napse que permite gestionar, administrar, distribuir y monitorear de manera centralizada y eficiente nuevas versiones de productos Napse en la red de tiendas de un retailer.
Además, posee la funcionalidad de monitorear en forma remota las terminales publicando múltiple información de las mismas.

2.2 Componentes

Director se encuentra constituido por los siguientes componentes:

• Director Server
  Ubicado de forma centralizada en un servidor, permite y efectúa la gestión, administración, coordinación e integración del sistema. Le ofrece al usuario una consola web de operación. 
  
  

• Consola de administración
  Por medio de la interfaz gráfica web, el usuario puede acceder a la solución para administrar los productos Napse y sus versiones y monitorear las terminales de los locales. 
  
  

• GIT
  Se encarga de llevar a cabo el control y la gestión de versiones de los productos definidos en el sistema. 
  
  

• Agente
  Se encuentra integrado en cada producto de una terminal, Entre sus principales funciones se encuentran: informar periódicamente el estado del producto, actualizar el producto a nuevas versiones vigentes e informar datos de una terminal.

3. Consola de Administración

3.1 Acceso

Por medio de la interfaz gráfica web, el usuario puede acceder a la solución para dar de alta compañías, administrar los productos Napse y sus versiones y monitorear las terminales de los locales. 

La consola de administración es una herramienta Web, accesible a través del uso de un browser como Internet Explorer, Mozilla Firefox o Chrome.

Para conectarse a la consola es necesario utilizar el siguiente enlace:

Donde:

• IP-SERVER: corresponde a la dirección IP o nombre del server donde se está ejecutando el servidor Director (ejemplo: 10.4.203.58)
• PORT: corresponde al puerto del servidor web utilizado por Director (ejemplo: 8080)

Finalizada la inicialización del sistema, en la parte superior derecha de la pantalla, el sistema muestra las opciones disponibles:

• Iniciar sesión: acceso a la consola de administración.
• Integración: acceso a los manuales de integración.

3.2 Login

Al iniciar sesión, se solicitarán las credenciales de acceso, con lo cual se deberá ingresar el usuario y clave en los campos habilitados.

Director concede por defecto una cuenta de acceso a la consola de administración para la compañía napse, (soporte), y para la compañía del retail deberá ingresarse con el usuario indicado en el proceso de alta de Compañía. Este usuario tendrá los permisos necesarios para poder gestionar los usuarios del sistema.

3.3 Flujo Operativo

En este apartado se explicará el flujo o secuencia normal de configuración y operatoria en la consola de Director:

1. Creación de la compañía (apartado 4.1 Compañías)
   Se debe crear la entidad con mayor jerarquía en la red del negocio del retailer. La compañía contendrá un conjunto de tiendas.
   
   
2. Creación del Tienda (apartado 4.3 Tiendas)
   Una tienda pertenece a una compañía y posee un conjunto de terminales.
   
   
3. Creación de las terminales (apartado 4.5 Terminales)
   Las terminales son las unidades lógicas que representan una caja. En las mismas se ejecutan los productos que se actualizarán mediante Director.
   
   
4. Creación del producto (apartado 5.1 Administración de Productos)
   Es preciso definir en el sistema el producto de software que se utiliza en las terminales y la ruta en GIT en donde se almacenarán las versiones. Un producto poseerá varias versiones.
   
   
5. Alta de versión para el producto creado previamente (apartado 5.2 Administración de Versiones)
   Se define en el sistema la versión vigente del producto creado previamente.
   
   
6. Monitoreo y gestión de versiones por producto y por terminales (apartado 6.1 Monitoreo de Versiones).
   En estas pantallas, se gestionan las versiones de los productos por terminales y se monitorean las características que poseen cada una de las terminales.

4. Indicadores

En esta sección se permite consultar diferentes reportes de datos. Ofrecen una serie de filtros para acotar la búsqueda de datos, generalmente rangos de fecha, por compañía (para el caso de la compañía napse), por tienda y por otros campos dependiendo del tipo de reporte.

4.1 Indicadores generales por compañía

Acceso:

Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Indicadores generales por compañía" dentro de "Indicadores" (Indicadores > Indicadores generales por compañía).

Descripción de la página:

A través de esta página será posible visualizar información resumida de las ventas de la/s compañía/s.

Al acceder brinda la información del último mes, pero permite seleccionar ver la información de los períodos previos dentro de un rango de 31 días.

4.1.1 Búsqueda 

• Compañía: ingresando con el usuario administrador de la compañía napse, se cuenta con un combo de selección permitiendo ver la información de una compañía en particular o de todas. Ingresando con un usuario de una compañía distinta a napse, solo se podrá visualizar la información de la compañía propia.
• Tienda: combo de selección que, al completar la compañía, permite seleccionar ver la información de una tienda en particular o todas, entre las asociadas a la selección anterior.
• Terminal: combo de selección que, al completar la tienda, permite seleccionar ver la información de una terminal en particular o todas, entre las asociadas a la selección anterior.
• Fecha DESDE y fecha HASTA: permiten filtrar por un periodo de días determinado. Por defecto se informará un mes desde la fecha de consulta. El periodo a consultar no podrá superar los 31 días.

Una vez completado alguno de dichos campos, se debe presionar el ícono de Buscar para que la búsqueda se lleve adelante. 

4.1.2 Detalle de la información 

• Cantidad de Compañías: cantidad de compañías consultadas.

• Cantidad de Tiendas: cantidad de tiendas consultadas.

• Cantidad de Terminales: cantidad de terminales consultadas.

• Monto de dinero facturado: importe total recaudado en el periodo de tiempo consultado. Ingresando con el usuario administrador de la compañía napse, en caso de no haber acotado la búsqueda por medio de los filtros, se informará el total acumulado para todas las compañías.

• Cantidad de tickets emitidos: cantidad total de tickets emitidos en el periodo de tiempo consultado. Ingresando con el usuario administrador de la compañía napse, en caso de no haber acotado la búsqueda por medio de los filtros, se informará el total acumulado para todas las compañías.

• Monto de ticket promedios): importe promedio de un ticket en el periodo de tiempo consultado. Ingresando con el usuario administrador de la compañía napse, en caso de no haber acotado la búsqueda por medio de los filtros, se informará el total acumulado para todas las compañías.

4.2 Resumen de venta por compañía

Acceso:

Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Resumen de venta por compañía" dentro de "Indicadores" (Indicadores > Resumen de venta por compañía).

Descripción de la página:

A través de esta página será posible visualizar indicadores referentes a las transacciones de ventas de la/s compañía/s.

Al acceder brinda la información del último mes, pero permite seleccionar ver la información de los días previos dentro de un período de 31 días.

4.2.1 Para usuarios de la compañía napse

El gráfico de Ventas por compañías (Ranking 5): muestra las compañías con mayor monto de ventas en el rango de fechas seleccionado.

El gráfico Tiendas activas por compañía (Ranking 5): muestra las compañías con mayor cantidad de tiendas activas (las tiendas que más operaron) en el rango de fechas seleccionado.

4.2.2 Para usuarios de la una compañía distinta a napse

El gráfico de Ventas por tiendas(Ranking 5): muestra las tiendas con mayor monto de ventas en el rango de fechas seleccionado.

El gráfico Tiendas activas por compañía (Ranking 5): muestra las tiendas con mayor cantidad de terminales activas (las terminales que más operaron) en el rango de fechas seleccionado.

4.3 Informes por compañía

Acceso:

Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Informes por compañía" dentro de "Indicadores" (Indicadores > Informes por compañía).

Descripción de la página:

A través de esta página se permite conocer el desglose por tiendas de una compañía dada, de las transacciones de venta, devolución y cambio.

Al acceder brinda la información del último mes, pero permite seleccionar ver la información de los días previos dentro de un período de 31 días.

4.3.1 Búsqueda 

• Compañía: ingresando con el usuario administrador de la compañía napse, se cuenta con un combo de selección permitiendo ver la información de una compañía en particular o de todas.
• Nombre de Tienda: combo de selección que, al completar la compañía, permite seleccionar ver la información de una tienda en particular o todas, entre las asociadas a la selección anterior.
• Fecha DESDE y fecha HASTA: permiten filtrar por un periodo de días determinado. Por defecto se informará un mes desde la fecha de consulta. El periodo a consultar no podrá superar los 31 días.

Una vez completado alguno de dichos campos, se debe presionar el ícono de Buscar para que la búsqueda se lleve adelante. 

4.3.2 Detalle de la información 

• Compañía: nombre de la compañía a la que pertenece la tienda.
• Nombre de Tienda
• Cantidad de Terminales: cantidad de terminales que tiene asociada la tienda.
• # Tickets emitidos: cantidad de tickets emitidos.
• # Ítems vendidos: la sumatoria de la cantidad neta de los ítems vendidos y los ítems que se lleva el cliente cuando realiza un cambio.
• # Ítems anulados:  la sumatoria de las cantidades de ítems anulados en las transacciones de ventas, devoluciones y cambios.
• # Ítems devueltos: la sumatoria de la cantidad de ítems que se devuelven en una devolución y los ítems que devuelve el cliente cuando realiza un cambio.
• $ Ítems vendidos: la suma del importe neto de los ítems vendidos y los ítems que se lleva el cliente cuando realiza un cambio.
• $ Ítems anulados: la sumatoria del importe de ítems anulados en las transacciones de ventas, devoluciones y cambios.
• $ Ítems devueltos: la sumatoria del importe de ítems que se devuelven en una devolución y los ítems que devuelve el cliente cuando realiza un cambio.
• $ Ventas netas: monto neto de ventas ($VENTAS NETAS - Importe de devolución)

4.4 Reporte por Tienda/Terminal

Acceso:

Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Reporte por Tienda/Terminal" dentro de "Indicadores" (Indicadores > Reporte por Tienda/Terminal).

Descripción de la página:

A través de esta página se permite conocer el desglose por tiendas de una compañía dada, de las transacciones de venta, devolución y cambio.

Al acceder brinda la información del último mes, pero permite seleccionar ver la información de los días previos dentro de un período de 31 días.

4.4.1 Búsqueda 

• Nombre de tienda: combo de selección que permite seleccionar ver la información de una tienda en particular o todas.
• Nombre de terminal: combo de selección que, al completar la tienda, permite seleccionar ver la información de una terminal en particular o todas, entre las asociadas a la selección anterior.
• Fecha DESDE y fecha HASTA: permiten filtrar por un periodo de días determinado. Por defecto se informará un mes desde la fecha de consulta. El periodo a consultar no podrá superar los 31 días.

Una vez completado alguno de dichos campos, se debe presionar el ícono de Buscar para que la búsqueda se lleve adelante. 

4.4.2 Detalle de la información 

• Nombre de Tienda: nombre de la tienda a la que pertenece la terminal
• Nombre de Terminal
• # Tickets emitidos: cantidad de tickets emitidos.
• # Ítems vendidos: la sumatoria de la cantidad neta de los ítems vendidos y los ítems que se lleva el cliente cuando realiza un cambio.
• # Ítems anulados:  la sumatoria de las cantidades de ítems anulados en las transacciones de ventas, devoluciones y cambios.
• # Ítems devueltos: la sumatoria de la cantidad de ítems que se devuelven en una devolución y los ítems que devuelve el cliente cuando realiza un cambio.
• $ Ítems vendidos: la suma del importe neto de los ítems vendidos y los ítems que se lleva el cliente cuando realiza un cambio.
• $ Ítems anulados: la sumatoria del importe de ítems anulados en las transacciones de ventas, devoluciones y cambios.
• $ Ítems devueltos: la sumatoria del importe de ítems que se devuelven en una devolución y los ítems que devuelve el cliente cuando realiza un cambio.
• $ Ventas netas: monto neto de ventas ($VENTAS NETAS - Importe de devolución)

5. Negocio

5.1 Compañías 

Una compañía o empresa es una asociación que posee una o varias tiendas. 

Acceso:

Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Compañías" dentro de "Negocio" (Negocio > Compañías).

Descripción de la página:

Logueandose con el usuario administrador asignado a Napse, a través de esta página será posible efectuar el alta, consulta edición y desactivación de las compañías que se manejarán en el sistema, como así también la visualización de las tiendas que se encuentran asociadas a las mismas.

Para el caso del perfil de cliente administrador de una compañía, a través de esta pagina será posible visualizar los detalles de la compañía del retail,

La información de esta sección será utilizada para la ejecución de los servicios de alta de compañías en Promo, Vtol, Fiscal Flow y Director, como así también para la obtención de el archivo .properties que será utilizado para la instalación de Bridge Manager Central.

5.1.1 Alta de compañías

Las compañías en Director pueden ser creadas únicamente por los usuarios de la empresa napse.

Para crear una compañía se deberá presionar en Nuevo ante lo cual se presentará un formulario de alta dividido en diferentes solapas.

Información general:

Esta información es utilizada para la confección de los servicios de alta de compañías de Promo, Vtol y Fiscal Flow, como así también información común entre los productos como ser el código, nombre, usuario y contraseña.

• ¿Modo testing? IMPORTANTE: Permite tildar la opción en caso de encontrarse configurando una nueva compañía para el entorno de testing exclusivamente. Este campo aplicará, en caso de integración con Fiscal Flow al tildarse para la creación de una compañía de test, la cual operará sus certificados de Homologación correspondientes.
• País (dato requerido): selección del país en donde se instalarán los productos Napse, pudiendo elegir entre Argentina, Chile, Colombia y México. En base al país aquí seleccionado se habilitaran los campos de entornos que estén habilitados para ese país, permitiendo seleccionar solo los entornos definidos para el país seleccionado
  
• Entorno Promo: permite seleccionar la url del servidor de Promo.
• Entorno Vtol: permite seleccionar la url del servidor de Vtol.
• Entorno Fiscal Flow: permite seleccionar la url del servidor de Fiscal Flow.
• Código de Compañía (dato requerido): Código de la compañía a generar en todos los productos de la Suite Napse (Director, Promo, Vtol, Fiscal Flow). Campo alfanumérico.
  
• Nombre de Compañía (dato requerido):  Nombre de la compañía a generar en Director y en los productos de la Suite Napse por servicio.  Campo alfanumérico.
  
• Usuario Administrador (dato requerido): Usuario administrador de Productos Napse. El campo se autocompletará a modo de ayuda (cuando se defina el campo "Código de compañía") con el código de compañía seguido de Admin (<companyCode>_Admin). Podrá ser editado en caso de querer definir otro usuario administrador. Este usuario administrador será el utilizado por el retailer para loguearse en BMC, BMT, así como también en la consola de Promo, Vtol, Fiscal Flow y Director de su compañía.
• Contraseña (dato requerido): Contraseña del administrador de Productos Napse. Esta contraseña de administrador será el utilizado por el retailer para loguearse en BMC, BMT, así como también en la consola de Promo, Vtol, Fiscal Flow y Director de su compañía.
• Provincia (dato requerido): Provincia de la compañía. El campo mostrará el catálogo de provincias en base al país seleccionado.
  
• Ciudad (dato requerido): Ciudad de la compañía. El campo mostrará el catálogo de ciudades en base a la provincia seleccionada.
  
• Comuna: en caso de aplicar, en base al país, provincia y ciudad seleccionados se listarán las comunas.
• Dirección (dato requerido): dirección legal de la compañía.
• Teléfono (dato requerido): Número de teléfono de la compañía.
  
• Email (dato requerido): Email de la compañía. Aquí se validará que los datos ingresados tengan formato de email. (***@***.com)
  
• Categoría impositiva (dato requerido): selección de la condición impositiva frente al IVA de la compañía en base al país donde se esté dando de alta la compañía.
  
• Nro. Identificación (dato requerido): CUIT de la compañía. Requerido para la correcta definición de la compañía en Fiscal Flow cuando el retailer opere integrado con este producto. Largo requerido 11 posiciones.
  
• N° Agente Percepción IIBB (dato requerido): número de inscripción como agente de Percepción. Largo requerido 11 posiciones.
  
• Rubro (dato requerido); Rubro de la compañía.
  
• Descripción: Descripción o datos adicionales de la compañía. 
  
• ¿Activo?: Informa el estado de la compañía. Por defecto el check estará tildado.
  

Opciones de instalación: 

• Protocolo (dato requerido): protocolo en Bridge Manager Central. Combo desplegable con las opciones http o https.
• Host/IP (dato requerido): Host/Ip de la máquina donde se va a instalar Bridge Manager Central. Aquí deberá definirse la IP o HOST del entorno donde estará alojado el BMC, a fin de que las configuraciones post instalación queden correctamente definidas al momento de que una tienda se instale y conecte al BMC.
• Directorio de instalación (dato requerido): Directorio donde se instalará Bridge Manager Central.
• Ubicación de la JVM (dato requerido) Directorio donde se encuentra instalado Java (se deberá incluir el directorio bin).
• Puerto sobre el cual se va a instalar el BMC (dato requerido): puerto donde se Instalará Bridge Manager Central. Combo desplegable con las opciones de puerto disponibles.

• scripts.zip: Directorio donde se encuentra el archivo scripts.zip propios del proyecto.
• certificados.zip: Directorio donde se encuentra el el certificado. Este campo se deberá completar de manera obligatoria en caso de seleccionar el protocolo https. En caso de seleccionar el protocolo http esta campo se encontrará deshabilitado.

Configuración de la base de datos:

• Host/IP (dato requerido): Host/Ip del servidor de MongoDB.
• Puerto (dato requerido): Puerto de la base de datos. 
• Nombre (dato requerido): Nombre de la base de datos a generar durante la instalación del BMC.
  
• Usuario (dato requerido): Usuario de la base de datos con permisos para crear la base de datos.
• Contraseña (requerido): Contraseña del usuario de base de datos.
• Método de autenticación (dato requerido): selección del tipo de autenticación contra la base de  datos, pudiendo elegir entre USER_PASSWORD y LDAP.

Al presionar el botón Guardar, Director ejecutará los servicios de creación de compañía en Promo Vtol y Fiscal Flow (en base a los productos que se hayan seleccionado para integración), tomando la configuración de los entornos definidos en la sección Configuración > "Productos" y en base a la información ingresada en la solapa de Información General. 

Al guardar, se solicitara una confirmación de inicio del proceso con el siguiente mensaje: “¿Desea continuar con la creación de Compañías? Esta acción creara una compañía en PROMO, FISCAL FLOW, VTOL y DIRECTOR con los datos aquí declarados.” (En base a los productos que se hayan seleccionado para integración). Al presionar en OK, se continuará con el proceso de creación de compañías, caso contrario, de presionarse Cancelar, se volverá a la pantalla de crear compañía sin guardar ningún cambio.

5.1.2 Edición de compañías

Para modificar una compañía en particular previamente cargada, se debe presionar el botón "Opciones > Editar".
En el formulario de edición, se mostrarán los datos cargados y se podrán modificar sus propiedades. Sin embargo, los siguientes valores no podrán ser editados:

Información general:

• País
• Código de compañía
• Usuario administrador
• Contraseña

Opciones de instalación

• Todos los campos podrán ser editados, al guardar los cambios estos se verán reflejados en el .properties de instalación del BMC.

Configuración de base de datos

• Todos los campos podrán ser editados, al guardar los cambios estos se verán reflejados en el .properties de instalación del BMC.

5.1.3 Detalle de compañías

Para visualizar el detalle y estado de las compañías dadas de alta en los diferentes productos de la Suite Napse se debe presionar el botón "Opciones > Detalle".

Se podrá visualizar

• El listado de productos Napse.
• El log en caso de ocurrir un error durante la creación de la compañía en alguno de los productos Napse.
• El estado de creación. En caso de que el alta de la compañía haya sido exitosa se mostrará un icono verde , en caso de error en la ejecución de los servicios en todos los productos, se mostrará un icono rojo y en caso de que el error se haya presentado solo en alguno de ellos se mostrara en naranja.
• En caso de ocurrir algún error, el la columna de Acciones se contará con el icono de reintento, el cual podrá volver a ejecutarse luego de corregido el error reportado.

5.1.4 Descargar .Properties de compañía

Para descargar el archivo .properties con los parámetros a definidos en el formulario de alta de compañías, se debe presionar el botón "Opciones > Descargar .Properties".

Este archivo deberá ser utilizado al momento de instalar Bridge Manager Central.

5.1.5 Registros de auditoría de compañía

Para acceder al listado del histórico de cambios de la compañía, se debe presionar el botón "Opciones > Auditoría".

Se visualizará la siguiente información:

• Fecha
• Usuario
• Nivel
• Acción

Al acceder a la opción Detalle se puede ver la información original y la modificada, identificándose en forma resaltada los datos modificados.

5.2 Divisiones Operativas

Una división operativa es una agrupación o una segmentación de tiendas.

La estructura de agrupación es abierta y determinable por el usuario: por región geográfica, por tipo de local, etc.

Acceso:

Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Divisiones Operativas" dentro de "Negocio" (Negocio > Divisiones Operativas).

Descripción de la página:

A través de esta página, será posible efectuar el alta, consulta y edición de las divisiones operativas que se manejarán en el sistema, como así también la visualización de las tiendas que se encuentran asociadas a las mismas.

5.2.1 Alta de división operativa.

Para crear una nueva división operativa, desde la pantalla de gestión de divisiones operativas, presionar en el botón Nuevo.

Se informará el código de compañía en la cual se encuentra logueado el usuario, sin posibilidad de edición, y se deberán ingresar los siguientes campos:

• Código: obligatorio y único
• Nombre: obligatorio

Presionar el botón Guardar para finalizar la creación de la división operativa o Volver para regresar a la pantalla de gestión de divisiones operativas.

5.2.2 Modificación de divisiones operativas

Para modificar una división operativa se debe presionar el botón "Opciones> Editar" correspondiente a la división operativa en cuestión.

En el formulario de edición, se mostrarán los datos cargados y se podrá modificar únicamente el nombre de la división operativa.

5.2.3 Registros de auditoría de división operativa

Para acceder al listado del histórico de cambios de la división operativa, se debe presionar el botón "Opciones > Auditoría".

Se visualizará la siguiente información:

• Fecha
• Usuario
• Nivel
• Acción

Al acceder a la opción "Detalle" se puede ver la información original y la modificada, identificándose en forma resaltada los datos modificados.

5.3 Tiendas

Una tienda o un local es un establecimiento físico o virtual que posee terminales para poder efectuar transacciones.

Las Tiendas pueden pertenecer o no a una división operativa en particular, pero siempre pertenecerán a una compañía preexistente.

Acceso:

Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Tiendas" dentro de "Negocio" (Negocio > Tiendas).

Descripción de la página:

A través de esta página es posible efectuar el alta, consulta, edición y eliminación de las tiendas que se manejarán en el sistema.

5.3.1 Alta de tienda

Una vez dada el alta la compañía en los diferentes productos de la Suite Napse, se deberá crear la/las tiendas asociadas a dicha compañía.

Para crear una tienda se deberá presionar en Nuevo ante lo cual se presentará un formulario de alta dividido en diferentes solapas.

Información general:

En esta sección se solicitaran los datos referentes al alta de Tienda  en los productos de la suite Napse (Promo, Vtol, Fiscal Flow), como así también información común entre los productos como ser el código y nombre.

• Compañía: se mostrará precargado el código de compañía a la cual pertenecerá la Tienda a crear, sin posibilidad de edición.
• Código (dato requerido): código de la tienda  a generar en todos los productos de la Suite Napse. El código es único, al guardar el formulario se validara que no haya creada otra tienda con el mismo código. En caso de que el código de la tienda  se encuentre ya definido, se presentará el mensaje de que no se pudo crear la tienda por estar el código duplicado.
  
• Nombre (dato requerido): nombre de la tienda en Director y en los productos de la Suite Napse por servicio.
  
• País: se autocompletará con el país al que pertenece la compañía de la que dependerá la tienda. El campo no podrá modificarse.
• Provincia (dato requerido): provincia de la Tienda. El campo mostrará el catálogo de provincias en base al país seleccionado.
  
• Ciudad (dato requerido): ciudad de la Tienda. El campo mostrará el catálogo de ciudades en base a la provincia seleccionada.
  
• Comuna: en caso de aplicar, en base al país, provincia y ciudad seleccionados se listarán las comunas.
• Dirección (dato requerido): dirección legal de la Tienda.
• Email (dato requerido): email de la Tienda. Aquí se validará que los datos ingresados tengan formato de email. (***@***.com)
  
• División Operativa: sección a la que pertenecerá la tienda a generar dentro de las categorizaciones de Director.
  
• ¿Activo?: informa el estado de la Tienda. Por defecto el check estará tildado.

Opciones de instalación: 

• Protocolo (dato requerido): protocolo en Bridge Manager Central. Combo desplegable con las opciones http o https.
• Host/IP (dato requerido): Host/Ip de la máquina donde se va a instalar Bridge Manager Tienda. Aquí deberá definirse la IP o HOST del entorno donde estará alojado el BMT, a fin de que, las configuraciones post instalación, queden correctamente definidas al momento de que un punto de ventas se instale y conecte al BMT.
  
• Directorio de instalación (dato requerido): directorio donde se instalará Bridge Manager Tienda.
• Ubicación de la JVM (dato requerido): directorio donde se encuentra instalado Java (se deberá incluir el directorio bin).
• Puerto sobre el cual se va a instalar el BMT (dato requerido): puerto donde se Instalará Bridge Manager Tienda. Combo desplegable con las opciones de puerto disponibles.
  

• scripts.zip: directorio donde se encuentra el archivo scripts.zip propios del proyecto.

Configuración de la base de datos:

• Host/IP (dato requerido): identificación del servidor de instalación de la terminal. Valor por defecto: 127.0.0.1
  
• Puerto (dato requerido): puerto donde se encuentra la base de datos de la terminal. Por defecto es el puerto 27017.
• Nombre (dato requerido): identificador de la base de datos de la terminal. Se utiliza para crear una base nueva al realizar la instalación. No debe existir una base previa con este nombre. Campo texto, requerido. Valor por defecto: Bridge.
• Usuario (dato requerido): usuario con que se conectará a la base de datos. Valor por defecto admin.
• Contraseña (dato requerido): contraseña de acceso a la base de datos.
• Método de autenticación: forma de autenticación del usuario en la base de datos.

Al presionar el botón Guardar, Director ejecutará los servicios de creación de la Tienda en Promo, Vtol y Fiscal Flow (en base a los productos asociados a la compañía a la que pertenecerá la tienda a generar).

Al guardar, se solicitará una confirmación de inicio del proceso con el siguiente mensaje: “¿Desea continuar con la creación de la Tienda? Esta acción creara una Tienda en PROMO, FISCAL FLOW, VTOL y DIRECTOR con los datos aquí declarados.” (En base a los productos asociados a la compañía a la que pertenecerá la tienda a generar). Al presionar en OK, se continuará con el proceso de creación de Tiendas, caso contrario, de presionarse "Cancelar", se volverá a la pantalla de crear tienda sin guardar ningún cambio.

5.3.2 Edición de Tienda

Para modificar una Tienda en particular previamente cargada, se debe presionar el botón "Opciones > Editar".
En el formulario de edición, se mostrarán los datos cargados y se podrán modificar sus propiedades. Sin embargo, los siguientes valores no podrán ser editados:

Información general

• Compañía
• Código
• País

Opciones de instalación

• Todos los campos podrán ser editados, al guardar los cambios estos se verán reflejados en el .properties de instalación del BMT.

Configuración de la base de datos

• Todos los campos podrán ser editados, al guardar los cambios estos se verán reflejados en el .properties de instalación del BMT.

5.3.3 Detalle de tienda

Para visualizar el detalle y estado de las Tiendas dadas de alta en los diferentes productos Napse, se debe presionar el botón "Opciones> Editar" correspondiente a la tienda en cuestión.

Se podrá visualizar

• El listado de productos Napse.
• El log en caso de ocurrir un error durante la creación de la tienda en alguno de los productos Napse.
• El estado de creación. En caso de que el alta de la Tienda haya sido exitosa se mostrará un icono verde , en caso de error en la ejecución de los servicios en todos los productos, se mostrará un icono rojo y en caso de que el error se haya presentado solo en alguno de ellos se mostrara en naranja.
• En caso de ocurrir algún error, el la columna de Acciones se contará con el icono de reintento .

5.3.4 Descargar .properties de la tienda

Para descargar el archivo .properties con los parámetros a definidos en el formulario de alta de tienda, se debe presionar el botón "Opciones > Descargar .Properties".

Este archivo deberá ser utilizado al momento de instalar Bridge Manager Tienda.

5.3.6 Registros de auditoría de tienda

Para acceder al listado del histórico de cambios de la tienda, se debe presionar el botón "Opciones > Auditoría".

Se visualizará la siguiente información:

• Fecha
• Usuario
• Nivel
• Acción

Al acceder a la opción Detalle se puede ver la información original y la modificada, identificándose en forma resaltada los datos modificados.

5.4 Categorías

Se considera categoría al agrupador de una o más terminales que pertenecen a una misma tienda. 

Acceso:

Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Categorías" dentro de "Negocio" (Negocio > Categorías).

Descripción de la página:

A través de esta página, será posible efectuar el alta, consulta y edición de las categorías que se manejan en el sistema, como así también la visualización del conjunto de cajas que se encuentran asociadas a una nueva categoría específica. 

5.4.1 Alta de categorías.

Para crear una nueva categoría, desde la pantalla de Gestión de categorías, presionar en el botón "Nuevo".

Se informará el código de compañía en la cual se encuentra logueado el usuario, sin posibilidad de edición, y se deberán ingresar los siguientes campos:

• Código: obligatorio y único
• Nombre: obligatorio

Presionar el botón Guardar para finalizar la creación de la categoría o Volver para regresar a la pantalla de gestión de categorías.

5.4.2 Modificación de categorías

Para modificar una categoría se debe presionar el botón "Opciones> Editar" correspondiente a la división operativa en cuestión.

En el formulario de edición, se mostrarán los datos cargados y se podrá modificar únicamente el nombre de la categoría.

5.4.3 Registro de auditoría de categoría

Para acceder al listado del histórico de cambios de la división operativa, se debe presionar el botón "Opciones > Auditoría".

Se visualizará la siguiente información:

• Fecha
• Usuario
• Nivel
• Acción

Al acceder a la opción "Detalle" se puede ver la información original y la modificada, identificándose en forma resaltada los datos modificados.

5.5 Terminales

Se considera Terminal a la unidad lógica que representa una caja física.

Una vez dada el alta la Tienda en los diferentes productos de la Suite Napse, se deberán crear las Terminales asociadas a dicha Tienda. 

Acceso:

Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Terminales" dentro de "Negocio" (Negocio > Terminales).

Descripción de la página:

A través de esta página será posible efectuar el alta, consulta y edición de las Terminales que se manejan en el sistema.

5.5.1 Alta de terminal

Una vez dada la tienda en los diferentes productos de la Suite Napse, se deberá crear la/las terminales asociadas a dicha tienda.

Para crear una terminal se deberá presionar en Nuevo ante lo cual se presentará un formulario de alta dividido en diferentes solapas.

Información general:

Esta información es utilizada para la confección de los servicios de alta de terminales en Promo, Vtol y Fiscal Flow, como así también información común entre los productos como ser el código y  nombre.

• Compañía: se mostrará precargado el código de compañía pertenece la terminal que se esta dando de alta, sin posibilidad de edición.
• Tienda (Nombre) (dato requerido): se deberá selecciona el nombre de la Tienda a la que pertenecerá la Terminal.
• Código de Terminal (dato requerido): código único de Terminal en Director, Promo, Vtol, Fiscal Flow y Bridge. Campo numérico y no acepta como valor "0" (cero).

• Nombre de Terminal (dato requerido):  nombre identificatorio de Terminal en Director, Promo, Vtol, Fiscal Flow y Bridge. 
• Usuario terminal: usuario para el login en BridgePOS.
• Contraseña: contraseña para el login en BridgePOS.
• Tipo de punto de venta: se deberá seleccionar el tipo de punto de venta a instalar, pudiendo seleccionar entre Tienda (defecto), Self Order, Supermercado, playa, Verificador de precios, Self Scan, Self CheckOut,
• Modo Cuadrado: determinará la forma de la pantalla del pos operador al momento de iniciar. Define la resolución cuadrada o wide de la pantalla del punto de ventas.
• ¿Ejecuta el POS en pantalla completa?: indicará si el POS se inicia como pantalla completa o en modo ventana. Las opciones disponibles son: "Pantalla Completa" (defecto) y "Modo Ventana".
• ¿Utiliza emuladores en los dispositivos?: podrá indicarse aquí si el punto de venta opera con emuladores de dispositivos, o bien si se deben configurar los dispositivos con los que operará el punto de ventas.
• Categoría (código): se considera categoría al agrupador de una o más terminales que pertenecen a una misma tienda. Campo combo que se cargara con lo definido en Director desde las opciones de menú Negocio > Categorías.
• ¿Activo?: Indicará si la terminal a generar estará activa o no. Por defecto se encontrará activa.

Opciones de instalación: 

• Opera en Modo Offline: Permite realizar operaciones en la terminal sin tener conexión a Bridge Manager Tienda. De indicar NO, deberá de indicarse la ruta, puerto y nombre de la base de datos online de la tienda (en la solapa de "Configuración de la base de datos") y en caso de no tener conexión el pos no podrá ser operado. 
• Directorio de instalación: indicar el directorio en que se desee ubicar los archivos de la instalación. Puede ser un directorio nuevo o uno existente. El directorio de instalación del POS debe ser distinto al que se seleccionó para la instalación del BM. De esta forma, si para la instalación de BM se seleccionó c:\napse\bridge, se recomienda seleccionar ahora c:\napse\pos. La carpeta debe estar vacía o no existir para evitar conflictos en la instalación.
• Ubicación de la JVM: se debe configurar el directorio en el cual se encuentra instalada la máquina virtual de Java (INCLUYENDO el directorio bin dentro del directorio a configurar). Por ejemplo: C:\Program Files\Java\jre1.8.0_351\bin.
• Puerto sobre el cual se va a instalar Bridge Api: por defecto será el puerto 10000.
• clietPOS.zip: Este archivo contiene imágenes y recursos para un cliente en particular. La ruta a definir aquí no debe incluir \clientPos.zip (Ejemplo C:\users\admin\documents).
• Ingrese el puerto para el pinpad: por defecto será el puerto COM9. En caso se que la compañía no se encuentre integrada con Vtol, este campo se encontrará deshabilitado.
• Seleccione el driver del pinpad: se deberá indicar el modelo de driver para el pinpad. En caso se que la compañía no se encuentre integrada con Vtol, este campo se encontrará deshabilitado.

Configuración de la base de datos:

• Host/Ip: dirección IP del servidor de base de datos o el nombre del host (localhost en caso que resida en el mismo servidor). Valor por defecto: 127.0.0.1
  
• Puerto: puerto donde se encuentra la base de datos. Por defecto es el puerto 27017
• Nombre: identificador de la base de datos. Se utiliza para crear una base nueva al realizar la instalación. No debe existir una base previa con este nombre. Valor por defecto: bridgeOffline
• Usuario: usuario con que se conectara a la base de datos. Valor por defecto admin.
• Contraseña: contraseña de acceso a la base de datos. El campo estará vacío por default.
• Método de autenticación: forma de autenticación del usuario en la base de datos. Valores a mostrar: "Usuario y Contraseña" y "LDAP".

Al presionar el botón Guardar, Director ejecutará los servicios de creación de la terminal en Promo, Vtol y Fiscal Flow (en base a los productos asociados a la compañía a la que pertenecerá la terminal a generar).

Al guardar, se solicitará una confirmación de inicio del proceso con el siguiente mensaje: “¿Desea continuar con la creación de la terminal? Esta acción creará una terminal en PROMO, FISCAL FLOW, VTOL y DIRECTOR con los datos aquí declarados.” (En base a los productos asociados a la compañía a la que pertenecerá la terminal a generar). Al presionar en OK, se continuará con el proceso de creación de la terminal, caso contrario, de presionarse "Cancelar", se volverá a la pantalla de crear la terminal sin guardar ningún cambio.

5.5.2 Edición de terminal

Para modificar una terminal se debe presionar el botón "Opciones> Editar" correspondiente a la terminal en cuestión.

En el formulario de edición, se mostrarán los datos cargados y se podrán modificar sus propiedades. Sin embargo, el código de compañía y de terminal no podrán ser editado.

Información general

Opciones de Instalación

• Todos los campos podrán ser editados, al guardar los cambios estos se verán reflejados en el .properties de instalación del punto de ventas.

Configuración de la base de datos

• Todos los campos podrán ser editados, al guardar los cambios estos se verán reflejados en el .properties de instalación del punto de ventas.

5.5.3 Productos de la terminal

Para acceder al detalle de los productos que tiente instalados la terminal y conocer el estado de los mismos, se debe presionar el "Opciones >Productos de la terminal".

5.5.4 Detalle de terminales

Para visualizar el detalle y estado de las terminales dadas de alta en los diferentes productos de la Suite Napse, se debe presionar el botón "Opciones > Detalle".

Se podrá visualizar

• El listado de productos Napse.
• El log en caso de ocurrir un error durante la creación de la Terminal en alguno de los productos Napse.
• El estado de creación. En caso de que el alta de la Terminal haya sido exitosa se mostrará un icono verde , en caso de error en la ejecución de los servicios en todos los productos, se mostrará un icono rojo  y en caso de que el error se haya presentado solo en alguno de ellos se mostrara en naranja. 
• En caso de ocurrir algún error, el la columna de Acciones se contará con el icono de reintento .

5.5.5 Descargar .Properties de terminales

Para descargar el archivo .properties con los parámetros a definidos en el formulario de alta de terminales, se debe presionar el botón "Opciones > Descargar .Properties".

Este archivo deberá ser utilizado al momento de instalar Bridge POS.

5.5.6 Registros de auditoría de terminal

Para acceder al listado del histórico de cambios de la terminal, se debe presionar el botón "Opciones > Auditoría".

Se visualizará la siguiente información:

• Fecha
• Usuario
• Nivel
• Acción

Al acceder a la opción "Detalle" se puede ver la información original y la modificada, identificándose en forma resaltada los datos modificados.

6 Monitoreo

6.1 Monitoreo de Versiones

Las versiones de los productos que están instaladas en los terminales se podrán controlar y actualizar de forma centralizada.
El proceso de actualización de versiones de productos consta de dos etapas:

• Descarga: descarga en la terminal la versión disponible de un producto.
• Instalación: con la descarga finalizada de archivos correspondientes a la versión y disponibles en la terminal, se efectúa la instalación automática.

Cada uno de los pasos de la actualización en cada terminal es ejecutado e informado por el componente Director Agent.
Ambas etapas de actualización se realizan bajo demanda desde la pantalla de "Monitoreo de Versiones" de Director.

Acceso:
Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Monitoreo de Versiones" dentro de "Monitoreo" (Monitoreo > Monitoreo de Versiones).

Descripción de la página:

En esta página, se logran ejecutar los procesos de descarga e instalación de versiones.
En la cuadrilla se logra visualizar todas las terminales con sus productos instalados, conocer la versión que poseen y la versión que tienen descargada para actualizar el producto, como así también si poseen una tarea asignada a la terminal (tanto de descarga como de instalación).
Además, se informa el estado de la terminal (activo o desconectada) y el estado del producto que se ejecuta en la terminal (en funcionamiento o detenido).

6.1.1 Búsqueda

Los filtros ofrecidos para monitorear las versiones instaladas en las terminales son los siguientes:

• Producto (obligatorio)
• División operativa
• Tienda
• Categoría
• Terminal
• Actual
• Descargada
• Ultimo estado (mayor)
• Ultima tarea
  • Con error
  • Sin error
• Versión de agente

Presionar el ícono de Buscar para que la búsqueda se lleve adelante. Al hacer esto, en la tabla se mostrará como resultado las terminales por tienda y por producto.

6.1.2 Descarga de versión

El proceso de descarga permite que en una terminal se descargue remotamente desde un repositorio central una versión seleccionada por el usuario para posteriormente efectuar el proceso de instalación de la versión descargada.

Para descargar una versión a una o más terminales, se debe tildar la/las mismas y luego presionar el botón de “Descargar”, donde se mostrará un diálogo con un resumen de la cantidad de terminales seleccionadas y una lista de versiones disponibles para descargar a las terminales seleccionadas con el objetivo de que el usuario pueda confirmar la acción deseada.

Adicionalmente se le pedirá que indique las opciones de planificación

• indicando fecha y hora
• o bien que la descarga se haga ni bien la terminal se reporte al servidor

Por último se le pedirá al usuario que ingrese un comentario (obligatorio) asociado a la acción de descarga y que generará un registro de auditoria en el sistema.

Una vez finalizada la descarga de la versión en la/las terminales a la hora y fecha programada, se mostrará en la columna "Estado" la leyenda Disponible y en la columna "Descargada" el código de versión actualizado.

El paso siguiente es generar la instalación de la versión descargada en la terminal.

6.1.3 Instalación de versión

Una vez realizado exitosamente el proceso de descarga, se procede a ejecutar también de forma remota la instalación de la versión en la terminal.

Para actualizar una o más terminales se deben tildar y presionar el botón "Instalar".

Se abrirá un diálogo con un resumen de de la cantidad de terminales seleccionadas, un agrupamiento de cantidades de terminales que se instalarán X versión y un comentario obligatorio.

A diferencia de la descarga, el proceso de Instalación se ejecutará tan pronto el agente (componente cliente de la solución Director) se reporte al servidor. El agente ejecutará una serie de pasos y los informará a Director Server para que sea mostrado en la pantalla.

Finalizada la etapa de instalación, se informará en la columna "Estado" la leyenda Disponible, en la columna "Actual" la versión instalada.

7. Administración

7.1 Ejecución de procesos

Acceso:

Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Ejecución de procesos" dentro de "Administración" (Administración > Ejecución de procesos).

Descripción de la página:

A través de esta página es posible conocer el detalle de cada ejecución de cada proceso, pudiendo filtrar por estado o proceso:

El listado de ejecuciones de procesos brinda la siguiente información:

• Estado: OK u Error.
• Nombre: nombre identificador del proceso. Para ver el listado completo de procesos consultar la sección "Estado de procesos".
• Notas: en el caso de haber finalizado el proceso con un error, permite ver su descripción.
• Fecha U. Actualización: fecha de última ejecución del proceso.

7.2 Estado de procesos

Acceso:

Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Estado de procesos" dentro de "Administración" (Administración > Estado de procesos).

Descripción de la página:

A través de esta página es posible ver el listado completo de procesos del sistema.

El listado de procesos brinda la siguiente información:

• Estado:
  
  • Running: actualmente siendo ejecutado.
  • Ready: lista para ser ejecutado.
  • Stopped: proceso detenido.
• Nombre

• U. Actualización: fecha de última ejecución.

7.2.1 Cambiar Estado

Esta opción permite detener un proceso listo para ser ejecutado (Ready => Stopped) o activar un proceso detenido (Stopped => Ready).

7.2.2 Ejecutar

Esta opción ejecuta el proceso seleccionado

7.3 Alertas Generadas

Acceso:

Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Alertas generadas" dentro de "Administración" (Administración > Alertas Generadas).

Descripción de la página:

7.4 Logs Servidor

Acceso:

Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Logs Servidor" dentro de "Administración" (Administración > Logs Servidor).

Descripción de la página:

Desde esta sección se permite acceder al log del servidor. Esta información es importante para poder identificar la causa de los errores que puedan ocurrir en el servidor.

El log del servidor se registra por año, Fecha, Hora y Tipo, como muestra la siguiente imagen.

Se podrá distinguir 2 tipos de log:

• info
• error

7.4.1 Descargar 

Se cuenta con la funcionalidad de poder descargar los archivos de log, a través del boto "Descargar" que aparece sobre cada log listado.

7.5 Auditoría

Acceso:

Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Auditoría" dentro de "Administración" (Administración > Auditoría).

Descripción de la página: 

La aplicación registra constantemente la información de las acciones realizadas sobre las distintas entidades que contiene, identificando el usuario que realizó dicha acción y la fecha.

Desde esta página es posible realizar una búsqueda de las acciones efectuadas por medio de la consola de administración, filtrando por:

Para ello se deben completar los filtros deseados y luego presionar el botón "Buscar".

En el listado de registros de auditoría se puede consultar la siguiente información:

• Acción:
  
  • LOGIN
  • CREATE: entidad creada.
  • UPDATE: entidad modificada.
  • DELETE: entidad eliminada.
• Entidad:
  • Compañía
  • Plantilla
  • Procesos
  • Terminal
  • Tienda
  • Unidad de negocio
  • Usuario
• Usuario
• Código de compañía
• Nivel
• Fecha

7.5.1 Ver detalle de acción auditada

Para ver el detalle de una acción auditada se debe presionar el botón "Detalle" correspondiente al registro en cuestión.

8. Configuración 

8.1 Configuración

Acceso:

Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Configuración" dentro de "Configuración" (Configuración > Configuración).

Descripción de la página:

A través de esta página se permite configurar las propiedades del sistema.

8.1.1 Opciones de Configuración

8.1.2 Búsqueda de configuración

Es posible realizar una búsqueda de las acciones efectuadas por medio de la consola de administración, filtrando por

Para ello se deben completar los filtros deseados y luego presionar el botón "Buscar".

8.1.3 Edición de configuración

Para editar la configuración presionar sobre el botón de opciones > editar. A continuación ingresar el nuevo valor y presionar guardar.

8.2 Entornos

Acceso:

Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Entornos" dentro de "Configuración" (Configuración > Entornos).

Descripción de la página:

A través de esta página se permite configurar los entornos de la suite Napse con los que se integrará Director. Al acceder a Configuración > "Entornos"  se mostrará el listado de productos dados de alta hasta el momento, en donde se observará la siguiente disposición de la información:

1. Estado: indicará el estado de la consola de producto configurada. El estado podrá ser: 
   • Activo y con conexión
   • Inactivo
   •  Activo pero sin conexión
2. Nombre: nombre único identificador del producto. El nombre deberá ser único, validándose al momento de guardar que no exista otro producto con el mismo nombre dado de alta previamente.
3. Código de Producto: código identificador del producto. El código deberá ser único, validándose al momento de guardar que no exista otro producto con el mismo código dado de alta previamente.
4. URL: dirección URL donde se encuentra el producto.
5. País: país al que pertenecerá el producto a dado de alta.
   
6. Botón Opciones: este botón desplegara la opción "Editar" desde la cual se podrá acceder al formulario de edición del producto, y a la opción "Detalle" que mostrará un resumen del producto.
   
7. Botón Nuevo: por medio de este botón podrá accederse al formulario de alta de nuevo producto.
   

Botón Opciones:

Al presionar en el botón Opciones de un producto se mostrarán las siguientes opciones:

• Editar: por medio del cual se accederá al formulario de edición de un entorno. (Ver sección Edición de Entorno)

8.2.1 Nuevo entorno

Al acceder con el super usuario asignado a Napse será posible definir nuevos entornos

La integración de productos de la suite Napse requiere que en Director se pueda definir los path  desarrollados por los productos Promo, Fiscal Flow y Vtol para la obtención de Token y para la creación de compañía tienda y terminal.

Estos datos deberán de indicarse en la sección de Configuración. (Ver Configuración > Configuración)

Se presentara el formulario de creación de nuevo producto, donde se solicitarán los siguientes datos:

• Entorno: campo combo donde podrá seleccionarse entre los productos de la suite Napse a darse de alta. Mostrará las siguientes opciones:

  • Fiscal Flow
  • Promo
  • Vtol

• Nombre (*): nombre único identificador del producto. Campo requerido.

• URL (*): Url donde se encuentra la consola del producto. Campo requerido.
• País (*): campo combo que mostrará los posibles países a los que un producto puede pertenecer. Las opciones podrán ser: "Argentina", "México", "Colombia" y "Chile".
• ¿Activo?: informa el estado del entorno. Por defecto el check estará tildado.

8.2.3 Edición de entorno 

Al presionar en la opción "Editar" se mostrará la siguiente pantalla donde podrán editarse los campos del producto seleccionado. Todos los campos podrán ser editados.

8.3 Modelos PinPad

Acceso:

Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Modelos PinPad" dentro de "Configuración" (Configuración > Modelos PinPad).

Descripción de la página:

A través de esta página se podrán configurar los modelos de pinpad, que luego deberán ser utilizados al momento de dar de alta una nueva terminal. Al acceder a Configuración > "Modelos Pinpad" se mostrará el listado de pinpad previamente generados, donde se detallara el estado, el código y el nombre de cada pinpad.

Botón Opciones:

Al presionar en el botón Opciones de un pinpad se mostrarán las siguientes opciones:

• Editar: por medio del cual se accederá al formulario de edición de un pinpad. (Ver sección Edición de pinpad)

8.3.1 Nuevo modelo de Pinpad

Al acceder con el super usuario asignado a Napse será posible definir nuevos pinpads

Al presionar en Nuevo se presentara el formulario de creación de nuevo producto, donde se solicitarán los siguientes datos:

• Código: código identificador del pinpad.  
• Valor: valor que se le asignará al parámetro pinpad.portName en el archivo .properties. El valor deberá ser único, validándose al momento de guardar que no exista otro modelo de pinpad con el mismo valor dado de alta previamente.
• Modelo: modelo de pinpad.
• ¿Activo?: informa el estado del entorno. Por defecto el check estará tildado. 

Presionar el botón "Guardar" para finalizar la creación de la categoría o "Volver" para regresar a la pantalla de gestión de categorías.

8.3.2 Modificación de categorías

Para modificar un modelo de pinpad, se debe presionar el botón "Opciones> Editar" correspondiente al modelo de pinpad en cuestión.

En el formulario de edición, se mostrarán los datos cargados y se podrá modificar únicamente el valor y el modelo.

8.4 Alertas

Acceso:

Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Alertas" dentro de "Configuración" (Configuración > Alertas).

Descripción de la página:

A través de esta página se podrán visualizar las alertas del sistema.

9. Seguridad

9.1 Usuarios

Acceso:

Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Usuarios" dentro de "Seguridad" (Seguridad > Usuarios).

Descripción de la página:

 A través de esta página es posible efectuar el alta, edición y eliminación de los usuarios que se manejarán en el Sistema, como así también cambiar la contraseña y visualizar los roles a los que se encuentra asociado el usuario.

9.1.1 Búsqueda de usuarios

Los usuarios cargados en el sistema se podrán localizar mediante los siguientes filtros:

• Usuario
• Email
• Nombre 
• Rol

Una vez completado alguno de dichos campos, se debe presionar el ícono de "Buscar" para que la búsqueda se lleve a cabo.

Al hacer esto en la tabla se mostrarán sólo aquellos usuarios que posean una coincidencia igual o parcial.

9.1.2 Alta de usuarios

Para crear un usuario, presionar el botón "Nuevo" ante lo cual se desplegará la siguiente pantalla:

Se deberán ingresar los siguientes campos:

• Usuario: obligatorio y único, no podrá ser modificado.
• Nombre y Apellido: obligatorio.
• Email: obligatorio
• Contraseña: obligatorio.
• Repetir contraseña: obligatorio
• Rol al que se asociará el usuario
• Activo: estado del producto, por defecto estará tildado que significa habilitado

Presionar botón "Guardar" para finalizar la creación del usuario o "Volver para volver a la pantalla principal.

9.1.3 Modificación de usuarios

Para modificar un usuario se debe presionar el botón "Opciones > Editar" correspondiente al usuario en cuestión.
A través de la pantalla de edición se podrá modificar las propiedades del usuario, a excepción del usuario.

Una vez efectuada las modificaciones presionar "Guardar" para guardar los cambios o "Volver" para volver a la pantalla principal.

9.1.4 Modificar contraseña de usuarios

Para modificar la contraseña de un usuario se debe presionar el botón "Acciones > Cambiar contraseña" correspondiente al usuario en cuestión.

Una vez efectuada las modificaciones presionar "Guardar" para guardar los cambios o "Volver" para volver a la pantalla principal.

En el próximo acceso del usuario, el sistema automáticamente le pedirá el ingreso de una nueva contraseña, para comenzar a operar la aplicación.

9.1.5 Registro de auditoría

Al ingresar desde el botón de "Opciones > Auditoría", se accederá al listado del histórico de cambios realizados sobre el usuario seleccionado, indicando nombre de usuario, nivel, acción y fecha.

Al acceder a la opción "Detalle" se puede ver la información original y la modificada, identificándose en forma resaltada los datos modificados.

9.2 Clientes Api

Acceso:

Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Clientes Api" dentro de "Seguridad" (Seguridad > Clientes Api).

Descripción de la página:

A través de esta página, es posible crear clientes para acceder a los servicios de la api. Cada cliente pertenece a una compañía en particular y posee un id y un Secret, el cual debe proporcionar para autenticarse.

9.2.1 Alta de Cliente Api

Para dar de alta un cliente no se requiere ningún dato. Se genera automáticamente y puede consultarse desde el listado, al ordenar por fecha de creación.

Presionar el botón "Guardar" para finalizar la creación del cliente Api o "Volver" para regresar a la pantalla de Cliente Api.

9.3 Roles

Acceso:

Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Roles" dentro de "Seguridad" (Seguridad > Roles).

Descripción de la página:

A través de esta página, se permite definir los roles de usuarios, los cuales se definen a través de un conjunto de permisos.

9.3.1 Alta de rol

Para crear un rol, presionar el botón "Nuevo" ante lo cual se desplegará un formulario en el cual se deberán completar los siguientes campos:

• Nombre: descripción del rol.
• Rol: código del rol, no podrá ser editado.
• Activo: permite activar o inactivar un rol.
• Permisos: seleccionar los permisos del listado de permisos.

Presionar el botón "Guardar" para finalizar la creación del rol o "Volver" para regresar a la pantalla de gestión de Roles.

9.3.2 Modificación de rol

Para modificar una categoría se debe presionar el botón "Editar" correspondiente a la división operativa en cuestión en cuestión.

En el formulario de edición, se mostrarán los datos cargados y se podrán modificar las propiedades del rol, a excepción del código de rol.

Una vez efectuada las modificaciones presionar "Guardar" para guardar los cambios o "Volver" para volver a la pantalla principal.

9.4 Permisos

Acceso: 

Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Permisos" dentro de "Seguridad" (Seguridad > Permisos).

Descripción de la página:

A través de esta página, se permite conocer todos los permisos disponibles en el sistema y las url afectadas por los mismos.

10. Versiones

10.1 Administración de Productos

Un producto es una solución de software instalada en las terminales de una empresa.
Director permite definir y gestionar los productos de forma única para su posterior uso en el sistema.

Acceso:
Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Administración de Productos" dentro de "Versiones" (Versiones > Administración de Productos).

Descripción de la página:

A través de esta página es posible efectuar el alta, consulta y edición de los productos que operará el retailer.

Por defecto, al realizar el alta de la compañía se darán de alta los siguientes códigos de productos:

• BManager
• FiscalFlow
• BApiT
• BApi
• BridgePOS
• EMVKITAR

10.1.1 Alta de productos

Crear en GitLab (previamente configurado) un repositorio para el nuevo producto.

Al momento de dar de alta en repositorio en gitLab se debe tener en cuenta las siguientes consideraciones:

• El Project name deberá ser el nombre de la compañía + el código del producto (respetando mayúsculas y minúsculas del código de compañía y del código de producto).
• El Project slug deberá ser exactamente igual al Project name (respetando mayúsculas y minúsculas).
• En Project URL, el usuario deberá ser root.
• El Nivel de visibilidad deberá ser público.

Una vez creado el repositorio, ya podemos crear un producto en Director Server.
Presionar el botón "Nuevo" del formulario "Administración de Productos". Se desplegará la siguiente pantalla:

Se informará el código de compañía en la cual se encuentra logueado el usuario, sin posibilidad de edición y  se deberán ingresar los siguientes campos:

• Código: obligatorio y único
• Nombre: obligatorio
• Nombre repositorio GIT: el nombre del repositorio en GIT se autocompletará con el código de la compañía y el código del producto ingresado por el usuario. El  nombre de repositorio deberá ser previamente creado en GIT.
• Descripción: detalle descriptivo opcional del producto
• Activo: estado del producto, por defecto estará tildado que significa habilitado

Presionar el botón "Guardar" para finalizar la creación del producto o "Cancelar" para regresar a la pantalla de administración de productos.
Una vez registrado el producto se generará en forma automática una versión base, la cual se utilizará como punto de partida para una futura versión que se desee instalar en una o más tiendas/terminales.

10.1.2 Modificación de productos

Para modificar un producto en particular previamente cargado, se debe presionar el botón "Opciones > Editar".

En el formulario de edición, se mostrarán los datos cargados y se podrán modificar los siguientes valores:

• Nombre
• Descripción
• Estado

Presionar "Guardar" para guardar los cambios o "Volver" para descartarlos y volver a la pantalla principal.

10.1.3 Modificación de producto Bridge POS

A partir de Director 2.0 es posible incorporar al crear un nuevo producto, la posibilidad de gestionar los archivos de personalización del punto de ventas por medio de la asociación del archivo ClientPos.Zip,

Este archivo contiene imágenes y recursos para un cliente en particular, como ser imágenes tipografías y colores propios de la marca de un cliente.

En esta sección se describe  al usuario final el  paso a paso  para la gestión y actualización del producto (BridgePos) con archivos de personalización ClientPos.zip.

Actualmente el archivo ClientPos.Zip, contiene archivos de la personalización y mantiene el look and feel del punto de venta (BridgePOS) de cada cliente.

Cuando se realiza algún desarrollo nuevo o se incorpora un Fix  sobre el POS, y la actualización del producto se gestiona desde Director, al momento de ejecutar la actualización de producto es posible indicar que se incluye en la actualización el archivo de personalización ClientPos.Zip.

El archivo ClientPos.zip es incorporado manualmente en el proceso de actualización del producto desde la consola de Director, para que al momento de que el cliente realice la actualización del punto de venta no se superponga el archivo y quede con la tipografía, colores y logos por defecto.

La gestión del ClientPos.zip solo intervendrán en procesos de actualización del punto de venta, por lo que es importante incorporarlos al crear el producto que gestionará la actualización de un punto de venta que ya opere con archivos de personalización.

Los campos de definición del archivo ClientPOs.zip solo estarán disponibles en la edición del producto y no al momento de la generación de un nuevo.

Gestión del ClientPos.zip

Para la incorporación del archivo ClientPos.zip en el proceso de actualización de un punto de ventas desde director, será necesario acceder a la consola de Director, logueándose con las credenciales de la compañía a la que pertenece el punto de ventas a actualizar.

Accediendo desde el Menú a la opción "Versiones" > "Administración de productos" se mostrara la siguiente grilla con todos los productos que al momento la compañía gestiona desde Director, y seleccionaremos el código del producto "BridgePOS", el cual administra las actualizaciones de los puntos de venta de la compañía y presionaremos en "Editar".

Accederemos al formulario de "Crear / Editar producto". Aquí encontraremos los datos de definición del producto, y se mostrara al pie de la pantalla las opciones para la gestión del ClientPos.zip en el proceso de actualización del producto.

Los campos disponibles son:

• Ya se adjuntaron imágenes y recursos particulares para el cliente: este campo quedará tildado y sin posibilidad de edición una vez se haya guardado de manera correcta el archivo clienPos.zip. En caso de que el producto aun no tenga asociado un archivo clientPos.zip el check estará destildado y sin posibilidad de edición.
  
• Choose File: permite adjuntar el archivo   ClientPos.Zip, que contiene las imágenes de personalización del punto de ventas de un cliente.
  
• Importar: Permite importar el paquete actualizador con las imágenes de personalización del punto de ventas de un cliente.

Cuando se requiera realizar una actualización del producto BridgePOS, ya sea por la incorporación de nuevas funcionalidades o por correcciones de fix, se ejecutarán los pasos de actualización de producto descritos en el capítulo 10.2 Administración de Versiones del manual.

10.2 Administración de Versiones

Los productos evolucionan en forma de versiones para otorgar nuevas funcionalidades.
Con Director, las versiones de los productos se alojan en un repositorio central para luego ser distribuidas en todas las terminales de un retail de manera remota.

Acceso:
Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Administración de Versiones" dentro de "Versiones" (Versiones > Administración de Versiones).

Descripción de la página:

A través de esta página es posible efectuar el alta, consulta y edición de las versiones de los productos registrados en el sistema.

10.2.1 Búsqueda de versiones

Las versiones cargadas en el sistema se pueden localizar mediante los siguientes filtros:

• Nombre del producto
• Código de la versión

Una vez completado alguno de dichos campos, se debe presionar el ícono de "Buscar" para que la búsqueda se lleve a cabo y se puedan visualizar los registros que posean una coincidencia igual o parcial.

10.2.2 Alta de versiones

Para crear una versión de un producto, presionar el botón "Nuevo" del formulario "Administración de Versiones". Se desplegará la siguiente pantalla:

Se informará el código de compañía en la cual se encuentra logueado el usuario, sin posibilidad de edición, y  se deberán ingresar los siguientes campos:

• Código: obligatorio y único
• Descripción: detalle descriptivo opcional de la versión
• Producto
• Versión anterior: Versión (Código) de la cual hereda la nueva versión
• Activo: estado del producto, por defecto estará tildado que significa habilitado
• Backup base de datos: permite realizar un backup automático de la base de datos
• Seleccionar versión: el archivo a adjuntar debe ser formato zip y contener la versión del producto con la siguiente estructura de directorios:

• Importar: presionar en el botón importar para importar la versión.

Una vez cargado y validado el archivo, se informarán los cambios que se efectuaron en el repositorio tras la carga de una nueva versión.

Presionar el botón "Aceptar" para continuar.
Finalmente, presionar "Guardar" para registrar la versión en el sistema o "Volver" para volver a la pantalla de administración de versiones.

11. Actualización masiva de agentes

11.1 Descripción

A través de Director se pueden descargar y actualizar versiones de aplicaciones. Este proceso se lleva a cabo gracias a la interacción entre un componente cliente llamado "agente", desplegado en cada terminal que posee software actualizable, y el componente servidor o Director Server. No obstante, para actualizar el agente en sí, no es posible hacerlo de la misma manera que se hace con una aplicación. Sin embargo, la solución posee un mecanismo para distribuir los binarios de los agentes en toda la cadena, por ejemplo cuando:

• Se agregan nuevas funcionalidades
• Se corrigen issues
• Hay algún binario queda corrupto
• Etc.

11.2 ¿Cómo funciona?

Cuando inicia el agente, antes de iniciar la aplicación, le consulta al Director Server si sus binarios son los mismos que él tiene, utilizando para ello un número de versión.

Si dicha versión es la misma, el proceso continúa con el inicio normal.

Si no son iguales, se hace una comparación entre lo que tiene el cliente/agente y lo que tiene el servidor. Con éste delta, se hace la transferencia automática de las diferencias, la cuales son aplicadas en el cliente para luego, si continuar con el proceso normal de inicio

11.3 ¿Cómo se activa?

Para activar ésta funcionalidad se debe crear una carpeta en el servidor donde se ejecuta Director Server que contenga todos los binarios del Agente.

Por ejemplo:

Luego crear un archivo de texto llamado "update.config" que contenga la siguiente propiedad

Donde N es un número incremental que se debe incrementar cada vez que se haya introducido algún cambio a dicha carpeta (agregar, renombrar o quitar archivos)

Una vez creada, ingresar a la consola de administración de Director Server e ir a la sección "Configuración → Configuración". Luego buscar la propiedad "Directorio raíz de actualizaciones del agente". Dicha propiedad debe indicar el directorio creado en el paso anterior, donde se encuentran los binarios del agente que se quieren sincronizar.

11.4 ¿Cómo evidenciar el funcionamiento?

Realizada la configuración de los pasos anteriores, al iniciar cada agente, notará que se logea así con la siguiente explicación:

11.5 ¿Cómo desplegar una versión nueva?

Para desplegar una versión nueva se debe

1. agregar/reemplazar/eliminar los archivos deseados de la carpeta "monitoreada" por Director Server (propiedad "Directorio raíz de actualizaciones del agente")
2. abrir el archivo "update.config" de dicho directorio
3. incrementar el valor de la propiedad "application.version"
4. reiniciar cada agente de la cadena