4.6 分页查询订单列表

接口URL

{开放平台域名地址}/openApi/open/order/mallOrder/pageList

注： 员工账号和查询时间不可同时为空，按时间搜索的话时间搜索类型必填，时间跨度不能超过1天（可以是1天也就是24h），开始时间是>，结束时间是<=，如果输入用户则不限制时间跨度

HTTP请求方式

POST

公共参数

字段	类型	是否必填	中文意描述
access_token	String	是	授权访问凭证
timestamp	String	是	毫秒级时间戳 防止重复攻击
sign	String	是	签名
version	String	否	业务接口版本号，如1.0.0

body参数

字段	类型	是否必填	中文意描述
account	String	否	员工账号，如果输入账号则必须存在，否则返回失败
timeType	String	否	时间搜索类型：1根据创建时间查询；2根据更新时间查询
timeStart	String	否	开始时间，格式为yyyy-MM-dd HH:mm:ss
timeEnd	String	否	结束时间，格式为yyyy-MM-dd HH:mm:ss
currentPage	Integer	否	页码，默认1
itemsPerPage	Integer	否	页数，默认10，最大20

请求示例

POST /openApi/open/order/mallOrder/pageList?access_token=abc&timestamp=1597300776947&sign=fa66cb4d8604413b8fb30afd32e3e73e HTTP/1.1
Content-Type: application/json
Cache-Control: no-cache
{
     "currentPage": 1,
     "itemsPerPage": 10,
     "timeEnd": "2024-11-06 00:00:00",
     "timeStart": "2024-11-05 00:00:00",
     "timeType": 2
   }

返回参数说明

字段	类型	中文意描述
code	String	返回码
data	ResponseData	相应报文
msg	String	如果错误，返回错误信息

ResponseData：

字段	类型	中文意描述
orderNo	String	订单号
account	String	员工账号
orderStatus	String	订单状态：1、待支付；2、待收货；3、待使用；4、已完成；5、已取消；6、已支付
createTime	Integer	创建时间，格式为yyyy-MM-dd HH:mm:ss
updateTime	String	更新时间，格式为yyyy-MM-dd HH:mm:ss
totalAmount	BigDecimal	订单总金额（单位：元）
goodsList	List<MallOrderGoodsResponse>	商品列表

MallOrderGoodsResponse：

字段	类型	中文意描述
goodsId	String	商品ID
goodsName	String	商品名称
num	Integer	购买数量
channel	String	所属频道
imageUrl	String	商品图片

返回示例

success:

{
  "code": "0",
  "data": {
    "listObj": [
      {
        "orderNo": "21241105160600060589",
        "account": "lisi",
        "orderStatus": 5,
        "updateTime": "2024-11-05 16:06:02",
        "totalAmount": 5.00,
        "goodsList": [
          {
            "goodsId": "2440671",
            "goodsName": "测试商品_9999",
            "num": 1,
            "channel": "东福超市",
            "imageUrl": "https://oss-scm-goods-prd.dongfangfuli.com/merchantSpu/picture/12ec11e8bc8c4517a26f18805fdc9275.jpg"
          }
        ],
        "createTime": "2024-11-05 16:06:02"
      }
    ],
    "total": 3,
    "currentPage": 1,
    "itemsPerPage": 10
  },
  "msg": "success",
  "errMsg": null
}

fail:

{
  "code": "10016",
  "data": null,
  "msg": "签名错误"
}