Introducción

Este documento tiene como propósito servir como guía integral para la instalación, configuración inicial y puesta en marcha de la suite Napse, una solución tecnológica diseñada para optimizar y unificar los procesos operativos y comerciales en empresas del segmento medio. A través de este material se detallan los pasos necesarios para una implementación exitosa de los distintos productos que componen la suite, incluyendo sus requisitos previos, configuraciones esenciales, tiempos estimados y validaciones necesarias.

La suite Napse está compuesta por múltiples aplicaciones que operan de manera integrada, algunas disponibles en modalidad cloud y otras on-Premise, en servidores propios. Su correcta instalación requiere una planificación detallada y la ejecución secuencial de diversas tareas, por lo que este documento se presenta como una herramienta de consulta clave en todo el proceso de puesta en marcha, desde el entorno base hasta las configuraciones finales de operación.

El objetivo principal de este documento es proporcionar una referencia completa que permita realizar correctamente la instalación y configuración inicial de los productos Napse. Busca facilitar el entendimiento del proceso de implementación y servir de apoyo durante cada una de sus etapas, cubriendo tanto aspectos técnicos como funcionales. Asimismo, pretende estandarizar la metodología de instalación, evitar errores comunes, y ser una fuente de consulta para todas las personas involucradas. Este material también puede utilizarse como base de capacitación o documentación interna, ya que contempla desde los requisitos de hardware y software hasta las validaciones posteriores a la instalación.

El contenido de esta guía está dirigido a una audiencia diversa. Por un lado, está pensado para colaboradores internos de Napse, incluyendo equipos de soporte, quienes deben garantizar la correcta implementación de cada componente. Por otro lado, también está destinado a áreas de proyecto que, sin tener necesariamente un perfil técnico, necesitan comprender el proceso general para poder gestionarlo y acompañarlo. Además, se incluye como referencia para partners y aliados estratégicos que deban realizar implementaciones o brindar soporte a clientes.

Arquitectura BM SMB de alto nivel

1. Pre-requisitos de instalación (Linux)

Esta sección tiene como objetivo detallar los lineamientos y pasos para la instalación de BMT y POS de Napse únicamente en el sistema Linux Ubuntu 20.04 

Pre-requisitos de hardware

• BMC, PROMO y OMNI  

1. 1. Ubuntu 20.04
   2. 64 GB memoria
   3. 256 SSD

• BMT // BME
  
  • Para Tiendas / Estaciones con hasta 3 POS (incluyendo terminales móviles), se requiere:
    • Procesador i7 o similar
    • 16 Gb de memoria RAM
    • SSD 128 Gb (capacidad para guardar el historial de un mes de actividad)

• • Para Tiendas / Estaciones con 4 a 12 POS (incluyendo terminales móviles), se requiere:
    • Procesador i7 o similar
    • 32 Gb de memoria RAM
    • SSD 256 Gb (capacidad para guardar el historial de un mes de actividad)

• • Para Tiendas / Estaciones con más de 12 POS (incluyendo terminales móviles), se requiere:
    • Procesador i7 o similar
    • 64 Gb de memoria RAM
    • SSD 512 Gb (capacidad para guardar el historial de un mes de actividad)

Instalación de pre-requisitos sobre UBUNTU 20.04

Pasos a seguir:

1. JAVA:  1 - Ubuntu - Bridge - Java 
   
2. NodeJS:  3 - Ubuntu - Bridge - NodeJS y PM2
   
   1. NodeJS 18. (64 bits) (No superior a NodeJs 20)
3. MongoDB 5: 2 - Ubuntu - Bridge - MongoDB
   
   1. Instalación: Ver:
   2. Preparando MongoDB para Promo:
      1. Ver:  Instalación MongoDB  en Manual de Instalación Promo. Y ejecutar los pasos del 2 al 6

2. Instalación - Promo 7.X (Linux)

• Instalación de Promo v7.X:  PROMO 7.8 - Manual de Instalación

3. Instalación - Director 2.0 (Linux)

Instalación de Director: Ver: DIRECTOR - Instalación Servidor (asistencia técnica de @WG)

1. Configuraciones SMB: Director - SMB - Configuración de Entornos

