Guía de uso
Pedidos
Pedidos are the commercial and production starting point for quote-to-sale work.
Intención de la página
La intención de Pedidos es localizar, crear y monitorear compromisos con clientes antes de hacer cambios más profundos en el detalle del pedido.
Contexto para soporte
Si hay un total incorrecto, un cliente faltante o una transición bloqueada, incluye el número de pedido y la última acción que intentaste.
Cómo funciona
La parte superior de la página resume la cartera actual de trabajo con tarjetas KPI como pedidos totales, pedidos pendientes y monto total. Esto da una respuesta rápida sobre cuánto trabajo existe antes de que el usuario edite algo.
El espacio de trabajo separa los filtros de los resultados. Los usuarios pueden acotar por estado, cliente, dependiente, tipo, línea de producto, fecha de creación o fecha de entrega para que la lista visible responda a una pregunta operativa real.
Crear pedido abre el asistente guiado que captura datos generales, líneas del pedido y acciones opcionales como una tarea de seguimiento o una notificación. Al guardarse, el pedido se convierte en la referencia usada por tareas, lotes, facturación y reportes.
Botones y acciones
| Acción | Qué hace |
|---|---|
Crear pedido | Opens the guided order wizard from the main workbench. |
Simple | Uses the faster search mode for broad lookup. |
Avanzado | Opens more precise filters such as customer, dependent, type, dates, status, and product line. |
Crear pedido | Persists the order and its selected lines. |
Detalle | Abre el espacio de trabajo de pedidos completo. |
Editar | 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. |
Exportar CSV | Exporta la lista de pedidos visibles desde el banco de trabajo. |
Reschedule | Cambia la fecha de entrega con un comentario. |
Cancelar | Marca el pedido como cancelado cuando el trabajo debería detenerse. |
Eliminar | Elimina un pedido cuando se creó por error y se puede eliminar de forma segura. |
Buscar | Aplica los filtros visibles para acotar los registros mostrados en la página. |
Limpiar | Restablece los filtros para volver a la lista completa de trabajo. |
Crear ticket | Abre una solicitud de soporte con esta página ya adjunta como contexto. |
Análisis detallados
Mapa de contenido
Parte superior del banco de trabajo
Pedidos 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
Búsqueda y filtros
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
Pedidos 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
Asistente para crear pedido
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 Pedidos, filtra por cliente o fecha, revisa estado y abre Detalle 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, Pedidos sirve como punto de partida. El botón de detalle permite revisar información comercial y luego Facturar este pedido lleva el contexto hacia Facturación 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 Pedidos. |
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 Pedidos 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. |