UC005 - Calendario operativo e inteligencia temporal

Fecha: 2026-06-03

Estado: DEFINICION FUNCIONAL TENANT

Scope: tenant

tenant_id: alpuntodeventa

Owner: Gabi / Carlos Canu

Resumen ejecutivo

Este documento define el BUSINESS-OBSERVER-USE-CASE-005 para APV.

Su pregunta central es:

como debe leer APV el tiempo comercial real para comparar mejor, proyectar mejor y decidir mejor.

No define tecnologia, SQL, APIs, IA, dashboards, runtime ni procesos de infraestructura.

Define criterio funcional y reglas de negocio del tenant alpuntodeventa.

1. Problema de negocio

Comparar meses sin mirar cuantos dias se trabajaron realmente puede llevar a conclusiones equivocadas.

Un mes puede facturar menos en total y aun asi haber sido mejor si logro esa venta con menos dias efectivos de trabajo comercial.

Mirar solo dias calendario tampoco alcanza.

Tampoco alcanza mirar solo dias laborables teoricos o solo feriados oficiales.

APV necesita distinguir entre:

• dias calendario
• dias laborables teoricos
• feriados
• dias realmente trabajados
• dias con actividad comercial real

La razon es simple:

• no todos los dias habiles se trabajan igual
• no todos los feriados se dejan de trabajar
• no todos los dias abiertos generan actividad comercial comparable

En este contexto, la facturacion o los comprobantes emitidos pueden funcionar como evidencia practica de que ese dia existio actividad comercial real.

2. Definicion conceptual

Dia calendario

Todo dia existente en el calendario del periodo analizado, sin importar si fue laborable, feriado o dia con actividad comercial.

Dia laborable teorico

Dia que, segun el calendario laboral esperado, deberia ser potencialmente trabajable.

Feriado

Dia que el calendario oficial considera no laborable o excepcional.

Dia trabajado real

Dia en el que APV efectivamente tuvo trabajo comercial relevante segun su criterio operativo.

Dia con actividad comercial

Dia en el que existio movimiento comercial observable, aunque esa actividad no siempre refleje todo el trabajo interno realizado.

Dia con comprobantes emitidos

Dia en el que existe al menos un comprobante de venta o facturacion emitido.

Dia efectivo de venta

Dia util para medir productividad comercial real porque tuvo evidencia de venta o actividad comercial comparable.

Mes operativo real

Lectura del mes basada no solo en dias calendario, sino tambien en cuantos dias fueron efectivamente utiles para vender, atender clientes y mover negocio.

3. Regla funcional APV

Para APV, un dia puede considerarse trabajado comercialmente si existe al menos un comprobante de venta o facturacion emitido en esa fecha.

Aclaraciones obligatorias:

• esto no reemplaza controles humanos
• esto sirve como evidencia comercial
• puede haber excepciones
• la regla pertenece al tenant alpuntodeventa, no al Core
• otros tenants podrian usar otra regla

La regla se aprueba como criterio funcional inicial para documentar la capacidad temporal de APV.

No se implementa todavia.

4. Argentina / Buenos Aires

Para APV, el calendario operativo debe pensarse inicialmente para:

• Argentina
• Buenos Aires
• operacion comercial de APV

Aclaraciones:

• no se implementa todavia integracion con calendario oficial
• no se define todavia fuente tecnica
• solo se documenta la necesidad funcional

5. Indicadores que habilita

La capacidad temporal habilita lecturas mas correctas para indicadores como:

• venta neta por dia trabajado
• rentabilidad por dia trabajado
• pedidos por dia trabajado
• clientes unicos por dia trabajado
• unidades por dia trabajado
• bultos por dia trabajado
• venta por vendedor por dia trabajado
• pedidos por vendedor por dia trabajado
• clientes atendidos por vendedor por dia trabajado
• productividad por marca por dia trabajado
• productividad por SKU por dia trabajado
• productividad por zona
• productividad por supervisor
• productividad por canal

La mejora no es solo numerica.

La mejora esta en comparar sobre dias comparables y no sobre meses que tuvieron distinta cantidad de dias efectivos.

6. Productividad comercial

Esta capacidad ayuda a medir productividad real y no solo volumen total.

Ejemplo conceptual:

• Mes A factura 100
• Mes B factura 90

Si Mes A tuvo 25 dias trabajados reales y Mes B tuvo 18, la lectura cambia:

• Mes A: 4 por dia trabajado
• Mes B: 5 por dia trabajado

En ese escenario, Mes B vendio menos en total pero fue mas productivo por dia efectivo.

Sin inteligencia temporal, esa conclusion quedaria oculta.

7. Forecast / proyeccion de cierre

La capacidad temporal ayuda a proyectar con mas precision:

• cierre mensual
• venta esperada
• rentabilidad esperada
• pedidos esperados
• clientes esperados
• cumplimiento de objetivo
• alertas tempranas de desvio

Ejemplo conceptual:

Si ya se trabajaron 14 dias reales y quedan 5 dias efectivos de venta, el observer puede proyectar el cierre con mejor criterio que si solo mira cuantos dias calendario faltan para fin de mes.

8. Stock y dias de cobertura

La dimension temporal tambien mejora la lectura de stock.

Permite relacionar:

• stock disponible
• venta diaria promedio
• dias operativos de cobertura
• diferencia entre dias calendario y dias reales de venta

Ejemplo conceptual:

Si un SKU vende 20 bultos por dia trabajado y hay 100 bultos de stock, la cobertura real es de 5 dias operativos.

Eso es mas util para compras y reposicion que decir solo cuantos dias calendario faltan para el cierre del mes.

