> For the complete documentation index, see [llms.txt](https://softypaq.gitbook.io/centro-de-ayuda-softypaq/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://softypaq.gitbook.io/centro-de-ayuda-softypaq/app-del-operador/escaneo-de-paquetes.md).

# Escaneo de paquetes

Es la pantalla que se abre al presionar **Escanear** sobre una recolección. Aquí se van marcando uno a uno los paquetes conforme se recogen físicamente.

### Modos de captura

* **Cámara**: escanea el código de barras o QR de cada paquete (usa la cámara trasera del dispositivo).
* **Entrada manual**: escribe o pega el código de rastreo cuando el código físico no se puede escanear (dañado, ilegible, etc.).

### Qué pasa al escanear un código válido

* Si el código pertenece a una guía de este manifiesto y no se había escaneado antes, queda marcado como **Recolectado** y se suma a la lista de "hechas" en pantalla.
* Si el código **no pertenece a este manifiesto**, se muestra el aviso "*(código) — no pertenece a este manifiesto*" y no se registra nada.

### Alertas de duplicado

Si intentas escanear un paquete que **ya fue escaneado** (o que ya está marcado como no recolectado) dentro de la misma recolección, el sistema:

* Reproduce un **sonido de alerta** y **vibra** el dispositivo (si el navegador lo permite).
* Muestra un aviso indicando el folio y el evento con el que ya había quedado registrado.

Esto evita marcar un mismo paquete dos veces por accidente.

### Marcar un paquete como "No recolectado"

Cuando un paquete de la lista no se pudo recoger (el cliente no lo tenía listo, no estaba en el domicilio, etc.), se marca individualmente como **No recolectado** en lugar de escanearlo. Un paquete así marcado queda bloqueado para escaneo normal: si se intenta escanear después, salta la misma alerta de duplicado/bloqueo.

### Reportar un problema en un paquete

Sobre cualquier paquete de la lista se puede **reportar un problema**:

1. Se abre un panel para describir el problema con detalle (campo de texto libre).
2. Se pueden adjuntar hasta **3 fotos** como evidencia.
3. Al guardar, el reporte queda asociado a esa guía dentro de la recolección; puede consultarse después en modo de solo lectura.

### Cerrar la recolección desde el escáner

El botón **Cerrar** (con confirmación previa) cierra la recolección directamente desde esta misma pantalla, sin necesidad de volver a la lista de recolecciones asignadas. Si el manifiesto ya fue cancelado desde el panel administrativo mientras estabas escaneando, la app lo detecta y bloquea el cierre.

### Comportamiento sin conexión

El escáner funciona igual con o sin internet: si no hay conexión en el momento de escanear, el paquete se guarda localmente en el dispositivo y se marca como **pendiente de sincronizar** (mensaje *"✓ (código) — se sincronizará al reconectarse"*). Ver el detalle completo en Modo sin conexión.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://softypaq.gitbook.io/centro-de-ayuda-softypaq/app-del-operador/escaneo-de-paquetes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.