Guía de uso
Creación de pedidos
La creación de pedidos es el asistente guiado que captura el contexto del cliente, las líneas vendibles y las acciones de seguimiento opcionales en un solo flujo.
Intención de la página
La intención de la creación de pedidos es crear un pedido operativo completo que pueda moverse limpiamente al inventario, las tareas, la facturación y los informes.
Contexto para soporte
Para problemas de creación, incluya si la falla ocurrió en datos generales, líneas, acciones opcionales o envío final, e incluya el texto de validación que se muestra.
Cómo funciona
El asistente está dividido en secciones para que el usuario pueda pensar en el mismo orden que la empresa: quién realiza el pedido, qué se vende o se prepara y qué coordinación adicional debe realizarse inmediatamente después de la creación.
Los datos generales definen el cliente, el dependiente, el tipo de pedido, el proveedor opcional/reference, la fecha prometida, el indicador de factura electrónica, el estado y las notas. Esos campos explican el contexto comercial y de entrega del pedido antes de agregar cualquier línea.
Las líneas de órdenes son el núcleo operativo. Cada línea puede provenir de un lote o de una variación de producto compuesto, y Ballista valida las cantidades, la coherencia fiscal y la disponibilidad del lote antes de permitir que se cree el pedido.
Las acciones opcionales permiten al equipo dejar un mejor seguimiento desde el principio. El mismo asistente puede incluir una tarea de seguimiento y una notificación de backend para que el pedido no desaparezca después de guardarse.
La acción de creación final envía una carga útil completa, no solo un encabezado. Es por eso que el asistente pertenece a Órdenes y no a un modal genérico: es el punto donde Ballista convierte la intención comercial en trabajo operativo coordinado.
Botones y acciones
| Acción | Qué hace |
|---|---|
Create order | Abre o envía el asistente guiado según el contexto. |
Close | Cierra el asistente y restablece el estado del borrador. |
Create follow-up task | Incluye una tarea vinculada en la carga útil del pedido cuando está habilitada. |
Send notification | Incluye una notificación de backend en la carga útil del pedido cuando está habilitado. |
Add detail | Agrega otra línea al pedido. |
Remove detail | Elimina una línea borrador del asistente. |
Create Ticket | Abre una solicitud de soporte con esta página ya adjunta como contexto. |
Mapa de contenido
Primer bloque del mago
General data
Defina a quién pertenece la orden y bajo que contexto comercial se creará.
Contenido visible
- Cliente y dependiente.
- Tipo de orden.
- Referencia externa/supplier opcional.
- Fecha prometida.
- Factura electrónica, estados y notas.
Acciones
- Definir contexto comercial y promesa de entrega.
Segundo bloque del mago
Order lines
Core de la orden: que se vende o prepara realmente.
Contenido visible
- Lineas por lote o producto compuesto.
- Cantidad, nombre del artículo, descripción, precio unitario y etiqueta.
- Validación de lotes e impuestos.
Acciones
- Agregar/quitar líneas.
- Cambiar entre sourceType lote y compuesto.
Tercer bloque del mago
Optional actions
Acciones opcionales que preparan seguimiento o comunicación desde el mismo momento de crear.
Contenido visible
- Incluye tarea con título, descripción, prioridad, propietario y fecha de vencimiento.
- Incluir notificación con título, identificación de usuario y mensaje.
Acciones
- Incluir tarea ligada a la orden.
- Incluir notificación a otro usuario.
Parte inferior del mago
Final submit
Acción que envió pedido, detalles, tarea y notificación en un solo payload.
Contenido visible
- Mensaje de validación.
- Mensajes de validación de backend/conflict mensajes cuando aplica.
- Crear acción de orden.
Acciones
- Crear la orden.
- Cerrar el mago.
Notificaciones y alertas
| Notificación | Disparador | Dónde aparece | Resultado |
|---|---|---|---|
| Notificacion opcional del wizard | El usuario activa withNotification y completa al menos el mensaje. | Backend + feed de notificaciones del usuario destino. | La orden nace con contexto compartido y no solo con datos guardados. |
| Tarea opcional del wizard | El usuario activa withTask y completa título y fecha. | Tasks y posiblemente Home/alertas según el backend. | La orden deja seguimiento estructurado desde el primer minuto. |
Ejemplos operativos
Ejemplo 1: un vendedor crea una orden con factura electrónica y una tarea de preparación para que reciba operaciones trabajo claro al instante.
Ejemplo 2: si la disponibilidad de un lote no alcanza, el mago frena la creación antes de guardar una orden imposible de cumplir.
Ejemplo 3: si la venta requiere avisar a otra persona, la notificación opcional evita depender de mensajes por fuera del sistema.
Cómo se lee en el código
| Archivo | Qué hace |
|---|---|
frontend/src/modules/orders/components/order-complete-wizard.tsx | Controla el estado completo del wizard, validaciones, lot availability realtime, sales tax consistency y submit del payload createOrderComplete. |
frontend/src/modules/orders/components/order-complete-wizard-sections.tsx | Separa visualmente general data, lines y optional actions. Tambien define los pasos del guided demo create-order-*. |
frontend/src/locales/en/common.json | El flujo coreOrderToInvoiceReport documenta los pasos ordersWorkbench, ordersResults, createOrder, createOrderGeneral, createOrderLines, createOrderOptional y createOrderSubmit. |