9. Relacion con UC004

UC005 complementa a UC004.

La relacion principal aparece en:

• dias sin stock
• dias efectivos sin stock
• venta perdida estimada
• oportunidad economica perdida
• unidades o bultos potencialmente no vendidos
• margen no generado

Aclaracion clave:

• no todo faltante implica venta perdida real
• debe diferenciarse oportunidad estimada de demanda confirmada

UC005 no duplica UC004.

UC004 mira la demanda no atendida y la oportunidad perdida.

UC005 aporta la lectura temporal correcta para medir mejor en que dias esa perdida fue comercialmente relevante.

10. Relacion con UC001

UC005 se conecta con UC001 porque ayuda a leer mejor la frecuencia real de compra.

Ejemplos de relacion:

• cliente sin compra durante dias efectivos de venta
• frecuencia real de compra
• alerta por 14 dias sin comprar
• diferencia conceptual entre 14 dias calendario y 14 dias operativos

Importante:

• no cambia la regla actual de 14 dias
• solo deja abierta una reflexion futura sobre temporalidad operativa

11. Relacion con UC002

UC005 se conecta con crecimiento y colocacion porque permite:

• medir avance de siembra por dia trabajado
• medir velocidad de colocacion
• comparar vendedores con distinta cantidad de dias efectivos
• proyectar cumplimiento de objetivos de colocacion

La lectura temporal mejora la justicia comparativa entre equipos, zonas y ventanas comerciales.

12. Relacion con UC003

UC005 se conecta con impacto y aprendizaje porque permite:

• medir antes, durante y despues usando dias comparables
• evitar comparar periodos desiguales
• aprender que acciones funcionan por dia trabajado

Sin esa correccion temporal, parte del aprendizaje puede quedar sesgado por meses o semanas con distinta intensidad operativa.

13. Relacion con Pricing

La dimension temporal tambien sera importante para una futura capacidad de pricing.

Ejemplos conceptuales:

• fecha de relevamiento
• fecha de compra del cliente
• fecha de oferta competidor
• fecha de ultimo cambio de costo
• precio viejo vs precio nuevo
• competencia vendiendo stock viejo durante algunos dias

Esta relacion se deja documentada solo como frontera conceptual.

No se crea ningun Use Case de pricing en este documento.

14. Datos funcionales necesarios

Sin disenar tablas, esta capacidad probablemente necesitara:

• calendario del mes
• feriados
• dias laborables teoricos
• dias realmente trabajados
• comprobantes emitidos por fecha
• ventas por fecha
• pedidos por fecha
• clientes unicos por fecha
• vendedor
• zona
• SKU
• marca
• proveedor
• stock diario al cierre
• costo vigente
• precio vigente
• acciones comerciales realizadas

15. Preguntas que deberia responder el Observer

• cuantos dias tuvo el mes
• cuantos dias laborables tuvo
• cuantos feriados tuvo
• cuantos dias trabajo realmente APV
• que feriados se trabajaron
• que dias tuvieron facturacion
• cual fue la venta por dia trabajado
• cual fue la productividad por vendedor
• cual fue la proyeccion de cierre
• cuantos dias de stock quedan
• cuanto representa economicamente cada dia sin stock
• que productos tuvieron faltantes en dias efectivos de venta
• cuanto dinero estimamos que dejamos de facturar por faltantes
• que vendedor tiene mejor productividad diaria
• que zona rinde mas por dia trabajado

16. Casos de uso concretos APV

Caso A - Comparacion mensual justa

APV compara dos meses y descubre que el mes con menor venta total tuvo mejor productividad diaria porque opero con menos dias efectivos.

Caso B - Proyeccion de cierre mensual

APV observa cuantos dias trabajados reales lleva el mes y cuantos dias efectivos faltan para proyectar mejor el cierre.

Caso C - Dias de stock por SKU

APV mide cuantos dias operativos de cobertura tiene un SKU usando venta por dia trabajado en lugar de dias calendario.

Caso D - Oportunidad perdida por faltante

APV cruza dias efectivos sin stock con ventas historicas y estima impacto comercial potencial mas realista.

Caso E - Productividad por vendedor

APV compara vendedores por venta, pedidos y clientes atendidos por dia trabajado, evitando sesgos por distinta cantidad de dias efectivos.

Caso F - Feriado trabajado con facturacion real

APV detecta que un feriado tuvo comprobantes emitidos y por lo tanto debe considerarse un dia trabajado comercialmente para ese analisis.

17. Riesgos y limites

• facturar no siempre refleja toda la actividad comercial
• puede haber trabajo sin facturacion
• puede haber facturacion administrativa de pedidos tomados antes
• puede haber dias parcialmente trabajados
• puede haber diferencias por canal
• no debe confundirse productividad diaria con calidad comercial
• no debe usarse para castigar vendedores sin contexto

18. Clasificacion Core vs Tenant

Core reusable

• capacidad generica de calendario operativo
• comparacion por dias trabajados
• proyeccion basada en dias efectivos
• analisis temporal

Tenant APV

• Argentina / Buenos Aires
• regla de comprobantes emitidos como evidencia de dia trabajado
• calendario operativo propio
• criterios comerciales APV

19. Roadmap UC005

Etapa 1

Definicion funcional.

Etapa 2

Reglas APV de dia trabajado.

Etapa 3

Datos necesarios.

Etapa 4

Relacion con ventas, stock y comprobantes.

Etapa 5

Indicadores comerciales.

Etapa 6

Proyeccion y forecast.

Etapa 7

Relacion con UC004.

Etapa 8

Operacion futura.