# Paquetería

> El espacio que registra las cartas y paquetes que llegan al lugar físico (coworking, sede, oficina): la recepción registra con foto y locker, el miembro recibe un aviso por correo y lo recoge, y el equipo sigue la cola. Roles, correo, código del locker y datos personales.

El módulo **Paquetería** registra **cada carta o paquete que llega al espacio físico para un miembro**. Es el cuaderno y el grupo de WhatsApp de la recepción dentro de Memberfy: el equipo registra en segundos (quién recibe, qué es, una foto, dónde quedó guardado), el miembro **recibe un aviso por correo** y el paquete se cierra cuando se recoge, con la fecha y quién lo recogió.

Cada espacio de Paquetería es **una unidad física**. Un coworking con dos sedes crea dos espacios, cada uno con su cola y su historial.

## Para qué sirve

| Comunidad | Paquetería |
|---|---|
| Coworking | La recepción registra el paquete de Amazon y el residente recibe el aviso al momento, con la foto |
| Sede de asociación | Cartas y documentos de los socios, con quién los recogió y cuándo |
| Oficina de empresa | Entregas para personas y para empresas de la planta, sin notas en papel |
| Condominio de salas | Lockers numerados, con el código de recogida solo para su dueño |

## Cómo funciona

### Qué guarda el paquete

Cada paquete tiene el **destinatario** (una persona o una empresa que es miembro de la comunidad y tiene acceso al espacio), el **tipo** (**Carta**, **Paquete** u **Otro**, con una descripción corta), el **remitente**, el **transportista** y el **código de seguimiento** (todos opcionales), una **observación**, hasta **5 fotos**, el **lugar** (locker, estante o recepción) y, si el espacio lo usa, el **código de recogida** del locker.

Pasa por cuatro situaciones:

| Situación | Qué significa |
|---|---|
| **Esperando recogida** | Llegó y está guardado |
| **Recogido** | Alguien lo recogió. Queda registrado cuándo, cómo y quién |
| **Devuelto** | Volvió al remitente, con el motivo |
| **Descartado** | Nadie lo recogió y el equipo le dio fin, con el motivo |

Cerrar un paquete **no borra nada**: el registro, las fotos y el motivo siguen en el historial. Todo horario se lee en la **zona horaria del país de la comunidad**.

### La configuración del espacio

Al crear el espacio, y después en **Configurar espacio** (barra **Gestionar paquetes**), la pantalla pide:

| Campo | Qué hace | Por defecto |
|---|---|---|
| **Dónde se guardan los paquetes** | **En la recepción**: el equipo guarda todo en la recepción y el campo de locker no aparece. **En un locker o estante**: el equipo escribe dónde lo dejó ("armario 12", "estante B") y el miembro ve ese lugar | En la recepción |
| **Código de recogida del locker** | Solo con locker. El equipo puede definir un código por paquete; solo el destinatario lo ve | Desactivado |
| **Foto en el correo de aviso** | El correo al miembro lleva una miniatura de la foto. Desactívalo si las fotos pueden mostrar dirección o datos personales | Activado |
| **Exigir confirmación del equipo** | Desactivado, el miembro confirma su propia recogida con el botón **Lo recogí**. Activado, solo el equipo marca la recogida | Desactivado |

La pantalla muestra además el aviso *"Este módulo guarda fotos y el nombre del remitente de cada paquete. Informa a los miembros de la comunidad."*

### Quién hace qué

El equipo, en este módulo, es el **propietario, el administrador, el moderador y el financiero**.

| Acción | Miembro | Financiero y moderador | Administrador y propietario |
|---|---|---|---|
| Ver **sus propios** paquetes y el código del locker de ellos | Sí | Sí | Sí |
| **Lo recogí** en su propio paquete (si la confirmación del equipo está desactivada) | Sí | Sí | Sí |
| Ver la **cola** de todos | No | Sí | Sí |
| **Registrar**, **editar**, tocar las **fotos**, **marcar la recogida** y **devolver** | No | Sí | Sí |
| **Descartar**, **reabrir** y **eliminar** un registro | No | No | Sí |
| Configurar el espacio | No | No | Sí |

