Flujo de Packing

Crear el packing desde una pick list

Click en + Nuevo Packing. El modal lista las pick lists del almacén en estado COMPLETED o IN_PROGRESS (las que ya tienen stock pickeado). Seleccioná una y confirmá.

POST /api/packing  Body: { pick_list_id, notes? }

El backend:

• Valida que la pick list esté en estado válido
• Garantiza unicidad (no permite duplicar packing para misma pick list)
• Asigna pack_number consecutivo (nextDocNumber('PACK'))
• Inserta packing_orders con status=OPEN y hereda customer_code/customer_name/sap_doc_entry de la pick list
• Para cada línea PICKED con picked_qty > 0 inserta una fila en packing_lines con status=PENDING

Abrir el detalle

Click en Ver. Se despliega el detalle inline con las líneas, el input de escaneo y el botón Completar Packing.

GET /api/packing/{id}

El backend devuelve la cabecera + lines con quantity, packed_qty, batch_number, sap_line_num, container_id.

Escanear el item

El operador escanea (o tipea) el código de barras del producto en pack-scan-input y presiona Enter.

POST /api/packing/{id}/scan  Body: { barcode | item_code }

El backend valida que el item esté esperado en la orden y no haya sido empacado todavía. Devuelve la línea matcheada, lo esperado, lo packed y lo restante.

Confirmar la línea

El operador confirma la cantidad empacada (total o parcial) y, opcionalmente, asigna el contenedor.

POST /api/packing/{id}/pack-line/{line_num}  Body: { quantity?, container_id? }

El backend acumula packed_qty. Si alcanza quantity → status=PACKED; sino queda como PENDING (acepta empaque parcial en múltiples corridas).

Completar el packing

Una vez todas las líneas están PACKED, click en Completar Packing.

POST /api/packing/{id}/complete

El backend:

• Verifica que no haya líneas pendientes (caso contrario rechaza)
• Actualiza packing_orders.status=COMPLETED + completed_at
• Inserta registro en sap_sync_log con status=PENDING y mensaje «Esperando despacho para crear DeliveryNote»

Crear el despacho

Click en + Nuevo Despacho. Al abrirse el modal dispara:

• GET /api/sap/drivers — lista de CENT_CHOFERES (UDO de SAP)
• GET /api/sap/vehicles — lista de CENT_VEHICULOS (UDO de SAP)

Operador selecciona chofer, vehículo (auto-completa patente y transportista), ingresa kilómetros estimados y confirma.

POST /api/dispatch

// payload
{
  "warehouse_id":  16,
  "driver_code":   "967186",        // CENT_CHOFERES.Code
  "driver_name":   "JOSE BENITEZ",
  "vehicle_code":  "0001",          // CENT_VEHICULOS.Code
  "vehicle_plate": "HDS255",
  "km_estimate":   15,
  "carrier":       "COMFAR S.A.E.C.A."
}

Asignar el packing al despacho

POST /api/dispatch/{id}/assign  Body: { packing_order_id }

El backend valida que el packing esté COMPLETED, que no esté ya asignado a otro despacho, y crea una dispatch_lines por cada packing_lines. Pasa el despacho a status=LOADING.

(Opcional) Escanear contenedores para verificación

POST /api/dispatch/{id}/scan-container

Marca dispatch_lines.status=VERIFIED al matchear el LPN escaneado.

Cerrar el despacho — aquí se crea la SAP DeliveryNote

POST /api/dispatch/{id}/close

El backend ejecuta atomicamente:

1. Valida que estén cargados driver_code, vehicle_code, km_estimate
2. Por cada packing asignado:
   • Registra movimiento de stock DISPATCH (salida AVAILABLE)
   • Lee el SO origen de SAP para heredar CardCode, DocCurrency, DocRate
   • Construye el payload de la SAP DeliveryNote
   • POST /b1s/v1/DeliveryNotes
   • Persiste packing_orders.sap_delivery_entry y sap_delivery_num
   • Loguea en sap_sync_log con status=SUCCESS
3. Actualiza dispatches.status=DISPATCHED + dispatched_at + dispatched_by