3.1 Declaración de Entornos en Director y Configuraciones Previas a la Creación de una Compañía

3.1 - Declaración de Entornos de la Suite Napse en Director

Previo a la creación de una compañía en Director sera necesario definir en la consola de Director los Productos de la Suite Napse que podrán integrarse con una compañía. 

Ver: DIRECTOR Multiempresas - Manual de usuario 2.X  > Entornos

3.2 - Creación de usuario y rol en la base de datos - VTOL

Antes de realizar la generación de una compañía desde Director será necesario obtener los datos de usuario y rol en base de datos de Vtol. Estos datos podrán obtenerse siguiendo los pasos especificados en el siguiente link Interno NAPSE:

• 4. Creación de usuario y rol en la base de datos  

Es necesario para terminar la configuración de conexión, declarar estos datos en la consola de Director.

Accediendo con el Super-Usuario de Director a la compañía principal, en la opcion de menú "Configuración" > "Configuración", filtrando por el tipo de configuración "Server", en el campo de búsqueda, ingresaremos "vtol"  podremos declarar los datos vtol.authenticationPassword y vtol.authenticationUser de Vtol.

3.3 - Creación de Id y Secret en FISCAL FLOW

Antes de realizar la generación de una compañía desde Director será necesario obtener los datos de Id y Secret de Fiscal Flow.

Estos datos podrán obtenerse accediendo a la consola de Fiscal Flow con el Super-Usuario de la compañía Napse, ingresando a la opcion de menú "Administración" > "Configuración".

En las configuraciones del tipo Server, filtraremos en el campo de busqueda por la palabra SMB y se nos presentaran los datos de Id y Secret necesarios para declarar luego en Director. 

Estos datos podrán obtenerse por servicio siguiendo los pasos especificados en el siguiente link:

• AR Server - Servicios SMB

Obtenidos los datos de Secret y ID de Fiscal Flow, es necesario para terminar la configuración de conexión, declarar estos datos en la consola de Director.

Accediendo con el Super-Usuario de Director a la compañía principal, en la opcion de menú "Configuración" > "Configuración", filtrando por el tipo de configuración "Server", en el campo de búsqueda, ingresaremos "fiscal flow" podremos declarar el Id y Secret editando las opciones "fiscalflow.ClientId" y "fiscalflow.ClientSecret"

3.4 - Configuración de Conexiones con Productos de la Suite Napse

Obtenidos los datos de Vtol y Fiscal Flow indicados en los pasos anteriores será necesario realizar las configuraciones correspondientes en Director para poder realizar correctamente las conexiones con los productos de la Suite Napse que se configuren para los clientes.

Desde la consola de Director, logueados con el super usuario, deberá accederse al menú "Configuración", opción Configuración y allí setear en los parametros fiscalflow.ClientId y fiscalflow.ClientSecret obtenidos desde la consola de Fiscal Flow (paso 4.2).

Así como también, configurar vtol.authenticationPassword y vtol.authenticationUser obtenidos desde Vtol (paso 4.1)

4. Creación de una nueva compañía en Director

Pasos a seguir:

• Director - SMB - Gestión de Compañías

5. Certificación de compañía en Fiscal Flow

La certificación de la compañía en Fiscal Flow es un paso esencial para aquellos clientes que han contratado la suite integrada Napse y desean operar con emisión de comprobantes fiscales a través de Fiscal Flow. Este proceso garantiza que la compañía esté correctamente registrada y validada dentro del sistema, permitiendo la gestión de facturación electrónica conforme a las normativas fiscales vigentes.

El proceso de certificación se divide en dos fases. Primero, se realiza la certificación en un ambiente de homologación, donde se verifica el correcto funcionamiento del sistema y se validan los datos de la compañía. Luego, en la etapa de producción, la configuración se ajusta en base a los requerimientos específicos y la documentación proporcionada por el cliente.

Este procedimiento es necesario únicamente para nuevos clientes que implementan la suite completa con Fiscal Flow. En caso de que el cliente no requiera la integración con este módulo, este paso puede omitirse y continuar con las siguientes configuraciones del sistema.

6. Instalación de Bridge Manager Central (Linux)

