# Guía de prueba — Viajes de reparto (cobranza y rentabilidad)

> **Qué se resolvió.** DOBA arma sus repartos al interior en una planilla Excel (`PEDIDO INTERIOR 2026.xlsx`):
> qué llevó a cada cliente, cuánto vendió, los viáticos y los kilómetros. Ahora el viaje vive en el sistema y
> se arma solo con los documentos que ya existen —facturas, recibos, notas de crédito—, sin cargar nada dos
> veces. Además responde lo que la planilla no decía: **cuánto de lo vendido ya es plata**, **si el cobrador
> rindió todo** y **si el viaje ganó plata**.
>
> **Importante**: el viaje **no guarda cantidades propias**. Todo lo que muestra sale de los documentos
> enganchados. Si un número no cierra, casi siempre es un documento que falta o que sobra.

**Fecha**: 01/10/2026 · **Empresa de prueba**: DOBA S.A. · **Docs de diseño**: `novasispy-erp/docs/superpowers/specs/2026-09-23-viajes-reparto-design.md` y `2026-10-01-viajes-cobranza-rentabilidad-design.md`

---

## Antes de empezar

- **Usuario**: `80144315` (administrador de DOBA). El menú está en **Ventas › Viajes**.
- **Migraciones**: tienen que estar aplicadas las tres de viajes (`20260923000000_viajes_reparto`,
  `20260923000100_viajes_submodulo` y `20261001000000_viaje_rendiciones`). Después de aplicarlas,
  **reiniciá el backend una vez**.
- **Submódulo**: la empresa tiene que tener habilitado **VENTAS_VIAJES** en su plan. La migración da los
  permisos solo a los perfiles con "admin" en el nombre; los demás perfiles se asignan a mano.
- **No tiene que haber otro viaje** de Cristian entre el 25/05 y el 07/06/2026. Un documento pertenece a un
  solo viaje: si ya hay uno con esas fechas, sus documentos no se ofrecen y los números no van a coincidir.

> Los números de esta guía están verificados contra la base del **01/10/2026**. Si cargaron facturas o
> recibos de Cristian de esas fechas después, van a cambiar.

---

## El caso de prueba

Vamos a armar el viaje de **Cristian** del **25/05 al 07/06/2026**, con km de salida **25.187** y de
vuelta **25.790** (603 km, los de la hoja real de la planilla).

## Números de referencia

Todo lo que sigue se puede verificar contra esta tabla. Si un número no coincide, algo anda mal.

| Qué                                       | Valor                                                                                            |
| ----------------------------------------- | ------------------------------------------------------------------------------------------------ |
| Documentos que propone "Traer documentos" | **111** (44 facturas · 17 notas de crédito · 50 recibos)                                         |
| Facturado                                 | **Gs. 208.413.247**                                                                              |
| Notas de crédito                          | **Gs. 22.259.282**                                                                               |
| **Vendido** (facturado − NC)              | **Gs. 186.153.965**                                                                              |
| Cobrado en caja                           | Gs. 765.000                                                                                      |
| Por cobrar (todo vencido)                 | **Gs. 9.990.800**                                                                                |
| Notas de crédito sin aplicar              | Gs. 7.796.000                                                                                    |
| Productos en Carga / Matriz               | 12 productos · 34 clientes con factura                                                           |
| Clientes en Cobranza                      | 81 (con saldo: 7 · con deuda anterior abierta: 19)                                               |
| Rendiciones de viáticos                   | RVI-2026-00010 (Mirna, Gs. 1.545.000) + RVI-2026-00008 (Victor, Gs. 921.500) = **Gs. 2.466.500** |
| Margen bruto (costo conocido)             | **Gs. 5.339.370** · 16,4 % · cobertura **16 %**                                                  |
| Resultado (costo conocido)                | **Gs. 2.872.870**                                                                                |
| Costo por km                              | Gs. 4.090                                                                                        |

**El cuadre tiene que cerrar al guaraní:** facturado 208.413.247 = caja 765.000 + recibos 189.861.447 +
por cobrar 9.990.800 + NC sin aplicar 7.796.000.

---

## Prueba 0 — Que todas las pantallas abran

**Hacé esta primero.** Entrá a cada pantalla y confirmá que **carga y muestra contenido**:

