Detalle
| Dato | Valor |
|---|---|
| Tipo de documento | Manual de Usuario |
| Módulo | Legales e Impuestos / Gestión |
| Formulario | frmGestion_TarjetasDeCredito |
| Caption de ventana | Tarjetas de Credito/Debito |
Introducción
Esta pantalla es un ABM (Alta, Baja y Modificación) de los productos de tarjeta de crédito y débito que la empresa acepta como medio de cobro. Cada producto define una descripción, una sigla, el importe mínimo aceptado, la cuenta contable asociada y reglas de validación del número de tarjeta (longitud esperada y dígitos iniciales).
Aclaración importante sobre el acceso desde menú: en la documentación interna del Asistente este formulario aparece vinculado a dos entradas de menú ("Tarjetas de Crédito y Débito" y "Actualizacion Alicuotas IIBB"). En el código real de la v14 el formulario
frmGestion_TarjetasDeCreditose abre únicamente desde la opción "Tarjetas de Credito" (btnGestion_TarjetasCreditoDebito). La opción de menú "Actualizacion Alicuotas IIBB" (btnImpuestos_AlicuotasIIBB) abre otro formulario distinto (frmGestion_Operaciones_Actualizacion_ARBA); la única referencia afrmGestion_TarjetasDeCreditoen ese handler está comentada (código muerto). Por lo tanto, este manual documenta el formulario en su único modo real: el ABM de tarjetas. No existe un "modo Alícuotas IIBB" dentro de este formulario.
Acceso al módulo
Se accede desde la opción de menú "Tarjetas de Credito". Antes de abrir, el sistema valida el permiso Gestion.TarjetasDeCredito; si el usuario no lo tiene, la ventana no se abre. El formulario se muestra acoplado dentro del panel principal de la aplicación (dock panel).
Pantalla principal
La pantalla presenta:
- Una barra de búsqueda superior con el botón Buscar y un check para limpiar parámetros.
- Una grilla de resultados (solo lectura) con las columnas: Descripción, Importe Minimo y Sigla (la columna ID existe pero está oculta).
- Una barra de herramientas ABM (Ribbon) con las acciones Nuevo, Modificar y Eliminar.
Al cargar, la grilla se llena automáticamente con todas las tarjetas activas.
Parámetros
La búsqueda admite filtrar por:
| Parámetro | Descripción |
|---|---|
| ID | Identificador del producto (0 = sin filtro). |
| Descripción | Texto contenido en la descripción del producto. |
| Activo | El listado siempre devuelve únicamente registros activos (Activo = true). |
El check de "limpiar parámetros" reinicia los filtros a sus valores por defecto.
Resultados
La grilla muestra los productos de tarjeta activos. Columnas visibles:
| Columna | Contenido |
|---|---|
| Descripción | Nombre del producto de tarjeta. |
| Importe Minimo | Importe mínimo aceptado para ese medio. |
| Sigla | Sigla identificatoria de la tarjeta. |
La grilla es de solo lectura; las modificaciones se hacen desde la ventana de Alta/Modificación.
Acciones disponibles
- Nuevo: abre la ventana "Agregar Tarjeta de Crédito/Débito" (
frmGestion_TarjetasDeCredito_AddMod) en blanco. Permite cargar Descripción, Importe Minimo, Sigla, Tipo (Credito/Debito), Cuenta contable y los datos de validación (Longitud y Primeros Dígitos), más el check Activo. - Modificar: abre la misma ventana de Alta/Modificación con el registro seleccionado cargado.
- Eliminar: realiza una baja lógica (marca el registro como
Activo = false, no lo borra físicamente). Pide confirmación antes de ejecutar. - Buscar: refresca la grilla aplicando los filtros.
En la ventana de Alta/Modificación: - La Descripción es obligatoria (si está vacía, el sistema lo advierte y no guarda). - El Tipo se elige en un combo con las opciones "Credito" y "Debito". - La Cuenta contable se selecciona mediante un selector de cuentas; al ingresar un número se autocompleta el nombre de la cuenta. - Los campos Longitud y Primeros Dígitos alimentan la validación del número de tarjeta.
Ejemplo práctico
Para dar de alta una tarjeta Visa Crédito: 1. Abrir "Tarjetas de Credito" desde el menú. 2. Click en Nuevo. 3. Completar Descripción = "VISA Crédito", Sigla = "VISA", Tipo = "Credito". 4. Indicar la Cuenta contable correspondiente (se autocompleta el nombre). 5. En Validación, cargar Longitud = 16 y Primeros Dígitos = "4" (las tarjetas Visa empiezan con 4). 6. Marcar Activo y Aceptar. El producto queda disponible para los cobros con tarjeta.
Consejos útiles
- La validación de número de tarjeta (
ValidTarjeta) verifica que la longitud del número coincida con la Longitud configurada y que comience con los Primeros Dígitos definidos. Cargar bien estos campos evita cobros con números inválidos. - La eliminación es lógica: un producto "eliminado" deja de aparecer en la grilla pero conserva su historial en la base.
- Use la sigla para identificar rápidamente el medio en otros listados y reportes.
Preguntas frecuentes
¿Este formulario también actualiza alícuotas de IIBB de ARBA?
No. Aunque el catálogo del Asistente lo asocia a la opción "Actualizacion Alicuotas IIBB", en el código real esa opción de menú abre otro formulario (`frmGestion_Operaciones_Actualizacion_ARBA`). Este formulario solo administra productos de tarjeta de crédito/débito.Al eliminar una tarjeta, ¿se borra de la base de datos?
No. La eliminación es lógica: el registro queda con `Activo = false` y desaparece de la grilla, pero permanece almacenado.¿Qué diferencia hay entre Crédito y Débito en el campo Tipo?
El campo Tipo es un combo con dos opciones (Credito / Debito) que clasifica el producto. Internamente se guarda como un valor booleano según el índice seleccionado.¿Para qué sirven Longitud y Primeros Dígitos?
Son reglas de validación del número de tarjeta: la longitud esperada de dígitos y la cadena de dígitos con la que debe comenzar el número. Se usan al validar una tarjeta ingresada en operaciones.Permisos
| Permiso | Acción |
|---|---|
Gestion.TarjetasDeCredito |
Permite abrir el formulario y ver las tarjetas. |
El alta, modificación y baja dentro del formulario no realizan una verificación de permiso adicional en el código: quedan habilitados al abrir la pantalla.
Información técnica
Basada en el análisis del formulario real de la v14
Formularios principales
| Form | Rol |
|---|---|
frmGestion_TarjetasDeCredito |
Pantalla principal: búsqueda y grilla de tarjetas (proyecto VPNET_WinForms, C#). |
frmGestion_TarjetasDeCredito_AddMod |
Ventana de Alta/Modificación de una tarjeta. |
Gestion_TarjetasDeCredito_Manager |
Manager de negocio (consulta, validación y persistencia). |
Permisos reales
| Permiso | Acción |
|---|---|
Gestion.TarjetasDeCredito |
"Permite ver las Tarjetas de Credito." — valida la apertura del formulario. |
Tablas de base de datos principales
| Tabla | Uso |
|---|---|
Gestion_TarjetasDeCredito |
Almacena los productos de tarjeta (Descripcion, Sigla, Importe_Minimo, Cta_Contable, Tipo, Validacion_Longitud, Validacion_PrimerosDigitos, Activo, auditoría). |
Cuentas |
Cuentas contables, para resolver el nombre de la cuenta asociada. |
Relación con otros módulos / manuales
| Manual relacionado | Vínculo operativo |
|---|---|
| Legales Impuestos Padrones de IIBB | Amplía el circuito, la configuración o los datos que utiliza esta funcionalidad. |
| Legales Impuestos Percepciones alícuotas | Amplía el circuito, la configuración o los datos que utiliza esta funcionalidad. |
| Alícuotas Default | Amplía el circuito, la configuración o los datos que utiliza esta funcionalidad. |
Notas para soporte
- El formulario existe en dos proyectos: la versión activa en
VPNET_WinForms(C#) y una versión histórica enVisualPlenarioNET.Legacy(VB). Verificar contra el binario instalado cuál se está ejecutando en el cliente. - El catálogo del Asistente (
AsistenteIA_TicketsBLTools.vb) mapea la entrada de menú "Actualizacion Alicuotas IIBB" afrmGestion_TarjetasDeCredito, pero el handler real del menú abrefrmGestion_Operaciones_Actualizacion_ARBA. Tratar la asociación del catálogo como dato desactualizado.