Saltar a contenido

Pricing Audit 001 - APV Business Observer

Fecha: 2026-06-03

Estado: AUDITORIA DOCUMENTAL

Scope: tenant

tenant_id: alpuntodeventa

Owner auditoria: Codex / apoyo documental

1. Objetivo

Esta auditoria se realiza para determinar si la capacidad de pricing, mercado y competencia ya esta distribuida de forma suficiente dentro de la documentacion actual del Business Observer de APV, o si conviene separarla como un futuro UC006.

El objetivo no es disenar implementacion.

El objetivo es revisar evidencia documental, frontera funcional y gobierno documental antes de abrir un nuevo caso de uso.

Restricciones respetadas:

  • sin runtime
  • sin VPS
  • sin Docker
  • sin OpenClaw runtime
  • sin Portainer
  • sin NPM
  • sin SQL
  • sin APIs
  • sin IA
  • sin dashboards
  • sin tablas
  • sin agentes

2. Inventario de referencias

La auditoria relevo referencias literales y referencias conceptuales cercanas en:

  • docs/tenants/alpuntodeventa/business-observer/
  • docs/business/OPENCLAW-BUSINESS-OBSERVER.md
  • docs/PROJECT-STATE.md
  • docs/ROADMAP.md

Precio

  • Documento: UNSERVED-DEMAND.md Seccion: # 3. Registro desde vendedores Contexto: aparece precio esperado por el cliente, opcional como dato de captura comercial cuando hubo pedido no atendido.
  • Documento: UNSERVED-DEMAND.md Seccion: ## Caso 2 - Precio esperado informado por vendedor Contexto: el precio esperado se usa para entender si un sustituto o una futura reposicion siguen siendo comercialmente viables.
  • Documento: UNSERVED-DEMAND.md Seccion: # 13. Riesgos y limites Contexto: se aclara que los precios esperados pueden ser imprecisos.
  • Documento: OPENCLAW-BUSINESS-OBSERVER.md Seccion: ### Stock Contexto: el documento Core menciona precio como dato general del dominio stock, no como capacidad propia de pricing.
  • Documento: OPENCLAW-BUSINESS-OBSERVER.md Seccion: ## 8. Limites Contexto: se explicita que la primera vision del observer no debe ejecutar accion automatica sobre precios.

Competencia

  • Documento: IMPACT-AND-LEARNING.md Seccion: ## Zona Contexto: la competencia aparece como factor de contexto para entender por que una accion comercial responde mejor o peor en una zona.
  • Documento: BUSINESS-OBSERVER-AUDIT-001.md Seccion: ## A) Inteligencia de mercado y pricing Contexto: la auditoria previa ya ubica mercado, competencia y precio como frente distinto de riesgo, crecimiento y aprendizaje.

Competidor

  • No se encontraron referencias literales a competidor o competidores dentro del alcance auditado.

Margen

  • Documento: GROWTH-PLACEMENT-RULES.md Seccion: # 4. Concepto de producto prioritario Contexto: el margen aparece como una de las razones por las que direccion comercial puede empujar un producto prioritario.
  • Documento: UNSERVED-DEMAND.md Seccion: # 1. Problema de negocio Contexto: la demanda no atendida se vincula con dinero y margen que posiblemente quedaron afuera.
  • Documento: UNSERVED-DEMAND.md Seccion: ## Oportunidad economica perdida Contexto: la oportunidad perdida puede expresarse como margen potencial no generado.
  • Documento: UNSERVED-DEMAND.md Seccion: # 6. Estimacion de oportunidad economica perdida Contexto: vuelve a aparecer margen potencial no generado como parte de la estimacion.
  • Documento: UNSERVED-DEMAND.md Seccion: # 10. Preguntas que debe responder el Observer Contexto: una de las preguntas es cuanto margen estimamos que no generamos.
  • Documento: OPENCLAW-BUSINESS-OBSERVER.md Seccion: ## Resumen ejecutivo Contexto: el documento Core incluye rentabilidad como parte de la lectura general del negocio.
  • Documento: OPENCLAW-BUSINESS-OBSERVER.md Seccion: ### Vendedores Contexto: aparece margen o contribucion atribuible.
  • Documento: OPENCLAW-BUSINESS-OBSERVER.md Seccion: ### Clientes Contexto: aparece margen generado.
  • Documento: OPENCLAW-BUSINESS-OBSERVER.md Seccion: ### Marcas Contexto: aparece margen bruto estimado.
  • Documento: OPENCLAW-BUSINESS-OBSERVER.md Seccion: ### Rentabilidad Contexto: se listan margen bruto, cambios de rentabilidad y defensa de margen como parte del observer general.

