Anexo A.6 · Referencia — Devoluciones y Entradas

Estado: BORRADOR (revisión intensiva 02-sep) · Material de consulta.

A.6.1 Cómo nace una devolución

Las devoluciones no se crean a mano ni las empuja el ERP: la app las extrae de los pedidos en memoria — cada línea con unidades negativas genera una devolución (las unidades se muestran en positivo). Consecuencias visibles:

• Hace falta haber cargado la lista de pedidos para que aparezcan devoluciones nuevas; a veces una devolución «tarda una recarga» en aparecer (si la comprobación contra el servidor falla, esa pasada no crea nada, sin aviso).
• Cada línea negativa es una devolución independiente (dos comodines 66M del mismo pedido son dos devoluciones).
• Comodines (código 66X): el artículo real se busca en el texto de la nota — el último segmento tras un guion con forma dddd…L (p. ej. «…015058M MASCOW…»); si no casa, se muestra el texto libre. Las instrucciones son la línea de comentario inmediatamente posterior a la línea negativa.
• Las devoluciones incompletas se hidratan solas desde ALO (una vez por sesión, requiere VPN en beta): la lista se completa a los pocos segundos sin aviso.

A.6.2 Los tres carriles y su regla de cierre

Carril	Qué contiene realmente
Por recibir	Sin recepción confirmada — incluidas las ya abonadas si nadie confirmó la llegada.
En almacén	Con recepción confirmada, pendiente de destino del producto.
Resueltas	Destino decidido Y parte administrativa cerrada (abono/reposición). Una vez resuelta, no se recalcula.

La lista es en tiempo real y se organiza en acordeón de dos niveles: cliente → pedido → líneas (así se coteja tal y como llega la mercancía al almacén):

Nivel	Qué muestra	Detalles finos
Cliente	Nombre y NIF, nº de pedidos y de líneas, unidades totales (globo rojo).	Con un solo pedido, su nº y fecha se pintan ya en la fila del cliente. La clave de agrupación es el id del cliente en ALO (o el nombre normalizado si falta).
Pedido	Nº de documento, estado de venta del ERP con su color real (el del propio ALO), fecha y nº de líneas.	El chip de estado sale del catálogo de estados de venta (referencia del estado).
Línea	Imagen y código del artículo, instrucciones de la devolución, unidades.	Pulsar abre el Proceso de Devolución; deslizar → «Ver pedido» / «Reponer» / «Ajuste».

Lo desplegado sobrevive a las re-emisiones del listener (no se te cierra el acordeón porque

llegue un cambio), y al buscar los resultados aparecen ya desplegados. El badge del menú cuenta pedidos con líneas de devolución, no devoluciones (pueden no cuadrar).

A.6.3 Proceso de devolución — acciones y efectos exactos

El modelo son dos carriles independientes (la guía en pantalla lo explica): la parte física (producto) y la administrativa (dinero). Configuración que exige cada acción, y su efecto real:

Acción	Efecto real	Requiere
Confirmar recepción	Solo traza: unidades recibidas + estado («Recibida VENDIBLE» / «Recibida DAÑADA») y nota. No mueve stock.	—
Generar abono	Albarán de abono en el ERP: descuenta al cliente y da entrada al stock en la playa de devoluciones. Es la pieza de la que dependen Reintegrar y Devolver a proveedor.	Serie de abono + almacén de devolución (+ recepción previa si la empresa lo exige).
Reponer	Abono + pedido de venta nuevo para reenviar el producto al cliente.	Ídem.
Reintegrar a venta	Traspaso playa de devoluciones → almacén de entrada: el producto vuelve a ser vendible.	Abono previo + almacén de devolución + almacén de entrada + serie de traspaso.
Tirar (merma)	Registro de merma con motivo. No crea documento ni mueve stock en el ERP.	Recepción previa (como todas las disposiciones).
Devolver a proveedor	Albarán de compra negativo a precio 0 (administración lo valora); el stock sale de la playa de devoluciones.	Abono previo + serie de albarán de compra + proveedor asociado en la ficha ALO («Sin proveedor asociado» si falta).
Añadir nota	Va a las observaciones del documento que se genere (abono/reposición). ⚠️ Solo vive en memoria: si cierras sin decidir, la nota se pierde.	Escribirla antes de decidir.

