# El Fiado

## Paso a paso

Las tareas más comunes, resumidas. El detalle de cada una está en las secciones numeradas.

### Dar de alta a un cliente para fiarle

1. En el menú lateral abre **👥 Clientes → El Fiado (crédito)**.
2. Pulsa **➕ Nuevo Cliente**.
3. Escribe el **Nombre** y el **Teléfono** (10 dígitos); el apodo, la dirección y las notas son opcionales.
4. Revisa el **Límite de crédito** (por defecto $500) y pulsa **Guardar**.

Ver sección 4.

### Darle fiado a un cliente que ya está registrado (por ejemplo, uno de solo puntos)

1. En el menú lateral abre **👥 Clientes → El Fiado (crédito)**.
2. Pulsa **👥 Agregar cliente existente**.
3. Busca al cliente por nombre, apodo o teléfono y haz clic en su fila.
4. Revisa el **Límite de crédito** (por defecto $500) y pulsa **Dar crédito**.

Ver sección 4.2. No lo registres de nuevo: así se evita tener al mismo cliente duplicado.

### Venderle fiado

1. En el **Punto de Venta**, arma el carrito.
2. Elige el método de pago **📖 Fiado** y selecciona al cliente.
3. Revisa la vista previa (saldo actual, disponible y nuevo saldo).
4. Pulsa **Cobrar**. Si la compra pasa su límite, el sistema te pregunta si la autorizas de todas formas.
5. Imprime el ticket con el pagaré para que el cliente lo firme.

Ver sección 5.

### Registrar un abono

1. En **El Fiado**, busca al cliente y pulsa **💵 Abonar**.
2. Escribe el **Monto** (o pulsa **Liquidar Total**) y elige el método de pago.
3. Pulsa **Registrar Abono**.
4. Imprime el comprobante o envíalo por **💬 WhatsApp**.

Ver sección 6.

### Consultar o enviar el estado de cuenta

1. En **El Fiado**, pulsa **📋 Cuenta** en la fila del cliente.
2. Revisa sus compras y abonos con el saldo de cada movimiento.
3. Si quieres mandárselo, usa el botón de **WhatsApp**.

Ver sección 7.

## 1. ¿Qué es "El Fiado"?

"El Fiado" es el control de **clientes de confianza a quienes se les vende a crédito** (fiado). Permite:

- Registrar clientes con un límite de crédito.
- Vender a crédito desde el Punto de Venta (POS), cargando el importe a la cuenta del cliente.
- Registrar los abonos (pagos) que el cliente va haciendo para bajar su deuda.
- Consultar el estado de cuenta de cada cliente (compras y abonos, con saldo corriente).
- Enviar recordatorios y comprobantes por WhatsApp.

**Quién puede usarlo:** a diferencia de Productos y Proveedores (que son solo de administrador), **cualquier empleado** (cajero o admin) puede dar de alta clientes y registrar abonos, porque en el día a día es el cajero quien atiende el fiado. Solo un **administrador** puede:

- Cambiar el **límite de crédito** de un cliente.
- **Desactivar** o **reactivar** un cliente.

## 2. Cómo llegar al módulo

En el menú lateral abre **👥 Clientes → El Fiado (crédito)**. Arriba de la tabla verás:

- **← Volver al Inicio**
- **📜 Historial de Abonos** — ver todos los abonos registrados por cualquier cliente.
- **👥 Agregar cliente existente** — pasar a El Fiado a un cliente que ya está registrado (ver sección 4.2).
- **➕ Nuevo Cliente** — dar de alta un cliente nuevo.

### 2.1 Indicadores (KPIs) en la parte superior

| Tarjeta | Qué muestra |
|---|---|
| 💰 Deuda Total | Suma del `saldo_deudor` de todos los clientes. |
| ⚠️ Clientes con Deuda | Cuántos clientes tienen `saldo_deudor > 0`. |
| ✅ Al Corriente | Cuántos clientes tienen saldo en $0 o menos. |
| 🏦 Crédito Total Otorgado | Suma de los límites de crédito asignados a todos los clientes. |

Si hay clientes con deuda, en el menú de navegación aparece un **badge** (número) sobre "El Fiado" indicando cuántos.

