# Saldo virtual

Sección **"Saldo virtual"** está diseñado para mantener la contabilidad financiera interna de una casa de cambio. Permite rastrear la dinámica de las ganancias y gestionar el saldo virtual sin necesidad de conectar APIs de intercambio reales o sistemas de pago.El saldo virtual es una herramienta para llevar la contabilidad financiera interna de un exchanger.Principios principales:El saldo es completamente virtual: no hay integración con exchanges ni con sistemas de pago.Todos los cálculos se realizan en base a los campos de automatización financiera de las solicitudes.El objetivo es rastrear la dinámica de los cambios de saldo, calcular la ganancia por las solicitudes completadas y visualizarla en un gráfico.Solo los usuarios con el rol Admin pueden cambiar manualmente el valor del saldo virtual.

#### 1. Principio de funcionamiento <a href="#id-1.-principle-of-operation" id="id-1.-principle-of-operation"></a>

1. El Admin retira todos los fondos de los exchanges y sistemas de pago en efectivo.
2. El Admin establece el **saldo virtual** en el panel de administración, por ejemplo $300.
3. Cada solicitud que pasa al estado **Completada**, aumenta el saldo virtual por la cantidad de ganancia de esa solicitud.
   * Fórmula de ganancia:ganancia = cantidad recibida - cantidad pagada - comisión
   * El cálculo se realiza solo para solicitudes con el estado **Completada**.
   * Si los valores de una solicitud cambian después de la finalización, la ganancia **se recalcula** automáticamente.
4. Ejemplo:
   * Saldo inicial: $300
   * 50 solicitudes completadas con $10 de ganancia cada una → saldo virtual: $800
   * El Admin retira $800 en efectivo y vuelve a establecer el saldo en $100 → el ciclo comienza de nuevo.

#### 2. Requisitos funcionales <a href="#id-2.-functional-requirements" id="id-2.-functional-requirements"></a>

**2.1. Cálculo de la ganancia**

* Para cada solicitud que esté en el estado **Completada**, el sistema calcula:
  * ganancia = cantidad recibida - cantidad pagada - comisión
* Los valores se muestran:
  * En la tarjeta de la solicitud
  * En el archivo de exportación de solicitudes (columnas: `ganancia`, `saldo_virtual_en_el_cajero`)
* Cuando los campos de una solicitud se modifican después de la finalización, se realiza un **recalculo de la ganancia**.

**2.2. Gestión del saldo virtual**

* **Solo el Admin puede cambiar el saldo manualmente.**
* Todos los cambios se registran en el **historial de cambios**:
  * Quién lo cambió
  * Fecha/hora
  * Valor de saldo antiguo y nuevo
* El historial está disponible en la subpágina **"Historial de cambios manuales de saldo"**.

![](https://images.gitbook.com/__img/dpr=2,width=760,onerror=redirect,format=auto,signature=548958334/https%3A%2F%2F655796329-files.gitbook.io%2F~%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%2FKqXT4jWa7TDQpKKq2Yaf%2Fuploads%2FFxVyZFMUhGw7ZH8KuoyX%2Fimage.png%3Falt%3Dmedia%26token%3Df33f54d6-b050-463c-9f28-c9a7e1601c14)

**2.3. Gráfico de cambios de saldo**

![](https://images.gitbook.com/__img/dpr=2,width=760,onerror=redirect,format=auto,signature=1978129692/https%3A%2F%2F655796329-files.gitbook.io%2F~%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%2FKqXT4jWa7TDQpKKq2Yaf%2Fuploads%2FlrXiFnUUAMhmdgbkOJgH%2Fimage.png%3Falt%3Dmedia%26token%3Dd4bcaed1-f165-488a-8f30-52799a1d89c4)

* Acceso al gráfico: roles **Admin, Operador, Financiero**.
* El gráfico muestra el cambio de saldo
* Capacidad para seleccionar de forma flexible el período de visualización (por ejemplo, del 2 de octubre al 1 de noviembre).

**2.4. Capacidad para establecer el saldo**

1. **"Establecer saldo"**

   * Puede establecer manualmente el saldo virtual actual haciendo clic en el lápiz junto al saldo y rellenando el campo correspondiente en el menú desplegable

   ![](https://images.gitbook.com/__img/dpr=2,width=1168,onerror=redirect,format=auto,signature=-874058179/https%3A%2F%2F655796329-files.gitbook.io%2F~%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%2FKqXT4jWa7TDQpKKq2Yaf%2Fuploads%2FjuJaTJDEmCQZm75cuirs%2Fimage.png%3Falt%3Dmedia%26token%3D9df6e149-f235-4ab8-99bf-f62dabc0e93d)

#### 3. Roles y derechos de acceso <a href="#id-3.-roles-and-access-rights" id="id-3.-roles-and-access-rights"></a>

|            |                                    |                                    |
| ---------- | ---------------------------------- | ---------------------------------- |
| Admin      | "Establecer saldo", "Estadísticas" | Puede cambiar el saldo manualmente |
| Operador   | "Estadísticas"                     | Ver solo el gráfico                |
| Financiero | "Estadísticas"                     | Ver solo el gráfico                |

​