Guía de uso
Orders
Orders are the commercial and production starting point for quote-to-sale work.
Intención de la página
The intent of Orders is to locate, create, and monitor customer commitments before deeper changes happen in the order detail.
Contexto para soporte
En caso de un total incorrecto, un cliente faltante o una transición bloqueada, incluya el número de pedido y la última acción que intentó.
Cómo funciona
Orders is the central operating page of Ballista. It combines commercial intake, search, filtering, status control, and navigation into one module because almost every downstream action starts from an order.
The top of the page summarizes the current book of work with KPI cards such as total orders, pending orders, and total amount. This gives a quick answer to how much work exists before the user edits anything.
The workbench then separates filtering from results. Users can narrow by status, customer, dependent, type, product line, creation date, or delivery date so the visible list reflects a real operational question instead of a giant table.
Create order opens the guided wizard that captures general data, order lines, and optional actions such as a follow-up task or notification. Once saved, the order becomes the reference used by tasks, lots, billing, and reports.
Opening one order moves the user into Order Detail, where lines, lots, labels, invoice navigation, tasks, comments, and traceability live. That keeps the main list focused on locating and managing orders while deep changes happen in a dedicated workspace.
Botones y acciones
| Acción | Qué hace |
|---|---|
Create order | Opens the guided order wizard from the main workbench. |
Simple | Uses the faster search mode for broad lookup. |
Advanced | Opens more precise filters such as customer, dependent, type, dates, status, and product line. |
Create order | Persists the order and its selected lines. |
Detail | Abre el espacio de trabajo de pedidos completo. |
Edit | Abre campos de pedido básicos para su corrección. |
In progress | Marca el pedido como trabajo activo. |
Paid | Marca el pedido como financieramente completado. |
Export CSV | Exporta la lista de pedidos visibles desde el banco de trabajo. |
Reschedule | Cambia la fecha de entrega con un comentario. |
Cancel | Marca el pedido como cancelado cuando el trabajo debería detenerse. |
Delete | Elimina un pedido cuando se creó por error y se puede eliminar de forma segura. |
Search | Applies the visible filters to narrow the records shown on the page. |
Clear | Resets filters so the user can return to the full working list. |
Create Ticket | Abre una solicitud de soporte con esta página ya adjunta como contexto. |
Deep Dives
Mapa de contenido
Parte superior del banco de trabajo
Orders KPIs
Resumen rapido del volumen actual de trabajo antes de entrar a buscar una orden concreta.
Contenido visible
- Pedidos: total de pedidos visibles o conocidos por el módulo.
- Pendiente: cuantos pedidos siguen abiertos o sin cerrar.
- Monto total: monto total de trabajo comercial.
Acciones
- Usar los KPI para entender la carga operativa del período.
- Comparar si la lista visible tiene sentido antes de filtrar o exportar.
Bloque central de Órdenes
Search & Filters
Zona donde el usuario decide como localizar pedidos: por estado rápido, búsqueda simple o filtros avanzados.
Contenido visible
- Filtro rápido por estado.
- Pestañas Simple y Avanzado.
- Campo de búsqueda rápida.
- Filtros avanzados por id, cliente, dependiente, tipo, fecha de creación, fecha de entrega, estado y línea de producto.
Acciones
- Busque para aplicar filtros.
- Borre para reiniciar el modo de búsqueda.
- Cambie entre Simple y Avanzado según la complejidad de la pregunta.
Parte inferior del banco de trabajo
Orders results table
Tabla donde Ballista muestra el resultado operativo: la orden ya identificada con contexto comercial, fiscal y de gestión.
Contenido visible
- Orden, Cliente, Dependiente, Tipo, Línea de producto.
- Fecha, Fecha de entrega y Total.
- Factura electrónica y Estado.
- Acciones como Editar y Eliminar.
Acciones
- Abrir el detalle de una orden.
- Cambia el estado directamente en la fila.
- Exportar CSV.
- Editar encabezado o eliminar cuando aplica.
Modal / flujo guiado
Create order wizard
Entrada operativa principal del sistema. Captura la orden completa y puedes dejar trabajo o comunicación preparada desde el inicio.
Contenido visible
- Datos generales.
- Líneas de pedido.
- Tarea opcional.
- Notificación opcional.
- Crear orden de acción final.
Acciones
- Crear la orden con validación de stock/impuestos.
- Agregar tarea de seguimiento.
- Agregar notificación para otro usuario.
Notificaciones y alertas
| Notificación | Disparador | Dónde aparece | Resultado |
|---|---|---|---|
| Alerta local: orden actualizada | El usuario guarda cambios del DialogForm de edicion. | Toast temporal del frontend. | Se invalidan consultas de pedidos para refrescar lista y totales. |
| Alerta local: orden eliminada | El usuario confirma Eliminar sobre una fila. | Toast temporal del frontend. | El orden desaparece de la tabla después de actualizar las consultas. |
| Alerta local: status actualizado | El usuario cambia el status desde la fila del workbench. | Toast temporal del frontend. | La fila cambia de estado y puede impactar KPIs de pendientes. |
| Notificacion persistente desde Order Creation | En el wizard se habilita la seccion opcional de notificación y se completa usuario/mensaje. | Feed de notificaciones y contador global cuando el backend la publica. | El usuario destino recibe una notificación enlazable según metadata o ids asociados. |
Ejemplos operativos
Ejemplo 1: una persona necesita confirmar un pedido de un cliente frecuente. Entra a Orders, filtra por cliente o fecha, revisa estado y abre Detail para validar líneas, totales, lotes y tareas antes de marcarlo en proceso o pagado.
Ejemplo 2: un pedido fue creado sin fecha de entrega correcta. Desde la lista se puede localizar, usar Reschedule y dejar el cambio registrado con contexto para que producción y entrega no trabajen con una fecha vieja.
Ejemplo 3: si el pedido requiere factura, Orders sirve como punto de partida. El botón de detalle permite revisar información comercial y luego Invoice this order lleva el contexto hacia Billing sin volver a digitar todo.
Ejemplo 4: si soporte necesita una orden exacta pero solo recuerda el cliente y la fecha, Advanced filters reduce la tabla sin tener que abrir otras páginas.
Ejemplo 5: si un pedido nace y ya sabes que otra persona debe actuar, activa la notificación opcional en el wizard para que el seguimiento no dependa de chat externo.
Cómo se lee en el código
| Archivo | Qué hace |
|---|---|
frontend/src/pages/orders/orders.desktop.tsx | La página desktop monta DesktopLayout con contextualHintPageId="orders" y renderiza OrdersWorkbenchPanel. Eso explica por qué la ayuda contextual y el tour saben que están en Orders. |
frontend/src/modules/orders/components/orders-workbench-panel.tsx | Este panel arma filtros simples/avanzados, consulta pedidos, cataloga clientes/proveedores/tipos y abre OrderCompleteWizard para crear pedidos guiados. |
frontend/src/modules/orders/components/order-detail-workbench-panel.tsx | El detalle conecta líneas, lotes, tareas, etiquetas, impresión y navegación hacia facturación. Por eso Orders no es solo una lista: es el origen operativo del ciclo pedido-inventario-factura. |
frontend/src/modules/orders/components/order-complete-wizard.tsx | El wizard valida customer, lines, tax consistency y lot availability; tambien puede incluir tarea y notificación en el mismo payload createOrderComplete. |