> 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/operacion/guias-de-envio.md).

# Guías de envío

Es el módulo central de la operación: aquí se crean, editan, imprimen y dan seguimiento a las **guías** (órdenes de envío). Cada guía puede tener uno o varios **paquetes** asociados.

### Estados de una guía

Una guía transita por los siguientes estados:

* **Borrador** — recién creada, aún editable libremente.
* **Confirmada** — activada, lista para logística/recolección.
* **En tránsito**
* **Entregada**
* **Cancelada**

### Crear una guía nueva

1. Presiona **Nueva guía**.
2. Completa el formulario:
   * **Destino** (consignatario/dirección de entrega) — se puede elegir por catálogo o mediante un **código personalizado de destino**.
   * **Guía madre** (opcional) — para agrupar varias guías bajo una guía madre.
   * **Lote** — si la guía pertenece a un lote de guías pre-numerado (ver Lotes de guías).
   * **Ruta** de logística.
   * Datos de cada **paquete**: tipo de embalaje (o embalaje "Especificar" cuando no está en catálogo), **largo/ancho/alto (cm)**, **peso real (kg)**, **valor declarado ($)**, descripción del contenido y notas.
   * El sistema calcula automáticamente el **peso volumétrico** y el **peso facturable** (el mayor entre peso real y volumétrico) a partir de las dimensiones capturadas.
3. El campo **Replicar (veces)** permite crear varios paquetes idénticos dentro de la misma guía de una sola vez, en lugar de capturarlos uno por uno.
4. Guarda la guía; queda en estado **Borrador**.

### Acciones sobre una guía existente

Desde la vista de detalle o la lista, según el estado de la guía, están disponibles:

| Acción                                        | Qué hace                                                                                                           |
| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| **Editar**                                    | Modifica los datos de la guía (solo aplica mientras es editable)                                                   |
| **Activar guía** / **Activar grupo de guías** | Confirma una guía (o varias seleccionadas a la vez) para pasarla de Borrador a Confirmada                          |
| **Cancelar guía**                             | Cancela la guía; pide confirmar y captura un motivo                                                                |
| **Reactivar**                                 | Revierte la cancelación de una guía cancelada                                                                      |
| **Duplicar guía**                             | Crea una guía nueva en Borrador con los mismos datos. El sistema muestra el aviso **"Guía duplicada"** al terminar |
| **Copiar código**                             | Copia el código de rastreo al portapapeles                                                                         |
| **Imprimir guía**                             | Abre el menú de formato de impresión (ver más abajo)                                                               |

También existe **Cancelar guías (masivo)**: selecciona varias guías con las casillas (**Seleccionar todas** disponible) y cancélalas juntas con un solo motivo.

### Impresión de etiquetas

Al imprimir, el sistema ofrece distintos **formatos de papel** (por ejemplo, etiqueta compacta 102×102, 102×152, o tamaño carta), según lo definido en la plantilla activa (ver Plantillas de guías). Puedes elegir el formato desde el menú desplegable de impresión antes de generar el documento.

### Búsqueda, filtros y carga masiva

* **Buscar** por folio, código de rastreo, destino o consignatario.
* Filtros por **Lote**, **Guía madre**, rango de fechas (**Desde** / **Hasta**) y **Todas las categorías** (tipo de embalaje).
* **Carga masiva**: importa guías desde un archivo CSV. Cada fila debe indicar el destino (por `destino_id` o `id_personalizado_destino`), y opcionalmente `lote_id`, `guia_madre_id`, referencia interna, observaciones y los datos del paquete (`tipo_embalaje`, `largo_cm`, `ancho_cm`, `alto_cm`, `peso_real_kg`, `valor_declarado`, `contenido`). Al terminar, el sistema muestra cuántas guías se crearon y cuántas se omitieron, con el detalle de las primeras filas con error.

> Mientras se procesa una carga masiva, no cierres la pestaña — el sistema lo indica explícitamente en pantalla.


---

# 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/operacion/guias-de-envio.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.