文档
测试

收银看板-退款列表

POST
139.196.110.143/dev-api/system/return/listShopOrderReturnInfo?pageNum=1&pageSize=12

接口描述

退款接口。针对shop_order_item(订单商品表中)的指定商品进行退款。退款金额不得高于支付金额。不是针对整笔订单退款

请求头

参数名
类型
描述
必填
Authorization
必填

请求参数

application/x-www-form-urlencoded
参数名
类型
描述
必填
orderId
int
订单号
可选
startDate
date
起始日期。(退款记录提交日期)
可选
endDate
date
结束日期。(退款记录提交日期)
可选
buyerMobile
string
买家手机号
必填

响应参数

application/json
参数名
类型
描述
必填
code
int
状态码。200-成功;其他-失败
必填
msg
string
成功或失败提示
必填
data
object
必填
item
object
订单商品数据
必填
orderItemId
Long
订单商品主键ID
必填
orderId
String
订单号
必填
subOrderId
String
子订单号
必填
buyerUserId
Long
买家ID
必填
storeId
Long
门店ID
必填
skuId
Long
商品ID
必填
skuName
String
商品名称
必填
itemUnitPrice
BigDecimal
商品单价(原始单价)
必填
orderItemUnitPrice
BigDecimal
商品实际成交单价
必填
orderItemQuantity
Integer
商品数量
必填
orderItemImage
string
商品图片
必填
orderItemAmount
BigDecimal
商品实际总金额。order_item_unit_price*order_item_quantity
必填
orderItemDiscountAmount
BigDecimal
优惠总金额小计
必填
itemDiscountPrice
BigDecimal
优惠金额(单价)
必填
orderItemPaymentAmount
BigDecimal
商品实际成交金额
必填
unit
string
商品单位(个、份、笼)
必填
orderId
string
订单号
必填
storeId
int
店铺(门店)ID
必填
storeName
string
店铺名称
必填
buyerUserId
int
买家user_id,一期直接传0
必填
buyerMobile
string
买家会员手机号,一期没有,直接传空字符串
必填
orderTimeStamp
long
下单时间,10位时间戳
必填
orderTime
string
下单时间,2024-02-12
必填
orderPaymentAmount
BigDecimal
订单支付金额
必填

说明 / 示例

说明: 退款列表接口 1、首先查询shop_order_return退款记录表。 2、部分数据从订单表获取,需要根据上一步查询到的数据,取出order_id,然后从order_base表或order_info表,或者订单商品表shop_order_item表获取数据。 进行数据重构 入参: { "orderId": "CD20240819230720S1U1", "startDate":"2024-08-22", "endDate":"2024-08-25", "buyerMobile":"" } 出参: { "total": 1, "rows": [ { "returnId":"1", "orderId": "CD20240819230720S1U1", "buyerUserId": 1, "buyerMobile": "15888888888", "orderTime": "2024-08-19T23:07:21.000+08:00", "orderItemId": 374594, "subOrderId": "CD20240819230720S1U1S0", "skuId": 17930, "skuName": "宣恩黑毛土猪鲜肉大包50g", "itemUnitPrice": 2.8, "orderItemUnitPrice": 2.8, "orderItemQuantity": 2, "orderItemReturnNum": 0, "orderItemAmount": 5.6, "returnItemSubtotal":5, //退款总金额 "compensation_amount":0, //赔偿金额,先默认是0 "createTime":"2020-09-01" //退款提交时间 } ], "code": 200, "msg": "查询成功" }