跳转到内容
Cheeli 文档
返回官网

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

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

一、请求参数

请求URL:

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

基础参数

参数名类型必须示例值说明
appidStringtrue32432143214214合作伙伴AppId
timestampStringtrue1633618722当前时间戳
seller_nickStringtrueb2b-16249611221688账号
signStringtrue999de41d862efaa6f1084ead3b3ba480如何计算生成见示例代码

业务参数

名称类型是否必须描述示例值
bizTypesString[]否业务类型，支持： “cn”(普通订单类型), “ws”(大额批发订单类型), “yp”(普通拿样订单类型), “yf”(一分钱拿样订单类型), “fs”(倒批(限时折扣)订单类型), “cz”(加工定制订单类型), “ag”(协议采购订单类型), “hp”(伙拼订单类型), “gc”(国采订单类型), “supply”(供销订单类型), “nyg”(nyg订单类型), “factory”(淘工厂订单类型), “quick”(快订下单), “xiangpin”(享拼订单), “nest”(采购商城-鸟巢), “f2f”(当面付), “cyfw”(存样服务), “sp”(代销订单标记), “wg”(微供订单), “factorysamp”(淘工厂打样订单), “factorybig”(淘工厂大货订单)[“cn”,”ws”]
createEndTimejava.util.Date否下单结束时间20180802211113000+0800
createStartTimejava.util.Date否下单开始时间20180102211113000+0800
isHisboolean否是否查询历史订单表,默认查询当前表，即默认值为falsefalse
modifyEndTimejava.util.Date否查询修改时间结束20180802211113000+0800
modifyStartTimejava.util.Date否查询修改时间开始20180102211113000+0800
orderStatusjava.lang.String否订单状态，值有 success, cancel(交易取消，违约金等交割完毕), waitbuyerpay(等待卖家付款)， waitsellersend(等待卖家发货), waitbuyerreceive(等待买家收货 )success
pageint否查询分页页码，从1开始1
pageSizeint否查询的每页的数量20
refundStatusjava.lang.String否退款状态，支持： “waitselleragree”(等待卖家同意), “refundsuccess”(退款成功), “refundclose”(退款关闭), “waitbuyermodify”(待买家修改), “waitbuyersend”(等待买家退货), “waitsellerreceive”(等待卖家确认收货)refundsuccess
sellerMemberIdjava.lang.String否卖家memberIdb2b-1624961198
sellerLoginIdString否卖家loginIdalitestforisv02
sellerRateStatusjava.lang.Integer否卖家评价状态 (4:已评价,5:未评价,6;不需要评价)6
tradeTypejava.lang.String否交易类型: 担保交易(1), 预存款交易(2), ETC境外收单交易(3), 即时到帐交易(4), 保障金安全交易(5), 统一交易流程(6), 分阶段交易(7), 货到付款交易(8), 信用凭证支付交易(9), 账期支付交易(10), 1688交易4.0，新分阶段交易(50060), 当面付的交易流程(50070), 服务类的交易流程(50080)50060
productNamejava.lang.String否商品名称测试商品
needBuyerAddressAndPhonejava.lang.Boolean否是否需要查询买家的详细地址信息和电话false
needMemoInfojava.lang.Boolean否是否需要查询备注信息false
outOrderIdString否外部订单号，可用于控制幂等90187872898371

二、请求示例代码

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);
    }

三、返回结果

{
  "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会包含失败原因。 详细返回字段说明见文档