POST/orderDelivery/queryOrderDeliveryList管理后台

订单配送表-列表查询

订单·支付·售后 / 发货· OrderDeliveryController#queryOrderDeliveryList

基本信息

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

请求参数

Header 请求参数

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

Query 请求参数

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

路径参数及说明

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

Body 请求参数

Body 类型 OrderDeliveryListRequest

参数名	参数值	是否必填	参数类型	描述说明
orderId	…	否	Long	订单号，order表id → order_delivery.order_id
deliveryType	…	否	DeliveryType	配送方式(DeliveryType)，1=快递 2=自取 → order_delivery.delivery_type 1＝快递 2＝自取
deliverTime	…	否	Date	发货时间 → order_delivery.deliver_time
receiveTime	…	否	Date	收货时间 → order_delivery.receive_time
status	…	否	DeliveryStatus	状态(DeliveryStatus)，1=待发货 2=已发货 3=已收货 → order_delivery.status 1＝待发货 2＝已发货 2＝已收货
idList	…	否	List<Long>	id列表
keywords	…	否	String	关键字

认证方式

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

响应参数

data 类型 List<OrderDeliveryResponse>

参数名	参数值	是否必填	参数类型	描述说明
id	…	否	Long	→ order_delivery.id
orderId	…	否	Long	订单号，order表id → order_delivery.order_id
deliveryType	…	否	DeliveryType	配送方式(DeliveryType)，1=快递 2=自取 → order_delivery.delivery_type 1＝快递 2＝自取
receiveName	…	否	String	姓名 → order_delivery.receive_name
receivePhone	…	否	String	电话 → order_delivery.receive_phone
receiveProvince	…	否	Long	省份 → order_delivery.receive_province
receiveProvinceName	…	否	String	省份
receiveCity	…	否	Long	城市 → order_delivery.receive_city
receiveCityName	…	否	String	城市
receiveCounty	…	否	Long	区县 → order_delivery.receive_county
receiveCountyName	…	否	String	区县
receiveAddress	…	否	String	详细地址 → order_delivery.receive_address
deliverUser	…	否	String	发货人 → order_delivery.deliver_user
deliverTime	…	否	Date	发货时间 → order_delivery.deliver_time
expressCompany	…	否	String	发货快递公司 → order_delivery.express_company
expressNumber	…	否	String	发货快递单号 → order_delivery.express_number
receiveTime	…	否	Date	收货时间 → order_delivery.receive_time
receiveUesr	…	否	String	收货人 → order_delivery.receive_uesr
status	…	否	DeliveryStatus	状态(DeliveryStatus)，1=待发货 2=已发货 3=已收货 → order_delivery.status 1＝待发货 2＝已发货 2＝已收货
remark	…	否	String	备注 → order_delivery.remark

响应示例

成功响应示例 code=0

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": "1",
    "orderId": "1",
    "deliveryType": "1",
    "receiveName": "\"string\"",
    "receivePhone": "\"string\"",
    "receiveProvince": "1",
    "receiveProvinceName": "\"string\"",
    "receiveCity": "1",
    "receiveCityName": "\"string\"",
    "receiveCounty": "1",
    "receiveCountyName": "\"string\"",
    "receiveAddress": "\"string\""
  }
}

示例来自源码/导出内容，仅结构参考，非线上真实数据。

附录 · 实现细节

调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要

涉及数据表：order_delivery　反查全部引用接口 →

OrderDeliveryController#queryOrderDeliveryList
OrderDeliveryService#queryList（OrderDeliveryServiceImpl）
OrderDeliveryMapper#queryList
BeanUtils.map → OrderDeliveryQuery
BeanUtils.mapList → OrderDeliveryResponse

逻辑摘要：列表查询（orderDeliveryService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

旧站环境备注：pro：（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

调用点证据

dscp-html-manage/src/api/order/orderDelivery/index.ts:4　管理后台 · request