> ## Documentation Index
> Fetch the complete documentation index at: https://docs.camtomx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Seguimiento operaciones aduaneras en tiempo real

> Tracking del despacho aduanal: estatus por operacion, filtros por cliente, changelog de cambios y reportes en Excel para tu agencia.

Lifeline permite visualizar el estatus de cada operacion aduanera y sus partidas en tiempo real. El panel principal muestra todas las operaciones organizadas por su estatus actual (draft, processing, validated, completed), y cada operacion se puede expandir para ver el detalle de sus partidas individuales. Puedes filtrar por cliente, tipo de operacion, rango de fechas o estatus para encontrar rapidamente lo que necesitas. Cada operacion mantiene un timeline con el historial completo de cambios (changelog), permitiendo saber exactamente que paso, cuando y quien lo hizo: usuario, IA o sistema. Para equipos con multiples operadores, Lifeline ofrece visibilidad compartida que elimina la necesidad de preguntar "en que va la operacion" por correo o mensaje.

## Vista general de operaciones

El panel principal de Lifeline presenta las operaciones en una vista de lista que muestra:

* **Referencia** interna de la operacion (minimo 3 caracteres)
* **Cliente** asociado
* **Tipo**: Importacion o exportacion
* **Numero de partidas** y cuantas estan completas
* **Estatus** actual con indicador visual
* **Etapa actual** (step) de la operacion
* **Fecha de creacion** y ultima actualizacion

<Tip>
  Usa la vista de pipeline para ver tus operaciones organizadas en columnas por estatus. Esto facilita identificar rapidamente operaciones estancadas o cuellos de botella en tu flujo de trabajo.
</Tip>

## Estatus de operaciones

Cada operacion se encuentra en uno de los siguientes estatus que reflejan su avance real en el proceso:

<Tabs>
  <Tab title="Extracting">
    Se estan extrayendo datos de los documentos asociados a la operacion mediante CamtomDocs. Este estatus se activa automaticamente cuando se suben documentos y se inicia la extraccion.

    **Acciones tipicas:**

    * Esperar a que termine la extraccion de datos
    * Monitorear el progreso de la extraccion
  </Tab>

  <Tab title="Draft">
    La operacion esta en borrador. Los documentos ya fueron procesados (o no se subieron documentos) y la operacion esta lista para que el operador capture o revise las partidas.

    **Acciones tipicas:**

    * Completar datos del encabezado del pedimento
    * Agregar y capturar partidas
    * Solicitar documentos faltantes al cliente
    * Asignar responsable
  </Tab>

  <Tab title="Processing">
    La operacion esta activa. Las partidas estan siendo capturadas, clasificadas o revisadas. Este es el estatus donde ocurre la mayor parte del trabajo operativo.

    **Acciones tipicas:**

    * Completar campos de las partidas
    * Ejecutar sugerencias de IA (clasificacion y datos del pedimento)
    * Asociar documentos desde CamtomDocs
    * Revisar y aceptar o rechazar sugerencias
    * Generar cotizaciones con Quoter
  </Tab>

  <Tab title="Validated">
    Todas las partidas han sido validadas. La operacion esta lista para proceder al despacho aduanero. Los datos del pedimento estan completos y verificados.

    **Acciones tipicas:**

    * Revision final antes del despacho
    * Generar el pedimento
    * Preparar documentos con Digiter para VUCEM
  </Tab>

  <Tab title="Completed">
    El despacho aduanero se ha concretado. La operacion queda en el historial para consulta, auditoria y glosa posterior.

    **Acciones tipicas:**

    * Exportar reporte final en Excel
    * Revisar changelog para auditoria
    * Archivar documentacion
  </Tab>
</Tabs>

<Note>
  Tambien existe el estatus `extraction_error` que indica que ocurrio un error durante la extraccion de datos de los documentos. En ese caso, el operador puede reintentar la extraccion o proceder a captura manual.
</Note>

## Tracking a nivel de partida

Dentro de cada operacion, las partidas tienen su propio seguimiento individual. Esto es clave porque en una operacion con 20 partidas, algunas pueden estar completas mientras otras aun estan pendientes de clasificacion o datos.

### Informacion por partida

Cada partida muestra los campos estandar del pedimento aduanal mexicano (Anexo 22):

| Campo                           | Descripcion                                                   |
| ------------------------------- | ------------------------------------------------------------- |
| Secuencia (sec)                 | Consecutivo dentro de la operacion                            |
| Descripcion                     | Descripcion de la mercancia (minimo 5 caracteres)             |
| Fraccion arancelaria            | Codigo HS de 8 digitos                                        |
| NICO                            | Numero de Identificacion Comercial (2 digitos)                |
| Pais de origen/destino (p\_od)  | Codigo ISO de 3 letras                                        |
| Pais vendedor/comprador (p\_vc) | Codigo ISO de 3 letras                                        |
| Valor aduanero (valAdu\_valUsd) | Valor en aduana o USD                                         |
| Cantidad UMC                    | Cantidad en unidad de medida comercial                        |
| Cantidad UMT                    | Cantidad en unidad de medida de tarifa                        |
| Metodo de valoracion (met\_val) | 0-6 segun los metodos de valoracion de la OMC                 |
| Vinculacion (vinc)              | 0-2, relacion entre comprador y vendedor                      |
| Documentos                      | Documentos asociados desde CamtomDocs                         |
| Sugerencias de IA               | Estado de las sugerencias (pendientes, aceptadas, rechazadas) |

### Sugerencias de IA por partida

