Introducción.

¿Qué hace el asistente por ti? 

1. Verifica que tu sistema esté listo para la activación.
   
2. Detecta posibles problemas antes de que ocurran.
   
3. Te permite vincular tu historial si cambió tu número de control.
   
4. Activa los módulos seleccionados con seguimiento visual de progreso.
   
5. Revierte los cambios automáticamente si ocurre un error crítico. 
   

¿Cuándo se ejecuta el asistente?

1. Se requiere habilitar Analytics 3.0 o Autofactura 3.0 por primera vez.
   
2. Realizaste una migración desde la versión 2.0 a la 3.0.
   
3. El asistente fue cancelado previamente y la activación quedó pendiente.
   

Requisitos previos

1. Conexión a internet estable: El asistente necesita comunicarse con los servicios en la nube para verificar licencias, estatus de workspace y servicios externos.
   
2.  Licencia de Soft Restaurant vigente: Tu licencia debe estar activa y no vencida. Si está próxima a vencer, recibirás una advertencia pero podrás continuar.
   
3. Market Place configurado: Los módulos que deseas activar requieren una cuenta activa de Market Place, la cual puede ser la misma que se usó para registrar Soft Restaurant. 
   
4.  Sincronizador antiguo detenido: Si cuentas con el ‘Monitor de Servicios’ en ejecución (servicio 'SrvReportesSR' o el proceso 'ServiciosNS'), debes detenerlo antes de continuar. 
   
5. Soft Restaurant actualizado en todas las estaciones: Se recomienda que todas las estaciones tengan la misma versión para evitar errores de sincronización.
   

Si el sincronizador de la versión anterior (Monitor de Servicios) está activo, el asistente lo detectará como un error bloqueante en el paso de validaciones y deberá desinstalarse.

Vista general del asistente.

El Paso 2 (Licencias) solo aparece si seleccionas un módulo que requiere migración desde la versión 2.0. Si no aplica, el asistente salta automáticamente del Paso 1 al Paso 3. 

Paso 1: Selección de módulos

Qué verás en pantalla

1. Casilla de selección para marcar o desmarcar el módulo
   
2. Nombre del módulo (ej. Analytics, Autofactura)  
   
3. Versión instalada actualmente (o «No instalada» si es nueva) 
   
4. Versión destino a la que se actualizará (3.0) 
   
5. Indicador de migración: si el módulo proviene de una versión anterior, verás una etiqueta naranja que dice «Migración» 
   

Cómo completar este paso 

1. Revisa la lista de módulos disponibles.
   
2.  Marca la casilla de cada módulo que deseas activar.
   
3. Haz clic en «Siguiente» para continuar. 
   

Comportamiento visual 

1. Al seleccionar un módulo, la tarjeta cambia su borde a color naranja y el fondo se ilumina sutilmente.
   
2. Al pasar el cursor sobre una tarjeta, esta se resalta visualmente. 
   

Casos alternos

Paso 2: Vinculación de licencia

Este paso solo aparece si seleccionaste al menos un módulo con etiqueta de «Migración» en el Paso 1. Si no aplica, el asistente salta directamente al Paso 3 (Validaciones).

Qué verás en pantalla

Si tu número de control NO cambió

Si tu número de control SÍ cambió

1.  Marca la casilla «Tenía un número de control diferente al actual».
   
2.  Se mostrarán dos paneles lado a lado:
   
3. En el panel izquierdo, ingresa tu número de control anterior.
   
4.  Debajo del número anterior, ingresa la contraseña de ese número de control. 
   
5.  El panel derecho muestra tu número de control actual (no editable). 
   
6.  Debajo del número nuevo, ingresa la contraseña de tu número de control actual.
   
7.  Haz clic en «Siguiente» para vincular ambos números.  
   

Casos alternos

Paso 3: Validaciones preventivas

Cómo funciona

1.  Una barra de progreso con el mensaje «Ejecutando validaciones preventivas...»
   
2.  Conforme cada validación termina, aparece una tarjeta con el resultado
   
3. El nombre de la validación en curso se muestra en la barra de estado
   

Tipos de resultado

Estructura de una tarjeta de validación

1.  Indicador de estado (verde, rojo o ámbar) en el lateral izquierdo
   
2. Nombre del validador
   
3. Mensaje descriptivo que describe lo detectado
   
4. Pista de acción con sugerencia de solución (recuadro coloreado)
   
