订单详情查看(买家视角)
获取单个交易明细信息 。
1.请求参数:
请求URL:
POST https://open.fw199.com/gateway/1688/fenxiao/trade/detail
基础参数
参数名 | 类型 | 必须 | 示例值 | 说明 |
---|---|---|---|---|
appid | String | true | 32432143214214 | 合作伙伴AppId |
timestamp | String | true | 1633618722 | 当前时间戳 |
seller_nick | String | true | b2b-1624961122 | 1688账号 |
sign | String | true | 999de41d862efaa6f1084ead3b3ba480 | 如何计算生成见示例代码 |
业务参数
名称 | 类型 | 是否必须 | 描述 | 示例值 |
---|---|---|---|---|
webSite | String | 是 | 站点信息,指定调用的API是属于国际站(alibaba)还是1688网站(1688) | 1688 |
orderId | Long | 是 | 交易的订单id | 123456 |
includeFields | String | 否 | 查询结果中包含的域,GuaranteesTerms:保障条款,NativeLogistics:物流信息,RateDetail:评价详情,OrderInvoice:发票信息。默认返回GuaranteesTerms、NativeLogistics、OrderInvoice。 | GuaranteesTerms,NativeLogistics,RateDetail,OrderInvoice |
attributeKeys | String[] | 否 | 垂直表中的attributeKeys | [] |
outOrderId | String | 否 | 外部订单id,控制幂等 | 1556246 |
2. 请求示例代码(Java)
@Test
public void One688FenXiaoTradeDetail() throws Exception {
//业务参数
Map<String, String> data = new HashMap<String, String>();
data.put("appid", Config.AppId);
data.put("seller_nick", Config.AlibabaFenXiaoSellerNick);
Long timestamp = System.currentTimeMillis() / 1000;
data.put("timestamp", timestamp.toString());
data.put("webSite","1688");
data.put("orderId","4355875836205969811");
data.put("sign", Utils.Sign(data, Config.AppSecret));
// 调用服务API
String response = doHttpRequest(Config.One688FenXiaoTradeDetailUrl, data);
}
3. 返回结果如下:
{
"code": 0,
"message": "ok",
"data": {
"result": {
"baseInfo": {
"alipayTradeId": "UNCREATED",
"businessType": "cb",
"buyerContact": {
"companyName": "阿里巴巴(中国)网络技术有限公司",
"imInPlatform": "alitestforisv02",
"name": "测试账号暮星",
"phone": "8-888-5676544"
},
"buyerFeedback": "通过的订单通过千里马1688分销创建订单",
"buyerID": "b2b-1624961198",
"buyerLoginId": "alitestforisv02",
"closeOperateType": "",
"couponFee": 0,
"createTime": "20250525225053000+0800",
"discount": 0,
"flowTemplateCode": "assureTrade",
"id": 4355875836205970000,
"idOfStr": "4355875836205969811",
"modifyTime": "20250525225055000+0800",
"newStepOrderList": [
{
"activeStatus": 1,
"adjustFee": 0,
"discountFee": 4,
"gmtStart": "20250525225054000+0800",
"lastStep": true,
"logisticsStatus": 1,
"paidFee": 0,
"paidPostFee": 0,
"payFee": 98,
"payStatus": 1,
"postFee": 92,
"stepName": "全款交易",
"stepNo": 1
}
],
"outOrderId": "bxg-1003",
"overSeaOrder": false,
"payChannelCodeList": [],
"payChannelList": [],
"payTimeout": 432000,
"payTimeoutType": 0,
"receiverInfo": {
"toArea": "上海 上海市 浦东新区 陆家嘴街道 东方路200号",
"toDivisionCode": "310115",
"toFullName": "张三",
"toMobile": "13877778888",
"toPhone": "021-88889999",
"toPost": "200120"
},
"refund": 0,
"refundPayment": 0,
"remark": "通过的订单通过千里马1688分销创建订单",
"sellerContact": {
"companyName": "AOP对外测试账号01",
"imInPlatform": "alitestforisv01",
"name": "服务市场测试账号一",
"phone": "86-0591-1381112555",
"shopName": "AOP对外测试账号01"
},
"sellerID": "b2b-1623492085",
"sellerLoginId": "alitestforisv01",
"sellerOrder": false,
"shippingFee": 92,
"status": "waitbuyerpay",
"stepPayAll": false,
"subBuyerLoginId": "alitestforisv02:上海知力",
"sumProductPayment": 10,
"totalAmount": 98,
"tradeType": "50060",
"tradeTypeCode": "assureTrade",
"tradeTypeDesc": "担保交易"
},
"encryptOutOrderInfo": {
"oaid": "1bESjqND6CLmfX71Lk5eqqIGjBB55sKmu1R6Sc4AicHIeMYib8ibop4zqmRDQPwiau0WdjCXjFo",
"outOriginAddress": {
"address": "东方路200号",
"area": {
"name": "浦东新区"
},
"city": {
"name": "上海市"
},
"province": {
"name": "上海"
},
"town": {
"name": "陆家嘴街道"
}
},
"outPlatformAppkey": "21366350",
"outPlatformCode": "thyny",
"outPlatformOrderNo": "2510738042301603488"
},
"extAttributes": [],
"fromEncryptOrder": false,
"nativeLogistics": {
"address": "陆家嘴街道 东方路200号",
"area": "浦东新区",
"areaCode": "310115",
"city": "上海市",
"contactPerson": "张三",
"mobile": "1387777****",
"province": "上海",
"telephone": "021-888****",
"zip": "200120"
},
"orderBizInfo": {
"creditOrder": false,
"dropshipping": false,
"odsCyd": false
},
"orderRateInfo": {
"buyerRateStatus": 5,
"sellerRateStatus": 5
},
"productItems": [
{
"cargoNumber": "qs-xs",
"entryDiscount": 0,
"gmtCreate": "20250525225053000+0800",
"gmtModified": "20250525225055000+0800",
"guaranteesTerms": [
{
"assuranceInfo": "卖家承诺买家签收货物后7天内,在“商品完好”的情形下,向买家提供退货服务。",
"assuranceType": "qtwlybt",
"qualityAssuranceType": "7天无理由退货"
},
{
"assuranceInfo": "卖家在承诺买家保障服务的基础上,向买家提供“48小时发货延必赔”的服务。在买家通过支付宝担保交易完成付款或通过货到付款下单成功后,卖家承诺在买家支付成功起48小时内发货。如卖家未履行前述承诺,买家可在指定期限内发起维权,并申请赔付。",
"assuranceType": "ssbxsfh",
"qualityAssuranceType": "48小时发货"
}
],
"itemAmount": 6,
"logisticsStatus": 1,
"name": "测试商品-女大衣- qlm-勿删时尚气质2时尚百搭短款",
"price": 10,
"productCargoNumber": "396#原版天猫质量",
"productID": 902719378311,
"productImgUrl": [
"http://cbu01.alicdn.com/img/ibank/O1CN01N6LdOr1Bs32fw2Xaq_!!0-0-cib.80x80.jpg",
"http://cbu01.alicdn.com/img/ibank/O1CN01N6LdOr1Bs32fw2Xaq_!!0-0-cib.jpg"
],
"productSnapshotUrl": "https://trade.1688.com/order/offer_snapshot.htm?order_entry_id=4355875836205969811",
"quantity": 1,
"quantityFactor": 1,
"refund": 0,
"skuID": 5927527678773,
"skuInfos": [
{
"name": "颜色",
"value": "铅色"
},
{
"name": "尺码",
"value": "XS"
}
],
"specId": "3304a52052baafcbd679efd04e8589a5",
"status": "waitbuyerpay",
"statusStr": "等待买家付款",
"subItemID": 4355875836205970000,
"subItemIDString": "4355875836205969811",
"type": "common",
"unit": "箱"
}
],
"tradeTerms": []
},
"success": "true"
},
"trace_id": ""
}
说明: code为0表示成功,非0为失败,message会包含失败原因。 详细返回字段说明见文档
文档更新时间: 2025-05-26 17:27 作者:admin