Productos más vendidos
La respuesta a "qué se vendió más", "top productos por ingreso", "unidades por
SKU", en una sola llamada — en vez de paginar los ítems y agrupar del lado
del cliente. Ordena los ítems vendidos (order_item) por producto, SKU, categoría
o marca, en el mismo recorte que el reporte de ventas (org, ventana en la zona
horaria de la org, tienda, status).
Por fila: units (cantidad vendida), unitsCanceled, revenue, orders
(cuántos pedidos lo incluyeron) y lines. Las filas son el top N por ingreso
(limit, default 50); el total cubre todos los ítems del período, no solo
el top.
Desglósalo por tienda o por tiempo en una sola llamada. groupBy acepta una
lista separada por comas: el 1er token es la dimensión del ítem
(product/sku/category/brand) y puedes sumar store y/o un grano de tiempo
(day/week/month) — ej. groupBy=product,store, sku,week,
product,store,month. Con desglose, el limit toma los top ítems de todo el
período y cada fila es una celda (ítem × tienda × período) — tienes el detalle
por tienda o semanal sin una llamada por tienda. La fila lleva storeId, day
(YYYY-MM-DD), week (YYYY-Www, ISO) o month (YYYY-MM) según el caso; una celda
sin ventas no se emite.
revenue es ingreso de LÍNEA — SUM(price × quantity), con price = valor
unitario del ítem (neto del descuento del ítem). No es el total del pedido y
no coincide con el ingreso del reporte de ventas: descuentos y ajustes de
nivel-pedido no bajan al price del ítem, así que la suma de las líneas corre más
alta (≈+20% medido). Usa este para ranking de producto; usa el
order.report.sales para facturación. Valores en centavos.
category y brand vienen de ingesta parcial y están dispersos hoy (pocos %
en algunas orgs). El endpoint ya está listo para ellos y se va llenando conforme
la ingesta mejore — lee el meta.coverage (fracción de ítems e ingreso que tienen
categoría/marca) para que un desglose que cubre 5% del período no se lea como el
total. Las filas con id null son los ítems sin el campo. order_item no guarda el
nombre de categoría/marca, solo el id y el refId externo.
Try-it values populated from environment ACME (Demo)
Autenticación
Token
Send your user token in the x-guper-authorization header.