订单列表查看(买家视角)

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

1.请求参数:

请求URL:

POST https://open.fw199.com/gateway/1688/fenxiao/trade/list

基础参数

参数名 类型 必须 示例值 说明
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