5. Botón de acción para ejecutar una corrección automática (cuando aplica) 
   
6. Detalles técnicos expandibles con información técnica (para soporte) 
   

Lista completa de validaciones

Resultados posibles del paso

Revalidación automática

Cuando ejecutas una acción correctiva (como limpiar duplicados o resolver ventas sin forma de pago), las validaciones se vuelven a ejecutar automáticamente para verificar que el problema fue resuelto. Si el error corregido era bloqueante, el sistema ejecuta las validaciones restantes que no se habían completado.

Paso 4: Activación de módulos

Importante

Una vez que inicia la activación, el botón «Anterior» se deshabilita y no puedes regresar a pasos anteriores.

Qué verás en pantalla

1.  Pendiente (gris): El módulo está en espera de ser procesado.
   
2. Activando (naranja con animación): El módulo se está activando. Verás una barra de progreso.
   
3. Exitoso (verde con palomita): El módulo se activó correctamente.
   
4. Error (rojo con X): Ocurrió un error durante la activación. Se muestra el detalle del error.
   
5. Configuración externa (ámbar): El módulo requiere configuración adicional en un sitio web.
   

Flujo normal de activación

1. El asistente procesa cada módulo en orden.
   
2. Cada módulo pasa de «Pendiente» a «Activando» con barra de progreso.
   
3. Al completarse, cambia a «Exitoso» (verde).
   
4. Cuando todos los módulos se activan correctamente, aparece: «Todos los módulos fueron activados correctamente. Presione Finalizar para continuar.»
   
5. Haz clic en «Finalizar» para cerrar el asistente y comenzar la sincronización.
   

Caso especial: Configuración de Autofactura

Instrucciones del panel de configuración 

1. Haz clic en «Abrir en navegador» para ir al wizard de configuración web de Autofactura.
   
2. Completa todos los pasos del wizard en el navegador (datos fiscales y CSD).
   
3.  Cuando veas «Configuración Finalizada» en el navegador, regresa al asistente.
   
4. Haz clic en «Configuración finalizada» para que el asistente verifique y continúe.
   

1. «Abrir en navegador» / «Reabrir en navegador»: abre la URL del wizard en tu navegador predeterminado.
   
2. «Copiar URL»: copia la URL al portapapeles para pegarla manualmente.
   
3. «Configuración finalizada»: indica que terminaste la configuración web. 
   
4. «Cancelar»: cancela la espera de configuración (Autofactura no se activará).
   

Verificación automática

El asistente verifica automáticamente cada 12 segundos si completaste la configuración en el navegador. Si se detecta que está completa, la activación continúa automáticamente. 

Caso alterno: Error durante la activación

1. La tarjeta del módulo cambia a rojo con el mensaje de error.
   
2. El proceso se detiene inmediatamente.
   
3. Aparecen dos botones en la parte superior:
   
1. «Reintentar»: intenta activar nuevamente el módulo que falló. 
   
2. «Revertir cambios»: revierte los cambios de todos los módulos ya activados.
   

Reversión de cambios (Rollback) 

1. Si confirmas, el sistema revierte los cambios y muestra: «Los cambios han sido revertidos correctamente.»
   
2. Si la reversión falla, verás un mensaje pidiendo contactar a soporte técnico.
   

Importante sobre la reversión

La reversión desactiva los módulos que ya se habían activado durante esta sesión. Esto restaura el estado previo del sistema para que puedas intentar la activación nuevamente en el futuro.

Diálogos emergentes

Resolver ventas sin forma de pago

Opciones disponibles 

Servicios no disponibles

1. «Copiar todo» : copia la lista de servicios y URLs al portapapeles (útil para soporte)
   
2. «Verificar nuevamente» : vuelve a verificar la disponibilidad de los servicios 
   

Confirmación de limpieza de duplicados

Precaución

Esta acción es irreversible. Solo se conservará la primera ocurrencia de cada registro duplicado. Si no estás seguro, consulta con soporte técnico antes de confirmar. 

Confirmación de renovación de IDs

Sincronización de catálogos

Tiempo de espera

La sincronización de catálogos puede tardar varios minutos dependiendo de la cantidad de datos. Durante este proceso verás una barra de progreso. No cierres el asistente mientras se ejecuta la sincronización. 

Confirmación de cancelación del asistente

Si haces clic en «Cancelar» en cualquier momento, el asistente te pide confirmación:

«¿Está seguro que desea cancelar el wizard? El proceso de activación no se completará.»

