Conectar Unleashed y sincronizar productos y niveles de stock
Conecta tu cuenta de Unleashed (gestión de inventario) al CRM y mantén los productos y los saldos de stock actualizados automáticamente, sin duplicar registros.
Puedes conectar tu cuenta de Unleashed al CRM. Una vez conectada, el CRM trae de Unleashed los productos (crea o actualiza un Producto) y los niveles de stock (se convierten en un ajuste en tu Inventario), manteniendo todo vinculado por el id de Unleashed. Volver a sincronizar nunca crea duplicados: actualiza el registro que ya existe.
El modelo es BYO ("trae tu propia cuenta"): usas tu propia cuenta de Unleashed y tu par de API. Nunca vemos tu API Key (solo firma las llamadas) y no hay costo de nuestra parte. La integración nace inerte: nada ocurre hasta que configures las credenciales y la actives. En esta primera fase, la sincronización es de ENTRADA (Unleashed hacia el CRM), por consulta periódica.
Requisitos
- Una cuenta de Unleashed con acceso a la API.
- Un par de API (API ID y API Key) generado en Unleashed.
- En Sellio, ser administrador (permiso de gestionar configuración) para guardar las credenciales en Configuración → Integraciones.
Paso 1: genera el API ID y la API Key en Unleashed
- En Unleashed, abre Integración y luego API (Integration, API).
- Genera/copia el API ID y la API Key. La API Key es un secreto: guárdala con cuidado, no se muestra de nuevo.
Paso 2: pega las credenciales en el CRM
- Abre Configuración → Integraciones y localiza la tarjeta "Unleashed (gestión de inventario)".
- Pega el API ID y la API Key. La API Key se guarda cifrada y nunca se muestra de vuelta.
- Opcional: indica el código de un Almacén para usar solo el saldo de ese almacén. En blanco, el CRM suma el stock de todos los almacenes.
- En "Entidades y dirección", elige si quieres traer de Unleashed los Productos y los Niveles de stock (o desactivar cada uno).
- Haz clic en "Guardar conexión" y luego en "Activar".
Paso 3: sincroniza
- Haz clic en "Sincronizar ahora" para traer los datos de Unleashed de inmediato.
- A partir de ahí, la sincronización se ejecuta sola en intervalos cortos (cada pocos minutos) para mantener el stock casi en tiempo real, además de una pasada diaria de seguridad.
- En la tarjeta, observa cómo crece el conteo de "Vínculos por entidad" a medida que los productos se vinculan.
Qué se sincroniza
- Productos: el código del producto (SKU), la descripción, el precio de venta, el costo y el estado (activo/inactivo). Si ya tienes un producto con el mismo SKU en el CRM, se reutiliza (no duplica).
- Niveles de stock: el saldo de cada producto se convierte en un ajuste en tu Inventario, dejando el saldo del CRM igual al de Unleashed. Cada ajuste queda registrado en el historial de movimientos del producto, así nada se pierde ni se sobrescribe a ciegas.
Seguridad y privacidad
La API Key se guarda cifrada y nunca se muestra. Solo se usa para firmar cada llamada (HMAC), así que el secreto no viaja por la red. La conexión nace inerte y solo sincroniza después de configurarla y activarla.
Cómo probar
- Después de guardar y activar, haz clic en "Sincronizar ahora" y espera la confirmación.
- Abre la lista de Productos y la pantalla de Inventario y verifica que los productos y los saldos de Unleashed aparecieron.
- En la tarjeta, observa cómo crece el conteo de "Vínculos por entidad".
Solución de problemas
- No sincroniza nada: confirma que la integración está "Activada" y que al menos una entidad está en "Traer de Unleashed".
- Error de credenciales al sincronizar: vuelve a ingresar el API ID y la API Key (la Key nunca vuelve del servidor, así que pégala por completo).
- El stock no aparece: el stock solo se aplica a productos que existen en el CRM. Deja también "Productos" en "Traer de Unleashed" para que los productos se creen primero, o asegúrate de que el SKU del CRM sea igual al de Unleashed.
- El saldo difiere de lo esperado: verifica si configuraste el almacén correcto (o lo dejaste en blanco para sumar todos).