> ## Documentation Index
> Fetch the complete documentation index at: https://docs.finsync.ar/llms.txt
> Use this file to discover all available pages before exploring further.

# Operaciones

> Estructura de operaciones y transacciones, tipos de operaciones y significado de créditos y débitos.

# Operaciones

Las operaciones representan movimientos financieros que se componen de **una o múltiples transacciones**. Cada transacción individual es siempre fundamentalmente un **crédito** o un **débito**.

## Estructura Fundamental

### Operación vs Transacción

* **Operación**: El movimiento financiero completo (ej: "Bajada de Wise")
* **Transacción**: Cada registro individual de crédito o débito que forma parte de la operación

### Tipos de Transacciones

* **Crédito**: Suma dinero al saldo de la cuenta
* **Débito**: Resta dinero del saldo de la cuenta

## Significado según Tipo de Cliente

El **significado** de los créditos y débitos cambia según si se aplican a cajas o cuentas corrientes:

### Cajas (Clientes Internos / Activos / Cuentas Líquidas)

* **Débito**: Disminuye el activo de la empresa (dinero sale de caja)
* **Crédito**: Aumenta el activo de la empresa (dinero entra a caja)
* **Balance positivo**: Representa dinero disponible en caja
* **Balance negativo**: Representa dinero que falta en caja

### Cuentas Corrientes (Clientes Externos / Pasivos)

* **Débito**: Disminuye la deuda de la empresa hacia el cliente (el cliente te debe menos o tú le debes menos)
* **Crédito**: Aumenta la deuda de la empresa hacia el cliente (el cliente te debe más o tú le debes más)
* **Balance positivo**: La empresa le debe dinero al cliente (pasivo)
* **Balance negativo**: El cliente le debe dinero a la empresa (activo por cobrar)

### Lógica Contable Resumida

**Para Cuentas Internas (Activos)**:

* Crédito = Suma al saldo = Aumenta el activo
* Débito = Resta del saldo = Disminuye el activo

**Para Cuentas Externas (Pasivos)**:

* Crédito = Suma al saldo = Aumenta el pasivo (debes más al cliente)
* Débito = Resta del saldo = Disminuye el pasivo (debes menos al cliente)

## Tipos de Operaciones

### UP/DOWN Operations - Modos de Operación

Las operaciones UP y DOWN soportan tres modos diferentes, cada uno diseñado para diferentes escenarios de flujo de fondos:

#### Modo Estándar (Standard)

El modo tradicional de operaciones UP/DOWN entre cuentas internas y externas.

**DOWN (Bajada) - Modo Estándar**

* **Origen**: Cliente externo (cuenta corriente)
* **Destino**: Cuenta interna (caja)
* **Transacciones**:
  * **Crédito** en cuenta externa origen (aumenta la deuda que la empresa tiene con el cliente)
  * **Crédito** en cuenta interna destino (aumenta el activo de la empresa)
* **Significado**: El cliente envía dinero a una de tus cuentas, por lo que tu balance líquido aumenta y también aumenta la deuda que tienes con el cliente.
* **Ejemplo**: Bajada de Wise - Un cliente deposita dinero en tu cuenta de Wise

**UP (Subida) - Modo Estándar**

* **Origen**: Cuenta interna (caja)
* **Destino**: Cliente externo (cuenta corriente)
* **Transacciones**:
  * **Débito** en cuenta interna origen (disminuye el activo de la empresa)
  * **Débito** en cuenta externa destino (disminuye la deuda que la empresa tiene con el cliente)
* **Significado**: Pagas dinero que le debes al cliente. Tu balance líquido disminuye y también disminuye tu deuda con el cliente.
* **Ejemplo**: Retiro por caja - Pagas a un cliente desde tu caja

#### Modo Interno-Interno (Internal Transfer)

Transfiere balance entre cuentas líquidas internas (cajas).

**DOWN (Bajada) - Modo Interno-Interno**

* **Origen**: Cuenta interna
* **Destino**: Cuenta interna
* **Transacciones**:
  * **Débito** en cuenta origen (dinero sale de la cuenta origen)
  * **Crédito** en cuenta destino (dinero entra a la cuenta destino)
* **Significado**: Mueve balance entre cuentas líquidas internas.
* **Ejemplo**: Transferencia entre caja principal y caja secundaria

**UP (Subida) - Modo Interno-Interno**

* **Origen**: Cuenta interna
* **Destino**: Cuenta interna
* **Transacciones**:
  * **Débito** en cuenta origen (dinero sale de la cuenta origen)
  * **Crédito** en cuenta destino (dinero entra a la cuenta destino)
* **Significado**: Mueve balance entre cuentas líquidas internas.
* **Ejemplo**: Transferencia entre caja secundaria y caja principal

#### Modo Externo-Externo (Third Party)

Operaciones que involucran cuentas de terceros para recibir o pagar fondos de clientes.

**DOWN (Bajada) - Modo Externo-Externo**

* **Origen**: Cliente externo (cuenta corriente)
* **Destino**: Cliente tercero (cuenta corriente)
* **Transacciones**:
  * **Crédito** en cuenta cliente origen (aumenta la deuda que la empresa tiene con el cliente origen)
  * **Débito** en cuenta cliente tercero (disminuye la deuda que el tercero tiene con la empresa)
* **Significado**: Usas una cuenta de tercero para recibir fondos del cliente. La deuda del tercero contigo aumenta y también aumenta la deuda que tienes con el cliente.
* **Ejemplo**: Un cliente te paga a través de una cuenta de un tercero

**UP (Subida) - Modo Externo-Externo**