- [ ] Ventas › **Viajes** (la lista)
- [ ] El detalle de un viaje, y cada una de sus **6 pestañas**: Resumen · Carga · Clientes · Cobranza · Documentos · Gastos y km
- [ ] Los diálogos: Nuevo viaje · Editar · Traer documentos · Cerrar · Anular

**Qué buscar**: una pantalla **en blanco** o que se queda cargando para siempre.

> Si te pasa, apretá **F12 → pestaña Console**, sacale una foto al texto en rojo y mandánosla.

---

## Prueba 1 — Crear el viaje

1. **Viajes → + Nuevo viaje**.
2. Apretá **Crear viaje** sin completar nada → arriba aparece un aviso rojo que pide la **fecha de salida**.
3. Completá:
   - **Vendedor**: escribí `cristian` en el buscador y elegilo.
   - **Salida** 25/05/2026 · **Retorno** 07/06/2026.
   - **Descripción** `Reparto interior Cristian` · **Zona** `Interior` · **Km de salida** `25187`.
4. **Crear viaje** → te lleva al detalle, con el chip **Planificado** y un número `VJ-…`.

**Qué tenés que ver:** el formul![alt text](image.png)ario está en tres bloques alineados (_Datos del viaje_, _Quién y con qué_,
_Kilómetros_). En _Kilómetros_ hay un texto que dice que los viáticos se asocian después, en **Gastos y km**:
ya **no** hay un selector de rendición acá.

---

## Prueba 2 — Traer los documentos del viaje

1. Pestaña **Documentos → Traer documentos**.

**Qué tenés que ver:**

- El buscador dice **111 candidatos**.
- Los grupos: _Facturas 44 · Notas de crédito 17 · Recibos 50_. _Remisiones_ y _Órdenes de venta_ aparecen
  en gris con **0** y un texto que dice dónde se crean.

2. Escribí `super` en el buscador → el contador baja y solo quedan los que coinciden. Borrá la búsqueda.
3. Tildá el **casillero del grupo Facturas** → abajo dice **44 elegidos**. Destildalo → **0 elegidos**.
4. Apretá **Seleccionar todo (111)** → **111 elegidos**.
5. **Enganchar 111** → la tabla de Documentos muestra **111 filas** con número, fecha, cliente y total
   (nunca un código raro tipo `a3f9…`).

> **Por qué importa el "Seleccionar todo".** Lo normal es traer todo lo del vendedor en esas fechas. Antes
> había que tildar uno por uno.

---

## Prueba 3 — Un documento pertenece a un solo viaje

1. Creá un **segundo viaje** de Cristian con las mismas fechas.
2. **Traer documentos** → tiene que decir **"No hay documentos para proponer"**: los 111 ya están en el primero.
3. Anulá este segundo viaje (ver Prueba 12) para que no moleste.

## Prueba 3b — Al enganchar una factura se suman sus vinculados

1. En un viaje nuevo de Cristian, abrí **Traer documentos** y buscá `0001981`: debajo dice **"trae 1 vinculado"**.
2. Tildá **solo esa factura** y enganchala.
3. El aviso dice *"Se sumaron solos sus vinculados: 1 nota de crédito"*, y en la tabla aparecen la factura y la NC
   `001-001-0000603`.

> La factura ya sabe de dónde viene: su presupuesto, su orden de venta, sus remisiones y sus notas de crédito.
> Esos documentos entran solos con ella. Si alguno ya está en otro viaje no se mueve, y el aviso lo dice.

---

## Prueba 4 — Carga y Clientes (matriz)

1. Pestaña **Carga** → **12 productos**, con _Remitido_ en 0 (DOBA no usa remisiones) y _Facturado_ con las
   unidades.
2. Pestaña **Clientes** → la matriz **producto × cliente**, con **34 clientes**. _Planificado_ y _Comparado_
   aparecen deshabilitados con el motivo (no hay órdenes de venta), y _Entregado_ es el que se ve.

> **Cajas.** La columna de cajas va a estar **vacía** y se muestran unidades. Es lo esperado: las
> presentaciones de producto están apagadas por ahora. Cuando se habiliten, las cajas aparecen solas, sin
> tocar nada del viaje.

---

## Prueba 5 — Cobranza: cuánto de lo vendido ya es plata

Pestaña **Cobranza**. Es la pantalla más importante para el dueño.

**Qué tenés que ver, arriba de todo:** un aviso amarillo, **"28 recibos pagan facturas de este viaje y no
están enganchados"**. Son recibos que se hicieron después del retorno (09 al 11/06). No lo toques todavía.