Quién entra en el espacio sigue la regla de cualquier espacio (visibilidad, plan y grupo). Solo se registra un paquete para quien tiene acceso al espacio.

> [!NOTE]
> El **código del locker** lo lee solo el destinatario, en **Mis paquetes** y en el correo. Ninguna pantalla del equipo lo muestra: el equipo ve únicamente que *hay un código*, y puede definirlo de nuevo, nunca leerlo. Deja de valer cuando el paquete se recoge, se devuelve o se descarta.

### Qué ve el equipo

El espacio se abre en dos pestañas: **Cola** y **Mis paquetes**.

- La barra **Gestionar paquetes** muestra cuántos están **esperando recogida** y cuántos están **parados**, y el botón **Recibir un paquete**.
- La **Cola** lista los paquetes con foto en miniatura, destinatario, tipo, remitente, lugar y hace cuánto llegaron (*"Llegó hoy"*, *"Llegó hace 2 días"*). Los filtros son **Pendientes**, **Paradas**, **Recogidos**, **Devueltos**, **Descartados** y **Todos**, más el tipo y la búsqueda por nombre, remitente o seguimiento.
- El sello **Parado hace N días** marca el paquete que espera más que el plazo del espacio (3 días, si el espacio no define otro).
- El sello **Sin aviso por correo** aparece cuando el destinatario no pudo ser avisado (sin correo válido o ya fuera de la comunidad). El paquete se registra igualmente, y la pantalla muestra **Ex miembro** cuando es el caso.
- El detalle muestra las fotos, el historial (recibido el, registrado por, aviso por correo, cómo se recogió) y las acciones.

### Qué ve el miembro

En **Mis paquetes** (la pestaña del espacio, y la página con ese nombre):

- **Pendientes**: una tarjeta por paquete, con el nombre del espacio, la foto, el tipo, *"De {remitente}"*, hace cuánto llegó, *"Recoge en: {lugar}"* (o *"Recoge en la recepción"*) y el **código de recogida**, oculto tras el botón **Mostrar**. Si la confirmación del equipo está desactivada, el botón **Lo recogí** cierra el paquete; si está activada, la pantalla avisa de que la recogida la confirma el equipo, en la recepción.
- **Historial**: las recogidas (*"Recogido el … por …"*), devoluciones y descartes.

El miembro ve **solo los suyos**. Sin paquetes, la pantalla dice *"Nada para ti ahora"*.

## Paso a paso

### Crear el espacio

*Rol: propietario o administrador.*

1. En **Añadir Espacio**, abre la pestaña **Coworking** y elige el módulo **Paquetería**.
2. En **Dónde se guardan los paquetes**, elige **En la recepción** o **En un locker o estante**. Con locker, decide si habrá **Código de recogida del locker**.
3. Deja **Foto en el correo de aviso** activada o desactívala; activa **Exigir confirmación del equipo** si solo el equipo debe marcar la recogida.
4. Define la visibilidad y crea el espacio. Para otra unidad, crea otro espacio.

Para cambiarlo después, usa **Configurar espacio** en la barra **Gestionar paquetes**.

### Recibir un paquete

*Rol: equipo.*

1. Toca **Recibir un paquete**.
2. En **Destinatario**, escribe el comienzo del nombre (al menos 3 letras). Aparecen solo personas y empresas con acceso al espacio.
3. Elige el **Tipo**. En **Otro**, descríbelo (por ejemplo, *"caja de vino"*).
4. Si quieres, rellena **Remitente**, **Transportista**, **Código de seguimiento** y **Observación** (*"frágil"*, *"pesado"*).
5. Añade hasta 5 **Fotos**, con **Tomar foto** o **Elegir de la galería** (JPG, PNG o WebP).
6. Si el espacio usa locker, rellena **Lugar (locker)**; vacío significa *"en la recepción"*. Con código, rellena **Código de recogida** (de 4 a 12 caracteres).
7. Toca **Guardar**, o **Guardar y recibir otro** para limpiar el formulario y seguir.

