Cupones de Tarjeta

Detalle

Campo	Valor
Manual de Usuario	Consulta de cupones de tarjeta generados en cobranzas: estados, importes (cobrado, cuotas, recargo) y fechas, con acceso al asiento contable y a la cuenta corriente de la entidad.
Módulo	Tesorería
Tipo de pantalla	Consulta (solo lectura) con buscador + grilla

Introducción

Un cupón de tarjeta representa el comprobante de un cobro realizado con tarjeta de débito/crédito. Cada cupón guarda el importe total cobrado, el importe en cuotas, el eventual recargo aplicado, el número de cupón y el número de tarjeta, además de su estado y las fechas del ciclo (conciliación, liquidación, confirmación, anulación).

Esta pantalla es de consulta: permite buscar y listar los cupones, y desde cada uno acceder a su asiento contable y a la cuenta corriente de la entidad asociada. No es un ABM (no se cargan, editan ni eliminan cupones desde aquí; los cupones se generan automáticamente durante la cobranza).

Acceso al módulo

Ingresá al sistema con tu usuario.
Abrí el menú Tesorería.
Buscá la opción Cupones de Tarjeta.

El punto exacto del menú depende de la configuración de su instalación.

Pantalla principal

La ventana (caption "Cupones de Tarjetas") muestra:

Componente	Descripción
Panel de búsqueda	Filtros por Especie, Caja y rangos de fechas (Conciliación, Liquidación, Confirmación, Anulación), además del rango de Fecha general. Botón Buscar y casilla Limpiar parámetros.
Grilla de cupones	Listado de cupones con sus importes, estado, fechas, número de cupón/tarjeta, usuario y especie.
Cinta Ver	Botones Asiento y Cuenta Corriente.

Filtros de búsqueda

Filtro	Descripción
Fecha (rango)	Rango de la fecha del cupón. Se activa al cargar el rango.
Especie	Moneda/especie del cupón. 0 = todas.
Caja (Usuario)	Caja del usuario asociada al cupón. 0 = todas.
Conciliación (rango)	Rango de FechaConciliacion.
Liquidación (rango)	Rango de FechaLiquidacion.
Confirmación (rango)	Rango de FechaConfirmacion (procesado).
Anulación (rango)	Rango de FechaAnulacion.

Cada rango de fechas se aplica solo si se activa. La casilla Limpiar parámetros reinicia todos los filtros.

Resultados

La grilla presenta una fila por cupón. Columnas visibles principales:

Columna	Descripción
Id	Identificador interno del cupón.
Fecha	Fecha del cupón.
Especie	Especie/moneda (descripción).
Estado	Estado del cupón (por ejemplo, "Pendiente").
Importe (ImporteCuotas)	Importe cobrado en cuotas.
Recargo (ImporteRecargo)	Recargo aplicado.
Total (ImporteCobrado)	Importe total cobrado.
NroCupon	Número de cupón.
NroTarjeta	Número de tarjeta.
Usuario	Usuario que registró el cupón.

Otras columnas disponibles (no visibles por defecto): fechas de Conciliación, Liquidación, Confirmación y Anulación, Id_Asiento, Id_CtaCTeRecibo, Id_CtaCTeRecargo, Id_UsuarioCaja, datos de auditoría (Id_UsuarioAdd/Mod, Fecha_Add/Mod) y la caja cobrada (Especies_Cajas).

Acciones disponibles

Acción	Descripción
Buscar	Ejecuta la búsqueda con los filtros cargados.
Ver > Asiento	Abre el asiento contable del cupón seleccionado (si tiene `Id_Asiento`).
Ver > Cuenta Corriente	Abre la cuenta corriente de la entidad asociada al cupón (si tiene `Id_CtaCTeRecibo`).

Esta pantalla no tiene Nuevo/Modificar/Eliminar: los cupones se generan automáticamente en el proceso de cobranza con tarjeta.

Ejemplo práctico

Buscar los cupones cobrados en un período y revisar el asiento de uno:

Abrí Tesorería > Cupones de Tarjeta.
Activá el rango de Fecha y cargá el período deseado.
(Opcional) Elegí una Especie o Caja para acotar.
Hacé clic en Buscar.
Seleccioná un cupón y, en la cinta Ver, hacé clic en Asiento para ver el asiento contable, o en Cuenta Corriente para ver el movimiento de la entidad.

Consejos útiles

Usá los rangos de fecha de Conciliación, Liquidación y Confirmación para auditar en qué etapa del ciclo está cada cupón.
El Recargo corresponde a un cargo adicional generado por el cobro con tarjeta; su asiento usa la cuenta contable definida por la etiqueta de parámetro de recargo de cupones.
Si un cupón no tiene asiento o cuenta corriente, los botones Ver no abrirán nada (no hay datos asociados).

Preguntas frecuentes

¿Puedo cargar o modificar un cupón desde esta pantalla?

No. Es una pantalla de **consulta**. Los cupones se generan automáticamente durante la cobranza con tarjeta.