Rentabilidad

  • Documento: OPENCLAW-BUSINESS-OBSERVER.md Seccion: ## Resumen ejecutivo Contexto: rentabilidad forma parte de la lectura general del observer.
  • Documento: OPENCLAW-BUSINESS-OBSERVER.md Seccion: ### Sobre vendedores Contexto: pregunta por vendedores que venden mucho con baja rentabilidad.
  • Documento: OPENCLAW-BUSINESS-OBSERVER.md Seccion: ### Sobre rentabilidad Contexto: la rentabilidad es un frente propio del documento Core.
  • Documento: OPENCLAW-BUSINESS-OBSERVER.md Seccion: ## 7. Riesgos Contexto: costos incompletos o atrasados pueden distorsionar rentabilidad.
  • Documento: OPENCLAW-BUSINESS-OBSERVER.md Seccion: ## Ejemplos APV de uso futuro Contexto: se mencionan marcas con mejor rentabilidad y lectura de margen real.

Proveedor

  • Documento: BUSINESS-OBSERVER.md Seccion: ## Que define APV Contexto: APV declara ejemplos propios de productos y proveedores.
  • Documento: BUSINESS-OBSERVER.md Seccion: ### Use Case 002 - Crecimiento y colocacion estrategica Contexto: aparecen compromisos con proveedores como parte del crecimiento.
  • Documento: BUSINESS-OBSERVER.md Seccion: ### Use Case 003 - Impacto y aprendizaje comercial Contexto: lectura por proveedor como dimension de aprendizaje.
  • Documento: BUSINESS-OBSERVER.md Seccion: ## Proximos casos posibles Contexto: se menciona lectura de impacto por proveedor.
  • Documento: DATA-NEEDS.md Seccion: ## Datos que probablemente se necesitaran Contexto: proveedores esta en el inventario preliminar de datos.
  • Documento: DECISIONS.md Seccion: ### Esto es APV Contexto: proveedor esta explicitamente ubicado en la capa tenant.
  • Documento: GROWTH-PLACEMENT.md Seccion: ## Compromisos con proveedores Contexto: crecimiento y colocacion pueden responder a objetivos o distribucion acordada con proveedores.
  • Documento: GROWTH-PLACEMENT-RULES.md Seccion: # 3. Jerarquia de prioridades Contexto: los compromisos estrategicos con proveedores son prioridad nivel 1.
  • Documento: GROWTH-PLACEMENT-RULES.md Seccion: # 10. Impacto esperado Contexto: proveedor es una de las vistas de impacto.
  • Documento: GROWTH-PLACEMENT-RULES.md Seccion: ## Caso 4 - Compromiso con proveedor Contexto: caso concreto donde la prioridad sube por compromiso formal.
  • Documento: IMPACT-AND-LEARNING.md Seccion: ## Impacto Comercial Contexto: proveedor aparece como una de las dimensiones donde puede verse el cambio asociado a una accion.
  • Documento: IMPACT-AND-LEARNING.md Seccion: ## Proveedor Contexto: se evalua con que proveedores las acciones generan mejores resultados.
  • Documento: IMPACT-AND-LEARNING.md Seccion: ## Caso 3 - Campana con proveedor Contexto: aprendizaje posterior sobre una campana acordada con proveedor.
  • Documento: UNSERVED-DEMAND.md Seccion: # 1. Problema de negocio Contexto: la demanda no atendida puede originarse por problema de proveedor y deja visibilidad sobre proveedores que no cumplen.
  • Documento: UNSERVED-DEMAND.md Seccion: # 4. Causas posibles Contexto: demora del proveedor es una causa especifica.
  • Documento: UNSERVED-DEMAND.md Seccion: # 9. Impacto por dimensiones Contexto: proveedor es una dimension de lectura de la demanda no atendida.
  • Documento: UNSERVED-DEMAND.md Seccion: # 10. Preguntas que debe responder el Observer Contexto: pregunta por el proveedor que genera mas oportunidades perdidas.
  • Documento: UNSERVED-DEMAND.md Seccion: ## Caso 3 - Causa detectada por compras Contexto: la lectura pasa a alimentar proveedor y abastecimiento.
  • Documento: UNSERVED-DEMAND.md Seccion: ## Caso 4 - Lectura ejecutiva y accion Contexto: una accion posible es revisar relacion con proveedor.