### 2.2 Pestañas y búsqueda

- **Todos / Con Deuda / Al Corriente**: filtran la tabla.
- El buscador filtra por **nombre, apodo, teléfono o dirección** (no distingue mayúsculas/minúsculas).

## 3. La tabla de clientes

**Esta tabla solo lista a quienes realmente se les otorgó fiado**: clientes con un límite de crédito mayor a $0, o que aún deben algo aunque su límite se haya bajado a $0 después. Un cliente registrado únicamente para ganar puntos (por ejemplo, desde el POS o desde el botón "Nuevo Cliente" de [CRM y Fidelidad](./crm.md)) **no aparece aquí**, porque nunca se le dio crédito — ese cliente se ve en la pantalla de CRM y Fidelidad junto con todos los demás.

Cada fila muestra:

- **Cliente**: nombre, apodo (si tiene) entre comillas, y notas (ícono 📝, con el texto completo al pasar el mouse).
- **Contacto**: teléfono, mostrado como `(999) 329-5690` (con un ícono 💬 para abrir WhatsApp directo si el teléfono tiene 10 dígitos) y dirección. En la base de datos se guarda solo con dígitos — el formato con paréntesis y guion es únicamente de pantalla.
- **Límite de Crédito**: el límite asignado y el crédito disponible (`límite - saldo_deudor`).
- **Saldo Deudor**: monto que debe, con una barra de progreso de qué tanto de su límite ha usado.
- **Estado**:
  - ✅ **Al corriente** — no debe nada.
  - 🟡 **X% usado** — tiene deuda pero dentro de su límite.
  - 🔴 **⚠️ Límite Excedido** — su deuda superó el límite de crédito (esto puede pasar si un admin autorizó una venta que lo excedía, ver sección 5.3).
- **Acciones**:
  - **💵 Abonar** — registrar un pago del cliente.
  - **📋 Cuenta** — ver el estado de cuenta completo.
  - **💬 WhatsApp** (solo si tiene teléfono válido y debe algo) — enviar un recordatorio de saldo.
  - **✏️** — editar los datos del cliente.

## 4. Dar de alta o editar un cliente

### 4.1 Nuevo cliente

1. Clic en **➕ Nuevo Cliente**.
2. Llena el formulario:
   - **Nombre** (obligatorio).
   - **Apodo** (opcional) — como le dicen en el barrio, útil para identificarlo rápido.
   - **Teléfono** (obligatorio, 10 dígitos) — necesario para los botones de WhatsApp y para que el cliente aparezca en campañas de CRM.
   - **Dirección** (opcional).
   - **Límite de crédito** — cuánto se le permite deber como máximo. Por defecto $500.
   - **Notas** (opcional) — cualquier observación libre.
3. Clic en **Guardar**.

### 4.2 Agregar a El Fiado un cliente que ya está registrado

Si el cliente ya existe (por ejemplo, se registró solo para ganar puntos y después pidió crédito), **no lo des de alta otra vez**: conserva su mismo registro, con sus puntos e historial.

1. Clic en **👥 Agregar cliente existente**. Se abre una lista con los clientes activos que todavía no tienen fiado; cada uno muestra su teléfono y sus puntos.
2. Usa el buscador (nombre, apodo o teléfono) y haz clic en el cliente.
3. Escribe el **Límite de crédito** (debe ser mayor a $0; por defecto $500).
4. Clic en **Dar crédito**. El cliente aparece de inmediato en la tabla de El Fiado.

**Reglas:**

- Cualquier empleado puede hacerlo, igual que registrar un cliente nuevo.
- Solo sirve para dar el **primer** límite. Si el cliente ya tiene crédito, el sistema avisa "El cliente ya está en El Fiado"; para cambiar su límite, un administrador lo edita (sección 4.3).
- Un cliente desactivado no aparece en la lista: primero hay que reactivarlo (sección 4.4).
- Si quedó duplicado un cliente de antes, desactiva el que sobra (sección 4.4).

### 4.3 Editar un cliente existente