Lifeline genera sugerencias de IA para cada partida en dos scopes (alcances) que se procesan de forma concurrente:

**Scope "clasificacion":**

* Sugiere la **fraccion arancelaria** (8 digitos) y el **NICO** (2 digitos)
* Usa internamente el workflow de clasificacion de TariffPro
* Enriquece la descripcion con el precio unitario cuando esta disponible
* Incluye nivel de confianza, resumen de clasificacion y razonamiento

**Scope "datos del pedimento":**

* Sugiere **regulaciones** (RRNA) aplicables a la fraccion
* Sugiere **identificadores** del Anexo 22
* Genera una **descripcion** optimizada para el pedimento (maximo 80 caracteres)
* Sugiere la **unidad de medida de tarifa** (UMT)

Cada sugerencia tiene un estado individual:

| Estado     | Significado                                           |
| ---------- | ----------------------------------------------------- |
| `pending`  | Sugerencia generada, pendiente de revision            |
| `accepted` | El operador acepto la sugerencia y se aplico al campo |
| `rejected` | El operador rechazo la sugerencia                     |

<Note>
  Las sugerencias de IA son orientativas. Siempre deben ser revisadas y confirmadas por el operador antes de finalizar la partida. El changelog registra quien acepto o rechazo cada sugerencia para trazabilidad completa.
</Note>

## Asociacion de documentos

Cada operacion y partida puede tener documentos asociados desde CamtomDocs. Los tipos de documento reconocidos son:

* **invoice** (factura comercial): Ampara el valor y descripcion de la mercancia
* **packing\_list** (lista de empaque): Detalla el contenido de cada bulto
* **other** (otros): Certificados de origen, documentos de transporte, certificados sanitarios, constancias de NOMs, etc.

Los documentos se asocian por referencia: el archivo original permanece en CamtomDocs y Lifeline mantiene el vinculo, evitando duplicacion de archivos.

## Timeline y changelog

El changelog es el registro cronologico de todos los cambios realizados en una operacion. Cada entrada incluye:

* **Fecha y hora** exacta del cambio
* **Actor**: `user` (operador humano), `ai` (inteligencia artificial) o `system` (proceso automatico)
* **Tipo de evento**: creacion, edicion de campo, extraccion, generacion IA, aceptacion/rechazo de sugerencia, etc.
* **Partida afectada** (si aplica)
* **Campo modificado** con valor anterior y nuevo
* **Metadatos** adicionales del cambio

<AccordionGroup>
  <Accordion title="Ejemplo de changelog">
    ```
    2026-03-07 14:32:15 — user: Maria Lopez
    Tipo: suggestion_accepted
    Partida 3: fraccion cambiada a 8471.41.01, NICO: 00
    Confianza: 0.92

    2026-03-07 14:30:00 — ai
    Tipo: ai_generation
    Partida 3: Sugerencias generadas (scope: clasificacion)
    fraccion: 8471.41.01, NICO: 00

    2026-03-07 14:28:03 — user: Carlos Ruiz
    Tipo: document_added
    Partida 3: Documento asociado — Factura_CL2026-0892.pdf

    2026-03-07 10:15:42 — system
    Tipo: status_change
    Operacion: Estatus cambiado de "draft" a "processing"
    ```
  </Accordion>

  <Accordion title="Uso en auditorias y glosa">
    El changelog es particularmente valioso durante auditorias del SAT/ANAM, glosa posterior o revisiones internas. Permite demostrar que cada dato fue ingresado o modificado con trazabilidad completa: quien lo hizo (usuario, IA o sistema), cuando, y cual fue el valor anterior. Esto cumple con los requisitos de control interno de la agencia aduanal y facilita la resolucion de discrepancias.
  </Accordion>
</AccordionGroup>

## Filtros y busqueda

Lifeline ofrece filtros para localizar operaciones rapidamente:

| Filtro            | Opciones                                            |
| ----------------- | --------------------------------------------------- |
| Estatus           | extracting, draft, processing, validated, completed |
| Tipo de operacion | Import, Export                                      |
| Cliente           | Seleccion del catalogo de clientes                  |
| Fecha             | Rango de fechas de creacion o actualizacion         |
| Referencia        | Busqueda por referencia interna de la operacion     |

<Tip>
  Combina filtros para obtener vistas especificas. Por ejemplo, filtra por "processing" + "Import" + un cliente especifico para ver todas las importaciones activas de ese cliente.
</Tip>

## Exportacion de reportes

Desde la vista de operaciones puedes exportar reportes en Excel con los datos filtrados. Los reportes incluyen:

* Datos generales de cada operacion (encabezado del pedimento)
* Detalle de partidas con fraccion arancelaria, NICO, valores y unidades de medida
* Contribuciones calculadas por partida
* Estatus actual y fechas clave
* Resumen de totales por operacion

Estos reportes son utiles para:

* **Informes a clientes**: Enviar el estatus de sus operaciones
* **Analisis operativo**: Identificar tiempos promedio de despacho, carga de trabajo por operador
* **Glosa y auditoria**: Revision documental y fiscal de las operaciones
* **Reportes gerenciales**: Volumen de operaciones, metricas de productividad

## Proximos pasos

<CardGroup cols={2}>
  <Card title="Flujo de operaciones" icon="diagram-project" href="/learn/lifeline/operations-flow">
    Conoce el flujo completo desde la creacion hasta la finalizacion de una operacion.
  </Card>

  <Card title="¿Qué es Lifeline?" icon="circle-info" href="/learn/lifeline/overview">
    Regresa al overview general de Lifeline.
  </Card>
</CardGroup>
