文档
测试

return/detail(退货商品)

POST
\order\return\detail

接口描述

退货商品接口

请求参数

参数名
类型
描述
必填
token
string
身份认证
必填
operate
string
退款操作类型,参见接口说明
必填
code
string
退货输入凭证,参见接口说明
必填
qty
decimal
本次退货数量,参见接口说明
必填
price
decimal
本次退货价格,参见接口说明
必填
reason
string
本次退货原因,可为空,退货原因valu,参见接口说明
必填

响应参数

参数名
类型
描述
必填
code
string
状态码(0:成功/其它:错误
必填
message
string
错误信息(仅在发生错误时有意义)
必填
data
json
退货明细信息
必填
order_detail_info
json
退货商品信息 operate = 100 时有效
必填
order_id
string
订单号
必填
return_status
int
0/未退货 1/部分退货 2/退货完成
必填
return_total_amt
decimal
本次合计退款
必填
first_match_index
string
第一个匹配的商品索引,从0开始,未匹配到返回空
必填
first_match_line_id
string
商品列表搜索商品匹配到某个商品,返回商品行号用来跳转行情
必填
total_amt
string
整单退货金额
必填
details
set
商品明细列表
必填
order_id
string
订单号
必填
row
string
行号(用于展示)
必填
line_id
int
行号(用于业务逻辑)
必填
name
string
商品名称
必填
org_qty
decimal
可退数量(为0代表已退单)
必填
org_price
decimal
原单售价
必填
org_amt
decimal
可退金额
必填
qty
decimal
本次退货数量, 已选择数量大于0代表已选择,默认为0
必填
price
decimal
本次退货价格
必填
amt
decimal
本次退货金额
必填
reason
string
本次退货原因
必填
is_match
bool
是否和商品搜索条件匹配
必填
unit
stirng
商品单位
必填
org_spec_price
decimal
原单原价
必填
curr_details
set
已选择的商品列表
必填
item_id
string
商品id
必填
code
string
商品条码
必填
name
string
商品名称
必填
unit
string
商品单位
必填
spec
string
商品规格
必填
qty
decimal
本次退货数量
必填
price
decimal
本次退货价格
必填
amt
decimal
本次退货金额
必填
reason
string
本次退货原因,返回值为退货原因id
必填
org_price
decimal
原单可退价格
必填
order_curr_detail
json
当前编辑的退货信息operate = 200 时有效
必填
item_id
string
商品id
必填
code
string
商品条码
必填
name
string
商品名称
必填
unit
string
商品单位
必填
spec
string
商品规格
必填
org_qty
decimal
可退数量(为0代表已退单)
必填
org_price
decimal
销售价格
必填
org_amt
decimal
可退金额
必填
qty
decimal
本次退货数量
必填
price
decimal
本次退货价格
必填
amt
decimal
本次退货金额
必填
reason
string
本次退货原因,返回值为退货原因id
必填
qty_flag
string
是否允许小数退货 0/不允许 1/允许
必填
reasons
set
退货原因选择列表,operate = 400时有效
必填
name
string
退货原因显示值,e.g. 过期商品/食物变质
必填
id
string
退货原因实际值,e.g. 0/1/2
必填
is_disabled
bool
是否禁用
必填
is_default
bool
是否默认
必填

说明 / 示例

> `operate = 100 按小票退货模式下,在退货商品界面搜索商品` `code: 搜索商品的信息,为空代表刷新界面` `qty : 无效 ` `price: 无效 ` `reason: 无效 ` `此接口不会做数据筛选,只会根据匹配规则对数据进行重新排序和匹配,无匹配数据时,会返回错误信息` > `operate = 200 按小票退货模式下,选择商品进行退货` `code: 商品行号` `qty : 无效 ` `price: 无效 ` `reason: 无效 ` > `operate = 300 按小票退货模式下,确认商品退货信息` `code: 无效` `qty : 退货数量 ` `amount: 退货金额 ` `reason: 退货原因 ` > `operate = 400 按小票退货模式下,获取退货原因` `code: 无效` > `operate = 500 按小票退货模式下,取消退货,点击关闭时触发,进入商品主界面` `code: 无效` > `operate = 600 按小票退货模式下,删除已选择的商品` `code: 已选择的商品行号` > `operate = 700 按小票退货模式下,选择整单退货,整单退货后需要进入退款界面,调用开始退款`