# control/embarque/paquete -[storeQuantities] Path: /var/www/html/qaservicesapp/app/Http/Controllers/ShalomControl/EmbarqueController.php ## 🧾 **Descripción** Este servicio registra el **embarque de paquetes** para una Orden de Servicio (OS). Valida toda la información crítica del embarque, verifica restricciones de rutas, valida si la OS está apta para embarque (QR / clave / no anulada), confirma cantidades, registra procesos históricos, actualiza estados de embarque y permite manejar escenarios: - Embarque normal - Embarque masivo - Embarque aéreo - Embarque desde cooler Es uno de los servicios centrales del módulo logístico. --- # 🚀 **Endpoint**

`POST /store-quantities`

--- # 📥 **Request Body** ### Campos requeridos

Campo	Tipo	Obligatorio	Descripción
ose\_id	number	Sí	ID de la Orden de Servicio a embarcar.
cantidad	number	Sí	Cantidad total declarada a embarcar.
cantidades	string (CSV)	Sí	Paquetes escaneados para este embarque.
usuario	string	Sí	Usuario que está realizando el proceso.
terminal	number	Sí	Terminal desde donde se embarca.
tipo\_cierre	"APP" \| "PDA"	Sí	Tipo de registro del embarque.
cap\_id	number	Sí	Carguero (ruta programada) asignado.

### Campos opcionales

Campo	Tipo	Descripción
cierre\_aereo	number	ID del cierre a registrar si es embarque aéreo.
cooler	string	Código del cooler si se embarca desde uno.
placa	string	Para embarque masivo (opcional).
traspaso	number (0/1)	Indica si permite traspaso entre terminales.

--- # 🔐 **Seguridad** Servicio protegido mediante autenticación de API interna del sistema. Requiere usuario autenticado y terminal válida. --- # 🧠 **Flujo del Servicio (resumen real)** A continuación, el flujo real y completo basado en tu código: --- ### 🔹 **1. Validación de parámetros obligatorios** - ose\_id - cantidades - cantidad - usuario - terminal - cap\_id - tipo\_cierre (solo APP o PDA) --- ### 🔹 **2. Obtiene la Orden de Servicio** Consulta: `emp_ordenservicio` Valida: - Existe la OS - No está anulada - Tiene QR o clave (según reglas del contacto) - Terminal de destino coincide para permitir embarque --- ### 🔹 **3. Valida retención de embarque aéreo** Consulta: `emp_retencion_embarque_aereo` Si existe → no permite embarque. --- ### 🔹 **4. Valida terminales, rutas y restricciones del carguero** Consulta: `emp_cargprogramado` Verifica: - Que el origen del carguero incluya la terminal actual (a menos que sea traspaso). - Restricciones de destino. - Que si es destino aéreo, la ruta sea aérea. Si alguna restricción aplica → error. --- ### 🔹 **5. Obtiene cantidades totales de la OS** Consulta: `emp_os_detalle` Calcula unidades totales. --- ### 🔹 **6. Verifica paquetes previamente desembarcados** Consulta: `emp_procesos_historial_app` Si encuentra que todos los paquetes ya están en destino → bloquea embarque. --- ### 🔹 **7. Verifica embarques previos** Consulta: `emp_embarque_historial` Evalúa: - embarque actual - cantidades ya registradas - estado de guía - si ya está 100% embarcada Si ya embarcó todos los paquetes → error. --- ### 🔹 **8. Registra o actualiza el embarque** Dos escenarios: #### a) **Primer registro** Inserta en: `emp_embarque_historial` #### b) **Actualización** Actualiza registro existente. --- ### 🔹 **9. Actualiza el estado de la Orden de Servicio** Actualiza en `emp_ordenservicio`: - estado de paquete - último carguero - estado de embarque general - fecha de embarque - marcas de validación --- ### 🔹 **10. Registra proceso histórico** En: `emp_procesos_historial_app` - Si no existe → inserta - Si existe → actualiza cantidades --- ### 🔹 **11. Procesos adicionales** - Si es embarque aéreo → actualiza `emp_embarque_aereo` - Si embarca desde cooler → marca estado del registro en `emp_cooler_guias` --- ### 🔹 **12. Respuesta final** Devuelve éxito y número de guía. --- # 📤 **Response 200 – Ejemplo** --- # ❗ **Posibles Errores** ### 1. Campos faltantes ### 2. OS no encontrada ### 3. OS anulada ### 4. OS sin QR o clave válida ### 5. Terminal no permitida ### 6. Restricción de embarque aéreo ### 7. Restricción de ruta ### 8. Paquetes ya embarcados ### 9. Error al actualizar embarque aéreo o cooler --- # 📚 **Schemas (estructuras usadas)** ### **emp\_ordenservicio** ### **emp\_embarque\_historial** ### **emp\_procesos\_historial\_app** ### **emp\_cooler\_guias** ### **emp\_embarque\_aereo** --- # 🗃 **Lógica en pseudo-código**

`validar parámetros requeridosorden = obtener OSsi no existe o está anulada -> errorvalidar QR o clavevalidar terminal de destinovalidar retenciones aéreasvalidar rutas, orígenes, restriccionesdetalle = obtener total de paquetes de OSprocesos_previos = obtener historialsi todos los paquetes ya están en destino -> errorembarques_previos = obtener embarquessi ya embarcados todos -> errorsi no existe embarque actual: insertar registro de embarquesino: actualizar registro existenteactualizar estado de OSregistrar proceso históricosi cierre_aereo -> actualizar emp_embarque_aereosi cooler -> actualizar emp_cooler_guiasreturn éxito`