POST/order/queryOrderList管理后台

订单表主表-列表查询

订单·支付·售后 / 订单（主表）· OrderController#queryOrderList

基本信息

  • 接口状态前端在用 置信度 高
  • 接口URLPOSThttps://dscp-dev.hn12301.net/manage-api/order/queryOrderList
  • 请求方式POST
  • Content-Typeapplication/json
  • 暴露渠道管理后台　前缀 /manage-api
  • 名称来源源码注释
  • 调用方已确认在用 · 管理后台（1 个前端）
  • 需求上下文orderDto
  • 维护人 / 最后改动wuyou　2023-12-14　最近提交：orderDto
  • 读写数据表order　反查该表全部接口 →
  • 控制器com.jxxx.dscp.api.controller.order.OrderController#queryOrderList
  • 源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/order/OrderController.java:120
  • 判定依据1 个调用点：dscp-html-manage/src/api/order/index.ts

请求参数

Header 请求参数

参数名参数值是否必填参数类型描述说明
无（渠道统一鉴权头见《认证方式》）

Query 请求参数

参数名参数值是否必填参数类型描述说明
无

路径参数及说明

参数名参数值是否必填参数类型描述说明
无

Body 请求参数

Body 类型 OrderListRequest
参数名参数值是否必填参数类型描述说明
orderId…否Long订单Id，主键 → order.order_id
merchantId…否Long商户Id，merchant表Id → order.merchant_id
shopId…否Long商铺Id，shop表Id → order.shop_id
memberId…否Long会员用户Id → order.member_id
orderType…否OrderType订单类型，1旅游年卡，2美食特产，3生活好物，4自驾路线，5非遗专区，6景区套票，7酒店民宿，8餐饮美食 → order.order_type 1＝景区套票 2＝酒店民宿 3＝餐饮美食 4＝美食特产 5＝自驾路线 6＝非遗专区 7＝旅游卡 8＝旅游卡
orderSource…否OrderSource订单来源，1H5，2微信小程序，3支付宝小程序，4安卓APP，5IOSAPP → order.order_source 1＝H5 2＝微信小程序 3＝支付宝小程序 4＝安卓APP 5＝IOSAPP 6＝YOUZHENG 7＝XIANGGONGHUI 8＝XIANGYUEMA 9＝ZHIHUIYOU 10＝BCM 11＝JIANHANG 24＝MEIKE
buyNum…否Integer购买份数 → order.buy_num
orderAmount…否Integer订单金额(订单原始金额) → order.order_amount
receivableAmount…否Integer应收金额 → order.receivable_amount
payableAmount…否Integer实收金额 → order.payable_amount
reducedPrice…否Integer优惠金额 → order.reduced_price
expressAmount…否Integer运费金额 → order.express_amount
discountAmount…否Integer折扣金额 → order.discount_amount
isDelivery…否Integer是否配送(0=否；1=是) → order.is_delivery
payStatus…否PayStatus支付状态，1=待支付 2=已支付 3=已退款 → order.pay_status 1＝待支付 2＝已支付 3＝已退款 4＝退款失败 5＝退款中 6＝退款申请
orderStatus…否OrderStatus订单状态，1=待确认 2=已确认 3=待发货 4=已发货 5=已完成 6=已取消 → order.order_status 1＝待支付 2＝待发货 3＝已发货 4＝已完成 5＝已取消 6＝退款中 7＝已退款
orderPhone…否String下单人手机 → order.order_phone
orderTime…否Date下单时间 → order.order_time
orderExpressTime…否Date订单失效时间 → order.order_express_time
isSendIntegral…否Integer订单积分是否已发放(0=否 1=是) → order.is_send_integral
isComment…否Integer订单是否已经评价(0=否；1=是) → order.is_comment
isProfitSharing…否Integer订单资金是否已冻结(0=已冻结 1=已解冻) → order.is_profit_sharing
isSendCommission…否SendCommission订单佣金是否已发放，0=否 1=是 2=无佣金 → order.is_send_commission 0＝否 1＝是 2＝无佣金
shouldReturnCommission…否Integer应返佣金 → order.should_return_commission
reallyReturnCommission…否Integer实返佣金 → order.really_return_commission
idList…否List<Long>id列表
keywords…否String关键字

认证方式

需登录态：Authorization: Bearer <token>（多租户另带 tenant-id）；30002 会话失效需重登。详见全局公共参数。

响应参数

