POST/orderAfterSales/addOrderAfterSales管理后台

售后订单-新增

订单·支付·售后 / 售后· OrderAfterSalesController#addOrderAfterSales

基本信息

接口状态脚手架生成·未接入前端置信度中
接口URLPOSThttps://dscp-dev.hn12301.net/manage-api/orderAfterSales/addOrderAfterSales
请求方式POST
Content-Typeapplication/json
暴露渠道管理后台　前缀 /manage-api
名称来源源码注释
调用方本次扫描未发现调用　不等于可以下线
需求上下文orderDto
维护人 / 最后改动wuyou　2023-12-14　最近提交：orderDto
读写数据表order_after_sales　反查该表全部接口 →
控制器com.jxxx.dscp.api.controller.order.OrderAfterSalesController#addOrderAfterSales
源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/order/OrderAfterSalesController.java:75
判定依据控制器由代码生成器产出（@author Chaos-Toolkits），整套 CRUD 接口但前端无调用

请求参数

Header 请求参数

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

Query 请求参数

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

路径参数及说明

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

Body 请求参数

Body 类型 OrderAfterSalesAddRequest

参数名	参数值	是否必填	参数类型	描述说明
orderId	…	是	Long	订单号，order表id → order_after_sales.order_id
memberId	…	是	Long	会员Id，member_user表id → order_after_sales.member_id
refundAmount	…	是	Integer	退款金额 → order_after_sales.refund_amount
realRefundAmount	…	是	Integer	实际退款金额 → order_after_sales.real_refund_amount
refundCount	…	是	Integer	退货数量 → order_after_sales.refund_count
expressStatus	…	否	ExpressStatus	货物物流状态，1已发货 0未发货 → order_after_sales.express_status 0＝未发货 1＝已发货
refundContent	…	否	String	退款说明 → order_after_sales.refund_content
status	…	否	AfterSalesStatus	售后单状态，1=申请中；2=已同意；3=已拒绝 → order_after_sales.status 1＝申请中 2＝已同意 3＝已拒绝
refundStatus	…	否	RefundStatus	退款状态，0=待退款；1=退款中；2=退款成功；3=退款失败 → order_after_sales.refund_status 0＝待退款 1＝退款中 2＝退款成功 3＝退款失败
remark	…	否	String	备注 → order_after_sales.remark

认证方式

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

响应参数

data 类型 OrderAfterSalesResponse

参数名	参数值	是否必填	参数类型	描述说明
id	…	否	Long	→ order_after_sales.id
orderId	…	否	Long	订单号，order表id → order_after_sales.order_id
memberId	…	否	Long	会员Id，member_user表id → order_after_sales.member_id
refundAmount	…	否	Integer	退款金额 → order_after_sales.refund_amount
realRefundAmount	…	否	Integer	实际退款金额 → order_after_sales.real_refund_amount
refundCount	…	否	Integer	退货数量 → order_after_sales.refund_count
expressStatus	…	否	ExpressStatus	货物物流状态，1已发货 0未发货 → order_after_sales.express_status 0＝未发货 1＝已发货
refundContent	…	否	String	退款说明 → order_after_sales.refund_content
status	…	否	AfterSalesStatus	售后单状态，1=申请中；2=已同意；3=已拒绝 → order_after_sales.status 1＝申请中 2＝已同意 3＝已拒绝
refundStatus	…	否	RefundStatus	退款状态，0=待退款；1=退款中；2=退款成功；3=退款失败 → order_after_sales.refund_status 0＝待退款 1＝退款中 2＝退款成功 3＝退款失败
remark	…	否	String	备注 → order_after_sales.remark
createdTime	…	否	Date	申请时间 → order_after_sales.created_time

响应示例

成功响应示例 code=0

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": "1",
    "orderId": "1",
    "memberId": "1",
    "refundAmount": "1",
    "realRefundAmount": "1",
    "refundCount": "1",
    "expressStatus": "0",
    "refundContent": "\"string\"",
    "status": "1",
    "refundStatus": "0",
    "remark": "\"string\"",
    "createdTime": "\"2026-01-01 00:00:00\""
  }
}

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

附录 · 实现细节

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

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

OrderAfterSalesController#addOrderAfterSales
BeanUtils.map → OrderAfterSales ⇒ 表 order_after_sales

逻辑摘要：新增（orderAfterSalesService.add）；入参与返回值经 BeanUtils 做对象/分页映射

操作日志：order / 新增订单售后