Saltar a contenido

Glosario

Términos canónicos del dominio de BeneficiosCenter. "Consulta" no es "Trx"; "tipo de cliente" no es "tipo de factura" — confundirlos es la fuente de ambigüedad más común al leer el resto de esta documentación.

Término Significado
Beneficio Regla configurada por el Administrador que produce un porcentaje de descuento para ciertos tipos de cliente, en un período, franja horaria, sucursales y monto mínimo.
Tipo de cliente Tipo de cuenta del medio de pago (DINI Negocios, DINI Gift Card, …). Se identifica ante el autorizador por su payment_method_id. No confundir con el tipo de factura.
Medio de pago 999 Código payment_method_id con el que el POS y el gateway identifican a la billetera DINI en la intención de pago (payment_methods_data). No es un tipo de cliente y no se carga en el ABM: el tipo de cuenta que paga (990 Negocios, 991 Gift Card) lo determina el autorizador DINI al aprobar, y aplica el beneficio que coincide.
Tipo de factura Dato de facturación del comprador que envía el gateway: tipo A, B o C, con identificación CUIT, CUIL o DNI; consumidor final sin identificación es B con taxId vacío. Es solo un filtro de entrada; nunca es una dimensión de la respuesta.
Resolución Evaluar una petición del gateway contra los beneficios vigentes y devolver a lo sumo un porcentaje por tipo de cliente.
Consulta Registro de auditoría de una resolución: request, response, evaluaciones y latencia. No es la transacción de pago.
Resultado de pago Registro de lo que pasó realmente con un pago después de que el autorizador respondió: aprobado o rechazado, cuenta usada, descuento efectivo. Se correlaciona con una Consulta por requestId, pero no es lo mismo: la Consulta mide lo ofrecido, el Resultado de pago mide lo aplicado (entrega 3).
Trx Transacción de pago del GatewayQR. Vive en el gateway, no en BeneficiosCenter. Se cruza con la Consulta por requestId.
Ruta caliente El camino request → resolución → response, que debe responder en menos de 20 ms (p99) sin tocar la base de datos.
Configuración activa Snapshot en memoria de beneficios, tipos de cliente y sucursales vigentes, que la ruta caliente usa para resolver.
Administrador (ADMIN) Rol que configura beneficios, tipos de cliente, sucursales y usuarios.
Operador (OPERADOR) Rol de solo lectura: consulta auditoría y configuración, no modifica.
Autorizador Sistema externo (DINI vía Prisma) que aprueba el pago y aplica el beneficio que coincide con la cuenta que pagó.
GatewayQR Servicio de Tipre que intermedia entre el POS y el autorizador y que consulta a BeneficiosCenter.

Dónde sigue