物流流转信息查询 | 大麦家礼品代发API

# 物流流转信息查询

接口地址： http://www.damaijia168.com/vv/external/egetreceive

请求方式： POST

传参方式： JSON

返回格式： JSON

# 请求头参数

参数	类型	必选	值	示例
Authorization	string	是	授权 access_token	1798c6aadec33d1bc2f5b707f1049aefexxxx

# 请求参数

参数	类型	必选	描述
shop_id	Number	是	店铺id
fields	String[]	是	需要返回的字段。目前支持有：refund_id, tid, title, buyer_nick, seller_nick, total_fee, status, created, refund_fee, oid, good_status, company_name, sid, payment, reason, desc, has_good_return, modified, order_status,refund_phase
status	String	否	退款状态，默认查询所有退款状态的数据，除了默认值外每次只能查询一种状态。WAIT_SELLER_AGREE(买家已经申请退款，等待卖家同意)WAIT_BUYER_RETURN_GOODS(卖家已经同意退款，等待买家退货)WAIT_SELLER_CONFIRM_GOODS(买家已经退货，等待卖家确认收货)SELLER_REFUSE_BUYER(卖家拒绝退款) CLOSED(退款关闭) SUCCESS(退款成功)
buyer_nick	String	否	买家昵称
type	String	否	交易类型列表，一次查询多种类型可用半角逗号分隔，默认同时查询guarantee_trade, auto_delivery这两种类型的数据，查看可选值
start_modified	Date	否	查询修改时间开始。格式: yyyy-MM-dd HH:mm:ss
end_modified	Date	否	查询修改时间结束。格式: yyyy-MM-dd HH:mm:ss
page_no	Number	否	页码。取值范围:大于零的整数; 默认值:1
page_size	Number	否	每页条数。取值范围:大于零的整数; 默认值:40;最大值:100
use_has_next	Boolean	否	是否启用has_next的分页方式，如果指定true,则返回的结果中不包含总记录数，但是会新增一个是否存在下一页的的字段，通过此种方式获取增量退款，接口调用成功率在原有的基础上有所提升。
ouid	String	否	系统自动生成
edition	string	否	版本默认:1(不传默认为1) 1:1.0,2:2.0

# 请求示例

# 请求代码示例

cURL请求代码示例

PHP请求代码示例

JAVA请求代码示例

Pyton请求代码示例

# 响应参数

名称	类型	示例值	描述
data	object	返回数据
total_results	Number	100	搜索到的退款信息总数
has_next	Boolean	true	是否存在下一页
refunds	Refund []		搜索到的退款信息列表
--refund_id	String	83477	退款单号
--tid	Number	2231884277	淘宝交易单号
--oid	Number	2231884277	子订单号。如果是单笔交易oid会等于tid
--total_fee	String	10.00	交易总金额。精确到2位小数;单位:元。如:200.07，表示:200元7分
--buyer_nick	String	tbtest561	买家昵称
--seller_nick	String	tbtest869	卖家昵称
--created	Date	2000-01-01 00:00:00	退款申请时间。格式:yyyy-MM-dd HH:mm:ss
--modified	Date	2000-01-01 00:00:00	更新时间。格式:yyyy-MM-dd HH:mm:ss
--order_status	String	BUYER_RECEIVED	退款对应的订单交易状态。可选值TRADE_NO_CREATE_PAY(没有创建支付宝交易) WAIT_BUYER_PAY(等待买家付款) WAIT_SELLER_SEND_GOODS(等待卖家发货,即:买家已付款) WAIT_BUYER_CONFIRM_GOODS(等待买家确认收货,即:卖家已发货) TRADE_BUYER_SIGNED(买家已签收,货到付款专用) TRADE_FINISHED(交易成功) TRADE_CLOSED(交易关闭) TRADE_CLOSED_BY_TAOBAO(交易被淘宝关闭) ALL_WAIT_PAY(包含：WAIT_BUYER_PAY、TRADE_NO_CREATE_PAY) ALL_CLOSED(包含：TRADE_CLOSED、TRADE_CLOSED_BY_TAOBAO) 取自"http://open.taobao.com/dev/index.php/%E4%BA%A4%E6%98%93%E7%8A%B6%E6%80%81"
--status	String	SUCCESS	退款状态。可选值WAIT_SELLER_AGREE(买家已经申请退款，等待卖家同意) WAIT_BUYER_RETURN_GOODS(卖家已经同意退款，等待买家退货) WAIT_SELLER_CONFIRM_GOODS(买家已经退货，等待卖家确认收货) SELLER_REFUSE_BUYER(卖家拒绝退款) CLOSED(退款关闭) SUCCESS(退款成功)
--good_status	String	BUYER_RECEIVED	货物状态。可选值BUYER_NOT_RECEIVED (买家未收到货) BUYER_RECEIVED (买家已收到货) BUYER_RETURNED_GOODS (买家已退货)
--has_good_return	Boolean	true	买家是否需要退货。可选值:true(是),false(否)
--refund_fee	String	10.00	退还金额(退还给买家的金额)。精确到2位小数;单位:元。如:200.07，表示:200元7分
--payment	String	200.07	支付给卖家的金额(交易总金额-退还给买家的金额)。精确到2位小数;单位:元。如:200.07，表示:200元7分
--reason	String	退还邮费	退款原因
--desc	String	hello world	退款说明
--title	String	天堂伞龙井茶	商品标题
--num	Number	1	商品购买数量
--company_name	String	申通快递	物流公司名称
--sid	String	123456789	退货运单号
--refund_phase	String	onsale	退款阶段，可选值：onsale/aftersale
--refund_version	Number	1411375308927	退款版本号（时间戳）
--sku	String	30004447689	颜色分类:军绿色;尺码:XS
--attribute	String	{"key1":"value1", "key2":"value2"}	退款扩展属性
--outer_id	String	ISBN-001	商品外部商家编码
--operation_contraint	String	refund_onweb	退款约束，可选值：cannot_refuse（不允许操作），refund_onweb（需要到网页版操作）
--ouid	String	iuwekjhffd	ouid
deduct_money	int	1	消耗点券
status	int	0	状态码，0为成功

# 返回数据

{
  "data": {
     "refunds_receive_get_response": {"total_results": 100, "has_next": true, "refunds": {"refund": [{"refund_id": "83477", "tid": 2231884277, "oid": 2231884277, "total_fee": "10.00", "buyer_nick": "tbtest561", "seller_nick": "tbtest869", "created": "2000-01-01 00:00:00", "modified": "2000-01-01 00:00:00", "order_status": "BUYER_RECEIVED", "status": "SUCCESS", "good_status": "BUYER_RECEIVED", "has_good_return": true, "refund_fee": "10.00", "payment": "200.07", "reason": "退还邮费", "desc": "hello world", "title": "天堂伞龙井茶", "num": 1, "company_name": "申通快递", "sid": "123456789", "refund_phase": "onsale", "refund_version": 1411375308927, "sku": "30004447689|颜色分类:军绿色;尺码:XS", "attribute": "{"key1":"value1", "key2":"value2"}", "outer_id": "ISBN-001", "operation_contraint": "refund_onweb", "ouid": "iuwekjhffd","deduct_money": 4}]}}
        
  },
  "status": 0
}

# 错误码

状态码(status)	错误信息	解决方案
132	请求格式必须为JSON	修改请求参数格式为json
422	参数列表不合法，在err中会给出提示	根据提示做相应修改
200	认证失败	请确保请求头里的Authorization存在或者未过期
2011	店铺未授权	使用授权店铺

← 1-p_淘宝-物流流转信息查询 1-r_淘宝-搜索评价信息 →