Saltar a contenido

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, tipo de factura— 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
  • Estado: v1.1.1 — 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. 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 GW as GatewayQR (Tipre)
    participant BC as BeneficiosCenter (Tipre)
    participant AUT as Autorizador DINI/TECSO

    POS->>GW: 1. Intención de pago (monto, fecha, sucursal, POS, factura, CUIT/CUIL)
    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)
    GW-->>POS: 6. importe_final, importe_recdesc

Ver el detalle completo en Arquitectura del sistema y el contrato exacto en API de resolución.

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, 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.

Entrega 3 no es lo último por definición — es lo último hoy

Esta tabla se actualiza en cada entrega cerrada. Si estás leyendo esto mucho después del 2026-09-12, revisá el changelog del repositorio del sistema antes de asumir que entrega 3 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, sembro 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

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..005 y el contrato con el autorizador (docs/Beneficios-contrato-autorizador.pdf) del repositorio SistemaBeneficios.