Evidencias y cashback con OCR

Una evidencia es un comprobante que sube un miembro (ticket de compra, recibo, factura, albarán) para demostrar una acción que debe recompensarse.

Ciclo de vida de una evidencia

1. Subida — el miembro hace foto del ticket desde la app/PWA.
2. OCR — el sistema extrae automáticamente datos: comercio, importe, fecha, productos.
3. Validación — se comprueba contra las reglas de la campaña.
4. Aprobada / Rechazada — se recompensa al miembro o se notifica el rechazo.
5. Cierre — los datos quedan registrados para reporting y auditoría.

OCR

IncentIA soporta varios proveedores de OCR configurables por tenant:

• Gemini Flash (Google) — proveedor por defecto, buena relación calidad/coste.
• API externa — tu propio servicio OCR.
• Manual — sin OCR; un admin revisa y valida a mano.

El OCR devuelve un score de confianza. Si supera el umbral configurado (ej. 70%), la evidencia se aprueba automáticamente. Si no, va a cola de revisión manual.

Datos extraídos

Típicamente:

• Comercio (nombre, dirección si aparece).
• Fecha y hora de la compra.
• Importe total.
• Divisa.
• Items (cuando están legibles): nombre de producto, cantidad, precio unitario.

Reglas de validación

Por cada campaña se puede configurar:

• Importe mínimo/máximo del ticket.
• Comercio permitido (lista blanca o patrón regex).
• Productos obligatorios (deben aparecer en los items).
• Ventana temporal (solo tickets de las últimas 48h; fechas dentro del rango de campaña).
• Cuota por miembro (máximo N tickets por persona).

Detección de duplicados

El sistema guarda un hash perceptual de cada imagen y los datos extraídos. Si un miembro intenta subir el mismo ticket dos veces, se rechaza automáticamente.

Recompensa

Una vez aprobada, la evidencia dispara:

• Puntos al balance del miembro.
• Cashback (si la campaña es de cashback) — se crea un desembolso pendiente.
• Notificación al miembro por su canal preferido (email, WhatsApp, push...).

Revisión manual

Las evidencias que no se auto-aprueban (confianza baja, reglas no cumplidas claramente) van a una cola de revisión:

• Admin tenant las ve en su panel.
• Admin partner puede revisarlas centralmente para todas sus marcas.
• Cada revisión genera log (quién aprobó, cuándo, por qué se rechazó).

Shopper Collector (automatización)

Alternativa a la subida manual: conectas tu sistema de caja / ecommerce, y las compras llegan automáticamente como "evidencias pre-aprobadas" vinculadas al miembro. Sin foto, sin OCR — llevamos el dato directo del POS al programa.

Soportado por webhooks de Shopify, WooCommerce, o integración a medida con tu ERP.

Anti-fraude

El módulo de fraud rules detecta patrones sospechosos:

• Mismo miembro subiendo muchos tickets en poco tiempo.
• Tickets con importes idénticos sospechosos.
• Misma imagen con pequeñas variaciones.
• Horarios de compra irregulares.

Ante una alerta, las reglas pueden bloquear al miembro, exigir revisión manual, o solo registrar el incidente.