El presente diagrama representa la arquitectura general de la Suite de productos Napse. Muestra cómo los sistemas y servicios de la suite están integrados para gestionar, conectar y operar los procesos empresariales de manera eficiente. Está diseñado para ilustrar las conexiones, flujos de información y tecnologías utilizadas en cada uno de los módulos principales que conforman esta solución integral.
Principales componentes y flujos representados:
Bridge y OMNI: Responsable de la gestión de maestros y pedidos, con soporte para:
Importación de datos a través de servicios REST (JSON) para maestros y pedidos.
Consultas de pedidos en tiempo real mediante REST.
Exportación de información hacia Rabbit MQ, asegurando el intercambio eficiente de datos entre sistemas.
Promo: Gestiona promociones y catálogos. Incluye:
VTOL: Maneja integraciones mediante el protocolo TCP, enfocado en la gestión de medios de pago y servicios relacionados.
Fiscal Flow: Encargado del cumplimiento de requerimientos fiscales mediante la emisión de comprobantes electrónicos.
Prize: Administra el cálculo y la exportación de comisiones de vendedores a través de un servicio REST.
360: Ofrece una vista integral de las métricas y datos relacionados con la retención y gestión de clientes.
Director: Integra funcionalidades administrativas avanzadas y utiliza GIT como sistema de control de versiones para sus configuraciones.
Tiendas Físicas: La comunicación entre los sistemas y las tiendas físicas se realiza vía servicios REST (JSON), con autenticación segura mediante OAuth 2.0.
El objetivo de este documento es detallar la arquitectura de integración de la suite Napse, describiendo cada uno de sus módulos y la forma en que interactúan entre sí y con sistemas externos. Se proporciona un marco comprensible que puede ser utilizado por desarrolladores, arquitectos, gerentes de proyecto y otros stakeholders técnicos y de negocio. El documento está diseñado para facilitar la implementación, el soporte técnico y las futuras ampliaciones de la suite.

