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

获取单个交易明细信息 。

1.请求参数:

请求URL:

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

基础参数

参数名 类型 必须 示例值 说明
appid String true 32432143214214 合作伙伴AppId
timestamp String true 1633618722 当前时间戳
seller_nick String true b2b-1624961122 1688账号
sign String true 999de41d862efaa6f1084ead3b3ba480 如何计算生成见示例代码

业务参数

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

2. 请求示例代码(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);
    }

3. 返回结果如下:

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

文档更新时间: 2025-05-26 17:27   作者:admin