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¶
- Cómo se relacionan estos términos como entidades, en el Modelo de dominio.
- Cómo se usan en el contrato exacto de la API, en API de resolución.
- Los términos de
base_amount, en Base del beneficio.