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
The intent of Order Detail is to concentrate every decisión about a single order in one workspace.
Contexto para soporte
For a detail-page issue, include the order id, affected line, and whether the problem is pricing, traceability, invoice navigation, or task handoff.
Cómo funciona
Order Detail opens around one order and shows the commercial context, customer, dates, status, notes, invoice state, and totals. The user should be able to understand the order without jumping back to the list.
The main workspace manages order lines, compound products, lots, labels, comments, and task follow-up. This is where the user adds products, assigns stock, validates costs, and prepares the order for invoicing or delivery.
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 |
|---|---|
Back to orders | Returns to the order list. |
Change order status | Updates the operational status of the order. |
Add comment | Stores an operational note on the order. |
Copy link | Copies a direct link to the order. |
Export CSV | Exports order detail data for external review. |
Print detail | Opens a printable versión of the order. |
Invoice this order | Starts billing from the current order. |
View invoice | 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. |
Create label | Creates a preparation or pharmacy label for a line. |
View product lots | Shows lot availability for a selected product. |
New task | Creates a task linked to this order. |
Save order | Persists changes to order data, comments, totals, or lines. |
Edit | Opens an editable line or allocation. |
Delete | Removes a line, allocation, or comment when allowed. |
Create Ticket | Abre una solicitud de soporte con esta página ya adjunta como contexto. |
Mapa de contenido
Parte superior de Order Detail
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 New task, Export CSV, Print detail, Invoice this order, Copy link, Go to Tasks y Back to Orders.
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 Save 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.
- Edit line.
- Delete line.
- Manage lots o allocations.
- Create label.
Bloques posteriores
Traceability and support
Zona para tareas, movimientos, calidad y evidencia alrededor de la orden.
Contenido visible
- Tasks 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 New task dentro de Order Detail y guarda la tarea. | Toast temporal del frontend y módulo Tasks. | 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 Order Detail, 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, New task desde Order Detail 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. |