Fuentes de Inventario

Las fuentes de inventario en /integrations/inventory-sources te permiten mantener tus niveles de stock actualizados importando datos desde sistemas externos como ERPs, WMS u otras plataformas de e-commerce.

Para Qué Sirve

Si gestionas tu inventario en un sistema externo (un ERP, un WMS o una hoja de cálculo automatizada), las fuentes de inventario te permiten reflejar esos niveles en Fenicia sin duplicar el trabajo de captura.

Los cambios de stock en el sistema externo se sincronizan a Fenicia, manteniendo tus canales de venta con información precisa y reduciendo el riesgo de sobreventa.

Tip

Las fuentes de inventario complementan las fuentes de productos. Mientras las fuentes de productos importan el catálogo (nombre, precio, imágenes), las fuentes de inventario mantienen las cantidades actualizadas.

Conectar una Fuente de Inventario

1

Agregar fuente

En la pantalla de fuentes de inventario, haz clic en "Agregar fuente" y selecciona el tipo de sistema externo.

2

Configurar conexión

Proporciona las credenciales y parámetros de conexión según el sistema:

  • API REST: Endpoint URL, token de autenticación, formato de respuesta.
  • Webhook: URL de destino en Fenicia que recibirá las actualizaciones push.
  • Archivo programado: Ubicación del archivo (FTP/SFTP) y frecuencia de lectura.
3

Mapear identificadores

Define cómo se relaciona el identificador del producto en el sistema externo (SKU, código interno) con el producto en Fenicia.

4

Ejecutar primera sincronización

Lanza la sincronización inicial para verificar que el mapeo funciona correctamente y que los niveles se actualizan como se espera.

Estados de Sincronización

Cada fuente muestra su estado de sincronización en tiempo real:

EstadoDescripción
SincronizandoLa fuente está procesando una actualización de inventario
CompletadaLa última sincronización terminó exitosamente
ErrorLa sincronización falló; verifica credenciales y disponibilidad del sistema
PendienteLa sincronización está programada pero aún no se ha ejecutado

Marca de Tiempo

Junto a cada estado verás la marca de tiempo de la última sincronización exitosa. Esto te permite verificar qué tan recientes son los datos de inventario mostrados en Fenicia.

Sincronizaciones con error

Cuando una sincronización falla, Fenicia reintenta automáticamente en intervalos crecientes (5 min, 15 min, 1 hora). Si el error persiste después de 3 reintentos, la fuente se marca como error y recibirás una notificación.

Sincronización Manual

En cualquier momento puedes forzar una sincronización inmediata:

  1. Localiza la fuente en la lista.
  2. Haz clic en el botón "Sincronizar ahora".
  3. El estado cambiará a "Sincronizando" mientras se procesa.
  4. Al completar, verás el resultado con la cantidad de productos actualizados.

Esto es útil cuando:

  • Realizaste un ajuste masivo en el sistema externo.
  • Necesitas datos actualizados antes de una venta especial.
  • Quieres verificar que la conexión funciona después de una corrección.

Monitoreo y Reportes

Cada fuente incluye un panel de monitoreo con:

  • Historial de sincronizaciones: Lista de las últimas ejecuciones con resultado, duración y registros procesados.
  • Productos actualizados: Cantidad de SKUs que tuvieron cambio de stock en la última sincronización.
  • Errores detectados: SKUs no encontrados, formatos inválidos u otros problemas.

SKUs no mapeados

Si el sistema externo envía un SKU que no existe en Fenicia, se registra como "no mapeado" en el reporte. Puedes crear el producto faltante o ajustar el mapeo para resolver estos casos.

Frecuencia de Sincronización

Configura con qué frecuencia Fenicia consulta al sistema externo:

FrecuenciaRecomendado para
Cada 5 minutosAlto volumen de ventas, riesgo de sobreventa
Cada 15 minutosVolumen medio, la mayoría de tiendas
Cada horaBajo volumen, inventario estable
ManualSolo sincroniza cuando tú lo solicitas

Siguientes Pasos