La instalación de Bridge Manager Central (BMC) es un paso fundamental en la configuración de un nuevo ambiente dentro de la suite Napse. Este proceso es necesario únicamente cuando se arma un entorno desde cero para un nuevo cliente y debe ser ejecutado por el equipo de soporte de Napse o por partners autorizados.

BMC es una instancia cloud, diseñada para garantizar alta disponibilidad y estabilidad en la gestión centralizada de tiendas y terminales. Su implementación en la nube permite a las tiendas operar con continuidad, minimizando el impacto de posibles fallos locales y asegurando una integración eficiente con otros módulos de la suite.

Dado que se trata de un componente crítico del sistema, su instalación requiere cumplir con una serie de prerrequisitos técnicos, así como contar con los archivos de configuración específicos de cada cliente, los cuales deben descargarse desde Director y validarse antes de proceder con la ejecución del instalador.

Es importante destacar que este proceso solo es necesario en la creación de nuevos ambientes. Si el objetivo es únicamente la incorporación de nuevas tiendas o terminales en un ambiente ya existente, esta sección puede omitirse y se debe continuar con los pasos correspondientes a la instalación de tiendas y POS.

Pasos a seguir:

• Descargar desde el directorio \\stsfs1\GruposPrivados\Productos\BRIDGE el paquete instalador de Bridge Manager
• Se debe descargar el archivo bridge-manager-installer-7.x-SNAPSHOT.jar
  
• Se debe contar con el archivo ant.install.properties de la compañía descargado desde Director.

7. Configuración de la consola de Vtol para realizar transacciones Crédito - Débito

VTOL es el módulo encargado de la gestión de pagos con tarjeta dentro de la suite Napse, permitiendo operar con medios de pago en línea desde el punto de venta. La configuración inicial de sincronización de medios de pago se realiza desde Bridge Manager Central, lo que establece las condiciones generales para la gestión de pagos dentro de toda la infraestructura del cliente.

Si se trata de una implementación desde cero, donde se está configurando un nuevo ambiente, deben ejecutarse todos los pasos de esta sección para garantizar la correcta integración de VTOL con los sistemas de pago.

Sin embargo, si el proceso corresponde únicamente a la instalación y apertura de una nueva tienda en un cliente que ya opera con VTOL, no es necesario realizar la sincronización inicial de medios de pago. En este caso, solo se deben ejecutar los pasos 4, 5, 6 y 7, que abarcan la gestión de terminales, la configuración de los números de comercio y la integración con el POS.

Esto asegurará que la nueva tienda pueda procesar pagos correctamente, sin necesidad de repetir configuraciones que ya fueron establecidas previamente en la instancia central de Bridge Manager.

8. Importación de maestros en Bridge

Al momento de empezar a operar con Bridge Manager necesitamos contar con datos de artículos y clientes que podrán darse de alta de forma manual o masiva. En caso de optar por el alta masiva recomendamos ver  BRIDGE - Manual de servicios de integración WSDL / XML (7.X)

9. Sincronización de catálogos Bridge - Promo

En caso de estar nuestra compañía integrada con Promo, será necesario realizar una sincronización de maestros (catálogos en Promo) a fin de compartir las mismas definiciones de elementos en Bridge y en Promo y poder así definir promociones que apliquen a los elementos presentes en Bridge. Recomendamos ver Anexo - Sincronización de catálogos Bridge - Promo para comprender el proceso de sincronización propuesto por la integración.

10. Alta de una nueva Tienda en Director

• Loguearse en Director con las credenciales (usuario, pass y compañía) definidas para la nueva compañía en la que se requiere dar de alta la tienda.   Ver: Director - SMB - Gestión de Tiendas

11. Instalación de Bridge Manager Tienda

• Descargar desde el directorio \\stsfs1\GruposPrivados\Productos\BRIDGE el paquete instalador de Bridge Manager
• Se debe descargar el archivo bridge-manager-installer-7.x-SNAPSHOT.jar
  
• Se debe contar con el archivo ant.install.properties de la Tienda descargado desde Director.

Documentacion Realcionada:

• Instalación de Bridge Manager Tienda: Ver Bridge - Instalación BMT

12. Apertura de Tienda desde Bridge Manager Tienda