* **Origen**: Cliente tercero (cuenta corriente)
* **Destino**: Cliente externo (cuenta corriente)
* **Transacciones**:
  * **Crédito** en cuenta cliente tercero (disminuye la deuda que el tercero tiene con la empresa)
  * **Débito** en cuenta cliente destino (disminuye la deuda que la empresa tiene con el cliente destino)
* **Significado**: Usas una cuenta de tercero para resolver la deuda que tienes con tu cliente. La deuda del tercero contigo disminuye y también disminuye la que tienes con el cliente.
* **Ejemplo**: Pagas a un cliente usando fondos de una cuenta de tercero

### Resumen de Transacciones por Modo

| Modo                | Operación | Origen            | Destino           | Transacción Origen | Transacción Destino |
| ------------------- | --------- | ----------------- | ----------------- | ------------------ | ------------------- |
| **Estándar**        | DOWN      | Externa           | Interna           | Crédito (Haber +)  | Crédito (Haber -)   |
| **Estándar**        | UP        | Interna           | Externa           | Débito (Debe +)    | Débito (Debe -)     |
| **Interno-Interno** | DOWN/UP   | Interna           | Interna           | Débito (Debe +)    | Crédito (Haber -)   |
| **Externo-Externo** | DOWN      | Externa           | Externa (Tercero) | Crédito (Haber +)  | Débito (Debe -)     |
| **Externo-Externo** | UP        | Externa (Tercero) | Externa           | Crédito (Haber -)  | Débito (Debe +)     |

### Características Adicionales de UP/DOWN

* **Calculadora de Tipo de Cambio**: Cuando las monedas de origen y destino son diferentes, puedes usar la calculadora integrada para convertir montos automáticamente.
* **Comisiones**: Puedes agregar comisiones que se aplicarán a la cuenta origen, destino o a un tercero.
* **Tipos de transacción separados**: Los selectores principales de una operación muestran solo tipos de transacción clasificados como regulares. Los selectores dentro del bloque de comisiones muestran solo tipos clasificados como comisión.
* **Vista Previa de Saldos**: El sistema muestra una vista previa de cómo quedarán los saldos después de la operación.
* **Montos Iguales**: Opción para igualar automáticamente el monto de destino al de origen.
* **Estados**: Las transacciones pueden crearse como "Pendientes" o "Completadas" según tus permisos.

### Interfaz de UP/DOWN Operations

Al crear una operación UP o DOWN, verás una interfaz intuitiva con dos tarjetas principales:

1. **Tarjeta ORIGEN** (azul): Configura la cuenta o cliente desde donde sale el dinero
   * Muestra el tipo de cuenta (Interna/Externa)
   * Indica "Haber (-)" para cuentas internas o "Haber (+)" para cuentas externas
   * Permite seleccionar cuenta/cliente, moneda, tipo de transacción y monto
   * Muestra vista previa del saldo después de la operación

2. **Tarjeta DESTINO** (verde): Configura la cuenta o cliente hacia donde va el dinero
   * Muestra el tipo de cuenta (Interna/Externa)
   * Indica "Debe (+)" para cuentas internas o "Debe (-)" para cuentas externas
   * Permite seleccionar cuenta/cliente, moneda, tipo de transacción y monto
   * Muestra vista previa del saldo después de la operación
   * Incluye opción "Usar balance completo" cuando aplica

**Selector de Modo**: En la parte superior puedes elegir entre:

* **Estándar**: Para operaciones tradicionales entre cajas y clientes
* **Interno-Interno**: Para transferencias entre cuentas internas
* **Externo-Externo**: Para operaciones con terceros

**Herramientas Adicionales**:

* Calculadora de tipo de cambio (aparece cuando las monedas son diferentes)
* Gestor de comisiones (permite agregar múltiples comisiones)
* Resumen de operación (muestra todas las transacciones que se crearán)
* Descripción y nota interna opcionales

### Clasificación de tipos de transacción

Los tipos de transacción de tu empresa pueden clasificarse en distintos grupos. Hoy el sistema contempla:

* **Regulares**: se usan para los movimientos principales de la operación (origen, destino, intercambio, presupuesto, otras).
* **De comisión**: se usan exclusivamente cuando agregas una comisión.
* **De interés**: quedan reservados para configuraciones y procesos relacionados con intereses.

Esto evita mezclar tipos de comisión o interés en los movimientos principales y también ayuda a que cada módulo muestre solo los tipos que realmente corresponden.

### EXCHANGE (Intercambio)

Operaciones de cambio de moneda entre cuentas.

### OTHER (Otras)

Operaciones personalizables para casos específicos.

### BUDGET (Presupuesto)

Operaciones especiales para centros de costo:

1. Débito de cuenta interna
2. Crédito a cuenta externa (centro de costo)
3. Débito de cuenta externa (opcional, para netear el balance del cliente del centro de costo)

### INTEREST (Intereses)

Operaciones generadas automáticamente por el sistema para aplicar intereses devengados:

* Se crean periódicamente según la configuración de frecuencia de pago (diaria, semanal, mensual)
* Aplican intereses calculados sobre los saldos de las cuentas
* Son operaciones de solo lectura generadas por el sistema
* No pueden ser creadas manualmente por usuarios

## Estados de Transacciones

| Estado        | Descripción                                                             |
| ------------- | ----------------------------------------------------------------------- |
| **Pending**   | Transacción creada pero que aun no afecto los balances                  |
| **Completed** | Transacción procesada y aplicada al saldo                               |
| **Adjusted**  | Transacción cancelada o rollbackeada, su impacto en saldo fue revertido |