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

订单详情查看(买家视角)

获取单个交易明细信息 。

一、请求参数

请求URL:

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

基础参数

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

业务参数

名称类型是否必须描述示例值
webSiteString是站点信息，指定调用的API是属于国际站（alibaba）还是1688网站（1688）1688
orderIdLong是交易的订单id123456
includeFieldsString否查询结果中包含的域，GuaranteesTerms：保障条款，NativeLogistics：物流信息，RateDetail：评价详情，OrderInvoice：发票信息。默认返回GuaranteesTerms、NativeLogistics、OrderInvoice。GuaranteesTerms,NativeLogistics,RateDetail,OrderInvoice
attributeKeysString[]否垂直表中的attributeKeys[]
outOrderIdString否外部订单id，控制幂等1556246

二、请求示例代码

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

三、返回结果

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