Guía de uso
Detalle del pedido
Order detail is where teams review lines, traceability, invoicing navigation, and task links around one order.
Intención de la página
La intención de Detalle de pedido es concentrar cada decisión sobre un pedido en un solo espacio de trabajo.
Contexto para soporte
Para problemas en el detalle del pedido, incluye el id del pedido, la línea afectada y si el problema es de precio, trazabilidad, navegación a factura o entrega a tareas.
Cómo funciona
Detalle de pedido abre alrededor de un pedido y muestra contexto comercial, cliente, fechas, estado, notas, estado de factura y totales. El usuario debe poder entender el pedido sin volver a la lista.
El espacio principal administra líneas del pedido, productos compuestos, lotes, etiquetas, comentarios y seguimiento de tareas. Ahí el usuario agrega productos, asigna stock, valida costos y prepara el pedido para facturación o entrega.
Traceability and support sections sit after the main work so they can be reviewed without distracting from editing. They help explain which lots, movements, quality records, tasks, and invoices are connected to the order.
Botones y acciones
| Acción | Qué hace |
|---|---|
Volver a pedidos | Returns to the order list. |
Cambiar order status | Updates the operational status of the order. |
Add comment | Stores an operational note on the order. |
Copiar enlace | Copies a direct link to the order. |
Exportar CSV | Exports order detail data for external review. |
Imprimir detalle | Opens a printable versión of the order. |
Facturar este pedido | Starts billing from the current order. |
Ver factura | Opens the linked electronic invoice when one exists. |
Add product or lot | Starts a new order line. |
Add compound product | Adds a recipe-based product variation to the order. |
Add lot | Adds stock from an existing lot. |
Manage lots | Adjusts the lots assigned to a line. |
Crear etiqueta | Creates a preparation or pharmacy label for a line. |
Ver lotes del producto | Shows lot availability for a selected product. |
Nueva tarea | Creates a task linked to this order. |
Guardar order | Persists changes to order data, comments, totals, or lines. |
Editar | Opens an editable line or allocation. |
Eliminar | Quitars a line, allocation, or comment when allowed. |
Crear ticket | Abre una solicitud de soporte con esta página ya adjunta como contexto. |
Mapa de contenido
Parte superior de Detalle de pedido
Order overview actions
Bloque de contexto rapido y acciones globales sobre una sola orden.
Contenido visible
- Order id.
- Indicador de invoice emitted cuando aplica.
- Botones Nueva tarea, Exportar CSV, Imprimir detalle, Facturar este pedido, Copiar enlace, Ir a Tareas y Volver a pedidos.
Acciones
- Crear tarea ligada a la orden.
- Facturar desde la misma orden.
- Compartir enlace o volver a la lista.
Tarjeta de datos comerciales
Order data
Muestra y guarda el encabezado de la orden con su estado e información de factura.
Contenido visible
- Customer, order for, order type, product line.
- External reference y eInvoice.
- Fecha de creación y fecha de entrega.
- Status selector y Guardar order.
- Invoice key / invoice status / view invoice.
Acciones
- Cambiar status de la orden.
- Guardar encabezado.
- Abrir factura emitida.
Bloque principal de líneas
Order lines
Centro operativo real de la orden: que líneas existen, de que tipo son y con que costo/stock se sostienen.
Contenido visible
- Secciones para compound lines y lot lines.
- Cantidad, descuentos, impuestos, costo estimado y totales.
- Asignacion y breakdown de lotes.
- Etiquetas y acciones por linea.
Acciones
- Add compound product o Add lot.
- Editar línea.
- Eliminar línea.
- Manage lots o allocations.
- Crear etiqueta.
Bloques posteriores
Traceability and support
Zona para tareas, movimientos, calidad y evidencia alrededor de la orden.
Contenido visible
- Tareas asociadas a la orden.
- Historial o comentarios relevantes.
- Calidad/materiales/lotes cuando aplica.
Acciones
- Abrir task relacionada.
- Agregar nueva task.
- Revisar evidencia de trazabilidad antes de facturar o entregar.
Notificaciones y alertas
| Notificación | Disparador | Dónde aparece | Resultado |
|---|---|---|---|
| Alerta local: linea creada/actualizada/eliminada | El usuario guarda o elimina una linea o una asignacion. | Toast temporal del frontend. | Se refrescan líneas y trazabilidad de la orden. |
| Alerta local: tarea creada desde la orden | El usuario usa Nueva tarea dentro de Detalle de pedido y guarda la tarea. | Toast temporal del frontend y módulo Tareas. | La orden queda conectada con seguimiento estructurado sin salir del contexto del pedido. |
Ejemplos operativos
Ejemplo 1: un pedido ya existe pero hay que cambiar una linea, reubicar lotes y volver a revisar costo antes de facturar. Todo eso pertenece a Detalle de pedido, no a la lista.
Ejemplo 2: si soporte necesita entender por qué una linea no cuadra, revisa asignaciones, descuentos, impuestos y trazabilidad por lote en esta vista.
Ejemplo 3: si una orden necesita coordinacion adicional, Nueva tarea desde Detalle de pedido deja el seguimiento conectado a la orden correcta.
Cómo se lee en el código
| Archivo | Qué hace |
|---|---|
frontend/src/modules/orders/components/order-detail-workbench-panel.tsx | Coordina consultas de líneas, lotes, labels, tasks, comentarios y acciones globales como invoice, print y copy link. |
frontend/src/modules/orders/components/order-detail-workbench-sections.tsx | Define OrderOverviewCard, OrderContextCard, OrderLinesCard y otras secciones visuales que estructuran el workspace por bloques entendibles. |
frontend/src/modules/orders/components/order-detail-workbench.hooks.ts | Agrupa mutaciones para guardar orden, crear/editar/eliminar líneas, labels, allocations y tareas asociadas. |