Metrics

Métricas de Magazord con la API

Tu cliente conecta su cuenta de Magazord y tu producto consulta 11 métricas por el mismo endpoint que las demás plataformas. Cada métrica tiene un identificador (reference_key) que va en la llamada.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "comparison_start": "2026-09-01",
  "comparison_end": "2026-09-30",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "magazord:orders",
      "component": "number_v1",
      "metrics": [
        "orders_count"
      ],
      "dimensions": [
        "user"
      ]
    }
  ]
}
Ejemplo: "Pedidos" en octubre, comparado con septiembre.

Más ejemplos de llamadas a Magazord

El mismo endpoint para cada tipo de métrica. Los campos metrics y dimensions de cada ítem vienen del catálogo de la plataforma (GET /api/metrics/{integration_slug}).

Tabla

Pedidos por fecha

Tabla con pedidos, situación y valores.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "magazord:orders_table",
      "component": "datatable_v1",
      "metrics": [
        "revenue_value",
        "shipping_value",
        "discount_value",
        "created_at"
      ],
      "dimensions": [
        "order_code",
        "status",
        "payment_method"
      ]
    }
  ]
}

Número

Ingresos

Ingresos totales de los pedidos en el período.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "magazord:revenue",
      "component": "number_v1",
      "metrics": [
        "revenue_value"
      ],
      "dimensions": [
        "user"
      ]
    }
  ]
}

Números

8 métricas

  • Pedidos

    Número total de pedidos en el período.

    magazord:orders
  • Ingresos

    Ingresos totales de los pedidos en el período.

    magazord:revenue
  • Boleto promedio

    Ingresos medios por pedido.

    magazord:average_ticket
  • Envío

    Total de flete cobrado en los pedidos.

    magazord:shipping
  • Descuentos

    Total de descuentos aplicados en los pedidos.

    magazord:discounts
  • Tasa de cancelación

    Porcentaje de pedidos cancelados sobre el total de pedidos en el período.

    magazord:cancellation_rate
  • Flete medio

    Costo medio de flete por pedido en el período.

    magazord:average_shipping
  • Descuento medio

    Descuento medio por pedido en el período.

    magazord:average_discount

Tablas

3 métricas

  • Pedidos por fecha

    Tabla con pedidos, situación y valores.

    magazord:orders_table
  • Pedidos por situación

    Distribución de pedidos por situación en el período.

    magazord:orders_by_status
  • Ventas por origen

    Pedidos, ingresos y ticket medio por canal de origen (Sitio, Marketplace, Manual).

    magazord:origin_breakdown

Mira Connect aplicado a tu producto.

Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.