Si confirmas, el asistente se cierra. La próxima vez que inicies NS Sync, el asistente se mostrará nuevamente para retomar la activación.  

Solución de problemas

El asistente no aparece al iniciar NS Sync

1. Verifica que hayas seleccionado Analytics 3.0 o Autofactura 3.0 desde Market Place.
   
2. Confirma que se tiene la versión 3.5.2 o posterior de NS Sync con los ajustes de Onboarding.
   
3. Si el asistente fue completado previamente, no volverá a aparecer para los mismos módulos. 
   

El Paso 2 no aparece

1. El Paso 2 solo se muestra si seleccionaste un módulo que requiere migración.
   
2. Si no hay migración, el asistente salta directamente al Paso 3.
   

La vinculación de licencia falla

1. Verifica que el número de control y su contraseña sean correctos.
   
2. Asegúrate de tener conexión a internet.
   

Hay errores bloqueantes en las validaciones

1. Lee el mensaje y usa los botones de acción correctiva cuando estén disponibles.
   
2. Resuelve los problemas externos (como detener el sincronizador antiguo) y reintenta.
   
3. Si el problema persiste, contacta a soporte técnico con los detalles técnicos expandidos. 
   

La activación falla con error

1. Haz clic en «Reintentar» para intentar nuevamente.
   
2. Si el error persiste, haz clic en «Revertir cambios» para restaurar el estado anterior.
   

La configuración web de Autofactura no se detecta

1. Asegúrate de haber completado TODOS los pasos del wizard en el navegador.
   
2. Espera al menos 12 segundos para que la verificación automática detecte los cambios.
   
3. Si la verificación automática no funciona, haz clic en «Configuración finalizada».
   
4. Si el problema persiste, copia la URL y ábrela en otro navegador. 
   

El asistente se canceló accidentalmente

1. No te preocupes. La próxima vez que inicies NS Sync, el asistente aparecerá nuevamente.
   
2. Ningún cambio se realiza hasta el Paso 4, por lo que cancelar antes no afecta tu sistema. 
   

La sincronización de catálogos tarda mucho

1. La sincronización puede tomar varios minutos, especialmente con bases de datos grandes.
   
2. No cierres el asistente durante el proceso; la barra de progreso te indica el avance.
   
3. Si se interrumpe, puedes reintentar la validación y ejecutar la sincronización nuevamente.

Preguntas frecuentes

¿Puedo activar Analytics y Autofactura al mismo tiempo?

Sí, y es la opción recomendada si se requieren ambos módulos. En el Paso 1 puedes seleccionar ambos módulos y el asistente los activará en secuencia durante el Paso 4.

¿Qué pasa si cierro NS Sync durante la activación?

 Si cierras NS Sync durante el Paso 4, el proceso queda incompleto. Al reiniciar, el asistente detectará el estado pendiente y te permitirá retomar la activación.

¿Se pierden mis datos si algo falla?

No. Si ocurre un error durante la activación, puedes revertir los cambios para restaurar el estado anterior. Tus datos locales no se modifican. 

¿Es obligatorio vincular el número de control anterior?

Solo si tu número de control cambió. Si es el mismo, puedes dejar la casilla desmarcada en el Paso 2 y continuar.

¿Puedo ejecutar el asistente más de una vez?

El asistente solo se ejecuta cuando hay módulos pendientes de activar. Una vez completado, no volverá a aparecer para los mismos módulos. Si sólo seleccionaste un módulo, puedes ejecutar de nuevo el asistente cuando quieras activar otro módulo.

¿Qué significa la etiqueta «Migración» en un módulo?

Indica que tienes datos de una versión anterior (2.0) que serán migrados a la versión 3.0. Esto habilita el Paso 2 para que puedas vincular tu historial. 

¿Las advertencias en validaciones impiden activar?

No. Solo los errores bloqueantes (rojo) impiden continuar. Las advertencias (ámbar) te permiten avanzar, aunque se recomienda revisarlas.

¿Qué sucede después de finalizar el asistente?

Al hacer clic en «Finalizar», NS Sync inicia automáticamente el proceso de sincronización inicial para los catálogos con los módulos que acabas de activar.

¿Qué hago si la revalidación encuentra nuevos errores?

Después de corregir un problema, el sistema ejecuta las validaciones restantes. Si aparecen nuevos errores, repite el proceso: revisa el mensaje, aplica la acción correctiva y el sistema revalidará automáticamente.