API文档

sales_refund_push.php（创建原始退款单）

¥标准

1.接口说明

1.1 接口描述：销售订单（包括发货前和发货后）退款或退货单据推送至ERP。注：销售订单的售后换货订单此接口推送“退货类型”退款单，换出订单“trade_push.php”推送

1.2 适用版本：客户端 V2.4.5.0及以上版本

1.3 调用建议：批量推送的退款单据，每次不超过10单

1.4 注意事项：推送的原始退款单对应的销售订单必须在旺店通ERP内已经存在，否则无法生成系统售后单并进行处理。注：仅支持自有/其他平台店铺

2.调用场景

2.1 自研商城、分销系统、全渠道等系统对接

3.请求参数说明

3.1 请求地址

环境	HTTP地址
测试环境	https://openapitest.huice.com/openapi/sales_refund_push.php
正式环境	https://openapi.huice.com/openapi/sales_refund_push.php

3.2 公共请求参数

名称	字段	类型	必须	描述
卖家账号	sid	String	是	购买ERP时由旺店通分配给ERP购买方，请从ERP购买方获取。
接口账号	appkey	String	是	本开放平台“自助对接”功能模块内自助申请，获取方式点击这里
时间戳	timestamp	int	是	北京时间1970-01-01 08:00:00起至现在的总秒数，10位int值,旺店通企业版API服务端允许请求最大时间误差为5min，date.timezone = Asia/Shanghai。
签名	sign	String	是	API输入参数签名结果，签名算法介绍单击这里

3.3 业务请求参数

名称	字段	类型	长度	必须	描述
退款单节点	api_refund_list	data[ ]		是	请求参数的1级数据节点，包含平台售后订单所有属性信息的数据节点，节点下数据字段详见下述“api_refund_list”

api_refund_list

名称	字段	类型	长度	必须	描述
平台ID	platform_id	smallint	6	是	输入固定值127
店铺编号	shop_id	int		是	代表店铺所有属性的唯一编码，用于店铺区分用于推送指定店铺原始退款单据信息
平台销售订单号	tid	varchar		是	平台订单单号（与推送trade_push的tid保持一致对应旺店通ERP内原始单号）
平台退款/退货单号	refund_no	varchar	40	是	平台退款/退货单单号，保证唯一
平台售后类型	type	int		是	type=1：退款(未发货退款)；type=2：退货退款 type=3：换货 type=4 退款不退货 type=5 拒收退货 type=6 补发退款
平台售后状态	status	varchar		是	可选值：1 已取消 2 申请退款，3 等待退货（卖家同意后） 4 等待收货（买家发货后）5 退款成功 7 拒绝买家退货待买家修改 8 卖家发出换货商品待买家签收
退款金额	refund_fee	decimal	19,4	否	退款金额
买家昵称	buyer_nick	varchar	100	是	买家昵称（不传该字段，默认取原始订单上客户网名）
单据创建时间	refund_time	datetime		是	单据创建时间,时间格式：yyyy-MM-dd HH:mm:ss
退款原因	reason	varchar	255	否	退款原因
备注	desc	varchar	255	否	备注
物流单号	logistics_no	varchar	40	否	物流单号（如需维护退货物流单号，与logistics_name物流公司名称同时使用）
物流公司名称	logistics_name	varchar	40	否	物流公司名称
售后子订单	order_list	data[]		是	售后子订单

order_list

名称

字段

类型

长度

必须

描述

平台订单子订单编号

oid

varchar

是

平台订单子订单编号（与推送trade_push的oid保持一致

，对应旺店通ERP内原始子订单编号）可推送部分子订单

退货货品数量

num

decimal

(19,4)

是

退货货品数量（如果是type=1 退款

2 退款不退货类型，此处代表退款数量）

4.响应参数

4.1 公共响应参数