Innovaciones, Optimizaciones y Nuevas Funcionalidades del Ecosistema AS2
Índice
P.3
Cambios, Mejoras o Actualizaciones
Manual de Procedimientos para Mejoras y Actualizaciones
Ecosistema AS2
Este manual documenta de manera detallada los procesos de cambio, optimización o actualización implementados en las soluciones del Ecosistema AS2.
CAMBIOS, MEJORAS O ACTUALIZACIONES
SISTEMA: AS2 Florícola
ANTECEDENTES
Actualmente en el sistema AS2-Florícola el proceso core de planificación ha ido cambiando durante los últimos meses, debido a condiciones que requiere el giro de negocio de Mystic, y como ya existía un desarrollo previo en versión temprana que involucraba Mix y Rainbow, este se fue desfasando y quedando sin funcionamiento por lo anterior explicado, como resultado se afectaron incluso los reportes propios del esquema de Agrogana.
OBJETIVO
- Implementar funcionalidad que permita ajustar toda la lógica core de procesamiento de planificación para distribuir ventas de mix según la disponibilidad/proyección existente, para que sea compatible con la nueva forma de guardar el tracking de los tallos tomados por fecha, sucursal y cantidad exacta. Modificar el reporte de disponibilidad cultivo para solo mostrar las variedades solidas excluyendo el mix. En el subreporte de mix se permita mostrar sus componentes respetando el orden mix previamente configurado. Finalmente ajustar el subreporte que agrupe la data del reporte de disponibilidad cultivo por color.
DESARROLLO
En la pantalla ‘Configuración Florícola’ (ruta: paginas/datosBase/configuracion/configuracionFloricola)
| Parámetro | Mystic | Agrogana | Descripción |
| Planificación Sala Sin incluir Longitud | ✗ false | ✓ true | Indica si se tomara en cuenta la longitud de las variedades al momento de cargar la disponibilidad y distribuirlas. |
| Maneja Mixtos y Rainbow en Planificación | ✗ false | ✓ true | Habilita la distribución automática de mix y rainbow en la planificación |
| Validar Disponibilidad Cultivo | True o False | ✗ false (desactivado) | Agrogana desactiva este parámetro porque sus pedidos usan variedades mix. Cuando un pedido mix se edita, el sistema no puede simplemente “deshacer” y “volver a tomar” disponibilidad: los componentes del mix pudieron cambiar, la disponibilidad del cultivo ya se movió desde la última planificación, y la distribución entre componentes depende de una nueva ronda completa de planificación. Por eso, en lugar de validar al guardar cada pedido, Agrogana gestiona la disponibilidad únicamente al procesar la planificación sala. |
En la pantalla ‘Variedad’ (ruta: paginas/produccion/configuracion/variedad/variedadFlor) se debe definir los componentes del mix y su orden de distribución (ej. Mix Red → Explorer orden 1, Red Panther orden 2).
En la pantalla ‘Preventa Flor’ (ruta: paginas/comercializacion/procesos/pedidos/preventaFlor) se deben registrar las preventas: pueden ser con variedad sólida (ej. Red Panther, Explorer) o variedad mix (ej. Mix Red).
Se configura preventa con variedad sólida ‘red panther’.
Se configura preventa con variedad sólida ‘explorer’.
Se configura preventa con variedad mix “mix red” cuya composición incluye a Explorer y Red Panther como se mostró al inicio del documento.
En la pantalla ‘Proyección Cultivo’ (ruta: paginas/planificacion/procesos/proyeccionCultivo) se ingresa la proyección de tallos disponibles por variedad. Estos son la base del cálculo de disponibilidad. Se agregó como ejemplo la siguiente proyección:
Algoritmo de Distribución de Mix
Una vez procesadas las ventas sólidas, el sistema distribuye los componentes del mix en rondas iterativas:
🔄 Orden de procesamiento de ventas
1. Fecha de la venta
2. Orden de canal de venta del cliente
3. Documento de pedido flor
4. Preferencia de planificación en Tipo de Variedad Flor
5. Bunche
6. Variedad Mix: primero sólidas (false), al final mix (true)
Ejemplo Práctico — Distribución Paso a Paso
Escenario: Ventas mix de 100 tallos (bunche: 20 tallos). Disponibilidad: A1=80, A2=40, A3=120
Ronda 1 — Distribución inicial
| Variedad | Orden Mix | Disponibilidad | Distribuye | Disponibilidad Restante |
| A1 | 0 | 80 | 20 | 60 |
| A2 | 1 | 40 | 20 | 20 |
| A3 | 2 | 120 | 20 | 100 |
| TOTAL | 240 | 60 | 180 |
Ventas pendientes: 100 − 60 = 40 tallos
Ronda 2 — Distribución del remanente
| Variedad | Disponibilidad | Distribuye | Disponibilidad Restante |
| A1 | 60 | 20 | 40 |
| A2 | 20 | 20 | 0 |
| A3 | 100 | — (ya completo) | — |
| TOTAL | 180 | 40 |
Ventas pendientes: 40 − 40 = 0 ✓ Distribución completa
Resumen Final de Distribución
| Variedad | Ronda 1 | Ronda 2 | Total Distribuido | % del Total |
| A1 | 20 | 20 | 40 | 40% |
| A2 | 20 | 20 | 40 | 40% |
| A3 | 20 | 0 | 20 | 20% |
| TOTAL | 60 | 40 | 100 | 100% |
En la pantalla ‘Planificación sala’ (ruta: paginas/planificacion/procesos/planificacionSala) se ejecuta el proceso de planificación. El sistema distribuye automáticamente los mix según disponibilidad.
Al editar la planificación, en la primera pestaña se observan las ventas y las proyecciones originales.
Aclaración cálculo de tallos de proyección.
El número de tallos proyectados disponibles se obtiene aplicando los porcentajes de exportación y nacional:
📐 Fórmula de Cálculo
Tallos disponibles = Proyección × % Exportable × (100% − % Nacional Planificación)
Ejemplo con Explorer:
• Proyección total: 5.000 tallos
• % Exportable configurado: 80%
• % Nacional planificación: 12%
Paso 1: 5.000 × 80% = 4.000 (exportable)
Paso 2: 4.000 × (100% − 12%) = 4.000 × 88% = 3.520 ✓
| Variedad | Proyección Total | % Exportable | % Nacional | Tallos Disponibles |
| Explorer | 5.000 | 80% | 12% | 3.520 |
| Red Panther | 96 | 80% | 0% | 77 |
En la segunda pestaña ‘Consultar Detalles’ se puede verificar la distribución de los componentes mix. Los valores en morado muestran los tallos asignados a cada variedad.
Y recordando que de las ventas teníamos:
Entonces como ya se planifico se puede observar en los recuadros purpura, la distribución del “MIX RED”. Se explica los cálculos a continuación:
Con las preventas configuradas de la siguiente forma:
| Preventa | Tipo | Variedad | Tallos / Bunche | Total Tallos |
| (1) | Sólida | Red Panther | 50 / 25 | 50 |
| (5) | Sólida | Explorer | 250 / 25 | 250 |
| Mix Red | Mix | Mix Red (Explorer + Red Panther) | 100 / 25 | 100 |
El sistema procesa primero las sólidas y luego distribuye el mix. Resultado:
| Variedad | Ventas Sólidas | Ventas Mix (distribuidas) | Total Ventas | Proyección | Sobrante |
| Explorer | 250 | 50 | 300 | 3.520 | 3.220 |
| Red Panther | 50 | 25* | 75 | 77 | 2 |
| Freedom | 0 | 0 | 0 | 0 | — |
* Nota sobre Red Panther
El mix pedía 50 tallos de Red Panther, pero solo había 27 disponibles.
El sistema asignó 25 tallos (múltiplo del bunche configurado de 25) y registró 25 faltantes.
En la pantalla ‘Planificación Sala’ (ruta: paginas/planificacion/procesos/planificacionSala) en el listado principal, al pulsar el botón ‘Disponibilidad’ se generan 3 reportes: Principal (con integración de sólidas + mix), Mixtos (solo mix con componentes) y Disponibilidad por Color.
Nos saldrán 3 reportes:
- Reporte Principal
En este reporte está integrado las ventas de las variedades solidas con las variedades componentes del mix, por esa razón explorer y red panther se acumulan:
| Variedad | Ventas Sólidas | Ventas de Mix (distribuidas) | Total Ventas |
| Explorer | 250 | 50 | 300 |
| Red Panther | 50 | 25 | 75 |
- Reporte de mixtos
Este subreporte muestra exclusivamente las variedades de tipo mix y la distribución de sus componentes tal como quedó calculada por el algoritmo.
📌 ¿Qué muestra exactamente este reporte?
• En cada cabecera aparecen las variedades que son de tipo mix (NO las sólidas) y solo aquí se muestra las ventas reales del mix antes de distribuirlas, y los tallos que alcanzo a planificar según la disponibilidad, y la resta de estos dos, da la columna faltante.
• Por cada mix se listan sus componentes en el orden configurado en variedadFlor
• Los tallos de cada componente corresponden al resultado del algoritmo iterativo
• Si un componente quedó en 0 (por falta de disponibilidad), igual aparece con 0.
• Los mixtos Sobrantes son los Mixtos alcanzados de la tabla anterior.
Cómo se construye desde el algoritmo
Retomando el ejemplo de Mix Red de la sección 7:
Retomando el ejemplo de Mix Red de la sección 7:
| Paso del algoritmo | Qué calculó | Lo que aparece en el reporte de mixtos |
| Ronda 1 — Freedom (orden 0) ← PRIMERO | Disponibilidad: 0 (no hay proyección configurada). Pide 50 → nada disponible →Se ignora y continúa. | Freedom: 0 tallos (aparece igual) |
| Ronda 1 — Explorer (orden 1) | Disponibilidad: 3.270 sobrantes tras procesar sólidas. Pide 50 → hay de sobra → asigna 25. | Explorer: 25 tallos ✓ |
| Ronda 1 — Red Panther (orden 2) ← ÚLTIMO | Disponibilidad: 27 sobrantes tras procesar sólidas. Pide 50 → solo hay 27 → asigna 25 (múltiplo bunche de 25). | Red Panther: 25 tallos ✓ |
| Ronda 2 — Freedom (orden 0) ← PRIMERO | Disponibilidad: 0 (no hay proyección configurada). Pide 50 → nada disponible →Se ignora y continúa. | Freedom: 0 tallos |
| Ronda 2 — Explorer (orden 1) | Disponibilidad: 3.245 sobrantes tras procesar sólidas. Pide 25→ hay de sobra → asigna 25. | Explorer: 50 tallos ✓
Ya finaliza su asignación |
| Ronda 2 — Red Panther (orden 2) ← ÚLTIMO | Disponibilidad: 0 (no hay proyección configurada). Pide 50 → nada disponible →Se ignora y finaliza. | Freedom: 0 tallos |
Estructura visual del reporte
El reporte agrupa primero por variedad mix, luego lista sus componentes en el orden mix configurado:
| ▌ MIX RED — 100 tallos vendidos / 75 planificados / 25 faltantes |
| Orden 0 Freedom Asignados: 0 Faltante: — |
| Orden 1 Explorer Asignados: 50 Faltante: 0 |
| Orden 2 Red Panther Asignados: 25 Faltante: 25 |
| TOTALES → Venta: 100 tallos Asignados: 75 Faltantes (venta): 25 |
💡 ¿Por qué asignados = 75 si la venta fue de 100?
El algoritmo intenta cubrir los 100 tallos de Mix Red distribuyéndolos entre sus componentes:
Freedom → 0 asignados (sin proyección disponible)
Explorer → 50 asignados (había suficiente sobrante)
Red Panther→ 25 asignados (solo quedaban 27; se asigna múltiplo del bunche: 25)
Total asignado: 0 + 50 + 25 = 75 tallos de los 100 pedidos.
Faltante registrado en Consulta Planificación (pestaña 2): 25 tallos.
Regla del orden mix — impacto en el resultado
El orden configurado en variedadFlor.jsf es determinante. El algoritmo recorre los componentes en ese orden en cada ronda:
| Orden Mix | Significado práctico | Consecuencia si cambia |
| Orden 0 (primero en cada ronda) | En cada ronda recibe su bunche antes que los demás. Si la disponibilidad se agota a mitad de ronda, es el último en quedarse sin tallos. | Cambiarlo a último lo convierte en el más expuesto: si la disponibilidad se corta en esa ronda, ya los anteriores tomaron su bunche. |
| Orden 1, 2… (siguientes) | Recibe su bunche después del orden anterior en cada ronda. Si hay disponibilidad suficiente, todos reciben igual; la diferencia solo aparece cuando el stock se acaba en medio de una ronda. | Adelantarlo le da más seguridad ante cortes de disponibilidad; retrasarlo lo expone más al faltante. |
| Orden N (último en cada ronda) | Es el último en intentar tomar su bunche en cada ronda. Si la disponibilidad se agotó antes de llegar a él en esa ronda, queda sin tallos aunque haya recibido en rondas anteriores. | Es el componente más propenso a quedarse con faltante cuando el stock no alcanza para completar una ronda entera. |
⚠ Importante
El orden mix se configura una sola vez en la pantalla de variedadFlor.
Cambiar el orden DESPUÉS de haber procesado una planificación puede generar inconsistencias.
Si se requiere cambiar el orden, se debe reprocesar completamente la planificación.
- Reporte disponibilidad por color
Este reporte es la agrupación del reporte principal por color, tomando solo las 3 columnas que se muestran en la ilustración.
Consulta de Planificación
| → | Acceder a Consulta Planificación
paginas/planificacion/reportes/consultaPlanificacionSala.jsf Seleccionar sucursal y planificación, luego ir a las dos pestañas disponibles. |
En la primera pestaña: imprimimos el reporte:
Se observa la planificación tanto para las variedades sólidas, como para las variedades componentes del mix, cuyos valores coinciden con la distribución anteriormente explicada.
Finalmente damos click en la segunda pestaña
Y luego de dar click en el botón consultar con la sucursal y planificaciòn seleccionada, se observa que faltaron 25 tallos para planificar los 100 de la venta de la variedad mix, RED MIX, lo cual también coincide con lo explicado al inicio en la pantalla de planificación sala.
Trazabilidad de Disponibilidad: flo_detalle_caja_pedido_flor_planificacion
Durante el procesamiento de planificación sala, el sistema registra con exactitud cuántos tallos fueron tomados de la disponibilidad (proyecciones) para cada pedido. Esta información queda almacenada en la tabla flo_detalle_caja_pedido_flor_planificacion, la cual permite saber con exactitud de qué fecha, sucursal y en qué cantidad fueron tomados los tallos de la disponibilidad proyectada.
Propósito de la tabla
Cada registro en esta tabla representa un detalle atómico de disponibilidad consumida, vinculado a una caja de pedido de flor. Almacena los tres datos clave que permiten realizar reversos precisos de disponibilidad cuando un pedido es anulado o modificado:
| Campo clave | Dato almacenado | Descripción y uso |
| Fecha | Fecha de la proyección de la que se tomó la disponibilidad | Identifica exactamente en qué día de la planificación sala se consumió disponibilidad. Permite regresar los tallos al día correcto al realizar un reverso (anulación o edición). |
| Sucursal | Sucursal (finca o centro de acopio) de donde proviene la disponibilidad consumida | Cuando una caja está en un centro de acopio, la disponibilidad puede tomarse de cualquier sucursal participante en esa planificación. Este campo guarda de cuál sucursal específica se tomó, garantizando que el reverso devuelva los tallos al lugar correcto. |
| Cantidad (tallos) | Número de tallos tomados de esa fecha y sucursal específica | Permite calcular el diferencial exacto al editar un pedido (aumento o disminución de tallos), y reversar únicamente la cantidad correspondiente a cada registro, sin afectar la disponibilidad de otras fechas o sucursales. |
Comportamiento en Agrogana
⚠ Importante — Agrogana y el parámetro VALIDAR_DISPONIBILIDAD_CULTIVO
Se recalca que Agrogana no utilizará el parámetro VALIDAR_DISPONIBILIDAD_CULTIVO. Este parámetro, que funciona en pedidos fijos y preventas para validar disponibilidad al guardar, deberá estar desactivado (false) Con ello, la creación y edición de pedidos fijos y preventas continúa funcionando tal como lo ha hecho siempre en el floricola, sin ningún tipo de validación de disponibilidad al guardar.
La tabla flo_detalle_caja_pedido_flor_planificacion sí será utilizada en el contexto del procesamiento de planificación sala, donde el sistema distribuye la disponibilidad entre las ventas y deja trazabilidad de exactamente qué fecha, sucursal y cantidad de tallos fueron asignados a cada caja.