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. Desde v1.4.0 el resolver no filtra por tipo de factura: al momento del pago QR la factura todavía no existe.
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.
RouterQR Componente entre el POS y el GatewayQR; reenvía la solicitud de pago. Para base_amount no tuvo cambios de código: pasa el campo tal cual.
TECSO Autorizador DINI al que el GatewayQR envía la intención de pago. Recibe el descuento ya calculado (discount.amount, discount.base_amount) y no recalcula.
base_amount Campo opcional que el POS envía con el pago QR: monto acumulado de los ítems de una promo base. Viaja POS → RouterQR → GatewayQR (/trxpago, nivel superior) → BeneficiosCenter (transaction.base_amount) → autorizador (discount.base_amount). Si falta, el descuento se calcula sobre el total (v1.6.0).
Promo base Promo de medio de pago, configurada en el backend de promos, cuyo medio de pago no existe en el POS; el POS suma los ítems que cubre y ese acumulado es el base_amount. Si el medio de pago sí existe en la caja, no es una promo base.
Base efectiva Monto sobre el que BeneficiosCenter calcula discountAmount y evalúa montoMinimo: base_amount acotado a [0, amount]; sin base_amount, el total. Se devuelve como baseAmount en cada beneficio.
BASE_CERO Motivo de descarte: llegó un base_amount informado cuya base efectiva es 0, así que no se ofrece el beneficio. Solo aplica si el campo fue informado.
Eco del autorizador benefits_data.base_amount que el autorizador devuelve en su respuesta. El GatewayQR lo compara con el enviado y registra un WARN si no coincide; nunca falla el pago.

Dónde sigue