Saltar a contenido

Frontend Data Contract - La Directa Ecommerce

Fecha: 2026-06-23

Estado: CONTRATO DOCUMENTAL / DATOS DISPONIBLES PARCIALES / SIN SYNC ACTIVA

Objetivo

Definir que datos puede proveer o gobernar OpenClaw para que La Directa Front los use como contrato visual/documental hasta que existan productores, endpoints, sincronizaciones o runtime autorizados.

Datos disponibles desde SOURCE-002

OpenClaw ya documento 314 SKUs de SOURCE-002 Productos con campos utiles para frontend B2B:

Campo OpenClaw Uso frontend permitido Estado
SKU identidad visible y cruce tecnico disponible
nombre / articulo titulo de producto disponible
marca atributo, filtro, badge o ficha disponible
categoria navegacion y taxonomia disponible
subcategoria navegacion secundaria y filtros disponible
PrecioListaFinal precio publico candidate disponible, requiere confirmacion antes de runtime
Stock indicacion de disponibilidad candidate disponible, no stock absoluto de checkout
Unidades_x_Bulto unidades por bulto disponible
CantVtaMin minimo de venta disponible
CantVentaAgrupada incremento candidate disponible
PesoxUnidad informacion logistica unitaria disponible si valor valido
VolumenxUnidad informacion logistica unitaria disponible si valor valido

Campos futuros gobernados por OpenClaw

Campo futuro Owner Estado
modo_venta OpenClaw + decision comercial futuro
etiqueta_pack OpenClaw provee semantica, Front disena texto final futuro
imagenes / galeria OpenClaw gobierna matching/fuente, Front muestra futuro
pricing B2B por cliente OpenClaw futuro, bloqueado hasta SOURCE-001 y persistencia B2B
wc_customer_id -> sgc_customer_id OpenClaw futuro
sku -> wc_product_id OpenClaw futuro
flags de calidad/publicacion OpenClaw + negocio futuro

Reglas para uso frontend

  • Usar estos campos como contrato visual/documental hasta que existan productores o sync reales.
  • No inventar logica de precios.
  • No asumir stock definitivo sin fuente validada y regla de reserva.
  • No confundir bulto cerrado comercial con bulto equivalente/logistico.
  • No mostrar datos sensibles de cliente.
  • No exponer costos, margenes, proveedor ni reglas internas.
  • No implementar sincronizaciones desde el repo frontend.
  • No publicar precios B2B hasta que OpenClaw entregue decision server-side autorizada.
  • Validar minimo e incremento en backend/runtime, no solo en JavaScript.

Semantica minima para UI

Necesidad UI Dato fuente Regla
Badge bulto x N u. Unidades_x_Bulto mostrar como pack/logistica, no como obligacion comercial salvo regla aprobada
Minimo de compra CantVtaMin mostrar como condicion comercial candidate
Incremento de compra CantVentaAgrupada no forzar hasta que backend lo valide
Stock visible Stock mostrar con lenguaje prudente si no hay reserva runtime
Precio publico PrecioListaFinal mostrar como candidate solo en previews o drafts hasta confirmacion
B2B cliente SOURCE-001 + precios por lista bloquear hasta mapping y calculo seguro

Gaps que no debe resolver el frontend solo

  • imagen por SKU;
  • descripcion editorial final;
  • regla final de productos sin stock;
  • regla final de productos sin precio;
  • regla final de productos sin imagen;
  • categorias VARIOS o NO APLICA;
  • modo de venta definitivo;
  • precios B2B por cliente;
  • matching entre clientes WooCommerce y SGC;
  • metricas comerciales;
  • sync o write API.

Referencias OpenClaw

  • docs/tenants/ladirecta/ecommerce/OPENCLAW-DATA-AND-OBSERVABILITY-RESPONSE.md
  • docs/tenants/ladirecta/ecommerce/DATA-OWNERSHIP-MATRIX.md
  • docs/tenants/ladirecta/ecommerce/CROSS-PROJECT-HANDOFF-PROTOCOL.md