Precio esperado

  • Documento: UNSERVED-DEMAND.md Seccion: # 3. Registro desde vendedores Contexto: precio esperado por el cliente como dato opcional de captura.
  • Documento: UNSERVED-DEMAND.md Seccion: ## Caso 2 - Precio esperado informado por vendedor Contexto: aparece como referencia comercial para evaluar viabilidad.
  • Documento: UNSERVED-DEMAND.md Seccion: # 13. Riesgos y limites Contexto: se advierte que los precios esperados pueden ser imprecisos.

Precio cliente

  • No se encontraron referencias literales a precio cliente.
  • La referencia mas cercana es precio esperado por el cliente en UC004.

Precio mercado

  • No se encontraron referencias literales a precio mercado.
  • La referencia conceptual mas cercana aparece en BUSINESS-OBSERVER-AUDIT-001.md bajo Inteligencia de mercado y pricing, pero no esta desarrollada todavia en los casos activos.

Precio promocion

  • No se encontraron referencias literales a precio promocion.
  • La referencia mas cercana a dinamica promocional aparece en IMPACT-AND-LEARNING.md, donde promocion figura como tipo de accion comercial, pero no se documenta precio promocional como capacidad.

Sustitucion por precio

  • No se encontraron referencias literales a sustitucion por precio.
  • La sustitucion si aparece en UNSERVED-DEMAND.md, pero como respuesta a faltante y defensa parcial de venta, no como efecto de variacion de precio.

Equilibrio

  • No se encontraron referencias literales a equilibrio o precio de equilibrio en la documentacion actual auditada.

Descuento

  • Documento: OPENCLAW-BUSINESS-OBSERVER.md Seccion: ### Rentabilidad Contexto: los descuentos forman parte de la lectura de rentabilidad del observer Core.

Costo

  • Documento: IMPACT-AND-LEARNING.md Seccion: # 12. Metricas futuras Contexto: aparece costo comercial relativo del esfuerzo.
  • Documento: UNSERVED-DEMAND.md Seccion: ## Caso 2 - Precio esperado informado por vendedor Contexto: no hay costo literal, pero el caso ya insinua la necesidad de comparar precio esperado con reposicion futura.
  • Documento: OPENCLAW-BUSINESS-OBSERVER.md Seccion: ### Stock Contexto: costo aparece como dato general del dominio stock.
  • Documento: OPENCLAW-BUSINESS-OBSERVER.md Seccion: ### Rentabilidad Contexto: aparece costo de mercaderia.
  • Documento: OPENCLAW-BUSINESS-OBSERVER.md Seccion: ## 4. Que fuentes de datos consumiria Contexto: SGC / ERP se menciona como fuente esperada para ventas y costos.
  • Documento: OPENCLAW-BUSINESS-OBSERVER.md Seccion: ## 7. Riesgos Contexto: costos incompletos o atrasados pueden distorsionar la lectura.
  • Documento: BUSINESS-OBSERVER-AUDIT-001.md Seccion: ## A) Inteligencia de mercado y pricing Contexto: ya se anticipa necesidad de temporalidad de precio / costo / oferta.

3. Hallazgos por caso de uso

UC001

Temas de pricing detectados:

  • no hay pricing explicito como capacidad
  • solo aparece una referencia indirecta en BUSINESS-OBSERVER-AUDIT-001.md sobre relacion con compras a competencia
  • el documento Core del observer si trae rentabilidad y margen como preocupacion general, pero no como regla de UC001

Clasificacion:

  • principal: no
  • secundario: si, de forma muy marginal e indirecta

Juicio funcional:

  • precio, competencia y margen no pertenecen realmente al centro de UC001
  • UC001 debe seguir enfocado en deterioro comercial, inactividad, perdida de participacion y perdida de volumen

UC002

Temas de pricing detectados:

  • prioridad de productos por margen
  • compromisos con proveedores
  • potencial tension entre marca propia y compromiso de proveedor
  • crecimiento dentro de una marca y entre marcas

Clasificacion:

  • principal: no
  • secundario: si

Juicio funcional:

  • estas referencias pertenecen parcialmente a UC002 porque ayudan a priorizar crecimiento
  • no alcanzan para justificar que UC002 absorba pricing de mercado, competencia o equilibrio
  • UC002 necesita saber que se quiere empujar, no resolver todavia cuanto vale, contra quien compite y hasta que margen minimo conviene sostenerlo

UC003

Temas de pricing detectados:

  • competencia como factor contextual por zona
  • proveedor como dimension de impacto
  • costo comercial relativo del esfuerzo
  • promocion como tipo de accion comercial

Clasificacion:

  • principal: no
  • secundario: si

