← Volver a Entidades de Tarjetas

TarjetasPrepago

Entidad para gestión de tarjetas de prepago y vales

📊 Descripción General

La entidad TarjetasPrepago representa las tarjetas de prepago y vales utilizados en el sistema RestMaster. Esta entidad gestiona el saldo disponible, límites, fechas de validez y configuración de impuestos para cada tarjeta.

🎯 Propósito de la Entidad

  • Gestión de Saldo: Control de saldo disponible y máximo
  • Control de Validez: Fechas de inicio y fin de validez
  • Seguridad: PIN de acceso y control de baja
  • Configuración Fiscal: Tipo de IVA y porcentaje

📋 Propiedades de la Entidad

TarjetaPrepago

double
Identificador único de la tarjeta (clave primaria)

Maximo

double?
Saldo máximo permitido en la tarjeta

Disponible

double?
Saldo disponible actual en la tarjeta

Baja

string (1)
Indicador de tarjeta dada de baja

Recargable

string (1)
Indicador si la tarjeta es recargable

Caducidad

string (1)
Indicador si la tarjeta tiene caducidad

FechaInicio

DateTime?
Fecha de inicio de validez de la tarjeta

FechaFin

DateTime?
Fecha de fin de validez de la tarjeta

Pin

string (20)
PIN de seguridad de la tarjeta

TipoIva

string (15)
Tipo de IVA aplicable a la tarjeta

Iva

double?
Porcentaje de IVA aplicable

🔗 Relaciones con Otras Entidades

💳 Entidades de Tarjetas

  • Tarjeta: Tarjeta principal relacionada
  • TipoIva: Tipo de IVA aplicable

🎯 Funcionalidades Relacionadas

  • Gestión de Saldo: Control de saldo disponible
  • Control de Validez: Fechas de validez
  • Seguridad: PIN y control de acceso
  • Fiscal: Configuración de impuestos

💡 Ejemplo de Uso

// Crear una tarjeta de prepago var tarjetaPrepago = new TarjetasPrepago { TarjetaPrepago = 1001, Maximo = 100.00, Disponible = 100.00, Baja = "N", Recargable = "S", Caducidad = "S", FechaInicio = DateTime.Now, FechaFin = DateTime.Now.AddMonths(12), Pin = "1234", TipoIva = "GENERAL", Iva = 21.0 }; // Consultar tarjetas activas var tarjetasActivas = context.TarjetasPrepagos .Where(t => t.Baja == "N" && t.Disponible > 0) .ToList(); // Consultar tarjetas por fecha de caducidad var tarjetasCaducadas = context.TarjetasPrepagos .Where(t => t.FechaFin < DateTime.Now && t.Caducidad == "S") .ToList(); // Actualizar saldo de tarjeta var tarjeta = context.TarjetasPrepagos .FirstOrDefault(t => t.TarjetaPrepago == 1001); if (tarjeta != null) { tarjeta.Disponible -= 25.50; context.SaveChanges(); }

🔧 Configuración de Base de Datos

🗄️ Configuración de Tabla

  • Tabla: TARJETAS_PREPAGO
  • Clave Primaria: TARJETA_PREPAGO
  • Esquema: Maestro

🔑 Restricciones

  • TarjetaPrepago: Clave primaria, número único
  • Baja: Máximo 1 carácter
  • Recargable: Máximo 1 carácter
  • Caducidad: Máximo 1 carácter
  • Pin: Máximo 20 caracteres
  • TipoIva: Máximo 15 caracteres

🔗 Integración con Otros Componentes

📚 Componentes Relacionados

  • Back.API: TarjetasController para gestión
  • Back.Application: Servicios de tarjetas
  • Back.Domain: DTOs de tarjetas
  • Common.Constants: Validaciones de tarjetas

🎯 Casos de Uso

  • Gestión de Vales: Tarjetas de regalo
  • Tarjetas de Fidelización: Programas de puntos
  • Tarjetas Corporativas: Empresas y organizaciones
  • Control de Saldo: Gestión de fondos
  • Seguridad: Control de acceso con PIN
  • Reportes: Análisis de uso de tarjetas