您的位置 : 文档中心 -> API信息

com.alibaba.trade:alibaba.trade.getBuyerOrderList-1
订单列表查看(买家视角) 免费

获取买家的订单列表,也就是用户的memberId必须等于订单里的买家memberId。该接口仅仅返回订单基本信息,不会返回订单的物流信息和发票信息;如果需要获取物流信息,请调用获取订单详情接口;如果需要获取发票信息,请调用获取发票信息的API

API用户授权类型

需要授权

系统级输入参数

名称 类型 是否必须 描述
_aop_timestamp String 请求时间戳
_aop_signature String 请求签名
access_token String 用户授权令牌

应用级输入参数

名称 类型 是否必须 描述 示例值 默认值
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
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

返回结果

名称 类型 是否必须 描述 示例值
+ result alibaba.openplatform.trade.model.TradeInfo[] 查询返回列表 []
errorCode String 错误码
errorMessage String 错误信息
totalRecord Long 总记录数 528

返回结果

返回参数示例

  {
    "result":[
        {
            "baseInfo":{
                "businessType":"cn",
                "buyerID":"b2b-1623492085",
                "completeTime":"20180806104425000+0800",
                "createTime":"20180801104333000+0800",
                "id":196965465451498520,
                "modifyTime":"20180806104425000+0800",
                "refund":0,
                "sellerID":"b2b-1624747073",
                "shippingFee":0,
                "status":"cancel",
                "totalAmount":0.01,
                "discount":-3989,
                "buyerContact":{
                    "phone":"86-0591-13805040134",
                    "name":"测试账号一暮星",
                    "imInPlatform":"alitestforisv01",
                    "companyName":"AOP对外测试账号01"
                },
                "sellerContact":{
                    "phone":"86-",
                    "name":"暮星",
                    "imInPlatform":"alitestforisv04",
                    "companyName":"AOP对外测试账号04"
                },
                "tradeType":"50060",
                "refundPayment":0,
                "idOfStr":196965465451498520,
                "alipayTradeId":"2018080121001008530224243852",
                "receiverInfo":{
                    "toFullName":"洪帮",
                    "toDivisionCode":"330782",
                    "toPost":"322000",
                    "toArea":"浙江省 金华市 义乌市"
                },
                "buyerLoginId":"alitestforisv01",
                "sellerLoginId":"alitestforisv04",
                "buyerUserId":1623492085,
                "sellerUserId":1624747073,
                "buyerAlipayId":"2088611492691533",
                "sellerAlipayId":"2088521180335604",
                "closeReason":"BUYER_NO_PAY",
                "sumProductPayment":39.9,
                "stepPayAll":false
            },
            "nativeLogistics":{
                "area":"义乌市",
                "areaCode":"330782",
                "city":"金华市",
                "contactPerson":"洪帮",
                "province":"浙江省",
                "zip":"322000"
            },
            "productItems":[
                {
                    "itemAmount":0.01,
                    "name":"夏季亚麻九分裤韩版潮流棉麻薄款修身小脚裤时尚休闲哈伦裤潮男裤",
                    "price":39.9,
                    "productID":574273466269,
                    "productImgUrl":[
                        "http://cbu01.alicdn.com/img/order/trading/025/894/154564569691/9134583276_1665066988.80x80.jpg",
                        "http://cbu01.alicdn.com/img/order/trading/025/894/154564569691/9134583276_1665066988.jpg"
                    ],
                    "productSnapshotUrl":"https://trade.1688.com/order/offer_snapshot.htm?order_entry_id=196965465451498520",
                    "quantity":1,
                    "refund":0,
                    "skuID":3753684468637,
                    "status":"cancel",
                    "subItemID":196965465451498520,
                    "type":"common",
                    "unit":"件",
                    "guaranteesTerms":[

                    ],
                    "productCargoNumber":"KY",
                    "skuInfos":[
                        {
                            "name":"颜色",
                            "value":"深灰色"
                        },
                        {
                            "name":"尺码",
                            "value":"3XL"
                        }
                    ],
                    "entryDiscount":-3989,
                    "specId":"7a2087a6594c7d6030d8ff5c42c8a2e8",
                    "quantityFactor":1,
                    "statusStr":"交易取消",
                    "closeReason":"BUYER_NO_PAY",
                    "logisticsStatus":1
                }
            ],
            "tradeTerms":[
                {
                    "payStatus":"8",
                    "payTime":"20180801104336000+0800",
                    "payWay":"1",
                    "phasAmount":0.01,
                    "phase":2960551254498520
                }
            ],
            "orderRateInfo":{
                "buyerRateStatus":5,
                "sellerRateStatus":5
            }
        }
    ],
    "totalRecord":537
} 

API工具

SDK 示例