订单列表查看(买家视角)
获取买家的订单列表,也就是用户的memberId必须等于订单里的买家memberId。该接口仅仅返回订单基本信息,不会返回订单的物流信息和发票信息;如果需要获取物流信息,请调用获取订单详情接口;如果需要获取发票信息,请调用获取发票信息的API
1.请求参数:
请求URL:
基础参数
参数名 | 类型 | 必须 | 示例值 | 说明 |
---|---|---|---|---|
appid | String | true | 32432143214214 | 合作伙伴AppId |
timestamp | String | true | 1633618722 | 当前时间戳 |
seller_nick | String | true | b2b-1624961122 | 1688账号 |
sign | String | true | 999de41d862efaa6f1084ead3b3ba480 | 如何计算生成见示例代码 |
业务参数
名称 | 类型 | 是否必须 | 描述 | 示例值 |
---|---|---|---|---|
bizTypes | String[] | 否 | 业务类型,支持: “cn”(普通订单类型), “ws”(大额批发订单类型), “yp”(普通拿样订单类型), “yf”(一分钱拿样订单类型), “fs”(倒批(限时折扣)订单类型), “cz”(加工定制订单类型), “ag”(协议采购订单类型), “hp”(伙拼订单类型), “gc”(国采订单类型), “supply”(供销订单类型), “nyg”(nyg订单类型), “factory”(淘工厂订单类型), “quick”(快订下单), “xiangpin”(享拼订单), “nest”(采购商城-鸟巢), “f2f”(当面付), “cyfw”(存样服务), “sp”(代销订单标记), “wg”(微供订单), “factorysamp”(淘工厂打样订单), “factorybig”(淘工厂大货订单) | [“cn”,”ws”] |
createEndTime | java.util.Date | 否 | 下单结束时间 | 20180802211113000+0800 |
createStartTime | java.util.Date | 否 | 下单开始时间 | 20180102211113000+0800 |
isHis | boolean | 否 | 是否查询历史订单表,默认查询当前表,即默认值为false | false |
modifyEndTime | java.util.Date | 否 | 查询修改时间结束 | 20180802211113000+0800 |
modifyStartTime | java.util.Date | 否 | 查询修改时间开始 | 20180102211113000+0800 |
orderStatus | java.lang.String | 否 | 订单状态,值有 success, cancel(交易取消,违约金等交割完毕), waitbuyerpay(等待卖家付款), waitsellersend(等待卖家发货), waitbuyerreceive(等待买家收货 ) | success |
page | int | 否 | 查询分页页码,从1开始 | 1 |
pageSize | int | 否 | 查询的每页的数量 | 20 |
refundStatus | java.lang.String | 否 | 退款状态,支持: “waitselleragree”(等待卖家同意), “refundsuccess”(退款成功), “refundclose”(退款关闭), “waitbuyermodify”(待买家修改), “waitbuyersend”(等待买家退货), “waitsellerreceive”(等待卖家确认收货) | refundsuccess |
sellerMemberId | java.lang.String | 否 | 卖家memberId | b2b-1624961198 |
sellerLoginId | String | 否 | 卖家loginId | alitestforisv02 |
sellerRateStatus | java.lang.Integer | 否 | 卖家评价状态 (4:已评价,5:未评价,6;不需要评价) | 6 |
tradeType | java.lang.String | 否 | 交易类型: 担保交易(1), 预存款交易(2), ETC境外收单交易(3), 即时到帐交易(4), 保障金安全交易(5), 统一交易流程(6), 分阶段交易(7), 货到付款交易(8), 信用凭证支付交易(9), 账期支付交易(10), 1688交易4.0,新分阶段交易(50060), 当面付的交易流程(50070), 服务类的交易流程(50080) | 50060 |
productName | java.lang.String | 否 | 商品名称 | 测试商品 |
needBuyerAddressAndPhone | java.lang.Boolean | 否 | 是否需要查询买家的详细地址信息和电话 | false |
needMemoInfo | java.lang.Boolean | 否 | 是否需要查询备注信息 | false |
outOrderId | String | 否 | 外部订单号,可用于控制幂等 | 90187872898371 |
2. 请求示例代码(Java)
@Test
public void One688FenXiaoTradeList() 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());
// yyyyMMddHHmmssSSSZ 是一个日期时间格式模式,以下是对其各部分的解析:
//yyyy:表示四位数的年份,例如 2023。
//MM:表示两位数的月份(01-12),例如 03 表示三月。
//dd:表示两位数的日期(01-31),例如 15 表示15号。
//HH:表示两位数的小时(00-23,24小时制),例如 14 表示下午2点。
//mm:表示两位数的分钟(00-59),例如 45 表示45分钟。
//ss:表示两位数的秒(00-59),例如 30 表示30秒。
//SSS:表示三位数的毫秒(000-999),例如 123 表示123毫秒。
//Z:表示时区偏移量,格式为 +hhmm 或 -hhmm,例如 +0800 表示东八区。
data.put("createStartTime","20250325000000000+0800");
data.put("createEndTime","20250526000000000+0800");
data.put("page","1");
data.put("pageSize","20");
data.put("sign", Utils.Sign(data, Config.AppSecret));
// 调用服务API
String response = doHttpRequest(Config.One688FenXiaoTradeListUrl, data);
}
3. 返回结果如下:
{
"code": 0,
"message": "ok",
"data": [
{
"baseInfo": {
"alipayTradeId": "UNCREATED",
"businessType": "cb",
"buyerAlipayId": "2088541018029473",
"buyerContact": {
"companyName": "阿里巴巴(中国)网络技术有限公司",
"imInPlatform": "alitestforisv02",
"name": "测试账号暮星",
"phone": "8-888-5676544"
},
"buyerFeedback": "通过的订单通过千里马1688分销创建订单",
"buyerID": "b2b-1624961198",
"buyerLoginId": "alitestforisv02",
"buyerSubID": 2219417659696,
"buyerUserId": 1624961198,
"createTime": "20250525225053000+0800",
"discount": 0,
"id": 4355875836205970000,
"idOfStr": "4355875836205969811",
"modifyTime": "20250525225055000+0800",
"overSeaOrder": false,
"receiverInfo": {
"toArea": "上海 上海市 浦东新区",
"toDivisionCode": "310115",
"toFullName": "张三",
"toPost": "200120"
},
"refund": 0,
"refundPayment": 0,
"remark": "通过的订单通过千里马1688分销创建订单",
"sellerAlipayId": "2088541420590570",
"sellerContact": {
"companyName": "AOP对外测试账号01",
"imInPlatform": "alitestforisv01",
"name": "服务市场测试账号一",
"phone": "86-0591-1381112555"
},
"sellerID": "b2b-1623492085",
"sellerLoginId": "alitestforisv01",
"sellerUserId": 1623492085,
"shippingFee": 92,
"status": "waitbuyerpay",
"stepPayAll": false,
"sumProductPayment": 10,
"totalAmount": 98,
"tradeType": "50060"
},
"nativeLogistics": {
"address": "上海 上海市 浦东新区",
"area": "浦东新区",
"areaCode": "310115",
"city": "上海市",
"contactPerson": "张三",
"privacyProtection": false,
"province": "上海",
"zip": "200120"
},
"orderBizInfo": {
"creditOrder": false,
"dropshipping": false,
"odsCyd": false
},
"orderRateInfo": {
"buyerRateStatus": 5,
"sellerRateStatus": 5
},
"productItems": [
{
"cargoNumber": "qs-xs",
"entryDiscount": 0,
"guaranteesTerms": [
{
"assuranceInfo": "卖家承诺买家签收货物后7天内,在“商品完好”的情形下,向买家提供退货服务。",
"assuranceType": "qtwlybt",
"qualityAssuranceType": "7天无理由退货",
"shortCode": "qtwlybt"
},
{
"shortCode": "qtwlybt_2"
},
{
"assuranceInfo": "卖家在承诺买家保障服务的基础上,向买家提供“48小时发货延必赔”的服务。在买家通过支付宝担保交易完成付款或通过货到付款下单成功后,卖家承诺在买家支付成功起48小时内发货。如卖家未履行前述承诺,买家可在指定期限内发起维权,并申请赔付。",
"assuranceType": "ssbxsfh",
"qualityAssuranceType": "48小时发货",
"shortCode": "D"
},
{
"shortCode": "D_2"
},
{
"shortCode": "EOT"
}
],
"itemAmount": 6,
"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,
"type": "common",
"unit": "箱"
}
],
"tradeTerms": []
}
],
"trace_id": ""
}
说明: code为0表示成功,非0为失败,message会包含失败原因。 详细返回字段说明见文档
文档更新时间: 2025-05-26 17:27 作者:admin