¿Qué diferencia hay entre "Total", "Importe" y "Recargo"?

**Total** es el importe total cobrado (`ImporteCobrado`), **Importe** es lo cobrado en cuotas (`ImporteCuotas`) y **Recargo** es el cargo adicional por el uso de tarjeta (`ImporteRecargo`).

El botón "Asiento" no hace nada.

El cupón seleccionado no tiene un asiento contable asociado (`Id_Asiento` vacío). Lo mismo aplica a "Cuenta Corriente" si no hay `Id_CtaCTeRecibo`.

¿Cómo se genera el recargo del cupón?

Al generar el cupón, si hay recargo se arma un asiento contra la cuenta contable indicada por la etiqueta de parámetro `Web.Tesoreria.Operaciones.CobranzaCupones.EtiquetaCuenta` y se genera el movimiento de cuenta corriente correspondiente.

Permisos

En el formulario WinForms FormTesoreriaCajas_Cupones no se invoca IsAllowedObject ni KeyLicences: no hay un permiso enforced dentro de esta pantalla. El acceso, si existe, se controla a nivel de menú.

El manager define una constante de permiso Web.Tesoreria.Operaciones.VerCobranzaCupones ("Permite Ver Cupones de Cobranza", tipo Tesoreria.Operaciones), pero corresponde al uso web de cupones y no se valida en este formulario WinForms.

Verificar contra el binario instalado: el acceso a esta pantalla puede gobernarse por el permiso del ítem de menú correspondiente.

Información técnica

Sección de referencia para soporte/desarrollo. Basada en el análisis del formulario real de la v14 (FormTesoreriaCajas_Cupones, WinForms C# / Entity Framework).

Formularios principales

Form	Rol
`FormTesoreriaCajas_Cupones`	Consulta/buscador de cupones. Hereda de `FrmResult`. Caption "Cupones de Tarjetas". Grilla `gridCCupones`/`gridVCupones`. `VPNET_WinForms/Tesoreria/FormTesoreriaCajas_Cupones.cs`.
`Tesoreria_Cajas_Cupones_Manager`	Manager EF (`Base_Manager<Tesoreria_Cajas_Cupones>`). Búsqueda con filtros por fechas/especie/caja; generación de cupones (`GenerarCupon`). `VPNET_DataModel/Manager/Gestion/Tesoreria/Tesoreria_Cajas_Cupones_Manager.cs`.

Permisos reales

Permiso	Acción
(ninguno enforced en el form)	No se invoca `IsAllowedObject` en `FormTesoreriaCajas_Cupones`.
`Web.Tesoreria.Operaciones.VerCobranzaCupones`	Definido en el manager (constante `permisoVerWebCupones`), uso web, no validado en este WinForm.

Tablas de base de datos principales

Tabla	Uso
`Tesoreria_Cajas_Cupones`	Cupones de tarjeta. Campos: `Id`, `Id_Tipo_Entidad`, `Id_Entidad`, `Fecha`, `Id_Especie`, `Estado`, `FechaConciliacion`, `FechaLiquidacion`, `FechaConfirmacion`, `FechaAnulacion`, `ImporteCobrado`, `ImporteCuotas`, `ImporteRecargo`, `NroCupon`, `NroTarjeta`, `Id_Recibo`, `Id_Asiento`, `Id_CtaCTeRecibo`, `Id_CtaCTeRecargo`, `Id_UsuarioCaja`, auditoría (`Id_UsuarioAdd/Mod`, `Fecha_Add/Mod`).
`Especies` / `Especies_Cajas`	Especie y caja del cupón (incluidas en la consulta).
`Seguridad_Usuarios_Cajas`	Caja del usuario (usada al generar el cupón).
Cuentas contables / cuenta corriente	El recargo genera asiento (`Asientos_Manager`) y movimiento de cuenta corriente (`CuentasCorrientes_Manager`).

Relación con otros módulos / manuales

Manual relacionado	Vínculo operativo
Importar Recibos	Amplía el circuito, la configuración o los datos que utiliza esta funcionalidad.

Notas para soporte

La grilla se llena con GetDatasources (EF, AsNoTracking, incluye Especies_Cajas y Especie). Los filtros de fecha solo aplican si su flag está activo.
Bug latente en filtros de fecha (verificar contra binario): en el code-behind, los handlers de cambio de fecha de Liquidación y Confirmación asignan desde uC_FechaConciliacion (copy/paste) en lugar de sus propios controles, y un handler de "Hasta" general asigna a Fecha_Desde. Esto puede hacer que esos rangos no filtren como se espera.
Botón Asiento: VPNetApp.Main.MostrarAsiento(Id_Asiento). Botón Cuenta Corriente: VPNetApp.Main.MostrarCuentaCorriente(tipoEntidad, Id_Entidad).
GenerarCupon (no expuesto en esta UI) arma el cupón en estado "Pendiente", genera asiento de recargo si ImporteRecargo != 0 y asocia la caja del usuario.

Ver también

Importar Recibos