Reporte de ventas y facturación: por día/tienda, dashboard, atribución por campaña
Ventas/facturación agregadas por período, desglosadas por día, mes o tienda — la respuesta a "cuánto vendí ayer", "facturación por tienda este mes", "ticket promedio por período". Devuelve los totales más el desglose por estado.
Los ingresos son netos de cancelación por defecto (los pedidos cancelados
quedan fuera del total). El bloque byStatus siempre reporta todos los
estados, incluido el cancelado, para que lo excluido siga siendo auditable.
Valores en centavos. El día se corta de order_date (la fecha del
negocio) convertida a la zona horaria de la organización. updatedThrough es
el mayor createAt que entró en el cálculo: como el pedido llega después de
la venta, "ayer" es un número mutable.
Reemplaza a financeSumary, que sumaba cancelaciones, perdía el último día
del período y agrupaba en UTC.
Todo total trae mix, el ingreso descompuesto desde el precio de lista
hasta lo que realmente entró — la respuesta a "cuál es mi ingreso neto",
"cuánto di de descuento", "cuánto me costó el programa de lealtad":
| campo | significado |
|---|---|
listRevenue |
precio de lista — revenue + discounts |
discount |
lo que la tienda cedió |
incentive |
saldo que pagó el programa (null sin withAttribution) |
netRevenue |
lo que entró — revenue − incentive (null sin withAttribution) |
averageTicket |
ASP, precio promedio efectivamente cobrado |
listAverageTicket |
OSP, precio promedio de lista, antes del descuento |
⚠️ revenue ya es neto del descuento comercial — el price del artículo
es el unitario después del descuento. Entonces el precio de lista es revenue
más discounts, no menos. Restar el descuento de revenue lo cuenta dos
veces, y es la forma más común de equivocarse con este número.
⚠️ No confunda mix con attribution.revenueGross / revenueNet: esos
son del recorte de las ventas atribuidas, mientras que mix es del negocio
entero.
⚠️ listRevenue y listAverageTicket valen lo que valga total_discounts.
Donde la integración no manda "precio de lista menos precio de venta" el
número no se sostiene — ordersDiscountOverRevenue, en el mismo total,
cuenta los pedidos con descuento mayor que la propia venta.
Todo total y toda fila traen también los conteos principales: orders,
revenue, averageTicket y customersIdentified — los
compradores únicos (clientes distintos, COUNT(DISTINCT client)): cuántas
personas diferentes compraron — más ordersIdentified / ordersAnonymous
(pedidos con y sin cliente identificado). Así "ventas por día con ticket promedio
y compradores únicos" es una sola llamada: este reporte con groupBy=day (suma
membership=member para solo miembros). customersIdentified cuenta solo
comprador identificado — un pedido anónimo no tiene cliente que contar.
Pasa compareWith para comparar con otro período (previous = ventana
del mismo tamaño justo antes; previousYear = las mismas fechas un año atrás;
o un rango YYYY-MM-DD..YYYY-MM-DD). La respuesta agrega un bloque
comparison con el total del período base y el delta (absoluto y %).
Pasa withAttribution para el ingreso atribuido a campañas — el valor
total de las ventas donde el cashback / saldo de una campaña se canjeó o
cuyo mensaje generó la compra, y el mismo desglose por campaña
(topCampaigns=N), para responder "cuánto generó el cashback de la campaña X" y
el ticket por campaña. Es ingreso influenciado, no incremental. El bloque
separa además venta atribuida (canjeó saldo), influenciada (solo recibió
el mensaje y compró) e impactada (la suma) en split. El bloque ya
trae las derivadas sobre pedidos distintos: avgDiscount
(redeemed / revenueGross), averageTicketGross y averageTicketNet — la
diferencia entre los dos tickets es el saldo promedio aplicado por pedido.
Try-it values populated from environment ACME (Demo)
Autenticación
Token
Send your user token in the x-guper-authorization header.
Encabezados
Parámetros de ruta
Parámetros de query
Respuestas
Notas
Comparando períodos (compareWith)
Agrega un bloque comparison junto al total. La comparación usa los mismos
filtros store/status; sólo se calcula el total del período base (sin
desglose por día o por tienda en el período base).
| valor | período base |
|---|---|
previous |
la ventana del mismo tamaño justo antes — ej.: para 2026-08-01..2026-08-31 (31 días) es 2026-07-01..2026-07-31 |
previousYear |
las mismas fechas un año antes — ej.: 2025-08-01..2025-08-31 |
2026-06-01..2026-06-30 |
un rango explícito que tú pasas |
delta compara el total actual con el base, en orders, revenue y
averageTicket:
abs— la diferencia (actual − base). En centavos pararevenueyaverageTicket.pct— el cambio como razón:0.0767= +7,67%,-0.0509= −5,09%. Esnullcuando el base es0.
En el ejemplo: facturación +7,7% con −5,1% de pedidos.
Atribuida, influenciada, impactada (split)
Con withAttribution=true, el bloque separa los dos caminos por los que el
programa llega a la venta, siempre en pedidos distintos:
| lado | qué es |
|---|---|
attributed |
el pedido canjeó saldo de una campaña |
influenced |
el cliente solo recibió el mensaje de la campaña y compró, sin canjear nada |
impacted |
los dos juntos — el total del propio bloque |
cashback |
de los atribuidos, los que canjearon sin push |
push |
de los atribuidos, los que canjearon y recibieron push (push gana el empate) |
El pedido cae de un solo lado: recibir el mensaje y canjear cuenta como
atribuido, así que attributed e influenced nunca cuentan doble y siempre
suman (impacted). Dentro de los atribuidos, cashback + push = attributed
— la separación por canal, porque el cashback base y el push cuestan distinto y
mezclarlos subestima el retorno del push.
"attribution": {
"orders": 1558,
"revenueNet": 303065066,
"split": {
"attributed": { "orders": 1480, "revenueGross": 345645957, "redeemed": 62869038, "revenueNet": 282776919, "avgDiscount": 0.1819 },
"influenced": { "orders": 78, "revenueGross": 20288147, "redeemed": 0, "revenueNet": 20288147, "avgDiscount": 0 },
"impacted": { "orders": 1558, "revenueGross": 365934104, "redeemed": 62869038, "revenueNet": 303065066, "avgDiscount": 0.1718 },
"cashback": { "orders": 1432, "revenueGross": 332780112, "redeemed": 60667968, "revenueNet": 272112144, "avgDiscount": 0.1823 },
"push": { "orders": 48, "revenueGross": 12865845, "redeemed": 2201070, "revenueNet": 10664775, "avgDiscount": 0.1711 }
}
}
influenced solo existe donde la campaña manda mensaje — una campaña que
solo emite saldo nunca cae ahí. cashback/push también aparecen en byDay y
en los desgloses byStore/byInterface (cashback vs push por canal y mes).
Reporte revenueNet: es la base de la factura.
discounts y los pedidos en que no cuadra
discounts es la suma de total_discounts, que las integraciones deberían mandar
como precio de lista menos precio de venta. Algunas no lo hacen.
ordersDiscountOverRevenue cuenta los pedidos del recorte cuyo descuento es
mayor que la propia venta — lo que esa definición vuelve imposible.
No es residuo de redondeo: en una organización son 27% de los pedidos, todos de
una sola integración, y con ellos adentro la razón descuento/facturación da 67%.
Revise ese campo antes de publicar cualquier razón hecha sobre discounts; arriba
de cero, reporte el monto y diga que la razón no se sostiene, en vez de convertir
dato sucio en número de negocio. Arreglar el dato es de la integración, no del
reporte.