Zentto Migrator — Guía del técnico

Herramienta para traer los datos de un cliente desde su sistema anterior (DatQbox, SQL Server) hacia Zentto (PostgreSQL). Guía el proceso paso a paso; no requiere programar.

1. Dos formas de usarla

2. Instalación en tu PC (una sola vez)

1. Instala Node.js 20+ desde nodejs.org (botón LTS, siguiente-siguiente-finalizar).
2. Copia la carpeta del Zentto Migrator a tu PC (o git clone https://github.com/zentto-erp/zentto-migrator).
3. Listo — la primera vez que la abras, instala sola lo que falta.

3. Paso a paso

Abrir

Doble clic a Iniciar-Migrador.cmd. Se abre una ventana negra (déjala abierta) y luego el navegador.

Paso 1 — Conéctate al sistema anterior

• La herramienta busca sola los servidores SQL Server de tu PC y de la red (igual que SSMS). Elige el del cliente en Servidor.
• Si no aparece, escríbelo en "Escribir otro servidor" (ej. SERVIDOR\SQLEXPRESS o 192.168.1.10).
• Usuario y contraseña de SQL Server (normalmente sa) → Conectar.
• Elige la base del cliente (suele llamarse DatQbox) → Revisar qué se puede migrar.

Paso 2 — Revisa qué se va a traer

• Lista de cada tipo de dato con cuántos registros tiene; los recomendados vienen marcados.
• Si la base no es compatible, lo dice y no deja continuar (con el detalle de qué falta).
• Continuar.

Paso 3 — Elige a dónde van los datos

• Destino Zentto: elige el cliente/empresa de la lista (ya configurados).
• Conectar al destino → elige la empresa que recibirá los datos → ▶ Iniciar migración y confirma.

Paso 4 — Migración

• Barras de progreso por tipo de dato, en vivo. Al terminar: "Migración completada ✔".
• Si se corta: botón ↻ Reanudar donde quedó — continúa sin repetir.
• Avisos del proceso: detalles informativos (ej. un cliente borrado que se rescató como histórico). No son errores.

4. El asistente (IA)

Botón 💬 Asistente abajo a la derecha. Es un experto en migraciones que:

• Explica qué migrar, qué significa un aviso, cómo reanudar.
• Arma consultas SQL de verificación (ej. "dame un SELECT para comparar facturas origen vs destino").
• Cada consulta trae Copiar y ▶ Ejecutar (la corre contra el destino y muestra el resultado ahí mismo).
• Si una consulta modifica datos, pide confirmar antes de ejecutar (siempre con respaldo). Las de solo lectura corren directo.

Conoce los nombres reales de las tablas Zentto y el contexto de tu migración, así que sus respuestas son específicas.

5. Acceso en la versión web

Solo para el equipo Zentto, con tu correo @zentto.net:

1. Escribe tu correo → Enviarme un código.
2. Llega un código de 6 dígitos (vence en 10 min).
3. Escríbelo → Entrar. Sesión de 12 horas.

Sin contraseñas que recordar. Si tu correo no está autorizado, no recibirás código (pide a un administrador que te agregue a MIG_ALLOWED_EMAILS en Vault).

6. Preguntas frecuentes

¿Se daña algo en el sistema del cliente? No, solo lee.

Se cortó a la mitad. Vuelve a abrir, misma migración, Reanudar. No duplica.

La corrí dos veces. No se duplica: la segunda actualiza lo que ya estaba.

No aparece el servidor. Escríbelo a mano; verifica red y que SQL Server acepte conexiones.

"Base no compatible". No tiene el patrón DatQbox; la herramienta dice qué falta, pásalo al equipo.

¿A qué empresa fueron los datos? La que elegiste en el Paso 3; verifícalo con el asistente (SELECT de conteo).

7. Chuleta

1. Doble clic  → Iniciar-Migrador.cmd
2. Servidor    → elegir de la lista + usuario/clave → Conectar → elegir BD → Revisar
3. Marcar      → qué traer → Continuar
4. Destino     → elegir cliente + empresa → Iniciar migración
5. Esperar     → barras verdes = listo   (si se corta: Reanudar)
6. Verificar   → 💬 Asistente → "dame un SELECT para contar X" → Ejecutar

Cualquier duda durante el trabajo: pregúntale al 💬 Asistente, para eso está.