---
title: SmartOperation
slug: smartoperation
docTags: 
createdAt: 2026-01-25T13:49:57.712Z
---



Una Smart**Operation** es la representación visual de un conjunto de datos que agrupa información relevante de la operación

![](https://api.archbee.com/api/optimize/wYlzYU9oe8HZjh9BkqeFY/6Z4lFQtAw0hXfyHoom0h8_image.png "CUPON")

## Beneficios del modelo SmartOperationpara Operación y Soporte

**SmartOperation** es el modelo de cupones estandarizado de SUGA que unifica la representación de las operaciones de pago en una estructura común, independientemente del adquirente, procesante, canal o dispositivo desde el cual se haya originado la transacción.

Este modelo actúa como una **capa de abstracción** sobre las diferencias técnicas entre proveedores, permitiendo que toda transacción sea interpretada y operada bajo un mismo esquema.

**SmartOperation** aporta beneficios directos a los equipos operativos y de atención a comercios:

- Vista única y centralizada de la información de cada operación. 
- Estructura de datos consistente en todos los escenarios. 
- Eliminación de dependencias de formatos específicos por proveedor. 
- Reducción de tiempos de análisis y resolución de incidencias. 
- Mayor trazabilidad y auditabilidad. 

**Al normalizar los datos en SmartOperation** con una estructura común, SUGA permite que:

- Los equipos trabajen siempre sobre el mismo modelo de información. 
- Las herramientas de soporte utilicen una lógica única de visualización. 
- Los procesos operativos sean consistentes a escala. 

Como resultado, cualquier pago —sin importar si fue procesado por distintos adquirentes, procesantes, canales (online, presencial, in-app) o dispositivos— se presenta bajo un **formato homogéneo**, simplificando la operación diaria y mejorando la experiencia de atención al comercio.



## Aplicabilidad a SmartOperation y Transacciones

- Cada smart**Operation **puede contener uno o más **transacciones**. 
- Cada **transacción** posee su propio estado dentro de este mismo modelo. 
- El estado general de la operación se determina a partir del estado agregado de sus transacciones. 

Esto permite representar correctamente escenarios como:

- Pagos parciales. 
- Devoluciones parciales. 
- Split de pagos. 
- Diferencias de estado entre transacciones de un mismo Operation 

 y se compone de tres grandes bloques:

### Entidad: 

Es el comercio interviniente que recibe el pago. Cada entidad está compuesta por un ID y una referencia donde, ID es el identificador único del comercio dentro de la plataforma adquirente y la Referencia es un campo que se puede asignar un dato que se necesite para cruzar con otros sistemas. 

### Cliente: 

Es el Tarjetahabiente (pagador) y consta de Nombre de Usuario, Mail, Teléfono y ID (DNI, Cedula o pasaporte). Estos campos solo vienen completos si durante el proceso de la transacción el checkout, el SmartPOS o el QR reciben los campos completos del "Cutomer" definido en la documentación técnica 

### Detalles de la operación

1\) Datos del tarjetahabiente

- **Número de tarjeta (enmascarado):** 65008700\*\*\*\*6748 
- **Nombre tarjetahabiente:** CASTELLINA BRUNO 
- **ID tarjetahabiente:** 39824169 

2\) Datos operativos de la transacción

- **ID transacción:** 0R2LHAH3MGBA35FFHUY9OH 
- ´Estado: 
- Referencia: 
- Canal:
- Dispositivo:
- S/N del dispositivo: 
- Monto:
- Medio de pago:
- Cuotas
- Plan Elegido
- Monto de las cuotas
- Fecha de creación 
- Fecha de actualización
- **Código de autorización:** 711870 
- **RRN:** 000000000004 
- ARN:
- **Número de lote:** 1 
- **Número de ticket:** 1 
- **ID plan:** 1 
- **UID plan:** \~JZx17kwe 
- **ID medio de pago:** 674a350a21872575df8e54b6 
- **Nombre medio de pago:** Cabal Débito 
- **Tipo medio de pago:** card
- **ID comercio/MID:** 89760000011 
- **Adquirente:** Mobbex Argentina 
- **Procesante:** Cabal 
- Fecha 
- Fecha de Pago

Esto permite un modelo consistente para soporte, conciliación y auditoría, independientemente del canal o adquirente/procesante.

## Acceso e Integración de Smartcupon/transacciones

Las transacciones gestionadas por la Plataforma Adquirente SUGA pueden ser consumidas e integradas por sistemas externos a través de distintos mecanismos, según las necesidades de cada caso de uso:

**APIs**: Permiten la consulta, búsqueda y obtención de detalle de transacciones y SmartCupones bajo demanda. 

::File{src="https://www.sugaway.dev/consulta-de-operaciones-por-operador" label="https://www.sugaway.dev/consulta-de-operaciones-por-operador"}

**Webhooks**:
 Permiten la notificación en tiempo real de eventos transaccionales relevantes, como creación de transacción, cambios de estado, autorizaciones, rechazos, devoluciones o conciliaciones. 

::File{src="https://www.sugaway.dev/webhook-operaciones" label="https://www.sugaway.dev/webhook-operaciones"}

**SUGA QL**:
 Lenguaje de consulta de SUGA que habilita exploración flexible, filtrado avanzado y análisis de información transaccional sobre el modelo unificado de datos. 



Este enfoque garantiza que las transacciones puedan ser accedidas tanto de forma **sincrónica**, **asíncrona** o **analítica**, manteniendo siempre el mismo modelo de información.