1. Clic en el ícono **✏️** de la fila del cliente.
2. Se abre el mismo formulario con los datos actuales.
3. **Importante:** el campo **Límite de crédito** solo lo puede modificar un **administrador**. Si entra un cajero, el campo aparece deshabilitado.
4. Si el usuario es administrador, también aparece el botón **🚫 Desactivar** dentro del modal.
5. El teléfono **solo es obligatorio al registrar un cliente nuevo**: si editas a un cliente que ya existía desde antes de este requisito y no tiene teléfono, puedes guardar sus demás datos sin que el sistema te obligue a capturarlo en ese momento.

### 4.4 Desactivar o reactivar un cliente (solo administrador)

Los clientes **no se eliminan**; se desactivan.

**Cliente que no está en El Fiado** (sin crédito, por ejemplo solo de puntos): no aparece en la tabla, así que se desactiva desde **👥 Agregar cliente existente**. Busca al cliente, pulsa el botón rojo **🚫** de su fila y confirma. Se conservan su historial y sus puntos.

**Cliente de El Fiado:**

- No se puede desactivar un cliente que tenga **saldo pendiente mayor a $0**. El sistema lo bloquea con un aviso.
- Si el saldo es $0, abre el cliente (✏️), pulsa **🚫 Desactivar** y confirma en el diálogo rojo **"Sí, desactivar"**. El cliente deja de aparecer en la lista de El Fiado y para ventas, pero **su historial de compras y abonos se conserva**.
- Para recuperarlo (de cualquiera de los dos casos), abre la pestaña **Inactivos** (junto a Todos / Con Deuda / Al Corriente) y pulsa **✅ Reactivar** en su fila. Esa pestaña lista a todos los clientes desactivados, hayan tenido fiado o no.

## 5. Vender a crédito desde el Punto de Venta (POS)