Juicio funcional:

  • estas referencias si pertenecen a UC003, pero como insumo de aprendizaje posterior
  • UC003 debe aprender si una accion funciono, no definir la politica de pricing que la origino
  • si pricing entra demasiado en UC003, el caso se vuelve una mezcla entre inteligencia comercial y memoria de acciones

UC004

Temas de pricing detectados:

  • precio esperado por el cliente
  • oportunidad economica perdida
  • margen potencial no generado
  • sustitucion
  • proveedor y abastecimiento como causas

Clasificacion:

  • principal: no para pricing integral
  • principal: si para precio esperado como senal de demanda frustrada
  • secundario: si para margen y sustitucion

Juicio funcional:

  • estas referencias si pertenecen realmente a UC004 cuando sirven para explicar por que la demanda no se atendio o cuanto impacto comercial dejo esa falla
  • no pertenece a UC004 construir una inteligencia completa de precios propios, mercado, competencia o equilibrio
  • UC004 usa pricing como evidencia contextual de una oportunidad perdida, no como objeto central de observacion

4. Riesgo de duplicacion

Conceptos repetidos

  • proveedor aparece en UC002, UC003 y UC004
  • margen aparece en UC002, UC004 y en el documento Core
  • sustitucion aparece principalmente en UC004, pero ya se la relaciona con UC001 y UC002
  • precio esperado aparece solo en UC004, pero si se abriera UC006 sin frontera clara podria duplicarse rapido

Conceptos superpuestos

  • margen puede ser prioridad de crecimiento en UC002, efecto economico en UC004 y dimension de rentabilidad en el Core
  • proveedor puede ser sujeto de compromiso comercial en UC002, sujeto de analisis de impacto en UC003 y causa de demanda no atendida en UC004
  • sustitucion puede leerse como defensa de venta, defensa de marca o cambio de mix, segun el caso

Conceptos ambiguos

  • precio esperado por el cliente no esta claro si significa precio maximo aceptable, precio historico, referencia de mercado o precio negociado deseado
  • oportunidad economica perdida hoy es correcta como estimacion comercial, pero podria confundirse con pricing si se la usa para recomendar precios
  • competencia aparece solo como contexto y no tiene todavia sujeto, fuente, fecha ni regla de lectura
  • rentabilidad esta fuerte en el documento Core, pero no tiene todavia un caso de uso tenant dedicado

5. Frontera recomendada

Que debe quedar dentro de UC001

  • deterioro comercial del cliente
  • inactividad
  • perdida de participacion
  • perdida de volumen
  • lectura de riesgo por mix solo cuando expresa perdida comercial ya ocurrida

No deberia quedar dentro de UC001:

  • comparacion sistematica de precios con mercado
  • precios de competencia
  • equilibrio
  • margen esperado como politica de precio

Que debe quedar dentro de UC002

  • crecimiento por siembra
  • ampliacion progresiva
  • prioridades por marca, producto y proveedor
  • uso de margen solo como criterio comercial de prioridad

No deberia quedar dentro de UC002:

  • inteligencia competitiva de precios
  • lectura temporal de costo viejo vs nuevo
  • precio de mercado por zona
  • politica de descuentos

Que debe quedar dentro de UC003

  • aprendizaje sobre acciones comerciales
  • impacto de promociones o campanas
  • costo comercial relativo del esfuerzo
  • aprendizaje sobre que contextos responden mejor

No deberia quedar dentro de UC003:

  • motor conceptual de pricing
  • lectura continua de competencia
  • definicion de precio de equilibrio

Que debe quedar dentro de UC004

  • precio esperado por cliente cuando hubo pedido no atendido
  • margen potencial no generado
  • sustitucion aceptada o rechazada
  • impacto economico estimado de la demanda frustrada

No deberia quedar dentro de UC004:

  • monitoreo permanente de mercado y competidores
  • recomendacion general de precios propios
  • lectura historica de precios viejos vs nuevos como capacidad transversal

Que deberia quedar exclusivamente en un futuro UC006

  • relevamientos de precio de mercado
  • relevamientos de competencia
  • temporalidad de costo, oferta y precio
  • precio viejo vs precio nuevo
  • comparacion por zona, localidad y provincia
  • lectura de elasticidad o impacto en volumen
  • lectura de impacto en rentabilidad
  • precio esperado como atributo comparado contra costo, mercado y competencia
  • margen esperado
  • precio de equilibrio

6. Pricing como capacidad

Conclusion:

  • si, pricing merece convertirse en caso de uso propio