El diagrama presentado proporciona una vista detallada de la arquitectura de integración de la suite Napse, mostrando cómo los diferentes componentes interactúan para ofrecer un ecosistema robusto y funcional.
Cloud y On-Premise:
Bridge Central y Bridge API:
RabbitMQ:
La arquitectura de integración de la suite Napse se basa en una combinación de tecnologías modernas y estándares industriales para garantizar una comunicación eficiente, segura y escalable entre sus módulos y con sistemas externos. Los principales mecanismos de integración incluyen:
Beneficios de la Arquitectura de Integración
Este enfoque integral asegura que la suite Napse pueda integrarse fácilmente con el ecosistema tecnológico de cualquier cliente, ofreciendo una solución robusta y preparada para el futuro. |
Módulos de la Suite:
Flujos de Comunicación:
Base de Datos:
BRIDGE: PROMO |
En un entorno empresarial dinámico y conectado, la capacidad de comunicar y compartir datos de forma segura, eficiente y escalable entre diferentes sistemas es esencial. La suite Napse ha sido diseñada para soportar una integración robusta con sistemas externos, utilizando protocolos de intercambio de datos modernos y ampliamente aceptados en la industria. Estos protocolos permiten una transferencia confiable de información entre los diferentes módulos de Napse y otros sistemas, garantizando la interoperabilidad, la protección de datos y la continuidad operativa.
El enfoque de Napse hacia la integración no solo abarca la conexión de sistemas internos, sino también la interacción fluida con soluciones externas como sistemas de gestión de inventarios (ERP), plataformas de fidelización, proveedores fiscales y canales de ventas omnicanal. La arquitectura modular y basada en microservicios de Napse asegura que cada componente pueda comunicarse de manera eficiente y segura, facilitando la adopción de nuevas tecnologías y la adaptación a las cambiantes necesidades del mercado.
REST (Representational State Transfer): Es un protocolo ampliamente utilizado para la transferencia de datos entre sistemas a través de APIs RESTful. Este enfoque permite la comunicación directa y en tiempo real entre los módulos de Napse y sistemas externos.
AMQPS (Advanced Message Queuing Protocol Secure): Este protocolo se utiliza en conjunto con RabbitMQ para manejar la comunicación asíncrona mediante colas de mensajes. Es ideal para gestionar grandes volúmenes de datos y eventos que no requieren una respuesta inmediata.
Beneficios de los Protocolos Utilizados
Interoperabilidad: La adopción de estándares como REST y AMQPS permite que la suite Napse se integre fácilmente con una amplia variedad de sistemas externos, reduciendo el tiempo y costo de implementación.
Seguridad: La combinación de HTTPS y TLS garantiza la protección de los datos en tránsito, cumpliendo con estándares internacionales de seguridad.
Eficiencia y Escalabilidad: Los protocolos seleccionados permiten manejar grandes volúmenes de datos y eventos, asegurando un rendimiento óptimo incluso durante picos de demanda.
Flexibilidad y Adaptabilidad: Al soportar tanto comunicaciones sincrónicas (REST) como asíncronas (AMQPS), la suite puede adaptarse a diversas necesidades operativas y técnicas.
La versión 3.8.0.12 de VTOL Multiempresa implementa un robusto sistema de encriptación basado en el algoritmo Triple DES (3DES). Este mecanismo asegura la protección de los datos sensibles, cumpliendo con los estándares internacionales de seguridad, incluyendo las normas PCI DSS. La arquitectura criptográfica está diseñada para proteger tanto los datos en reposo como en tránsito, utilizando una jerarquía de llaves y protocolos seguros que garantizan la confidencialidad e integridad de la información.
La seguridad de VTOL se basa en una jerarquía de llaves que asegura múltiples capas de protección:
Llave fija: Esta llave está embebida en el código de la aplicación y se utiliza para encriptar la llave maestra. Su propósito es añadir una capa adicional de seguridad para proteger las claves más críticas. Evitar el acceso directo a la llave maestra incluso si el archivo master.key es comprometido.
Llave maestra: La llave maestra es la base del sistema de encriptación. Se genera automáticamente utilizando el generador de números aleatorios seguro de Java (SecureRandom), y se almacena de forma encriptada en un archivo llamado master.key.
master.key:Llave operativa: Esta llave reside en la base de datos y se utiliza para encriptar los datos sensibles. Se genera dinámicamente a partir de la llave maestra, lo que asegura que los datos permanecen protegidos incluso si las llaves operativas cambian.
El algoritmo 3DES asegura la protección de los datos mediante un cifrado de 192 bits, que aplica tres pasadas de encriptación para fortalecer la seguridad.
Base de datos: Todos los datos sensibles relacionados con transacciones, como números de tarjetas de crédito, fechas de caducidad y códigos de seguridad, se almacenan encriptados utilizando 3DES. Protege los datos en reposo frente a accesos no autorizados.
Logs de sistema: En modo normal, los logs no almacenan datos sensibles. Sin embargo, en modo DEBUG, si se capturan estos datos, siempre se encriptan para garantizar la seguridad. Permite el diagnóstico sin comprometer la confidencialidad de la información.
VTOL asegura que toda la comunicación entre sistemas se realice a través de canales cifrados, utilizando SSL/TLS o VPN.
Rotación de llaves: Las llaves de encriptación tienen una vigencia de 90 días y se rotan automáticamente para minimizar el riesgo de vulnerabilidades.
Manejo de llaves por custodios: En casos específicos, usuarios con permisos pueden administrar manualmente las llaves a través de herramientas dedicadas. Esto permite una mayor flexibilidad en la gestión criptográfica sin comprometer la seguridad.
El sistema de encriptación basado en 3DES de VTOL 3.8.0.12 proporciona una capa de seguridad robusta para proteger datos sensibles, asegurando la confidencialidad y cumpliendo con las normativas de seguridad más estrictas. La jerarquía de llaves, junto con las medidas de protección en tránsito y en reposo, posiciona a VTOL como una solución confiable y preparada para entornos empresariales de alta demanda.
Ver También: |
Con la versión 3.8.1.0, VTOL implementa el algoritmo de encriptación AES-256 (Advanced Encryption Standard), considerado uno de los estándares más seguros y ampliamente utilizados en la industria para proteger datos sensibles. Este cambio representa una mejora significativa en la seguridad de los datos, cumpliendo con normativas internacionales como PCI DSS y proporcionando una infraestructura criptográfica moderna y robusta. AES-256 asegura la protección de la información tanto en reposo como en tránsito, mediante un sistema jerárquico de llaves y herramientas avanzadas de gestión criptográfica.
El sistema de encriptación de VTOL se basa en una jerarquía de llaves que proporciona múltiples capas de protección:
Clave fija: Reside en el código fuente de la aplicación y sirve para proteger la clave maestra mediante un proceso de encriptación adicional. Agregar una capa de seguridad adicional, asegurando que incluso si se compromete el archivo master.key, la clave maestra permanezca protegida.
Clave maestra: Es el núcleo del sistema de encriptación y se utiliza para generar y proteger las claves operativas.
master.key:Clave operativa: Es utilizada directamente para encriptar los datos sensibles en la base de datos. Cada cambio en las claves operativas puede realizarse sin afectar la seguridad de la clave maestra, proporcionando una flexibilidad operativa y seguridad adicional.
El algoritmo AES-256 es reconocido por su alta seguridad, y es adoptado por gobiernos, instituciones financieras y organizaciones de todo el mundo.
La protección de datos sensibles es una prioridad en VTOL. Todos los datos críticos son encriptados antes de ser almacenados o transmitidos.
Base de datos: Los números de tarjetas, fechas de caducidad y códigos de seguridad se almacenan en tablas encriptadas utilizando AES-256. Previene accesos no autorizados a la información crítica incluso si la base de datos es comprometida.
Logs de sistema:
VTOL asegura que todos los datos transmitidos entre sus componentes y sistemas externos viajen a través de canales cifrados.
Protocolos utilizados:
Beneficios de la transmisión segura:
VTOL 3.8.1.0 introduce Cryptool, una herramienta dedicada para gestionar y renovar el material criptográfico.
Funciones principales:
Ventajas de Cryptool:
Para implementar correctamente AES-256, VTOL requiere un entorno tecnológico que cumpla con los siguientes requisitos:
La adopción de AES-256 en VTOL 3.8.1.0 establece un nuevo estándar de seguridad para proteger datos sensibles. Este sistema criptográfico, junto con herramientas como Cryptool y protocolos seguros de transmisión, asegura la confidencialidad, integridad y disponibilidad de la información, posicionando a VTOL como una solución confiable para entornos empresariales críticos.
Ver También: |
En un entorno digital cada vez más dinámico, la forma en que se estructuran, comunican y almacenan los datos es crucial para garantizar la eficiencia, la interoperabilidad y la seguridad de las operaciones empresariales. La suite Napse adopta un enfoque estándar y flexible mediante el uso del formato JSON (JavaScript Object Notation) como modelo principal para la transferencia e intercambio de datos. Este modelo es ampliamente reconocido por su simplicidad y compatibilidad con múltiples plataformas, lo que permite una integración ágil con sistemas internos y externos.
El modelo de datos utilizado por Napse ha sido diseñado para cumplir con los requisitos modernos de comunicación en tiempo real, almacenamiento estructurado y procesamiento de eventos. Desde la sincronización de inventarios hasta la interacción con sistemas de fidelización, la suite se basa en un estándar robusto que facilita el manejo de grandes volúmenes de datos de manera eficiente y segura.
En el contexto de una arquitectura basada en microservicios, como la de Napse, es fundamental que todos los componentes puedan comunicarse y operar de forma independiente sin perder consistencia en los datos. JSON no solo satisface esta necesidad, sino que también permite a los desarrolladores y equipos de TI integrar fácilmente nuevos sistemas y funcionalidades sin necesidad de reestructurar la infraestructura existente.
Además, este modelo de datos garantiza que los datos críticos puedan ser procesados, almacenados y protegidos según los más altos estándares de seguridad. Esto es especialmente importante en sectores donde la protección de la información sensible, como los datos personales y financieros, es una prioridad.
Interoperabilidad Global: El uso de JSON como formato estándar permite que la suite Napse se conecte con una amplia variedad de sistemas externos, incluyendo sistemas de gestión empresarial (ERP), plataformas de marketing, sistemas fiscales y más.
Eficiencia Operativa: La naturaleza ligera y eficiente de JSON minimiza el tiempo y los recursos necesarios para transferir y procesar datos, mejorando así el rendimiento general del sistema.
Escalabilidad y Flexibilidad: A medida que las necesidades del negocio crecen, la estructura adaptable de JSON facilita la incorporación de nuevos módulos, microservicios y sistemas externos sin afectar la estabilidad de la solución existente.
Compatibilidad con Almacenamiento y Comunicación: La integración nativa con bases de datos como MongoDB y sistemas de mensajería como RabbitMQ asegura una transición fluida de los datos entre diferentes capas del sistema.
La suite Napse utiliza JSON (JavaScript Object Notation) como su modelo de datos estándar para todas las interacciones internas y externas. Este formato de datos ha sido seleccionado debido a su capacidad de estructurar información de manera clara y su amplia adopción en la industria tecnológica.
Ventajas del Uso de JSON:
Aplicaciones de JSON en Napse:
APIs REST:
RabbitMQ (AMQPS):
Para proteger la confidencialidad y la integridad de la información, algunos tipos de datos se encriptan tanto en tránsito como en reposo:
Tipos de datos sensibles:
Métodos de encriptación:
El modelo de datos JSON, respaldado por mecanismos de comunicación robustos y prácticas avanzadas de encriptación, proporciona la base para una arquitectura sólida, segura y escalable en la suite Napse. Esta elección tecnológica no solo respalda la operatividad actual, sino que también posiciona a la suite como una solución preparada para enfrentar los desafíos y oportunidades del futuro.
Ver mas en: |
El despliegue y el control de versiones son pilares fundamentales en cualquier sistema de software moderno, especialmente en una suite como Napse, que gestiona múltiples módulos y servicios en entornos distribuidos. La capacidad de administrar versiones de manera eficiente, garantizar la calidad del código y desplegar nuevas funcionalidades sin interrupciones es esencial para mantener la continuidad operativa y la satisfacción del cliente.
La suite Napse ha implementado un proceso de despliegue robusto y un sistema de control de versiones diseñado para manejar entornos escalables, distribuidos y de alta disponibilidad. Este sistema no solo facilita la gestión del código fuente, sino que también permite la implementación de nuevas versiones en diferentes tiendas o regiones de manera centralizada, segura y controlada.
El uso de herramientas como Git, Jenkins y Director asegura una trazabilidad completa de los cambios, la automatización de pruebas y la capacidad de realizar despliegues masivos con flexibilidad y precisión. Esto garantiza que cada actualización cumpla con los estándares de calidad y se adapte a las necesidades específicas de cada cliente o entorno operativo.
Control de versiones con Git:
Git es la herramienta principal para gestionar el código fuente de la suite Napse. Permite rastrear cambios realizados en el código a lo largo del tiempo, facilitando la colaboración entre desarrolladores y asegurando que cualquier modificación pueda ser revertida si es necesario.
Automatización de pruebas con Jenkins
Control de versiones en tiendas con Director
Preparación: El proceso comienza con la planificación de la actualización en JIRA, donde se registran los cambios propuestos y se documentan en Confluence. Los desarrolladores realizan las modificaciones en una rama específica de Git, garantizando la separación de las nuevas funcionalidades respecto al código estable.
Pruebas Automatizadas: Jenkins compila el código y ejecuta pruebas unitarias automáticamente, generando reportes detallados sobre el estado de la versión. Cualquier error detectado en esta etapa se soluciona antes de proceder al despliegue.
Despliegue Inicial en Entorno de Pruebas: Una vez aprobada la versión, se despliega en un entorno de pruebas para validaciones adicionales y simulación de escenarios reales.
Despliegue en Producción: Utilizando Director, se realiza el despliegue en producción, ya sea de manera escalonada (por grupos de tiendas) o masiva (todas las tiendas simultáneamente). Durante el despliegue, se monitorean los sistemas para identificar cualquier posible incidencia en tiempo real.
Rollback (si es necesario): En caso de detectar problemas, Director permite revertir rápidamente a la versión anterior sin interrumpir las operaciones.
El sistema de despliegue y control de versiones de Napse asegura una gestión eficiente y segura de las actualizaciones del software, minimizando el impacto en las operaciones y garantizando la calidad del sistema. Este enfoque permite a las empresas beneficiarse de nuevas funcionalidades sin comprometer la estabilidad y la continuidad del negocio.
SUITE NAPSE DIRECTOR |
La solución de ventas de Napse, está diseñada para ofrecer una plataforma robusta y flexible que soporta múltiples modalidades de puntos de venta (POS). Estas modalidades permiten a las organizaciones adaptarse a diferentes contextos operativos, optimizando tanto la experiencia del cliente como la eficiencia de los procesos en tienda. Desde terminales tradicionales hasta soluciones móviles y de autoservicio, Bridge ofrece una gestión centralizada y local de los dispositivos POS, garantizando una implementación escalable y personalizable según las necesidades de cada negocio.
Terminal Tradicional: Punto de venta convencional, donde el personal de la tienda realiza las transacciones.
Self Service: El cliente selecciona productos y realiza el pedido de manera autónoma.
Self Checkout: El cliente no solo selecciona productos, sino que también procesa y paga su compra sin intervención del personal.
POS Móvil Dispositivo portátil que funciona como un punto de venta completo, ideal para ventas en movimiento o en espacios reducidos.
Configuración Centralizada: Desde Bridge Central, se pueden gestionar y actualizar todos los dispositivos POS, asegurando una uniformidad en la configuración y un control centralizado de las funcionalidades.
Adaptación Local: Cada tienda puede realizar configuraciones específicas según sus necesidades, como la personalización de menús, promociones o preferencias de idioma.
|
La suite Napse está diseñada para ser completamente agnóstica al hardware, lo que significa que su software de terminal puede operar en una amplia variedad de dispositivos y sistemas operativos sin necesidad de ajustes específicos. Esto brinda a las organizaciones una flexibilidad excepcional para elegir el hardware que mejor se adapte a sus necesidades y presupuesto.
La solución es compatible con Windows, Linux y Android, asegurando una implementación sin problemas en terminales tradicionales, dispositivos móviles y sistemas personalizados.
La suite Napse está diseñada bajo el concepto de microservicios, lo que facilita la escalabilidad horizontal y vertical de la solución, permitiendo satisfacer las crecientes demandas de negocio. Esta arquitectura modular asegura que cada componente pueda evolucionar y expandirse independientemente, sin afectar la estabilidad del sistema global.
Este diseño se centra en la modularidad, con un CORE robusto que actúa como la base del sistema. Este CORE contiene las reglas de negocio comunes y fundamentales, ofreciendo una plataforma centralizada para la configuración y gestión de procesos estándar. Sobre esta base, los plugins extensibles permiten personalizar y ampliar las funcionalidades para adaptarse a necesidades específicas de cada cliente, industria o país.
Características del CORE
Plugins Extensibles
Eventos y Acciones Escalables
La suite Napse adopta un enfoque basado en eventos para gestionar procesos de negocio y comunicación entre módulos, lo que aumenta su escalabilidad y flexibilidad.
Suscripción a Eventos del Sistema
Procesamiento de Acciones Externas
Beneficios del Enfoque Basado en Eventos
El CORE del producto y la arquitectura basada en eventos, combinados con la capacidad de extensibilidad mediante plugins, garantizan que la suite Napse pueda escalar eficientemente. Esta flexibilidad asegura que las empresas puedan personalizar y optimizar sus procesos para satisfacer las demandas dinámicas del mercado, manteniendo la integridad y el rendimiento del sistema.
Los acuerdos de nivel de servicio (SLAs) son compromisos formales que garantizan la disponibilidad y el rendimiento de la infraestructura tecnológica. En la suite Napse, los SLAs aseguran que los flujos transaccionales críticos, como las ventas, devoluciones y actualizaciones de stock, se procesen de manera eficiente y sin interrupciones. El SLA garantizado es de 99.5%, lo que asegura un alto nivel de disponibilidad del sistema.
Disponibilidad Garantizada:
Un SLA del 99.5% equivale a un tiempo máximo de inactividad de aproximadamente 3.65 horas al mes.
Requerimientos de Telecomunicaciones:
Para más detalles sobre los SLAs aplicables, consulte el siguiente enlace:
Service Level Agreements (SLA) for Online Services - Microsoft.
La suite Napse está diseñada para operar en entornos empresariales críticos que requieren alta disponibilidad y resiliencia frente a fallos. Esto se logra mediante un esquema de Disaster Recovery Plan (DRP) implementado en la infraestructura de Microsoft Azure.
Alta Disponibilidad (HA):
Disaster Recovery (DRP):
Para más detalles sobre Azure Site Recovery, consulte:
Azure Site Recovery Overview.
La flexibilidad de la arquitectura de la suite Napse permite múltiples formas de comunicación e integración con sistemas legados, asegurando que las organizaciones puedan adoptar la solución sin necesidad de reemplazar sus plataformas existentes. Este enfoque modular y adaptable permite que los sistemas legados se conecten sin fricciones a los módulos centrales de Napse, manteniendo la coherencia de los datos y la funcionalidad operativa.
Servicios REST (JSON)
Carga de Archivos CSV
Plugins Personalizados en NodeJS
|
...proceso de desarrollo de plugins.... |
El diseño flexible y modular de la suite Napse garantiza una compatibilidad óptima con sistemas legados, proporcionando métodos de integración estándar y herramientas personalizadas. Esto permite a las organizaciones aprovechar las ventajas de una plataforma moderna sin comprometer sus inversiones en infraestructura existente. La combinación de servicios REST, carga de archivos CSV y plugins personalizados asegura una integración eficiente y adaptada a las necesidades específicas de cada cliente.
La arquitectura MACH (Microservicios, API-first, Cloud-native y Headless) define un enfoque moderno y modular para el desarrollo de software empresarial. Al adoptar este modelo, la suite Napse asegura flexibilidad, escalabilidad y la capacidad de adaptarse rápidamente a las cambiantes necesidades del mercado. MACH se posiciona como un pilar fundamental en la estrategia tecnológica de Napse, garantizando que cada componente del sistema sea independiente, interoperable y optimizado para la nube.
Microservicios (Microservices): La suite Napse está compuesta por un conjunto de microservicios independientes, cada uno de los cuales se encarga de una funcionalidad específica, como la gestión de promociones, la fidelización, o el procesamiento fiscal.
API-first: Las APIs son el núcleo de la interacción entre los módulos de Napse y los sistemas externos, lo que permite una integración rápida y flexible.
Cloud-native: La suite Napse está diseñada para aprovechar al máximo las capacidades de la nube, optimizando rendimiento, disponibilidad y costos operativos.
Headless: La lógica del sistema está completamente separada de la interfaz de usuario, permitiendo que las organizaciones personalicen sus frontends según sus necesidades específicas.
Escalabilidad y Resiliencia
Integración y Flexibilidad
Eficiencia Operativa
Personalización y Experiencia de Usuario
Promociones Dinámicas (PROMO): PROMO utiliza microservicios independientes para gestionar reglas complejas de promociones, integrándose con sistemas de fidelización a través de APIs y desplegándose en la nube para una disponibilidad global.
Fiscal Flow: Este módulo, basado en microservicios y operando en la nube, garantiza el cumplimiento de normativas fiscales mediante la emisión de comprobantes electrónicos en tiempo real.
Bridge POS: El POS se adapta a diferentes modalidades (tradicional, móvil, self-service) gracias a su arquitectura headless, permitiendo interfaces específicas para cada entorno sin afectar la lógica central de negocio.
La implementación de la arquitectura MACH en la suite Napse garantiza que la solución sea moderna, robusta y preparada para las necesidades futuras del mercado. Este enfoque asegura una experiencia de usuario optimizada, integraciones fluidas y una infraestructura escalable y resiliente, posicionando a Napse como líder en soluciones de gestión comercial.
La conectividad de red es un aspecto crítico para el correcto funcionamiento de la suite Napse. Para garantizar una comunicación segura y eficiente entre los módulos del sistema, se requiere una infraestructura de red que cumpla con estándares mínimos de calidad y seguridad.
VPN Site-to-Site:
La comunicación entre los servidores centrales y las tiendas se realiza a través de una VPN Site-to-Site, que garantiza un canal seguro y cifrado para proteger la información sensible en tránsito.
Especificaciones técnicas:
Para más información sobre la configuración de VPN Site-to-Site, visite:
VPN Gateway - About VPN Gateways - Microsoft Azure.