# SERVICIOS COMPLEMENTARIOS #
![](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2025-12/embedded-image-pvmfqtuc.png) DOCUMENTACIÓN SOBRE EL NUEVO SERVICIO AÉREO PARA ENTREGA SHALOM 14/01/2026 Versión 0.1 Queda prohibido cualquier tipo de explotación y, en particular, la reproducción, distribución, comunicación pública y/o transformación, total o parcial, por cualquier medio, de este documento sin el previo consentimiento expreso y por escrito a overskull. ÍNDICE 1. INTRODUCCIÓN 1.1. Objetivo 1.2. Alcance 2. ROLES Y PERMISOS 3. REGLAS DEL SISTEMA 4. FLUJO DEL PROCESO 4.1. Acceso y Activación del Servicio Aéreo 4.2. Validación de Restricciones y Casos de Prueba 5. GESTIÓN DE SERVICIOS ADICIONALES 5.1. Visualización en Lista de Orden de Servicio 5.2. Detalle de Mercadería y Anotaciones 5.3. Comprobantes y Tickets 6. ANEXOS --- ### 1. INTRODUCCIÓN El presente documento detalla la implementación y normativa de la nueva función Agregar Servicio Aéreo en el sistema empresarial. Esta función permite la transición de envíos de modalidad terrestre a aérea, garantizando que el cambio cumpla con los estándares de seguridad y logística establecidos por la organización. #### 1.1. Objetivo Proporcionar una guía técnica y operativa para el registro de servicios complementarios aéreos, asegurando la correcta aplicación de cobros adicionales, validación de dimensiones y actualización de estados en los comprobantes de pago. #### 1.2. Alcance Módulo: EMPRESARIAL SISTEMAS GENERALES -> LISTA ORDEN DE SERVICIO. Sección: SERVICIOS COMPLEMENTARIOS. --- ### 2. ROLES Y PERMISOS - **Agencia de Origen:** Autorizada para realizar el cambio de modalidad de terrestre a aéreo antes del despacho. - **Departamento de Operaciones / Sistemas:** Supervisión de validaciones de backend y gestión de incidencias. --- ### 3. REGLAS DEL SISTEMA Para que una Orden de Servicio (OS) sea elegible para el Servicio Aéreo, debe cumplir con los siguientes criterios: - **Origen del Envío:** La guía debe haber sido emitida originalmente como TERRESTRE desde los canales Empresarial, Plataformas o App. - **Estado de la Guía:** Solo se permite agregar el servicio a guías que se encuentren en origen (sin estados de transporte avanzados). - **Restricciones de Mercadería:** Solo se permiten los tipos: Sobre, Paquete XXS, Mini paquetería XS, Paquete S, Paquete M y CAJA. - **Regla de Cantidad para CAJA:** Si el tipo de paquete es CAJA, el sistema restringe la operación a una cantidad máxima de 1 unidad. - **Pago de Flete:** Es requisito indispensable que el flete principal esté pagado para proceder con el pago del servicio complementario. --- ### 4. FLUJO DEL PROCESO #### 4.1. Acceso y Activación del Servicio Aéreo 1. **Navegación:** Ingresar a Lista Orden de Servicio y filtrar la guía deseada. 1. **Selección:** En el menú de la OS, seleccionar Servicios Complementarios. 2. **Configuración:** Elegir Tipo de servicio: Servicio Aéreo. 3. **Registro de Datos:** Es obligatorio ingresar el Tipo de Mercadería y el Contenido del Envío. 4. **Validación de Montos:** El sistema cambiará la etiqueta de Precio Final por Precio Adicional, mostrando únicamente el excedente por el cambio de modalidad. 5. **Confirmación:** Al procesar el pago, el monto total se refleja en el registro y desaparecen las alertas visuales de saldo pendiente. \[ INICIO \] | v \[ Módulo: Lista Orden de Servicio \] | v \[ Seleccionar OS (Estado: Terrestre / Origen) \] | v \[ Botón: Servicios Complementarios \] | v \[ Seleccionar: SERVICIO AÉREO \] | +---------------------------------------+ | VALIDACIÓN DE REQUISITOS | +---------------------------------------+ | | |-- ¿Tipo de paquete permitido? --------+--> \[ NO \] --> \[ Alerta: Mercadería no permitida \] | (Sobre, XXS, XS, S, M, CAJA) | \[ FIN DEL PROCESO \] | | |-- ¿Es CAJA y cantidad = 1? -----------+--> \[ NO \] --> \[ Alerta: Solo se permite 1 unidad \] | | \[ FIN DEL PROCESO \] | | |-- ¿Estado de OS es Origen? -----------+--> \[ NO \] --> \[ Bloqueo: Paquete en tránsito \] | | \[ FIN DEL PROCESO \] | | +------------------\[ SI \]---------------+ | v \[ Ingresar: Tipo de Mercadería y Contenido \] (Obligatorio) | v \[ Visualización de "Precio Adicional" \] | v \[ Ejecutar Pago de Servicio \] | +---------------------------------------+ | ACTUALIZACIÓN SISTEMA | +---------------------------------------+ | | |-- BD: Registro cambia "OTROS" a | | "1 SERVICIO AEREO" | | | |-- INTERFAZ: Desaparece texto rojo | | de saldo pendiente | | | |-- DOCUMENTOS: Emisión de Ticket y | | Comprobante Nubefact con Subtotal | | | +---------------------------------------+ | v \[ FIN \] #### 4.2. Validación de Restricciones y Casos de Prueba Basado en las pruebas funcionales realizadas (CPRUEBA), el sistema responde bajo los siguientes comportamientos: - **Paquete Inventariado (CPRUEBA-1/5):** Permite la adición si el paquete no tiene restricciones de tipo y permanece en el origen de la ruta. - **Restricción de Bultos (CPRUEBA-2/6):** Si un envío contiene múltiples paquetes y uno de ellos no es apto para vuelo (ej. bulto pesado o motocicleta), el sistema bloquea la transacción. - **Estado de Transporte (CPRUEBA-4):** Si el paquete ya cuenta con servicio de reparto o está en tránsito al destinatario, el sistema impide la modificación. - **Validación de Cantidad (CPRUEBA-7):** Al intentar agregar más de una unidad bajo el tipo CAJA, el sistema muestra la alerta: "Para tipo de paquete CAJA, solo se permite cantidad 1". --- ### 5. GESTIÓN DE SERVICIOS ADICIONALES #### 5.1. Visualización en Lista de Orden de Servicio Una vez adquirido el servicio, el registro en la Lista Orden de Servicio de empresarial se actualizará de la siguiente manera: - Anterior: OTROS. - Actualizado: 1 SERVICIO AEREO. #### 5.2. Detalle de Mercadería y Anotaciones Al consultar el Detalle Adicional, la sección de anotaciones debe mostrar automáticamente el nombre del servicio complementario junto con el tipo de mercadería seleccionado en el modal. #### 5.3. Comprobantes y Tickets El sistema ha sido actualizado para reflejar el cambio en todos los apartados de pagos y comprobantes emitidos mediante Nubefact: - **Ticket Corto/Largo:** Se inserta el ítem: SERVICIO AEREO | Cantidad: 1 | Subtotal: \[Monto adicional\]. - **Sincronización:** El nombre del servicio debe coincidir en la base de datos y en el código de facturación. --- ### 6. ANEXOS - **Entorno de Pruebas:** [https://sysqa.shalomcontrol.com/listaordenservicio](https://sysqa.shalomcontrol.com/listaordenservicio) - **Validación de Facturación:** Módulo de Pagos Servicios Complementarios.