1. 利润统计

接口地址： /merchantapi/user/analysis/profit

请求方式： POST

请求参数：

参数名	类型	必填	说明
day	int	否	查询天数（默认使用商户时效性配置）

响应示例：

{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "data": [
      {
        "date": "2025-11-19", // 日期
        "self_goods_by_self_profit": 225, // 自营自售出的收益
        "self_goods_by_agent_profit": 54, // 代理帮售的收益
        "agent_goods_profit": 0, // 分销收益（自己代理别人商品的收益）
        "self_day_profit": 279, // 当天总收益（不含推广）
        "promote_profit": 0, // 推广收益
        "total_profit": 279 // 当天总收益（含推广）
      },
      {
        "date": "2025-11-20",
        "self_goods_by_self_profit": 0,
        "self_goods_by_agent_profit": 0,
        "agent_goods_profit": 0,
        "self_day_profit": 0,
        "promote_profit": 0,
        "total_profit": 0
      },
      {
        "date": "2025-11-21",
        "self_goods_by_self_profit": 0,
        "self_goods_by_agent_profit": 18,
        "agent_goods_profit": 0,
        "self_day_profit": 18,
        "promote_profit": 0,
        "total_profit": 18
      },
      {
        "date": "2025-11-22",
        "self_goods_by_self_profit": 0,
        "self_goods_by_agent_profit": 18,
        "agent_goods_profit": 0,
        "self_day_profit": 18,
        "promote_profit": 0,
        "total_profit": 18
      }
    ]
  }
}

---

2. 商品统计

更新于 2026-08-01：明确两类排行榜的数值字段不同。self_goods 使用订单数量字段 total_volume，proxy_goods 使用收益金额字段 total_profit。分销收益榜会先按商品汇总指定日期范围内的完整收益，再按收益倒序返回 TOP 5。

接口地址： /merchantapi/user/analysis/goods

请求方式： POST

请求参数：

参数名	类型	必填	说明
day	int	否	查询天数

响应示例：

{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "self_goods": [
      // 店铺商品销量排行榜
      {
        "goods_id": 1,
        "goods_name": "1000的商品1",
        "total_volume": 6, // 有效订单数量
        "is_proxy": 0 // 是否为代理商品
      }
    ],
    "proxy_goods": [
      // 分销商品收益排行榜（别人代理我的，我的收益商品的排行）
      {
        "goods_id": 1,
        "goods_name": "1000的商品1", // 我的商品名
        "total_profit": 90, // 我的收益 元
        "is_proxy": 1
      }
    ]
  }
}

字段说明：

• self_goods[].total_volume：店铺商品在日期范围内的有效订单数量，单位为单。
• proxy_goods[].total_profit：别人代理当前商户商品所产生的累计收益，单位为元。
• 两组数据均由后端完成倒序排列并最多返回 5 条，前端不应混用两个数值字段。

---

3. 销售走势

接口地址： /merchantapi/user/analysis/salesTrend

请求方式： POST

请求参数：

参数名	类型	必填	说明
day	int	否	查询天数

响应示例：

{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "data": [
      {
        "date": "2025-11-22", // 日期
        "total_order_count": 1, // 总订单数
        "success_order_count": 1, // 成功订单数（不含平台介入中的订单）
        "unpaid_order_count": 0, // 未支付订单数
        "closed_order_count": 0, // 已关闭订单数
        "refund_order_count": 0 // 退款订单数
      },
      {
        "date": "2025-11-23",
        "total_order_count": 0,
        "success_order_count": 0,
        "unpaid_order_count": 0,
        "closed_order_count": 0,
        "refund_order_count": 0
      }
    ]
  }
}

统计口径：

• success_order_count 只统计已支付且当前不处于“平台介入中”的订单
• 平台判定商户胜诉后，订单仍为已支付状态时会重新计入成功订单；已退款订单不计入