data 类型 List<OrderResponse>
参数名参数值是否必填参数类型描述说明
id…否LongID，主键 → order.id
orderId…否Long订单Id，主键 → order.order_id
merchantId…否Long商户Id，merchant表Id → order.merchant_id
merchantName…否String商户名称
shopId…否Long商铺Id，shop表Id → order.shop_id
shopName…否String商铺名称
memberId…否Long会员用户Id → order.member_id
memberPhone…否String会员用户手机号
orderType…否OrderType订单类型，1旅游年卡，2美食特产，3生活好物，4自驾路线，5非遗专区，6景区套票，7酒店民宿，8餐饮美食 → order.order_type 1＝景区套票 2＝酒店民宿 3＝餐饮美食 4＝美食特产 5＝自驾路线 6＝非遗专区 7＝旅游卡 8＝旅游卡
orderSource…否OrderSource订单来源，1H5，2微信小程序，3支付宝小程序，4安卓APP，5IOSAPP → order.order_source 1＝H5 2＝微信小程序 3＝支付宝小程序 4＝安卓APP 5＝IOSAPP 6＝YOUZHENG 7＝XIANGGONGHUI 8＝XIANGYUEMA 9＝ZHIHUIYOU 10＝BCM 11＝JIANHANG 24＝MEIKE
buyNum…否Integer购买份数 → order.buy_num
orderAmount…否Integer订单金额(订单原始金额) → order.order_amount
receivableAmount…否Integer应收金额 → order.receivable_amount
payableAmount…否Integer实收金额 → order.payable_amount
reducedPrice…否Integer优惠金额 → order.reduced_price
expressAmount…否Integer运费金额 → order.express_amount
discountAmount…否Integer折扣金额 → order.discount_amount
isDelivery…否Integer是否配送(0=否；1=是) → order.is_delivery
payStatus…否PayStatus支付状态，1=待支付 2=已支付 3=已退款 → order.pay_status 1＝待支付 2＝已支付 3＝已退款 4＝退款失败 5＝退款中 6＝退款申请
orderStatus…否OrderStatus订单状态，1=待确认 2=已确认 3=待发货 4=已发货 5=已完成 6=已取消 → order.order_status 1＝待支付 2＝待发货 3＝已发货 4＝已完成 5＝已取消 6＝退款中 7＝已退款
orderPhone…否String下单人手机 → order.order_phone
orderRemark…否String订单备注 → order.order_remark
orderTime…否Date下单时间 → order.order_time
orderExpressTime…否Date订单失效时间 → order.order_express_time
isSendIntegral…否Integer订单积分是否已发放(0=否 1=是) → order.is_send_integral
isComment…否Integer订单是否已经评价(0=否；1=是) → order.is_comment
isProfitSharing…否Integer订单资金是否已冻结(0=已冻结 1=已解冻) → order.is_profit_sharing
isSendCommission…否SendCommission订单佣金是否已发放，0=否 1=是 2=无佣金 → order.is_send_commission 0＝否 1＝是 2＝无佣金
icode…否String分销邀请码 → order.icode
shouldReturnCommission…否Integer应返佣金 → order.should_return_commission
reallyReturnCommission…否Integer实返佣金 → order.really_return_commission
goodsName…否String商品名称
goodsSkuName…否String商品Sku名称
refundAmount…否Integer退款金额
channelMerchantName…否String销售商户名称
channelShopName…否String销售商铺名称
transactionNo…否String支付中心otg的交易流水
refundTime…否Date退款时间

响应示例

成功响应示例 code=0

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": "1",
    "orderId": "1",
    "merchantId": "1",
    "merchantName": "\"string\"",
    "shopId": "1",
    "shopName": "\"string\"",
    "memberId": "1",
    "memberPhone": "\"string\"",
    "orderType": "1",
    "orderSource": "1",
    "buyNum": "1",
    "orderAmount": "1"
  }
}
示例来自源码/导出内容，仅结构参考，非线上真实数据。

附录 · 实现细节

调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要
涉及数据表：order　反查全部引用接口 →
  • OrderController#queryOrderList
  • OrderService#queryList（OrderServiceImpl）
  • OrderMapper#queryList
  • BeanUtils.map → OrderQuery
  • BeanUtils.mapList → OrderResponse
逻辑摘要：列表查询（orderService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射
旧站环境备注：pro：（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）
调用点证据
  • dscp-html-manage/src/api/order/index.ts:4　管理后台 · request
← 卡订单列表订单表主表-分页查询 →
由 tools/build.py 从 data/apis.json 生成 · 生成时间 2026-09-12 19:49 · 数据口径见说明 · 本页数字非手写，均来自同一份数据