Fuentes de Productos
Las fuentes de productos en /integrations/product-sources te permiten conectar catálogos externos para importar y mantener sincronizados tus productos en Fenicia. Centraliza tu catálogo sin importar de dónde provengan los datos.
Plataformas Compatibles
| Plataforma | Tipo | Sincronización |
|---|---|---|
| Shopify | E-commerce | Bidireccional (productos, variantes, imágenes) |
| WooCommerce | E-commerce | Importación con sync periódico |
| API personalizada | Custom | Configuración flexible vía webhooks o polling |
Tip
Si ya tienes un canal de Shopify conectado en Fenicia, la fuente de productos se configura automáticamente. No necesitas una conexión adicional para importar el catálogo.
Conectar una Fuente
Seleccionar plataforma
En la pantalla de fuentes de productos, haz clic en "Agregar fuente" y selecciona la plataforma de origen.
Autenticar la conexión
Según la plataforma, completa el flujo de autenticación:
- Shopify: Ingresa la URL de tu tienda y autoriza vía OAuth.
- WooCommerce: Proporciona la URL del sitio, consumer key y consumer secret.
- API personalizada: Configura el endpoint, método de autenticación y formato de datos.
Configurar mapeo de campos
Asocia los campos del catálogo externo con los campos de producto en Fenicia (nombre, SKU, precio, descripción, imágenes, variantes).
Iniciar importación
Ejecuta la primera importación. Dependiendo del tamaño del catálogo, puede tomar desde segundos hasta varios minutos.
Estados de la Fuente
Cada fuente conectada muestra un estado que indica su condición actual:
| Estado | Descripción |
|---|---|
| Activa | La fuente está funcionando y sincronizando según la frecuencia configurada |
| Inactiva | La fuente está pausada; no se ejecutan sincronizaciones |
| Sincronizando | Una importación o sincronización está en progreso |
| Error | La última sincronización falló; revisa los detalles del error |
Fuentes con error
Si una fuente permanece en estado de error, verifica que las credenciales sigan siendo válidas y que el servicio externo esté disponible. Fenicia reintenta automáticamente, pero si el error persiste más de 24 horas, la fuente se desactiva.
Flujos de Importación
Importación Inicial
La primera sincronización importa todo el catálogo disponible. Durante este proceso:
- Se crean los productos en Fenicia con toda su información (nombre, descripción, precio, imágenes).
- Las variantes se importan con sus atributos (talla, color, material).
- Los SKU se validan para evitar duplicados.
Sincronización Periódica
Después de la importación inicial, la fuente sincroniza cambios de forma incremental:
- Productos nuevos: Se crean automáticamente en Fenicia.
- Productos modificados: Se actualizan los campos que cambiaron.
- Productos eliminados: Se marcan como inactivos en Fenicia (no se borran).
Sincronización Manual
En cualquier momento puedes forzar una sincronización haciendo clic en "Sincronizar ahora". Esto es útil cuando realizaste cambios en la plataforma externa y no quieres esperar al próximo ciclo automático.
Filtrado Activas/Inactivas
Usa los filtros en la parte superior para ver:
- Todas: Muestra todas las fuentes configuradas.
- Activas: Solo fuentes que están sincronizando regularmente.
- Inactivas: Fuentes pausadas o desconectadas.
Gestionar una Fuente
Desde el detalle de cada fuente puedes:
- Editar configuración: Modifica la frecuencia de sincronización, el mapeo de campos o las credenciales.
- Pausar/Reanudar: Detén temporalmente la sincronización sin perder la configuración.
- Ver historial: Consulta un registro de todas las sincronizaciones ejecutadas con su resultado.
- Eliminar: Desconecta la fuente permanentemente. Los productos ya importados permanecen en Fenicia.
Productos huérfanos
Si eliminas una fuente, los productos importados desde ella seguirán existiendo en tu catálogo de Fenicia. Puedes editarlos o eliminarlos manualmente según necesites.
Siguientes Pasos
- Fuentes de inventario para sincronizar niveles de stock desde sistemas externos.
- Canales de venta para publicar los productos importados en marketplaces.