简要描述:

详情页接口新增参数说明

接口route=plugin.shop-assistant.frontend.index.index新增参数store_income_show

响应参数说明

参数名 类型 说明
store_income_show int 是否开启门店销售额排名 1开启,0关闭

店铺排行数据请求URL:

接口route=plugin.shop-assistant.frontend.index.get-store-rank

请求参数说明:

参数名 类型 是否必需 说明
rank_type int 1门店,2 收银台
time_type_name string 1门店,2 收银台
time int 返回开始的零点时间时间戳,如果选择日则返回当天零点时间,周就返回周一的零点时间,月就返回1号的零点时间

返回示例:

正确时返回:

{
    "result": 1,
    "msg": "ok",
    "data": {
        "current_page": "1",
        "data": [
            {
                "id": 12,
                "name": "as小店",
                "turnover": "600.00",
                "complete_turnover": "600.00",
                "withdraw": "0.00",
                "un_withdraw": "0.00",
                "withdrawing": "0.00"
            },
            {
                "id": 1,
                "name": "dfsaf",
                "turnover": 0,
                "complete_turnover": 0,
                "withdraw": "0.00",
                "un_withdraw": "0.00",
                "withdrawing": "0.00"
            },
            {
                "id": 2,
                "name": "门店二",
                "turnover": 0,
                "complete_turnover": 0,
                "withdraw": "0.00",
                "un_withdraw": "0.00",
                "withdrawing": "0.00"
            },
            {
                "id": 3,
                "name": "d12313123123",
                "turnover": 0,
                "complete_turnover": 0,
                "withdraw": "0.00",
                "un_withdraw": "0.00",
                "withdrawing": "0.00"
            },
            {
                "id": 4,
                "name": "12222222222111",
                "turnover": 0,
                "complete_turnover": 0,
                "withdraw": "0.00",
                "un_withdraw": "0.00",
                "withdrawing": "0.00"
            },
            {
                "id": 5,
                "name": "asdasd123",
                "turnover": 0,
                "complete_turnover": 0,
                "withdraw": "0.00",
                "un_withdraw": "0.00",
                "withdrawing": "0.00"
            },
            {
                "id": 6,
                "name": "门店6",
                "turnover": 0,
                "complete_turnover": 0,
                "withdraw": "0.00",
                "un_withdraw": "0.00",
                "withdrawing": "0.00"
            },
            {
                "id": 10,
                "name": "门店7777",
                "turnover": 0,
                "complete_turnover": 0,
                "withdraw": "0.00",
                "un_withdraw": "0.00",
                "withdrawing": "0.00"
            },
            {
                "id": 11,
                "name": "123123",
                "turnover": 0,
                "complete_turnover": 0,
                "withdraw": "0.00",
                "un_withdraw": "0.00",
                "withdrawing": "0.00"
            }
        ],
        "from": 1,
        "last_page": 1,
        "per_page": 15,
        "total": 9
    }
}

响应参数说明

参数名 类型 说明
result int 接口状态码,1 表示成功
msg string 接口消息,成功时返回 "ok"
data object 核心业务数据
data.current_page string 当前页码
data.data array 门店数据列表
data.from int 数据起始位置(分页偏移量)
data.last_page int 总页数
data.per_page int 每页显示数量
data.total int 总数据量

门店对象字段说明(data.data[])

参数名 类型 说明
id int 门店唯一标识
name string 门店名称
turnover string 累计营业额)
complete_turnover string 累计交易完成营业额
withdraw string 累计已提现收入
un_withdraw string 累计未提现收入
withdrawing float 累计提现中收入

类型说明

  • 金额字段:建议统一使用字符串类型保留两位小数(如 "0.00"),避免浮点数精度问题
  • 分页参数:建议将 current_page 字段类型改为 int 保持类型一致性

错误时返回:

{
    "result": 0,
    "msg": "请登录",
    "data": []
}