Ir al contenido principal

SERVICIOS COMPLEMENTARIOS













                                            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