Luego de instalada la Tienda, será necesario abrir el período contable a fin de que los pos que conectemos puedan operar.  Ver: Bridge - Apertura y cierre de tienda

13. Importar a Fiscal Flow los puntos de venta registrados en AFIP

La integración con Fiscal Flow es un requisito exclusivo para aquellos clientes que utilizan este sistema para la gestión y emisión de comprobantes fiscales. Como parte del proceso de instalación de una nueva tienda, es necesario verificar si el cliente opera con Fiscal Flow y, en ese caso, realizar la importación de los puntos de venta registrados en AFIP dentro de este sistema.

Este procedimiento se lleva a cabo en dos fases: primero, en un ambiente de homologación, donde se validan y prueban los puntos de venta, y posteriormente en el ambiente de producción, siguiendo las especificaciones del cliente. Es fundamental completar correctamente este proceso para garantizar que la tienda pueda emitir comprobantes fiscales sin inconvenientes.

Si el cliente no utiliza Fiscal Flow, este paso puede omitirse y se puede continuar con las siguientes etapas de configuración e instalación de la tienda y POS.

14. Creación de una nueva Terminal en Director

• Loguearse en Director con las credenciales (usuario, pass y compañía) definidas para la nueva compañía en la que se requiere dar de alta la terminal
• Ver: Director - SMB - Gestión de Terminales       

15. Instalación de Bridge POS

La instalación de Bridge POS es el último paso en la puesta en marcha de una nueva tienda dentro de la suite Napse. Este software es el encargado de gestionar el punto de venta (POS), permitiendo la realización de transacciones comerciales, la integración con medios de pago y la sincronización de datos con Bridge Manager Tienda y otros módulos del sistema.

Para garantizar una correcta instalación, es fundamental cumplir con los prerrequisitos técnicos establecidos y disponer de la configuración específica para la tienda en la que se implementará el POS. La instalación puede realizarse en entornos Windows o Linux, dependiendo de las necesidades del cliente y del hardware disponible.

Una vez instalado, Bridge POS es importante realizar una validación operativa, verificando que las transacciones se procesen correctamente y que los datos se sincronicen adecuadamente.

Este procedimiento es esencial para completar la implementación de una tienda y garantizar que el punto de venta esté listo para operar sin inconvenientes.

• Descargar desde el directorio \\stsfs1\GruposPrivados\Productos\BRIDGE
• Se debe descargar el archivo bridge-pos-installer-7.X.X.jar y el install.bat
  
• Se debe contar con el archivo ant.install.properties descargado desde Director para la instalación del pos, correspondiente a la terminal allí generada.

Documentación Relacionada:

Ver: Bridge - SMB - Instalación POS sobre Windows

Documentación de Productos y Material de Capacitación

Para facilitar la comprensión y correcta utilización de la suite Napse, es fundamental contar con material de consulta actualizado y accesible tanto para colaboradores internos, como para clientes y partners que implementan y operan la solución.

En esta sección se recopilan enlaces a la documentación oficial de los distintos productos que conforman la suite, así como recursos de capacitación que permitirán a los usuarios conocer en detalle cada funcionalidad, procedimiento de instalación y configuración, y mejores prácticas para su uso.

Este material servirá como una referencia clave para:

• Equipos de soporte e implementación de Napse, asegurando un despliegue eficiente de la solución.
• Clientes y partners, brindándoles autonomía para comprender y gestionar los productos.
• Usuarios finales que necesiten orientación sobre el uso y administración de los módulos de la suite.

A continuación, se presentan los enlaces a la documentación oficial y los recursos de capacitación disponibles.

Base de conocimiento NAPSE

• Manuales de usuario y técnicos de cada uno de los productos de la suite Napse
  • Bridge
  • Promo
  • Vtol
  • FiscalFlow
  • Prize
  • Director
  • CRM 360 

NAPSE ACADEMY:

• Material video-grafico de cada producto de la suite Napse.
  • Napse Academy - Guías de inducción
  • Napse Academy - Bridge
  • Napse Academy - OMNI
  • Napse Academy - Fiscal Flow
  • Napse Academy - Prize
  • Napse Academy - Director
  • Napse Academy - Promo
  • Napse Academy - CRM 360
  • Napse Academy - Vtol
  • Napse Academy - Workshops