Sincronización ERP

Esta guía explica cómo usar el panel de sincronización para mantener actualizados productos, marcas, categorías y clientes.

⏱️ 10 minutos de lectura 🟡 Nivel: Intermedio Admin
💡 Qué puedes hacer desde esta pantalla
  • Configurar la conexión SQL al ERP y los jobs por entidad (categorías, marcas, productos, clientes).
  • Definir frecuencia de extracción y URL del monitor local del agente.
  • Crear claves sync_sk_ para que el agente ingeste maestros de forma segura.
  • Abrir el monitor local (puente SSO) sin volver a iniciar sesión mientras la sesión sea válida.
Seguridad (SYNC-SEC-001): Solo usuarios Administrador acceden a #/admin/sync. Al crear una clave SYNC, el secreto completo se muestra una sola vez; en el listado solo verás un prefijo enmascarado. La cadena de conexión al ERP se guarda cifrada en el servidor; el agente la obtiene con su clave activa.

Índice rápido

1) Entrar al panel de Sync ERP

  1. Ingresa con un usuario con permisos de administración.
  2. Abre el módulo de sincronización ERP.
  3. Verifica que se muestre el listado de servicios.
📸

Captura pendiente de actualización (v2): panel #/admin/sync con listado de instalaciones, claves SYNC y configuración del agente.
Referencia visual legacy retirada; la UI actual usa rutas de administración unificadas y claves sync_sk_.

2) Crear un servicio de sincronización

  1. Haz clic en Nuevo Servicio.
  2. Completa nombre, origen y destino.
  3. Guarda la configuración.
  4. Confirma que el nuevo servicio aparezca en el listado.
📸

Captura pendiente: alta de instalación sync + generación de clave API (secreto visible una sola vez).

3) Programar sincronización automática

  1. Edita el servicio que quieres programar.
  2. Activa la opción de programación.
  3. Define la frecuencia de ejecución.
  4. Guarda y valida que la configuración quede persistida.
📸

Captura pendiente: configuración de jobs por entidad (categorías, marcas, productos, clientes) y frecuencia del agente.

4) Ejecutar sync manual

  1. Selecciona el servicio a ejecutar.
  2. Haz clic en Sincronizar ahora.
  3. Espera el resultado y revisa el historial.
📸

Captura pendiente: ejecución manual desde el monitor del agente o panel admin, con historial de corridas.

5) Eliminar un servicio

  1. Ubica el servicio que ya no se utilizará.
  2. Confirma la acción de eliminación.
  3. Verifica que no aparezca en el listado.
📸

Captura pendiente: revocación de clave SYNC o baja de instalación con confirmación.

6) Qué hacer si aparece un error

  • Reintenta una sola vez para descartar un corte temporal.
  • Revisa el mensaje del historial para identificar el punto de fallo.
  • Toma una captura del error y compártela con soporte interno.
  • Incluye nombre del servicio y hora aproximada del intento.
⚠️ Recomendación operativa: si estás trabajando con pedidos en curso, completa primero las tareas urgentes y luego vuelve al módulo de sincronización.

Siguientes pasos