En el bloque **"De lo facturado, cuánto ya se cobró"**:

| Fila                              | Valor                                |
| --------------------------------- | ------------------------------------ |
| Facturado                         | 208.413.247                          |
| − Notas de crédito                | 22.259.282                           |
| = Vendido                         | 186.153.965                          |
| Cobrado en caja                   | 765.000                              |
| Cobrado con recibos del viaje     | 2.107.400                            |
| Cobrado con recibos sin enganchar | **187.754.047** (en naranja)         |
| Notas de crédito sin aplicar      | 7.796.000                            |
| Por cobrar                        | **9.990.800**, en rojo, "ya vencido" |

> **Notas de crédito sin aplicar.** Hay 5 facturas anuladas con nota de crédito que nunca se aplicó a la
> factura: el saldo seguía completo. El sistema no las cuenta como deuda y lo muestra aparte. Si en _Por
> cobrar_ vieras 17.786.800, sería un error: es la cifra de antes de esta corrección.

En **"Cómo entró la plata"**: efectivo, transferencia, **cheque al día**, **cheque diferido** y
**cheque sin fecha** (los recibos viejos no guardaban la fecha del cheque), cada uno con su porcentaje. Debajo:
chips con los cheques diferidos **por semana de cobro** y **Deuda anterior cobrada Gs. 203.129.940**.

---

## Prueba 6 — Enganchar los recibos que faltaban

1. En el aviso amarillo apretá **Ver** → la lista de los 28 recibos (número, fecha, cliente, cuánto se aplicó
   al viaje).
2. Apretá **Enganchar 28**.

**Qué tenés que ver:**

- El aviso desaparece.
- _Cobrado con recibos del viaje_ pasa a **189.861.447** y desaparece la fila "sin enganchar".
- _Por cobrar_ **no cambia** (9.990.800): lo pendiente siempre sale del saldo de cada factura, esté o no el
  recibo en el viaje.
- _Deuda anterior cobrada_ pasa a **210.458.240**.

---

## Prueba 7 — Control de rendición

En el bloque **Control de rendición**:

| Tarjeta                                | Valor                        |
| -------------------------------------- | ---------------------------- |
| Rendido                                | 129.314.200                  |
| En rendición                           | 0                            |
| **Sin rendir** (rojo)                  | **185.028.223** — 43 recibos |
| **Cobro en ruta sin registrar** (rojo) | **9.270.800** — 6 facturas   |
| Cobrado en oficina                     | 82.480.098                   |

- Debajo hay chips con las rendiciones de cobranza (REN-000002, 000003, 000004, 000006, 000007),
  todas **aprobadas** y **sin diferencia**.
- La tabla _"Recibos cobrados en la ruta que no están rendidos"_ muestra las primeras 8 filas y un botón
  **Ver los 43**. Probá abrirlo y cerrarlo.

> **Por qué hay tanto "sin rendir".** De los recibos con cobrador, DOBA rinde pocos en Rendiciones de
> Cobranza. El rojo es la alarma que se buscaba: no es un error del cálculo.

---

## Prueba 8 — Cheques y detalle por cliente

1. **Cheques (37)**: primero los **diferidos** ordenados por fecha de cobro, después los al día y los sin
   fecha. Banco, número, monto y recibo. Muestra 8 y **Ver los 37**.
2. **Por cliente**: 81 clientes. Arriba aparece primero el que **debe y está vencido**
   (_MARIA CRISTINA GOMEZ-AUTOSERV. A Y L_, Gs. 2.415.000, "venció …").
3. Probá los filtros:
   - **Con saldo** → 7 · **Vencidos** → 7 · **Con deuda anterior** → 19 · **Todos** → 81.
4. Pasá el mouse por las chips de _Condición_ (Contado · Contado en ruta · Crédito) y de _Cómo pagó_: cada
   una explica qué significa.
5. Los clientes que solo pagaron deuda vieja dicen **"Solo cobro"** en la columna Facturas.

---

## Prueba 9 — Gastos y km: los viáticos, una rendición por persona

Pestaña **Gastos y km**.

1. Sin rendiciones, aparece **"Sin rendiciones asociadas"**. En Resumen, un aviso dice que el costo figura en cero.
2. En **Agregar rendición de viáticos** abrí la lista. Está agrupada: _En las fechas del viaje_ (hoy ninguna:
   las de DOBA son de agosto) y _Otras rendiciones_.
