Saltar a contenido

Source 002B - WooCommerce Imagenes

Fecha: 2026-06-05

Estado: FUENTE COMPLEMENTARIA REAL DOCUMENTADA

Scope: tenant

tenant_id: alpuntodeventa

Owner: Gabi / Carlos Canu

Fuente de verdad: docs/tenants/alpuntodeventa/business-observer/sources/SOURCE-002B-WOOCOMMERCE-IMAGENES.md

1. Fuente complementaria

  • nombre funcional observado: SOURCE-002B - Imagenes de productos desde WooCommerce por SKU
  • tipo de fuente: WooCommerce API
  • dominio funcional: imagenes de producto / catalogo visual
  • estado del hallazgo: fuente complementaria real documentada

2. Evidencia encontrada

Evidencia leida:

  • scheduler descriptor tenant: C:\APV\gestor-de-negocios\backend\app\plugins\alpuntodeventa\scheduler_jobs.py
  • servicio principal: C:\APV\gestor-de-negocios\backend\app\services\catalogo_pedidos_whatsapp_sync_service.py
  • registro de tipos de conexion: C:\APV\gestor-de-negocios\backend\app\core\connections_registry.py
  • modelo del catalogo: C:\APV\gestor-de-negocios\backend\app\models\cdpw_producto.py

Hechos observados:

  • el job de APV declara una conexion woocommerce_connection con tag woo_api:woo-alpuntodeventa
  • la integracion es opcional: solo corre si la conexion puede resolverse
  • la lookup de WooCommerce se hace por SKU
  • la API consulta /wp-json/wc/v3/products
  • el request pide: id, sku, images, date_modified, date_modified_gmt
  • la imagen elegida es la featured image, priorizando position = 0
  • la conexion canonica APV para esta fuente es woo_api:woo-alpuntodeventa

3. Relacion con SKU

La relacion observada es:

SKU del producto SGC

↓

busqueda del producto en WooCommerce

↓

seleccion de featured image

↓

preparacion de metadata y archivo local para el catalogo

Conclusiones:

  • WooCommerce no aporta el SKU; lo consume como clave de cruce
  • si el SKU no coincide, no hay imagen confiable para asociar

4. Que dato aporta

La fuente complementaria aporta:

  • wc_product_id
  • wc_image_id
  • wc_image_src
  • wc_modified_at
  • wc_modified_gmt
  • image como URL publica interna del catalogo cuando la descarga local resulta bien
  • image_hash
  • image_last_checked_at
  • image_last_synced_at

Tambien hay evidencia de almacenamiento local:

  • ruta local bajo backend/_uploads/catalogo_pedidos_whatsapp/<tenant>/images
  • nombre esperado: <sku>-featured.<ext>

5. Que no aporta

No aporta de forma primaria:

  • ventas
  • precios propios
  • stock
  • costo
  • proveedor
  • categoria de negocio confiable

No debe confundirse con fuente de verdad comercial.

6. Que parte corresponde a WooCommerce

Corresponde a WooCommerce:

  • resolver producto por SKU
  • devolver la lista de imagenes
  • informar la featured image
  • informar src remota y fechas de modificacion

Corresponde al flujo interno:

  • descargar la imagen
  • guardarla localmente
  • calcular hash
  • dejar lista una URL publica interna
  • persistir metadata de sincronizacion

7. Casos de uso consumidores

Consumidores plausibles:

  • catalogo visual
  • futuras recomendaciones con contexto visual

Lectura obligatoria:

  • no confundir esta fuente con ventas, precios o stock
  • para el Business Observer, la utilidad actual es secundaria y de apoyo visual, no de verdad comercial primaria

8. Riesgos

  • imagen faltante
  • SKU no coincide
  • imagen desactualizada
  • producto WooCommerce inexistente
  • dependencia externa
  • producto presente en SGC pero ausente en WooCommerce
  • imagen remota accesible pero descarga local fallida

9. Preguntas para Gabi

  • si WooCommerce es fuente confiable de imagenes para APV
  • si el SKU coincide siempre entre SGC y WooCommerce
  • si las imagenes deben ser visibles para vendedores
  • si las imagenes se usan para La Directa o solo APV
  • si la featured image es efectivamente la imagen comercial correcta

10. Proximo paso

Pedir a Gabi confirmar:

  • si woo-alpuntodeventa es la conexion correcta y vigente
  • si el cruce por SKU se considera estable
  • si existe muestra controlada de 3 a 5 SKU con imagen esperada

La fuente puede tratarse como complementaria real documentada para imagenes, pero su vigencia comercial sigue dependiendo de la estabilidad del cruce por SKU.

11. Confirmaciones de alcance

  • no se ejecuto sync
  • no se llamo WooCommerce
  • no se llamo endpoint
  • no se ejecuto conexion real
  • no se modifico runtime
  • no se implemento codigo
  • SGC productos y WooCommerce imagenes quedaron separados