Configurar el motor de precios y ejecutar una corrida

Objetivo

Dejar el motor de precios listo y ejecutarlo de punta a punta: al terminar, existe un nivel de precio, un grupo que reúne los artículos, una estrategia que calcula el precio desde el costo, una regla que liga el grupo con la estrategia, un ajuste por nivel, un costo neto capturado y una publicación que dice dónde aterrizan los precios; y una corrida aplicada que escribió el precio nuevo del artículo en su lista, conservando el precio anterior cuando ya existía una partida en esa lista.

El orden respeta las dependencias reales del cálculo: primero los niveles y el grupo, luego cómo se calcula (estrategia, regla y ajuste), después la entrada de costo y el destino, y al final la corrida que junta todo.

Antes de comenzar

Esta guía asume un tenant con sus catálogos base ya cargados: el almacén con su ubicación, la moneda y la cuenta contable que usan las listas de precios, el artículo dado de alta y asignado a un grupo de precios, y una fuente de costo para ese artículo — un movimiento de última compra, una cotización de compra vigente, o el costo neto con fuente Derivado que capturarás en esta guía. En la revisión d32f19b93, una captura con fuente Manual sí se guarda en F059080, pero el generador de corridas no la consulta. Debe existir además el tipo de lista de precio directo (clave LstPrc); es el tipo donde la corrida escribe los precios y sin él no puede crear la lista destino.

Puedes preparar la lista (F0510) y la estructura (F0520) destino de antemano, o dejar que la corrida las cree automáticamente al publicar; esta guía crea una publicación explícita para controlar dónde aterrizan los precios.

Procedimiento

Parte 1 — Niveles y grupo

Parte 2 — Cómo se calcula

Parte 3 — Costo y destino

Parte 4 — Ejecuta la corrida

Limitación observada en d32f19b93: el botón Publicar del índice construye el formulario con la acción y el método invertidos (/xvrrs/:id/post, método publish). La validación browser corrigió esos atributos en el DOM para comprobar el endpoint real /xvrrs/:id/publish por POST. La interfaz debe corregirse antes de que este último clic sea operable sin esa desviación.

Con la corrida aplicada, el artículo ya resuelve precio en el nivel calculado. Si la fecha de vigencia era futura, la corrida no se aplica de inmediato: queda programada y un proceso automático la aplica al llegar la fecha — ver variantes.

Variantes

Corrida por artículos específicos

En vez de un grupo completo, en el paso 9 puedes seleccionar artículos uno por uno en el campo de artículos de la corrida. El resto del recorrido es igual: cada artículo elegido debe tener su regla y su costo. Úsalo para recalcular unos pocos productos sin tocar todo el grupo.

Segundo nivel de precios con ajuste

Para precios diferenciados —menudeo y mayoreo del mismo artículo— crea un segundo nivel (paso 1), agrégale su ajuste en la regla (paso 6) con un porcentaje distinto, y su publicación hacia otra lista (paso 8). En la corrida (paso 9) selecciona ambos niveles: el borrador traerá una partida por artículo y nivel, y cada una tomará el ajuste de su nivel sobre el mismo precio base.

Publicaciones automáticas

Si omites el paso 8, al publicar la corrida el sistema crea por su cuenta la lista, la estructura y la publicación faltantes para cada almacén y nivel, y marca esa publicación como de generación automática. Es cómodo para arrancar, pero pierdes el control del nombre y la estructura destino; para producción conviene crear la publicación a mano.

Corrida programada a fecha futura

Si en el paso 9 capturas una fecha de vigencia futura, al publicar la corrida no se aplica: queda programada y sus partidas seleccionadas esperan. Un proceso automático la aplica cuando llega la fecha, tomando la corrida bajo candado para no publicarla dos veces. Sirve para dejar listo un cambio de precios que debe entrar un día exacto.

Cancelar una corrida

Una corrida en borrador o programada se descarta con Cancelar: sus partidas no aplicadas quedan omitidas y no cambian precios. Una corrida aplicada ya no se puede cancelar; para revertir precios se ejecuta una nueva corrida con los valores correctos.

Artículo sin costo o sin regla

Si un artículo aparece con estado con error en el borrador, la corrida no pudo calcularlo: casi siempre porque no hay costo disponible para él en el almacén, o porque no encontró una regla vigente para su artículo o grupo. Resuelve el costo (paso 7) o la regla (paso 5) y vuelve a generar la corrida; las partidas con error no se publican.

Costo desde última compra o cotización

No siempre capturas un costo derivado. Si el artículo tiene un costo de última compra registrado o una cotización de compra vigente, el motor los toma como fuente: usa el costo activo más reciente y, si hay una cotización vigente más nueva que ese costo, prefiere la cotización. En ese caso el paso 7 se omite.

Otras estrategias de cálculo

Costo más porcentaje es solo una opción. La estrategia (paso 4) también puede ser precio fijo (un valor que no depende del costo), costo derivado (deriva el precio de un costo base por cantidad y coeficiente) o margen con componentes heredados (reproduce el cálculo por descuentos, fletes, zona, conversión, tipo de cambio y margen del sistema anterior). Cambia el tipo y sus parámetros; el resto del recorrido no cambia.

Verificación final

Recorre la cadena que dejaste armada: el nivel está activo; el artículo pertenece a un grupo con una regla vigente que apunta a una estrategia; el nivel tiene su ajuste; el artículo tiene costo en el almacén; y existe la publicación del almacén y nivel hacia una lista. La prueba definitiva es abrir el detalle de la corrida y confirmar que quedó aplicada, que el precio nuevo se escribió en la lista de precios (F0510) y que el precio anterior se conservó cuando la lista ya tenía una partida. En una lista nueva, el precio anterior queda vacío en la primera publicación. Si esos precios se usan en la venta, verifica además que el nivel esté ligado al almacén con esa estructura (F529030).