3. Buscá `RVI-2026-00010` → elegila → **Asociar**. Repetí con `RVI-2026-00008`.

**Qué tenés que ver:**

- Dos tarjetas: **Mirna Lopez Valenzuela Gs. 1.545.000** y **Victor Ramirez Escobar Gs. 921.500**, con
  estado _Cerrada_, período y el tipo de gasto.
- Total arriba a la derecha: **Gs. 2.466.500**.
- _Por persona_: Mirna 63 % · Victor 37 %. _Por tipo de gasto_: todo en "VIÁTICOS A VENDEDORES".
- Un aviso amarillo: **"Todo el gasto cae en un solo tipo"**. Es correcto: DOBA no tipifica combustible,
  hospedaje, etc.

4. Quitá una (ícono de desenlazar) → el total baja. Volvé a asociarla.
5. **Una rendición pertenece a un solo viaje**: en otro viaje, la lista de rendiciones **no** tiene que
   ofrecer RVI-2026-00008 ni 00010.

---

## Prueba 10 — Cerrar, reabrir y viaje cerrado

1. **Cerrar viaje** → apretá _Cerrar viaje_ sin datos: pide **fecha** y **km de retorno**.
2. Poné km `25000` (menor al de salida) → error: no puede ser menor al de salida.
3. Poné fecha 07/06/2026 y km `25790` → muestra **"Km recorridos: 603"** en vivo. Confirmá.

**Qué tenés que ver:**

- Chip **Cerrado**. Desaparecen _Editar_, _Cerrar_, _Traer documentos_ y _Nueva remisión_; aparece **Reabrir**.
- En **Gastos y km**: no se puede agregar ni quitar rendiciones (solo abrirlas). _Costo por km_ = **Gs. 4.090**.

4. **Reabrir** → vuelve a **En ruta** y se puede editar otra vez. Volvé a cerrarlo para la Prueba 11.

---

## Prueba 11 — Resumen: ¿ganó plata el viaje?

Pestaña **Resumen**, en dos bloques.

**Ventas y cobranza**

| Tarjeta                | Valor             |
| ---------------------- | ----------------- |
| Vendido                | 186.153.965       |
| Cobrado                | 190.626.447       |
| Por cobrar (rojo)      | 9.990.800 vencido |
| Sin rendir (rojo)      | 194.299.023       |
| Deuda anterior cobrada | 210.458.240       |

Hacé clic en **Sin rendir** o en **Por cobrar** → te lleva a la pestaña **Cobranza**.

> _Cobrado_ puede ser mayor que _Vendido_: incluye notas de crédito aplicadas dentro de los recibos, y lo
> pendiente (9.990.800) es el saldo real de cada factura.

**Rentabilidad**

- Aviso amarillo: **"El costo de la mercadería está cargado solo para el 16 % de lo facturado"**.
- **Margen bruto** Gs. 5.339.370 (16 % sobre lo que tiene costo) · **Costo del viaje** Gs. 2.466.500
  (2 rendiciones) · **Resultado (costo conocido)** Gs. 2.872.870 · **Viáticos sobre venta** 1,3 % ·
  **Km** 603 · **Costo por km** Gs. 4.090 · **Clientes visitados** 81 (Gs. 2.298.197 por cliente).

> **Ojo con el resultado.** Con 16 % de cobertura, el resultado compara un margen parcial contra todos los
> viáticos, así que queda corto. Por eso dice "costo conocido". Para un número real hay que cargar el costo
> de los productos.

---

## Prueba 12 — Lista de viajes, búsqueda y acciones rápidas

1. Volvé a **Viajes**. Escribí `cristian` o el número `VJ-…` en el buscador → la lista se filtra (la búsqueda
   la hace el servidor, así que encuentra viajes de cualquier página).
2. En la columna **Acciones** de un viaje abierto:
   - **Lápiz** → abre _Editar_ sin salir de la lista. Cambiá la descripción y guardá: la fila se actualiza.
   - **X roja** → _Anular_. El botón queda deshabilitado hasta escribir un motivo de al menos 3 letras.
     Anulá el viaje de la Prueba 3.
3. Un viaje anulado no tiene ni lápiz ni X.
4. Al anular, **sus documentos y rendiciones quedan libres**: otro viaje del mismo vendedor y fechas los vuelve
   a proponer. En el detalle del viaje anulado queda un recuadro *"Al anularse tenía N elementos"* con la lista,
   solo para consulta.
