Foundation approval workflow engine for sale order send and confirm
Description
This module provides the core approval workflow engine for sale orders, gating quotation sending and order confirmation behind an approval step and exposing extension points so other modules can plug in their own approval conditions.
Author
Cloudia
Copyright
Copyright (c) 2025-Present Cloudia Systems S.A.C.
License
OPL-1
Version
18.0.1.1
Dependencies
sale
sale_management
web_studio
1. User instructions
There is no setting of its own. Sibling modules (credit, overdue invoices, margin, fiscal position, and others) turn on the send/confirm gates. This module shows the buttons, banners, locks and list colors, and talks to Studio Approval.
Request approval
On a quotation in Ventas whose send or confirm gate is on, a salesperson sees Solicitar aprobación (live; English source Request Approval).
Finish the cotización (customer, lines, payment term, pricelist).
Click Solicitar aprobación. The form recalculates flags first; if nothing requires approval the button does nothing.
The order locks: lines cannot be added, edited or deleted; Cliente, invoice address, payment term, validity date and pricelist cannot change until approval is reset (cancel or set back to draft).
COT000941. Purple Solicitar aprobación before Enviar por Email / Confirmar Cotización.
Approve (sales manager)
After the request, a user in Administrador de ventas sees green Aprobar. Salespeople do not. The banner reads Aprobación solicitada: Esta orden de venta está pendiente de aprobación. No se pueden realizar modificaciones en las líneas hasta que se restablezca el estado de aprobación.
Open the locked cotización.
Click Aprobar. The module writes Studio approval entries for every applicable rule (credit, margin, overdue, fiscal, …).
When every required Studio rule is approved, a green banner appears: Aprobación completa: Esta orden de venta está aprobada.
COT000825. Orange Aprobación solicitada banner and green Aprobar. A sibling module may add its own reason banner (here margin).
Sending (Enviar por Email) or confirming without approval raises Se requiere aprobación para esta acción. You cannot mark a quotation as sent except through Send by Email. Cancel or Restablecer a presupuesto / set to draft clears the request and Studio entries, then recalculates flags.
List colors
On the Cotizacion list: warning (yellow) when a gate is on but not yet requested; danger (red) when requested and still pending; success (green) when Studio approval is complete.
Ventas quotations list. Yellow rows are quotations that still need approval.
Duplicating an order resets the request, recalculates flags, and posts a chatter note if gates still apply. Sibling modules can paint Cliente / invoice partner in red (decoration-danger) and paint order lines red.
Base de aprobación de órdenes de venta
Nombre técnico: cs_sale_approval_base
Nombre
Sale Order Approval Base
Resumen
Motor de flujo de aprobación para enviar la cotización y confirmar la orden de venta
Descripción
Motor central de aprobación de órdenes de venta: bloquea el envío de la cotización y la confirmación hasta que se solicite y se otorgue la aprobación, y deja puntos de extensión para que otros módulos aporten sus propias condiciones.
Autor
Cloudia
Copyright
Copyright (c) 2025-Present Cloudia Systems S.A.C.
Licencia
OPL-1
Versión
18.0.1.1
Dependencias
sale
sale_management
web_studio
1. Instrucciones de usuario
No tiene ajustes propios. Los módulos hermanos (crédito, facturas vencidas, margen, posición fiscal y otros) encienden las barreras de envío o confirmación. Este módulo muestra botones, avisos, bloqueos y colores de lista, y se conecta con Aprobación de Studio.
Solicitar aprobación
En Ventas, si la cotización exige aprobación para enviar o confirmar, el vendedor ve Solicitar aprobación.
Termine la cotización (cliente, líneas, plazo de pago, lista de precios).
Pulse Solicitar aprobación. Primero se recalculan las banderas; si nada exige aprobación, el botón no hace nada.
La orden se bloquea: no se agregan, editan ni borran líneas; no se cambian Cliente, dirección de factura, plazo de pago, vencimiento ni lista de precios hasta cancelar o volver a borrador.
COT000941. Solicitar aprobación en morado, antes de Enviar por Email / Confirmar Cotización.
Aprobar (administrador de ventas)
Tras la solicitud, un usuario del grupo de administrador de ventas ve el botón verde Aprobar. El aviso es Aprobación solicitada: Esta orden de venta está pendiente de aprobación. No se pueden realizar modificaciones en las líneas hasta que se restablezca el estado de aprobación.
Abra la cotización bloqueada.
Pulse Aprobar. Se crean entradas de Studio para cada regla aplicable (crédito, margen, vencidas, fiscal, …).
Cuando todas las reglas requeridas están aprobadas aparece Aprobación completa: Esta orden de venta está aprobada.
COT000825. Aviso naranja Aprobación solicitada y botón Aprobar. Un módulo hermano puede añadir su propio motivo (aquí, margen).
Enviar (Enviar por Email) o confirmar sin aprobación muestra Se requiere aprobación para esta acción. No se puede marcar la cotización como enviada salvo por Enviar por Email. Cancelar o volver a borrador limpia la solicitud y las entradas de Studio, y vuelve a calcular las banderas.
Colores en la lista
En la lista Cotizacion: aviso (amarillo) si hay barrera y aún no se pidió aprobación; peligro (rojo) si está pedida y pendiente; éxito (verde) si Studio ya aprobó.
Lista de cotizaciones en Ventas. Las filas amarillas aún requieren aprobación.
Duplicar restablece la solicitud, recalcula banderas y deja una nota en el chatter si las barreras siguen aplicando. Los módulos hermanos pueden pintar de rojo el Cliente / dirección de factura y las líneas.