Justificacion:

  • hoy la documentacion activa solo contiene fragmentos de pricing dispersos
  • esos fragmentos no son suficientes para gobernar mercado, competencia, precios y rentabilidad temporal
  • el tema cruza varias dimensiones con semantica propia: mercado, competencia, costo, precio, margen, volumen, zona y tiempo
  • si se deja repartido entre UC002, UC003 y UC004, aumenta mucho el riesgo de duplicacion y mezcla de objetivos
  • la auditoria previa BUSINESS-OBSERVER-AUDIT-001.md ya habia anticipado que pricing no conviene integrarlo a 001, 002 ni 003

7. Alcance potencial de UC006

Si se abre en el futuro, UC006 - Inteligencia de Mercado y Pricing deberia ser un caso de uso tenant dedicado a responder:

como debe leer APV la relacion entre costo, precio, mercado, competencia y rentabilidad para tomar mejores decisiones comerciales

Conceptualmente incluiria:

  • relevamientos de vendedores
  • fecha del relevamiento
  • fecha de compra
  • fecha de oferta
  • fecha de actualizacion de costo
  • comportamiento temporal de competidores
  • precios viejos vs nuevos
  • precio esperado por cliente
  • margen esperado
  • precio de equilibrio
  • impacto en volumen
  • impacto en rentabilidad
  • impacto por zona
  • impacto por localidad
  • impacto por provincia

Tambien deberia poder distinguir:

  • precio propio vigente
  • precio previo
  • costo vigente
  • costo previo
  • precio relevado de mercado
  • oferta puntual vs precio estable
  • competencia observada vs competencia confirmada

No deberia nacer como caso de:

  • SQL
  • formulas cerradas
  • recomendaciones automaticas
  • dashboards
  • IA

Deberia nacer primero como capacidad documental y funcional.

8. Relacion con UC004

Debe permanecer en UC004:

  • precio esperado por cliente cuando el contexto es un pedido no atendido
  • aceptacion o rechazo de sustituto
  • impacto economico perdido estimado
  • margen no generado como efecto de la demanda frustrada

Debe migrar o quedar exclusivamente en UC006:

  • comparacion sistematica entre precio esperado, costo y precio de mercado
  • seguimiento temporal de cambios de costo
  • cambios de precio propio en el tiempo
  • comportamiento de competidores
  • analisis territorial de precio
  • analisis de equilibrio y rentabilidad esperada por politica de precio

Lectura recomendada:

  • UC004 debe seguir preguntando que demanda no pude atender y que impacto estimado perdi
  • UC006 deberia preguntar que estructura de precio y mercado explica o anticipa esas oportunidades

9. Relacion con sustitucion

Conclusion:

  • por ahora la sustitucion debe seguir como capacidad transversal

Justificacion:

  • hoy afecta al menos a UC001, UC002, UC004 y a futuro UC006
  • en UC004 sirve para distinguir venta perdida total de venta parcialmente rescatada
  • en UC001 puede mostrar migracion de mix y riesgo sobre marca
  • en UC002 puede mostrar defensa o ampliacion dentro de categoria
  • en UC006 podria explicar sustitucion empujada por diferencia de precio

Cuando podria transformarse en caso propio:

  • solo si la empresa decide observar sustitucion como fenomeno central, con reglas, causas y decisiones propias mas alla de faltantes o precio

Hoy esa evidencia no aparece en la documentacion.

10. Recomendacion final

Recomendacion:

  • B) Crear UC006 despues

Justificacion:

  • la capacidad merece caso propio
  • todavia no esta madura la base documental para abrirlo como siguiente frente oficial
  • primero conviene consolidar fronteras de UC004 y evitar que el nuevo caso nazca mezclado con demanda no atendida
  • abrirlo ahora aumentaria el solapamiento con UC002, UC003 y UC004 antes de que existan definiciones mas precisas de mercado, competencia, precio esperado y equilibrio

Validacion final:

  • duplicaciones detectadas: si
  • contradicciones documentales fuertes: no se detectan contradicciones nuevas dentro del alcance auditado
  • superposicion funcional: si, especialmente entre UC004 y un futuro UC006
  • mezcla Core / Tenant: riesgo bajo, pero el Core ya concentra bastante lenguaje de rentabilidad, margen y precio general que no debe absorber reglas comerciales propias de APV

Confirmacion de gobierno:

  • esta auditoria confirma que pricing todavia no es capacidad gobernada de forma explicita en el tenant
  • tambien confirma que no conviene esconderla dentro de casos de uso ya existentes
  • por eso la recomendacion correcta es prepararla como futuro caso propio, pero no abrirla todavia