4. Hacer clic en cualquier otra parte de la fila abre el detalle.

---

## Prueba 13 — Botones de estado y remisión

Creá un viaje nuevo cualquiera (arranca **Planificado**):

1. **Marcar en ruta** → el chip pasa a _En ruta_ y el botón desaparece (se mantiene al recargar).
2. Pestaña **Documentos → Nueva remisión** → te lleva a _Ventas › Remisiones › Nueva_. La remisión, una vez
   creada, se engancha con _Traer documentos_ si cae en las fechas del viaje.
3. Al terminar, anulá este viaje desde la lista (lápiz/X de la Prueba 12).

---

## Prueba 14 — Excel

**Exportar Excel** baja `viaje_VJ-….xlsx` con **4 hojas**:

| Hoja         | Qué revisar                                                                                                                                                                                                                    |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Carga**    | 12 productos con planificado, remitido, facturado y diferencia                                                                                                                                                                 |
| **Matriz**   | Un bloque de 4 columnas por cliente (precio, cajas, unidades, total), como la planilla de DOBA. Al pie, por cliente: **FACTURAS · CONDICIÓN · COBRADO · CÓMO PAGÓ · SALDO · VENCE** (reemplaza el FACT/FP que anotaban a mano) |
| **Cobranza** | El cuadre, los medios, el control de rendición, la tabla por cliente y los listados de cheques y recibos sin rendir                                                                                                            |
| **Resumen**  | Datos del viaje, **Rentabilidad** (margen %, cobertura y viáticos sobre venta con formato de porcentaje), las 2 rendiciones y el gasto por tipo                                                                                |

Los montos tienen que ser **números** (se pueden sumar en Excel), no texto.

---

## Prueba 15 — Celular

Abrí el detalle del viaje desde el celular (o achicá la ventana a ~390 px):

- [ ] No aparece scroll horizontal en la página (las tablas anchas sí se desplazan dentro de su recuadro).
- [ ] Los botones del encabezado bajan de renglón sin taparse.
- [ ] Las tarjetas del Resumen quedan una debajo de la otra.

---

## Casos límite que vale la pena mirar

| Situación                                         | Qué debería pasar                                                                      |
| ------------------------------------------------- | -------------------------------------------------------------------------------------- |
| Viaje sin documentos                              | Cada pestaña muestra un mensaje que explica qué falta y dónde cargarlo                 |
| Recibo que paga una factura del viaje y una vieja | La parte nueva va a _Cobrado_ y la vieja a _Deuda anterior cobrada_; no se mezclan     |
| Recibo con retención o NC aplicada                | La diferencia entre lo cancelado y lo que entró aparece como **Ajustes (no es plata)** |
| Rendición de cobranza **rechazada**               | Sus recibos cuentan como **sin rendir**                                                |
| Rendición de viáticos **anulada**                 | Se lista, pero con "No suma al costo"                                                  |
| Factura, NC, recibo o remisión **anulada** desde su pantalla, u **OV cancelada**, después de engancharla | No suma en ningún cálculo. En Documentos aparece tachada con un chip **Anulado**, y arriba un aviso con el botón **Quitarlos** |
| Ningún producto con costo cargado                 | _Margen bruto_ y _Resultado_ muestran "—": nunca se supone costo cero                  |
| Factura en dólares                                | Se muestra en su moneda y el equivalente usa la cotización guardada en el documento    |
| Empresa **sin** el submódulo VENTAS_VIAJES        | No ve el menú Viajes ni puede usar la API                                              |
| Usuario sin permiso de editar                     | Ve el viaje, pero sin botones de editar, enganchar ni asociar                          |

---

## Qué reportar

Si algo no coincide, contanos:

1. **Qué viaje** (número) y **qué pestaña**.
2. **El número que viste** vs. el de la tabla de referencia.
3. Si podés, **qué documento** creés que falta o sobra (número de factura o recibo).

Lo más valioso de reportar es un **cuadre que no cierra** (facturado ≠ caja + recibos + por cobrar + NC sin
aplicar) o un **cliente con saldo que no debe**. Eso significaría que el sistema le muestra al dueño plata
que no existe, o que esconde plata que sí falta.

Y si una pantalla queda **en blanco**, avisá aunque no sepas por qué: con la foto de la consola
(F12 → Console) se ubica el problema en minutos.