El miembro recibe el correo poco después (consulta [Correo al miembro](#correo-al-miembro)).

**Aviso de duplicado:** si ya existe un paquete del mismo tipo, para la misma persona y con el mismo código de seguimiento en las últimas 24 horas, la pantalla pregunta *"¿Registrar otro de todos modos?"*. Tocar dos veces **Guardar** no crea dos paquetes.

### Editar un paquete y tocar las fotos

*Rol: equipo.*

1. Abre el paquete y toca **Editar**.
2. Corrige lo que se escribió mal y toca **Guardar**. El destinatario no cambia: para eso, elimina el registro y regístralo de nuevo.
3. Para el código del locker, rellena **Nuevo código de recogida**; vacío mantiene el actual. No hay forma de leer el código ya definido.
4. En las fotos, usa **Añadir foto**, **Reemplazar foto** y **Quitar foto**. Quitar pide confirmación y borra la foto y el archivo para siempre; el paquete sigue registrado.

Un paquete ya cerrado solo lo corrige el propietario o el administrador, y nunca el código.

### Marcar la recogida

*Rol: equipo.*

1. Abre el paquete y toca **Marcar recogida**.
2. En **Quién lo recogió**, elige **El destinatario** (con el nombre de quien vino, opcional) u **Otra persona** (el nombre es obligatorio).
3. Toca **Confirmar recogida**. El código del locker deja de valer.

Dos personas marcando a la vez cierran el paquete una sola vez.

### Devolver al remitente

*Rol: equipo.*

En **Devolver**, indica el **Motivo** (por ejemplo, *"devuelto al remitente"*, *"rechazado"*) y toca **Devolver**. El paquete pasa a **Devuelto**.

### Descartar, reabrir y eliminar

*Rol: propietario o administrador.*

- **Descartar paquete**: para el que nadie recogió. Exige el **Motivo**; pasa a **Descartado**.
- **Reabrir paquete**: deshace una recogida, devolución o descarte hechos por error. Exige el **Motivo** y el paquete vuelve a **Esperando recogida**. El código anterior ya se borró: define otro en **Editar**, si lo necesitas.
- **Eliminar registro**: solo para el paquete registrado por error (para la persona equivocada). Sale de las listas y las fotos se borran; quién lo eliminó y el motivo quedan en el [registro de actividad](/membros/registros-de-atividades). Para cerrar un paquete de verdad, usa recogida, devolución o descarte.

### Recoger el propio paquete

*Rol: cualquier miembro, si el espacio no exige la confirmación del equipo.*

1. Abre **Mis paquetes**.
2. En el paquete, mira el lugar y, con el botón **Mostrar**, el código del locker.
3. Después de recogerlo, toca **Lo recogí** y **Sí, lo recogí**. La recogida queda registrada como confirmada por el propio miembro.

## Correo al miembro

Al registrar el paquete, el destinatario recibe un correo **por la cola de correos**, nunca durante el registro:

- el asunto no dice qué llegó;
- el cuerpo trae el tipo, el remitente (si lo hay), **dónde recoger**, el **código del locker** (si lo hay) y la hora, en la zona horaria de la comunidad;
- con **Foto en el correo de aviso** activada, una **miniatura** de la foto, en un enlace que vale **72 horas** (la foto completa queda en la app, con inicio de sesión);
- el botón para abrir **Mis paquetes**.

Si el destinatario ya salió de la comunidad o no tiene un correo válido, no se envía nada y la cola muestra **Sin aviso por correo**.

> [!NOTE]
> El código del locker va en el correo, así que queda en la bandeja de entrada del miembro. Si eso es un riesgo para tu comunidad, deja el código desactivado.

## Datos y privacidad

Este módulo guarda datos personales, y **la comunidad es la responsable**: decide qué registra.

- **Foto del paquete**: puede mostrar nombre, dirección o el contenido. Queda en almacenamiento privado, abierta solo con un enlace firmado y de corta duración, y solo la ven el equipo del espacio y el destinatario.
- **Remitente, transportista, seguimiento y observación**: datos del miembro y, de paso, de terceros.
- **Nombre de quien recogió**: se guarda cuando la recogida la hace otra persona.
- **Código del locker**: credencial de vida corta. Solo el destinatario lo lee y se borra al cerrar el paquete. En los registros de actividad aparece oculto.
- **Nada se borra.** Fotos y registros quedan guardados con la comunidad. Informa a los miembros, como recuerda el aviso de la configuración.

> [!SOON]
> En preparación: el **recordatorio** por correo para el paquete parado. Ya existe como ajuste del espacio, pero aún no se ejecuta.

## Ejemplos

**Coworking con recepción.** El espacio usa **En la recepción**. El moderador registra el paquete con dos fotos y el remitente; la residente recibe el correo con la miniatura y pasa a recogerlo; la recepción toca **Marcar recogida**.

**Salas con locker.** El espacio usa **En un locker o estante** con código. El equipo escribe *"Armario 12"* y el código; el miembro ve los dos en **Mis paquetes**, abre el armario y toca **Lo recogí**.

**Casa que quiere control.** Con **Exigir confirmación del equipo** activado, el miembro ve el paquete, pero solo la recepción cierra la recogida.

## Errores comunes y cómo resolverlos

| Mensaje o situación | Qué hacer |
|---|---|
| *"No se encontró a nadie con acceso a este espacio."* | Revisa el nombre (empieza por el comienzo, 3 letras) y si la persona tiene acceso al espacio (plan, grupo, visibilidad) |
| *"Ya hay un paquete igual para este destinatario en las últimas 24 horas."* | Probablemente ya se registró. Si es otro, toca **Registrar de todos modos** |
| *"Como máximo 5 fotos por paquete."* | Quita una foto antes de añadir otra |
| *"En esta comunidad solo el equipo confirma la recogida."* | El espacio exige la confirmación del equipo: pídeselo a la recepción |
| No hay botón **Descartar**, **Reabrir** ni **Eliminar** | Son del propietario y del administrador |
| *"Sin aviso por correo"* en la cola | El destinatario no tiene un correo válido o salió de la comunidad; avísale por otro medio |

## Preguntas frecuentes

**¿El miembro ve el código del locker si el equipo lo definió?**
Sí, solo él: en **Mis paquetes** y en el correo. El equipo nunca lo lee.

**¿Puedo registrar para una empresa?**
Sí, cuando la empresa es miembro de la comunidad y tiene acceso al espacio.

**¿Se puede registrar para quien no es de la comunidad?**
No. El destinatario tiene que ser miembro con acceso al espacio.

**¿El visitante del quiosco de Presencia recibe paquetes?**
No. Los paquetes son de los miembros; el quiosco es del visitante.

**¿El módulo cobra por la custodia?**
No.

## Con el asistente

El asistente registra y consulta paquetes, toca las fotos, marca la recogida, devuelve, descarta, reabre y elimina, y el miembro pregunta *"¿tengo algún paquete?"*. Consulta [Herramientas · Paquetería](/mcp/ferramentas-encomendas) y las recetas de [Paquetería](/mcp/receitas).

## En la API

Con `X-CommunityId` en la cabecera: `GET /api/parcels/spaces/{spaceId}/overview`, `GET .../members?q=` (búsqueda de destinatario), `POST` y `GET .../parcels`, `GET`, `PATCH` y `DELETE /api/parcels/parcels/{parcelId}`, `POST`, `PUT` y `DELETE .../photos`, `POST .../pickup`, `.../return`, `.../discard` y `.../reopen`, `GET /api/parcels/me/parcels` (los del propio miembro). La referencia completa, generada de la API, aparece en [Referencia de la API](/api/introducao) cuando la Paquetería llegue a las comunidades.

## Relacionados

- [Módulos](/conceitos/modulos)
- [Presencia](/espacos/presenca)
- [Roles y permisos](/conceitos/papeis-e-permissoes)
- [Visibilidad y acceso](/conceitos/visibilidade-e-acesso)
- [Registros de actividad](/membros/registros-de-atividades)
- [Crear y organizar espacios](/espacos/criar-e-organizar-espacos)