文档中心 电商接口 查询买家订单详情

查询买家订单详情

1.功能说明

查询买家订单详情

2.接口调用说明

请求URL

https://openapi.guanaitong.tech/commerce/order/getShopOrderDetail

正式环境和测试环境的域名请见通用协议

HTTPS请求方式

POST

输入参数说明

(1)公共参数

发送请求是必须传入公共参数,详见公共参数

(2)私有参数

参数名称 是否必须 参数类型 长度限制 描述
shop_order_code String [1-50] 购物单号,由下单接口返回。outer_trade_no 与 shop_order_code 二选一同步
outer_trade_no String [10-30] 外部交易号,下单时的入参。outer_trade_no 与 shop_order_code 二选一同步
请求示例
POST /commerce/order/getShopOrderDetail HTTP/1.1
Host: openapi.guanaitong.tech
Content-Type: application/x-www-form-urlencoded
cache-control: no-cache

access_token=a789d5e449ec7ea8c500a558a11b6b96&shop_order_code=13201911181334000009
&sign=8b90ff7cc9a9a533de4829caee35adce09d1f3df&timestamp=1574056874

                    
返回参数说明
参数名称 描述
code 返回码。详见错误代码
msg 如果错误,返回错误信息。
data ShopOrderDetail对象
ShopOrderDetail对象
order_price BigDecimal类型,订单总价
out_trade_no String类型,外部交易流水号(由系统自动生成)
time_order_created String类型,订单创建时间
time_order_payed String类型,订单支付时间
trade_status Integer类型,交易状态 1等待买家付款 2买家已付款 3.订单取消(交易关闭)
buyer_order_info_list List<BuyerOrderInfo>买家订单列表(未付款订单返回空列表)
BuyerOrderInfo对象说明
receiver_name String类型,收货人姓名
receiver_phone String类型,收货人手机号
address String类型,收货地址
buyer_order_code String类型,买家订单编号
trade_status Integer类型,买家订单交易状态
1 等待买家付款
2 买家已付款
3 商家已备货
4 商家已发货
5 买家已收货(交易成功)
6 订单取消(交易关闭)
order_detail_info_list List<OrderDetailInfo>买家订单商品详情列表
time_created String类型,创建时间
time_delivery String类型,发货时间
order_price BigDecimal类型,买家订单总价
OrderDetailInfo对象说明
shop_order_detail_id Long类型,商品详情ID,退款退货时用到
spu_code String类型,商品code
spu_name String类型,商品名称
product_title String类型,商品标题
sku_code String类型,sku_code
sku_name String类型,sku_name
sku_pic_url String类型,单规格商品的图片,默认取商品的第一张头图
sku_category 规格信息(商品销售属性)
current_price BigDecimal类型,现价
deal_price BigDecimal类型,成交价
purchase_num Integer类型,购买数量
正确返回示例
{
	"code": 0,
	"msg": "OK",
	"data": {
		"out_trade_no": "2020041320000008",
		"time_order_created": "2020-04-13 14:08:20",
		"trade_status": 2,
		"buyer_order_info_list": [{
			"buyer_order_code": "202004130978074246056073",
			"trade_status": 2,
			"time_created": "2020-04-13 14:08:20",
			"order_price": 1.0,
			"order_detail_info_list": [{
				"purchase_num": 1,
				"sku_pic_url": "https://img1.guanaitong.com/4fdd38867bc91f3211607f7a0a02c6c4.jpg",
				"deal_price": 1.0,
				"sku_name": "电器:小型 是否延保:1年",
				"current_price": 1.0,
				"spu_code": "PC19010800005038",
				"sku_category": "电器:小型 是否延保:1年 ",
				"spu_name": "测试自动审核",
				"sku_code": "KC19010800005039",
				"product_title": "啊测试自动审核通过333"
			}],
			"receiver_name": "收件人小明",
			"address": "山东省 济南市 市中区 山东省济南市市中区401路",
			"receiver_phone": "18088888888"
		}],
		"order_price": 12.02,
		"time_order_payed": "2020-04-13 14:08:21"
	}
}
                    
错误返回示例
{"code":1000210002,"data":null,"msg":"sign check failed!"}