BeneficiosCenter¶
Beneficios por medio de pago, decididos en milisegundos y configurados sin programar.
BeneficiosCenter es el servicio central que le dice al GatewayQR de Tipre qué porcentaje de descuento corresponde a cada tipo de cuenta DINI, para cada pago QR, antes de que el autorizador lo apruebe. El comercio configura las campañas desde una consola web —vigencia, días, horarios, sucursales, monto mínimo— sin tocar el POS ni coordinar código con la billetera. Toda oferta que se resuelve queda auditada.
De un vistazo
- Cliente: Supermercados DINO (Super MaMi), Córdoba · Proveedor: Tipre
- Medio de pago: DINI — cuentas Negocios (
990) y Gift Card (991) - Integración: GatewayQR de Tipre, autorizador DINI/TECSO vía Prisma
- Objetivo de respuesta: menos de 20 ms (p99), sin tocar la base de datos
- Versión actual: v1.6.0 (2026-11-16) — beneficio sobre una base
(
base_amount); ver el historial de versiones - Estado: entrega 1 en producción (go-live 2026-09-06), entrega 2 cerrada (2026-09-30), entrega 3 (Q2) cerrada: pipeline de resultado de pago y panel de Resultados en la consola
Para quién¶
- El comercio (DINO) configura campañas de descuento por tipo de cuenta desde la consola, sin depender de un despliegue.
- El GatewayQR consulta a BeneficiosCenter en medio de cada cobro y adjunta el resultado a la intención de pago que viaja al autorizador.
- El operador de soporte audita cualquier consulta —qué se ofreció, a quién, cuándo y por qué— desde la sección Auditoría.
El flujo en una imagen¶
Seis mensajes (el RouterQR solo reenvía el primero). BeneficiosCenter participa solo en el segundo y el tercero: si no llega a tiempo, el GatewayQR sigue adelante sin beneficios (CU-11), porque un cobro frenado es peor que una oferta perdida.
sequenceDiagram
participant POS
participant RQ as RouterQR
participant GW as GatewayQR (Tipre)
participant BC as BeneficiosCenter (Tipre)
participant AUT as Autorizador DINI/TECSO
POS->>RQ: 1. Intención de pago (monto, fecha, sucursal, POS, CUIT/CUIL, base_amount opcional)
RQ->>GW: reenvía la solicitud
rect rgba(224, 248, 72, 0.15)
Note over GW,BC: RUTA CALIENTE — objetivo < 20 ms, sin tocar la base
GW->>BC: 2. POST /api/v1/beneficios/resolver
BC-->>GW: 3. benefits[] — un porcentaje por tipo de cliente
end
GW->>AUT: 4. Intención Prisma + benefits_methods_data
AUT-->>GW: 5. Autorización + benefits_data (cuenta usada, monto final, eco de base_amount)
GW-->>POS: 6. importe_final, importe_recdesc
Ver el detalle completo en Arquitectura del sistema y el contrato exacto en API de resolución.
Beneficio sobre una base (v1.6.0)¶
Desde v1.6.0, si el POS informa una promo base, el descuento se calcula sobre el monto acumulado
de esa promo y no sobre el total del ticket. El campo es opcional: sin él, todo funciona como
antes. Las reglas, el recorrido por RouterQR, GatewayQR, BeneficiosCenter y TECSO, y la
compatibilidad están en Base del beneficio (base_amount); la
decisión, en ADR-007; el orden de despliegue, en
Despliegue.
Las tres entregas¶
| Entrega | Fecha | Qué agregó |
|---|---|---|
| Entrega 1 | 2026-09-06 (go-live) | Motor de resolución completo, API de resolución con auditoría asincrónica, consola con los cuatro ABM y dos roles, simulador del gateway. |
| Entrega 2 | 2026-09-30 | Tablero con KPIs, retención y exportación de auditoría, marca blanca en runtime, PWA (retirada en v1.3.0), contrato OpenAPI, prueba de carga sostenida, cierre de la deuda diferida D-01..D-24. |
| Entrega 3 | Q2 | Pipeline de resultado de pago: el GatewayQR reporta, fire-and-forget, cómo terminó cada pago (aprobado/rechazado, cuenta usada, descuento efectivo); panel de "Resultados de pago" en la consola; benefitId viaja de punta a punta desde el gateway. |
Después de la entrega 3 hubo cambios incrementales en la consola (v1.3.0 a v1.5.0) y la versión
v1.6.0 con base_amount. El detalle de cada versión está en Versiones.
Esta tabla es un corte en el tiempo
La versión vigente al 2026-11-16 es v1.6.0. Si estás leyendo esto mucho después, revisá el historial de versiones y el changelog del repositorio del sistema antes de asumir que sigue siendo la frontera.
Cómo está organizada esta documentación¶
Seguimos el framework Diátaxis: cuatro tipos de página según lo que el lector necesita en ese momento.
| Sección | Para qué sirve | Pregunta que responde |
|---|---|---|
| Entender el sistema | Comprender el porqué y el cómo | "¿Cómo funciona? ¿Por qué está diseñado así?" |
| Referencia técnica | Consultar datos exactos | "¿Qué endpoints, modelos y configuración hay?" |
| Guías prácticas | Resolver una tarea concreta | "¿Cómo lo instalo, siembro datos, o pruebo el gateway?" |
| Consola web | Reconocer la interfaz | "¿Qué pantallas tiene y qué puede hacer cada rol?" |
| Propuesta comercial | Presentar el producto | "¿Qué es y qué valor tiene, en dos páginas?" |
Por dónde empezar
- Si sos técnico y vas a instalarlo: Arquitectura → Despliegue.
- Si vas a integrar el gateway: API de resolución → Contrato con el autorizador → Pipeline de resultado de pago → Simulador del gateway.
- Si te interesa el beneficio sobre una base: Base del beneficio → Versiones.
- Si querés la visión de producto: Propuesta comercial.
Fuentes¶
Esta documentación se compiló a partir del SPEC.md, CONSTITUTION.md, CONTEXT.md,
DOMAIN-MODEL.md, ACCEPTANCE.md, RUNBOOK.md, los ADR-001..007, las notas de la versión
1.6.0 y el contrato con el autorizador (docs/Beneficios-contrato-autorizador.html) del repositorio SistemaBeneficios.