# Manual de Uso — Control Tower

**ASERCOL S.A. · Módulos de Importaciones**

Cómo usar los tres módulos de Importaciones: **Órdenes de Compra V2**, **Programación de Arribos** y **Control de Contenedores**. Qué muestra cada pantalla, qué significa cada semáforo y qué pasa cuando presionas cada botón.

| | |
|---|---|
| Módulos | 3 |
| Perfil | Cliente y operación |
| Origen de datos | Websimex (ERP) + registros del propio CTC |

---

## Contenido

- [Antes de empezar](#antes-de-empezar)
- [1 · Órdenes de Compra V2](#1--órdenes-de-compra-v2)
  - [El embudo: cuatro fases](#el-embudo-cuatro-fases)
  - [Buscar y filtrar](#buscar-y-filtrar)
  - [Columnas de la tabla](#columnas-de-la-tabla)
  - [Detalle, acciones y permisos](#detalle-acciones-y-permisos)
- [2 · Programación de Arribos](#2--programación-de-arribos)
  - [Los cuatro indicadores](#los-cuatro-indicadores)
  - [Columnas y semáforos](#columnas-y-semáforos)
  - [Asignar transporte a un pedido](#asignar-transporte-a-un-pedido)
  - [Enviar la prealerta al transporte](#enviar-la-prealerta-al-transporte)
- [3 · Control de Contenedores](#3--control-de-contenedores)
  - [El ciclo de una unidad de carga](#el-ciclo-de-una-unidad-de-carga)
  - [Columnas de la tabla](#columnas-de-la-tabla-1)
  - [La hoja de seguimiento](#la-hoja-de-seguimiento)
- [Preguntas frecuentes](#preguntas-frecuentes)

---

## Antes de empezar

El Control Tower no reemplaza al ERP aduanero: lo lee. Todo lo que ves en estos tres módulos se alimenta de **Websimex** y de lo que tu equipo registra en el propio CTC.

### Solo ves lo tuyo

Al ingresar, la sesión queda amarrada a tu **grupo empresarial** y a las compañías activas que le pertenecen. Ningún filtro, búsqueda ni enlace directo muestra operaciones de otro cliente.

Si tu usuario está registrado como **tercero** (por ejemplo, un operador que consulta a nombre de varios clientes), verás los grupos que te asignaron y tu acceso será de **solo consulta**: no aparecen los botones de crear, editar ni anular.

### Los guiones y los "SIN INFO" no son errores

Cuando una casilla muestra `—` o `SIN INFO`, significa que ese dato todavía no existe en el ERP para esa operación. No se inventa ni se estima: aparece en cuanto la aduana, la naviera o el equipo de operación lo registran.

### Dos velocidades de dato

- Las **fechas de arribo, levante, descargue y nacionalización** llegan del ERP y se actualizan solas.
- Las **citas de retiro, plantas de destino, transportadores y devoluciones** las escribe tu equipo dentro del CTC: si están vacías, es porque nadie las ha diligenciado todavía.

---

## 1 · Órdenes de Compra V2

Responde una sola pregunta, para todas tus órdenes emitidas a la vez: *¿dónde está cada una y cuál se está atrasando?*

| | |
|---|---|
| **Ruta** | `/impo/order-v2` |
| **Quién lo usa** | Compras, comercio exterior, analistas de cliente |
| **Qué responde** | Avance de la orden desde que se emite hasta que llega completa |

### El embudo: cuatro fases

La franja superior clasifica **todas** las órdenes del año seleccionado en cuatro fases. No es un dato que alguien digite: el sistema lo deduce cada vez que consultas, comparando la orden con sus órdenes de servicio en el ERP.

| Fase | Avance | Cuándo aplica |
|---|---|---|
| **Sin Confirmar** | ▮▯▯▯ | La orden se envió al proveedor y todavía no hay ni orden de servicio ni fecha estimada de despacho. |
| **Sin Embarcar** | ▮▮▯▯ | Ya hay operación abierta, pero la carga aún no sale. El pie de la tarjeta indica si tiene o no documento de transporte. |
| **En Tránsito** | ▮▮▮▯ | Al menos una orden de servicio tiene ETA y aún no registra llegada de mercancía. |
| **Con Arribo** | ▮▮▮▮ | Llegó *todo* lo de la orden. El pie dice *conforme* si no queda saldo, o *con novedad* si falta cantidad por recibir. |

> **Regla clave.** Una orden con varias órdenes de servicio toma siempre la **fase menos avanzada**. Si de tres embarques llegaron dos, la orden sigue apareciendo *En Tránsito*, no *Con Arribo*.

Cada tarjeta es además un filtro: al hacer clic, la tabla muestra solo esa fase y la tarjeta se marca como *Filtrando*; al volver a hacer clic, se libera.

Arriba a la derecha, **Conversión total del embudo** es el porcentaje de órdenes del año que ya llegaron completas. El botón **Ocultar embudo** pliega la franja y le devuelve espacio a la tabla.

### Buscar y filtrar

| Control | Qué hace |
|---|---|
| **Buscador** | Busca por **número de pedido**, **supplier**, **SED** (escribe solo el número de semana, 1 a 53) y **número de contenedor** (mínimo 4 caracteres). Presiona `Enter` o el botón **Consultar**. |
| **Año** | Acota por año de la fecha de la orden. Arranca en el año en curso si hay órdenes; si no, en el más reciente disponible. |
| **Segmento** | Solo aparece si tu compañía maneja segmentación de clientes. El nombre del filtro es el que tu empresa definió. |
| **Todas** | Quita el filtro comercial y deja las órdenes del año completo. |
| **Abiertas** | Órdenes sin operación abierta todavía, más las que están en proceso con saldo pendiente. |
| **Cerradas** | Se facturó cantidad y no queda saldo por recibir. |
| **⚠ En riesgo** | ETA vencida sin arribo, **o** más de **7 días** sin respuesta del proveedor sobre una orden ya emitida. |
| **Limpiar** | Aparece cuando hay búsqueda o filtros activos y los borra todos de una vez. |

> **Si no aparece lo que buscas.** Cuando la búsqueda no da resultados en el año consultado, el sistema revisa los demás años y ofrece botones como `2024 (3)`. Es el caso típico al buscar por contenedor: la orden existe, pero es de un año anterior. Un clic te lleva allí.

### Columnas de la tabla

| Columna | Qué muestra |
|---|---|
| **Orden** | Número de pedido y fecha de la orden. Si la orden consolida varios pedidos, verás `+2` al lado: pasa el cursor para ver todos. El símbolo ⚠ junto a la fecha avisa que la fecha registrada es posterior a hoy — conviene revisar el dato de origen. |
| **Compañía** | Solo se muestra si tu grupo tiene más de una compañía importadora. |
| **Supplier / Origen** | Proveedor y país de origen. |
| **SED** | Semana del año (ISO) de la fecha estimada de despacho. |
| **Ruta** | Puerto de origen → puerto de destino. Aparece solo si ambos están registrados. |
| **ETA** | Fecha estimada de arribo de **lo que aún no ha llegado**. Si ya llegó todo, muestra la ETA original. Se resalta en ámbar cuando la orden está en riesgo. |
| **Avance del ciclo** | La barra de cuatro segmentos con la fase y su detalle: *en curso*, *parcial 40%*, *ETA vencida*, *booking confirmado*, *conforme*… |
| **Recibido** | Cantidad facturada sobre cantidad ordenada. La diferencia es el saldo. |

### Detalle, acciones y permisos

Haz clic en cualquier parte de la fila para **desplegar el detalle**. Se abre una sola orden a la vez y muestra: importador, fecha estimada de despacho, cuántas órdenes de servicio tiene y cuántas ya arribaron, el saldo, y las líneas de producto con código, nombre, categoría, cantidad y precio, con sus totales al pie. Un producto sin homologar aparece como *Producto no homologado*.

| Acción | Dónde está | Quién puede |
|---|---|---|
| **+ Nueva Orden** | Arriba a la derecha | Usuarios con permiso de edición. No visible para terceros. |
| **Carga masiva** | Junto a *Nueva Orden* | Usuarios con permiso de edición. |
| **Editar** | Icono al final de la fila | Todos menos terceros. |
| **Anular** | Icono de papelera | Solo con permiso de edición y solo si la orden **no está cerrada**. Pide confirmación y no se puede deshacer. |

El listado pagina de **25 en 25**. Al cambiar de página, el detalle abierto se cierra.

> **Avisos de configuración.** Una franja ámbar en la parte superior indica un problema de parametrización, no un error tuyo: *"Tu acceso no tiene grupos empresariales asignados"* o *"Los grupos que consultas usan formas distintas de enlazar con el ERP"*. En ambos casos, avisa al administrador: los conteos pueden quedar incompletos.

---

## 2 · Programación de Arribos

La agenda de lo que está por llegar. Muestra las operaciones vivas, ordenadas por ETA, con el estado documental de cada una y —si tu compañía administra transporte— la asignación y prealerta a los transportadores.

| | |
|---|---|
| **Ruta** | `/impo/arribos` |
| **Quién lo usa** | Operación, logística de entrada, coordinadores de transporte |
| **Qué responde** | Qué llega esta semana y qué le falta para poder retirarse |

### Qué operaciones aparecen

El listado es de **operaciones abiertas**: importaciones con ETA registrada que **todavía no** tienen fecha de llegada de mercancía ni factura de servicio, abiertas desde marzo de 2023 y no anuladas.

Una operación **desaparece del listado** cuando arriba y se envía a facturar — eso es normal y significa que el ciclo se cerró.

### Los cuatro indicadores

Las tarjetas superiores se calculan sobre las operaciones que arribaron **en el mes en curso**:

| Indicador | Cómo se calcula |
|---|---|
| **Promedio Ciclo Importación** | Días entre la fecha del documento de transporte y la fecha de levante. |
| **Pedidos en Riesgo** | Operaciones que arriban dentro de 2 días o menos y todavía no tienen el BL original cargado. |
| **Entrega Doc. BL** | Días promedio entre la fecha del documento de transporte y la carga del BL original al CTC. |
| **Cumplimiento Doc. (BL)** | Porcentaje de operaciones cuyo BL original se cargó **antes** del arribo. |

### Filtros

Proceso, sucursal, rango de **ETA inicial / ETA final**, segmento de cliente y buscador.

El buscador acepta **número de DO**, **número de pedido**, **número de documento de transporte** y **nombre del importador**; presiona `Enter` o **Consultar**.

Si escribes solo la ETA inicial, el sistema toma como final el 31 de diciembre del año en curso. Haz clic en el encabezado **ETA** para alternar el orden ascendente y descendente.

> **Ojo.** El selector **Tipo Declaración** está visible en la barra pero hoy **no filtra** el listado. Para ubicar el tipo de declaración usa la columna **DIM** de la tabla.

### Columnas y semáforos

| Columna | Qué muestra |
|---|---|
| **# DO** | Número de la orden de servicio en el ERP. Es la llave para rastrear la operación en cualquier módulo. |
| **Pedido** | Número de pedido del cliente. |
| **Cliente** | Razón social del importador. |
| **Pto Arribo** | Sucursal operativa donde arriba la carga. |
| **ETA** | Fecha estimada con semáforo, y debajo los días que faltan o la etiqueta `ARRIBADO`. |
| **Motonave** | Nombre del buque o vuelo del documento de transporte. |
| **DIM** | Tipo de declaración de importación. |
| **Modo Transporte** | Marítimo, aéreo o terrestre. |
| **Tipo Carga** | `FCL` o `LCL` con el número de unidades de carga. |
| **Transporte** | Transportador asignado, o *SIN ASIGNAR*. |
| **Documentación** | `Completa` o `Pendiente`. Pasa el cursor sobre *Pendiente* para ver exactamente qué documento falta. |

#### Cómo leer los colores

| Señal | Significado |
|---|---|
| 🟢 **ETA verde** | Faltan más de 5 días para el arribo. |
| 🟡 **ETA amarilla** | Faltan entre 2 y 4 días. |
| 🔴 **ETA roja** | Menos de 2 días, o la ETA ya se venció (días en negativo). |
| 🔴 **Documentación pendiente** | Falta al menos un documento original obligatorio. |
| 🔵 **Fila celeste** | Ese pedido ya fue prealertado al transportador. |

#### Qué documentos se exigen

Siempre **factura comercial** y **lista de empaque**, más el documento de transporte según el modo:

| Modo | Documento de transporte |
|---|---|
| Marítimo | BL original |
| Aéreo | Guía Aérea |
| Terrestre | Carta de Porte |

Deben estar cargados en el CTC en modo *ORIGINAL* y activos; una copia digital no cuenta para el semáforo.

### Detalle de la operación

La flecha al inicio de cada fila abre un panel con tres pestañas: **Detalle Importación**, **Facturas** y **Unidades de Carga**, cada una con su contador. La información se trae en el momento de abrir, por eso verás un instante de *Cargando…*. Solo se mantiene un detalle abierto a la vez.

### Asignar transporte a un pedido

Disponible únicamente si tu compañía está configurada para administrar transporte. En ese caso aparece el botón de camión al final de cada fila.

1. Haz clic en el **botón de camión** de la fila. El modal muestra pedido, documento de transporte, puerto de arribo, ETA y tipo de carga, para que confirmes que es la operación correcta.
2. Selecciona el **Transportador**. Es obligatorio: sin él el sistema muestra *"Seleccione un transportador para continuar con la operación"*.
3. Selecciona la **Planta** de destino si aplica.
4. Presiona **Guardar**. La asignación se replica a **todas las unidades de carga activas** de esa DO y queda visible de inmediato en la columna Transporte y en Control de Contenedores.

Volver a abrir el modal sobre la misma DO permite cambiar el transportador o la planta: se actualiza la asignación existente, no se crea una nueva.

### Enviar la prealerta al transporte

El botón **Transporte** de la barra superior abre la distribución de pedidos por transportador que **aún no han sido prealertados**, con el número de pedidos y de unidades de carga de cada uno.

1. Revisa la fila del transportador: cantidad de pedidos y de unidades asignadas.
2. Presiona **Enviar**. Se envía un correo a los contactos registrados de ese transportador, con copia al coordinador de ASERCOL.
3. El correo lleva el asunto *PREALERTA PARA RETIRO DE MERCANCÍA* y una tabla con pedido, contenedor, tamaño, kilos brutos, número de bultos, ETA, puerto destino y planta.
4. Los pedidos quedan marcados como notificados, con su fecha, y sus filas pasan a mostrarse en celeste.

> **No tiene reversa.** La prealerta sale a **todos** los contactos del transportador en el momento en que presionas *Enviar*, y el pedido queda marcado como notificado. Verifica el transportador y la asignación antes de enviar: no hay botón para deshacer el envío.

### Descargar el listado

El botón **Descargar** genera un Excel con lo que está en pantalla — *Reporte de Operaciones Abiertas Importaciones* — incluyendo BL, fechas, días para arribo, tipo de carga, agente, transportador, pendientes documentales y producto. En listados grandes puede tardar unos segundos; espera el mensaje de la aplicación sin volver a presionar.

### Gráficos laterales

La columna derecha resume el mismo listado que estás viendo: distribución por tipo de carga, por puerto de arribo y por transportador. Cambian con cada consulta.

---

## 3 · Control de Contenedores

Sigue cada unidad de carga desde que arriba al puerto hasta que el vacío se devuelve, y avisa cuándo estás a punto de generar bodegajes o demoras.

| | |
|---|---|
| **Ruta** | `/impo/control-contenedores` |
| **Quién lo usa** | Operación en puerto, logística de planta, control de costos |
| **Qué responde** | Cuántos días libres quedan y hasta cuándo se puede retirar y devolver |

### Las dos pestañas

- **En Proceso** reúne las unidades que aún no tienen fecha de devolución del vacío.
- **Finalizados**, las que ya la tienen.

Cada pestaña muestra su conteo. Una unidad se mueve de una a otra en el momento en que alguien registra la fecha de devolución en la hoja de seguimiento.

El buscador filtra por **DO**, **pedido**, **número de contenedor** o **nombre del importador** mientras escribes. El encabezado **ETA** ordena el listado.

> **Módulo parametrizado.** Qué tipos de carga entran a este control, y si se muestran solo las unidades ya arribadas o desde determinada fecha, se define por cliente. Por eso dos empresas pueden ver universos distintos en la misma pantalla.

### El ciclo de una unidad de carga

Las columnas de la tabla siguen este orden, que es el orden real de la operación:

| # | Etapa | Detalle |
|---|---|---|
| 01 | **ETA** | Fecha estimada de arribo. *Viene del ERP* |
| 02 | **Arribo** | Llegada real de la mercancía. Arranca el reloj de los días libres. *Viene del ERP* |
| 03 | **Descargue** | Descargue en puerto. *Estado de hecho 0505* |
| 04 | **Nacionalización** | Mercancía nacionalizada. *Estado de hecho 2001* |
| 05 | **Retiro en puerto** | Cita programada para sacar el contenedor. *Lo registra tu equipo* |
| 06 | **Ingreso a planta** | Llegada al CEDI de destino. *Lo registra tu equipo* |
| 07 | **Devolución del vacío** | Cierra el ciclo y pasa la unidad a *Finalizados*. *Lo registra tu equipo* |

### Columnas de la tabla

| Columna | Qué muestra |
|---|---|
| **Icono de contenedor** | Abre la **hoja de seguimiento** de esa unidad. |
| **# Contenedor · # DO · Pedido** | Identificación de la unidad y de la operación a la que pertenece. |
| **Tipo Carga** | `FCL` o `LCL`. |
| **Días Para Arribo** | Punto 🟢 verde mientras la ETA no se ha cumplido; 🔴 rojo cuando ya pasó. Si la mercancía llegó, muestra `ARRIBADO`. |
| **Fecha Descargue / Nacionalización** | Hitos aduaneros reportados por el ERP. |
| **Eficiencia Nacionalización** | Días transcurridos entre el descargue y la nacionalización. |
| **Transportador** | El asignado en Programación de Arribos. |
| **Días Libres Puerto** | Días sin costo de bodegaje según el puerto y el tipo de carga, parametrizados para tu compañía. |
| **Fecha Máxima Retiro** | Arribo + días libres de puerto. Es la fecha tope para sacar sin bodegajes. |
| **Retiro Mercancía** | Fecha de la cita de retiro registrada en la hoja de seguimiento. |
| **Planta / Ingreso Planta** | CEDI de destino y fecha de ingreso. |
| **Días Libres Naviera** | Días sin costo de demoras otorgados por la naviera para esa DO. |
| **Fecha Máxima Devolución** | Arribo + días libres de naviera. Fecha tope para devolver el vacío. |
| **Fecha / Lugar Devolución** | Cuándo y dónde se devolvió el contenedor. |

#### Los dos puntos que hay que mirar

Junto a **Fecha Máxima Retiro** y a **Fecha Máxima Devolución** aparece un punto intermitente. Es la alerta económica del módulo:

| Punto | En Fecha Máxima Retiro | En Fecha Máxima Devolución |
|---|---|---|
| 🟢 **Verde** | El retiro quedó programado dentro de los días libres: **sin bodegajes**. | La devolución ocurrió dentro del plazo: **sin demoras**. |
| 🔴 **Rojo** | La cita quedó **después** de la fecha tope: se generan bodegajes. | El vacío se devolvió **después** de la fecha tope: se generan demoras. |

> **Si no ves el punto ni la fecha tope.** Las fechas máximas solo se calculan cuando existen los días libres parametrizados *y* la fecha de arribo. Si la columna de días libres muestra **0 DIA(S)**, falta la parametrización del puerto o de la naviera: pídela al administrador para que la alerta funcione.

### La hoja de seguimiento

Se abre con el icono de contenedor. Es la pantalla donde tu equipo registra todo lo que el ERP no sabe. Está dividida en cuatro bloques.

#### 1 · Identificación y destino

| Campo | Cómo se diligencia |
|---|---|
| **Orden de compra · Contenedor** | Solo lectura: vienen de la operación. |
| **ITR** | **SI** / **NO**. Obligatorio para guardar. |
| **CEDI** | Centro de distribución de destino. El botón **+** permite crear uno nuevo sin salir de la pantalla; queda disponible para el importador de esa operación. |
| **Fecha de cita CEDI** | Fecha acordada de ingreso a planta. |
| **Sucursal puerto de retiro** | Puerto desde donde se retira. |
| **Transportador** | **Bloqueado**. Se hereda de la asignación hecha en Programación de Arribos; para cambiarlo, hazlo desde ese módulo. |
| **Observaciones** | Texto libre. Se guarda en mayúsculas. |

#### 2 · Citas para retiro en puerto

1. Escribe la **fecha de programación de retiro** y la **hora de cita**.
2. Presiona **Agregar Cita**. La cita queda `Activa` en la tabla inferior y alimenta la columna *Retiro Mercancía* del listado.
3. Para reprogramar: presiona la **✕** de la cita activa, escribe el motivo en **observaciones** y confirma con **Cancelar Cita**. Queda como `Cancelada`, con su motivo, en el historial.
4. Registra entonces la nueva cita.

Solo puede haber **una cita activa** por contenedor. Si intentas agregar otra, el sistema responde: *"El contenedor ya tiene una cita vigente para retiro en puerto"*. Mientras no exista ninguna, la pantalla muestra un aviso naranja recordándolo.

#### 3 · Productos del contenedor

Permite distribuir en cada contenedor los productos facturados de la DO. Al elegir un producto, el sistema calcula la **cantidad disponible** — lo facturado menos lo ya asignado a otros contenedores — para que no se asigne de más.

#### 4 · Control de entrega del transportador

| Campo | Para qué sirve |
|---|---|
| **Fecha de devolución** | Cierra el ciclo del contenedor y alimenta la alerta de demoras. |
| **Lugar de devolución** | Patio o depósito donde se entregó el vacío. También se pueden crear nuevos con el botón **+**. |
| **Fecha de colilla** | Fecha del soporte de devolución entregado por la naviera. |
| **Observaciones del transportador** | Novedades del retiro o de la entrega. Se guarda en mayúsculas. |

> **Al guardar.** **Guardar** escribe los cambios y te devuelve al listado. Si diligenciaste la **fecha de devolución**, la unidad deja de aparecer en *En Proceso* y pasa a *Finalizados*. **Cancelar** vuelve al listado sin guardar nada.

---

## Preguntas frecuentes

**Busqué un contenedor en Órdenes de Compra y no aparece nada.**
Escribe al menos 4 caracteres del número y revisa el aviso bajo la tabla: si la orden es de otro año, el sistema te ofrece el botón para saltar a ese año.

**Una orden ya llegó pero sigue apareciendo *En Tránsito*.**
La orden tiene varias órdenes de servicio y todavía falta que alguna registre llegada de mercancía. Abre el detalle: allí ves cuántas son y cuántas ya arribaron.

**En Arribos los días salen en negativo, y en Contenedores en positivo. ¿Cuál es cuál?**
En **Programación de Arribos** el número son los días que *faltan*: negativo significa ETA vencida. En **Control de Contenedores** se cuentan los días *transcurridos* desde la ETA: ahí el positivo con punto rojo es el que está vencido.

**La documentación aparece *Pendiente* y yo ya envié los papeles por correo.**
El semáforo solo mira los documentos **cargados en el CTC**, en modo ORIGINAL y activos. Enviarlos por correo no los registra. Pasa el cursor sobre *Pendiente* para ver cuál falta.

**No veo el botón de camión ni el botón Transporte.**
Esos controles solo aparecen si tu compañía está configurada para administrar transporte. Si tu operación lo requiere, solicítalo al administrador del Control Tower.

**Envié la prealerta al transportador equivocado.**
El correo ya salió y no se puede retirar desde la aplicación. Corrige la asignación de transporte en la fila y comunícate directamente con el transportador notificado.

**El transportador de la hoja de seguimiento está bloqueado.**
Es intencional: se hereda de Programación de Arribos para que exista una sola fuente de verdad. Cámbialo allí y se refleja en el contenedor.

**Un contenedor desapareció de *En Proceso*.**
Alguien registró su fecha de devolución. Búscalo en la pestaña *Finalizados*: el historial completo sigue ahí.

**No puedo anular una orden de compra.**
La anulación requiere permiso de edición y solo aplica a órdenes que no estén cerradas. Los accesos de tercero son de solo consulta.

---

*Control Tower · ASERCOL S.A. — Manual de uso de Importaciones*