> Ver también: [manual del POS, sección "Venta a crédito (El Fiado)"](./pos.md#53-venta-a-crédito-el-fiado).

1. En el POS, arma el carrito normalmente.
2. En el método de pago, selecciona **Crédito**.
3. Aparece un selector **"-- Seleccionar cliente a quien fiar --"** con todos los clientes activos, mostrando su saldo actual y crédito disponible.
4. Al elegir un cliente, se muestra una vista previa con:
   - Límite de crédito
   - Saldo actual
   - Crédito disponible
   - Nuevo saldo a deber (si se completa la venta)
   - Una advertencia roja si la venta **supera el crédito disponible**.
5. Clic en **Cobrar / Finalizar venta**.

### 5.1 Validaciones al cobrar a crédito

- Es obligatorio seleccionar un cliente.
- El cliente debe estar **activo**.

### 5.2 Venta dentro del límite

Se procesa normalmente: el importe de la venta se suma al `saldo_deudor` del cliente.

### 5.3 Venta que excede el límite de crédito

Si el total de la venta supera el crédito disponible del cliente, el sistema muestra una confirmación:

> "Esta compra ($X) supera el crédito disponible de [Cliente] ($Y). ¿Deseas autorizar la venta fiada de todas formas?"

- Si se **cancela**, la venta no se realiza.
- Si se **autoriza**, la venta se completa de todas formas y el cliente queda con estado **"⚠️ Límite Excedido"** en la tabla de El Fiado. Esta autorización debe usarse con criterio (por ejemplo, un cliente de mucha confianza que pidió un poco más de lo normal).

## 6. Registrar un abono (pago del cliente)

1. Desde la tabla de El Fiado, clic en **💵 Abonar** en la fila del cliente (o desde el estado de cuenta).
2. Se abre el modal con:
   - Nombre del cliente y su deuda actual.
   - Campo **Monto** del abono.
   - Botón **"Liquidar Total ($X)"** que llena automáticamente el monto con toda la deuda pendiente.
   - Selector de **método de pago**: Efectivo, Tarjeta o Transferencia.
   - **Notas** (opcional).
3. Clic en **Registrar Abono**.

**Validación:** el monto debe ser mayor a $0. El sistema no obliga a que el abono sea menor o igual a la deuda (el campo `max` es solo una sugerencia visual del navegador), así que confirma bien la cantidad antes de guardar.

### 6.1 Comprobante de abono

Al registrar el abono se abre automáticamente un ticket imprimible con:

- Folio del abono (`ABO-####`), fecha y quién atendió.
- Saldo anterior, monto abonado, método de pago y nuevo saldo restante.
- Botones **🖨️ Imprimir Ticket** y, si el cliente tiene teléfono válido, **💬 Enviar por WhatsApp** (envía el comprobante como mensaje de texto).

### 6.2 Por qué importa el método de pago del abono

Si el abono se cobra en **Efectivo**, ese dinero se suma al efectivo esperado en la **Caja** (Corte de Caja) del empleado que lo registró — es dinero físico que entró a la caja aunque no sea una venta. Los abonos por Tarjeta o Transferencia no afectan el efectivo en caja.

## 7. Estado de cuenta de un cliente

1. Clic en **📋 Cuenta** en la fila del cliente.
2. Se muestra:
   - Saldo actual, total de cargos (compras a crédito), total de abonos y el límite de crédito.
   - Una tabla con **todos los movimientos**: cada compra a crédito (🛒 Compra, en rojo/naranja) y cada abono (💵 Abono, en verde), con fecha, folio, quién atendió, monto y el **saldo resultante** después de ese movimiento — así puedes ver la cuenta corriendo paso a paso.
3. Si el cliente tiene teléfono, hay un botón para **enviar el estado de cuenta por WhatsApp** (resumen con saldo actual, límite y los últimos 5 movimientos).

Este estado de cuenta se calcula siempre a partir del historial real de ventas y abonos — nunca se edita el saldo a mano.

## 8. Historial global de abonos

Desde el botón **📜 Historial de Abonos** en la parte superior de la pantalla se abre una tabla con **todos los abonos de todos los clientes**, ordenados con folio, fecha, cliente, monto, método de pago y quién lo atendió. Útil para revisar los cobros del día o de un periodo sin tener que abrir cliente por cliente.

## 9. Devoluciones de ventas a crédito

Si se hace una **devolución** de una venta que fue pagada con "Crédito", el sistema **reduce el saldo deudor del cliente** en vez de asumir que se devolvió efectivo (porque nunca hubo efectivo de por medio en esa venta). Esto se gestiona desde el módulo de Ventas/Devoluciones, no desde El Fiado directamente, pero el efecto se refleja en el saldo del cliente.

**Ventas con pago mixto.** Si la venta se cobró con **🔀 Mixto** y una parte fue a Fiado (ver [manual del POS](./pos.md#57-pago-mixto)), solo esa parte cuenta como cargo en el estado de cuenta y en el saldo del cliente. Si se devuelve parte de la venta, el saldo baja en la misma proporción que la parte fiada tenía en el total; el resto se trata como dinero que sí entró a la caja.

## 10. Preguntas frecuentes

**¿Puedo subir el límite de crédito de un cliente yo mismo (cajero)?**
No. Solo un administrador puede cambiar el límite de crédito de un cliente que ya tiene fiado. Pídele a un administrador que edite al cliente. La única excepción es darle su **primer** límite a un cliente que no tenía crédito (**👥 Agregar cliente existente**, sección 4.2).

**Un cliente que solo junta puntos me pidió fiado. ¿Lo registro otra vez?**
No. Usa **👥 Agregar cliente existente**: le asignas un límite y sigue siendo el mismo cliente, con sus puntos y su historial. Registrarlo de nuevo crearía un duplicado.

**¿Cómo desactivo a un cliente que no aparece en El Fiado?**
Un administrador abre **👥 Agregar cliente existente**, busca al cliente y pulsa **🚫** en su fila (sección 4.4).

**¿Qué pasa si el cliente ya no compra aquí y quiero quitarlo de la lista?**
Primero debe quedar en $0 de saldo (o registra un abono hasta liquidarlo). Entonces un administrador puede desactivarlo. No se borra: si regresa, se reactiva desde la pestaña Inactivos con todo su historial.

**¿Se puede autorizar una venta que sobrepase el límite de crédito?**
Sí, el sistema pregunta y permite autorizarlo manualmente al momento de cobrar en el POS. Usa esta opción con cuidado, ya que deja al cliente con estado "Límite Excedido" hasta que pague.

**¿Los abonos afectan el corte de caja?**
Solo los abonos pagados en **Efectivo** se suman al efectivo esperado del corte de caja de quien los registró.