Detalles operativos:

• Los botones desaparecen al cerrarse su carril (no se deshabilitan): una devolución abonada ya no muestra «Generar abono».
• Guardas con texto claro: «Falta configuración de empresa» (nombrando los campos), «Primero hay que recibir el producto», «Primero genera el abono».
• Éxitos: «✅ Abono generado», «✅ Reposición completada», «✅ Reintegrado a venta», «✅ Devuelto al proveedor». Errores «no se ha creado nada — puedes volver a intentarlo» + detalle del ERP.
• Dos avisos delicados que hay que respetar al pie de la letra: «Abono creado, registro incompleto» (el abono SÍ existe: no regenerar) y «Reposición incompleta» (el abono se creó, el pedido de reposición falló: crearlo a mano en el ERP o avisar a administración).
• La ficha inferior muestra artículo, instrucciones destacadas, cliente/documento/dirección/ vendedor/ruta, «Nota para el documento» y los adjuntos del pedido (ampliables).
• El proceso no es en tiempo real: dos usuarios sobre la misma devolución se pisan sin aviso.
• La guía «¿Cómo funciona…?» se recuerda por dispositivo, y añade el párrafo «⚠️ En esta empresa no se puede abonar hasta confirmar la recepción» solo si la política está activa.

A.6.4 Entradas — pedidos de compra

• Buscador libre (proveedor, nº o id) + chip de rango de fechas + «Limpiar filtros». No hay filtro por estado del documento.
• Fila: serie/registro, estado del documento, fecha, artículos, unidades, kg (calculados desde el catálogo), importe solo managers y «fecha prevista de entrada». Pull-to-refresh y scroll infinito de 25 en 25.
• Los pedidos totalmente recibidos desaparecen de la lista (no hay histórico de compras aquí).

A.6.5 Entrada de almacén (recepción)

• Cabecera: chips de unidades marcadas/disponibles, «Completo / En curso» y barra de progreso. Dos toggles: ocultar procesados y ordenar por ubicación.
• Línea: borde de color (gris/naranja/verde), miniatura pulsable (zoom con el código de barras dibujado), badges «Recibido: N» (esta pasada), «Anterior: N», «Max: N» y «+N sobre pedido» (solo posible con «permitir exceso» activo — es el único aviso de exceso).
• Controles − / nº / + / ✓; la cantidad tecleada se normaliza al salir del campo. Escaneo con

semáforo de color; un código puede sumar un pack completo; si el artículo está en dos líneas, siempre suma a la primera. – Deslizar → «Editar»: bultos, peso y medidas por bulto (conversión en vivo) y ubicación. ⚠️ Edita la ficha del catálogo, no solo esta línea. – Finalizar («Guardar albarán de compra» → modal «Finalizar Packing Compra»): genera el albarán de compra en el ERP, recalcula el documento y actualiza su estado de compra (parcial/total). No genera ningún traspaso ni interviene el «almacén de entrada»: el almacén es el del propio documento/línea. Alerta final «Recepción TOTAL» (sale de la lista) o «Recepción PARCIAL» (al reprocesar, solo aparecen los pendientes).

Recepciones por partes (fascículos) — segunda pasada

• Las líneas ya completas no aparecen (no es el toggle: no están en la lista).
• Las parciales reaparecen con lo anterior en «Anterior: N» y arrancan pintadas de naranja aunque aún no hayas recibido nada nuevo.
• Los totales de cabecera y del resumen incluyen las pasadas anteriores — lo que moverá el albarán es solo la diferencia de esta pasada.
• La pantalla trabaja sobre una foto del pedido (no realtime): dos operarios a la vez no se avisan. Salir y volver conserva el progreso si el pedido no cambió.