订单导入（新）

订单导入接口

1. 一次最多可以导入100个订单。如果订单之前已经导入过，则会更新订单的关键信息，如订单状态等。
2. 由于不同电商平台对订单的字段定义和描述各有不同，请根据蜂巢导入订单的字段说明，将对应的电商平台的订单字段值按要求导入。

   一. 请求参数

请求URL:

POST https://kf.fw199.com/gateway/wbprinter/trade/import

trade_list 请求数据示例

1.主订单字段描述

说明：
一、上面oaid值从订单（详情或增强型列表）接口中获取，不同的电商平台叫法不同。对应如下：

• 京东 : oaid
• 1688: caid
• taobao: oaid
• 抖音: open_address_id
• 拼多多：open_address_id
• 快手：oaid

2.子订单字段描述

3. 请求传入订单JSON的示例

以淘宝平台为例，其他平台按上面字段要求进行组装。

[
  {
    "trade_no": "3581388577432263469",
    "status": "WAIT_BUYER_CONFIRM_GOODS",
    "receiver_name": "",
    "receiver_name_mask": "周**",
    "receiver_mobile": "",
    "receiver_mobile_mask": "*******8797",
    "receiver_province_id": "",
    "receiver_province_name": "陕西省",
    "receiver_city_id": "",
    "receiver_city_name": "汉中市",
    "receiver_distrct_id": "",
    "receiver_distrct_name": "南郑区",
    "receiver_street_id": "",
    "receiver_street_name": "汉山街道",
    "receiver_detail_address": "",
    "receiver_detail_address_mask": "汉*街道周**路汉山公馆玉兰**栋***室",
    "exp_ship_time": "2024-03-22 00:38:39",
    "appointment_ship_time": "",
    "trade_remark": "",
    "transit_fee": 8,
    "goods_fee": 0.9,
    "total_fee": 8.9,
    "create_date": "2024-03-22 00:38:38",
    "seller_nick": "XX旗舰店",
    "buyer_message": "",
    "ship_time": "",
    "promotion_amount": 0,
    "update_time": "2022-03-22 00:38:39",
    "complete_date": "",
    "cancel_reason": "",
    "open_id": "AAEU0YHcABD0D2GIOazDW_4L",
    "pay_time": "",
    "seller_flag": "0",
    "oaid": "1F6qicravk5YgSjSLSYd1RGvj2ImZe7bIpS9I6kTnSPcY2zicd3P5vgRsU3eMYM0YiaKiaRT6E3",
    "trade_source_type": 0,
    "op": 1,
    "out_trade_no": "DD202310250061",
    "orders": [
      {
        "order_id": "3581388577432263461",
        "product_id": 547538216335,
        "product_name": "地暖辅材 分集水器标识卡扣 标记盘管 16#管",
        "pic_url": "https://img.alicdn.com/bao/uploaded/i4/3192091320/O1CN01OJp8z21LcbT7prUGL_!!2-item_pic.png",
        "qty": 1,
        "price": 0.9,
        "sub_total": 8.9,
        "remark": "",
        "spec": "颜色分类:客厅",
        "product_code": "",
        "sku_code": "4977544349948",
        "post_origin_amount": 0,
        "refund_status": "WAIT_BUYER_RETURN_GOODS",
        "promotion_amount": 0,
        "pay_amount": 8.9,
        "sku_id": 0
      }
    ]
  }
]

二. 请求示例代码(Java)

     @Test
    public void importTrade() throws Exception {
        String trades = "[{\n" + "    \"trade_no\": \"3581388577432263461x\",\n" + "    \"status\": \"WAIT_BUYER_CONFIRM_GOODS\",\n" + "    \"receiver_name\": \"\",\n" + "    \"receiver_name_mask\": \"周**\",\n" + "    \"receiver_mobile\": \"\",\n" + "    \"receiver_mobile_mask\": \"*******8797\",\n" + "    \"receiver_province_id\": \"\",\n" + "    \"receiver_province_name\": \"陕西省\",\n" + "    \"receiver_city_id\": \"\",\n" + "    \"receiver_city_name\": \"汉中市\",\n" + "    \"receiver_distrct_id\": \"\",\n" + "    \"receiver_distrct_name\": \"南郑区\",\n" + "    \"receiver_street_id\": \"\",\n" + "    \"receiver_street_name\": \"汉山街道\",\n" + "    \"receiver_detail_address\": \"\",\n" + "    \"receiver_detail_address_mask\": \"汉*街道周**路汉山公馆玉兰**栋***室\",\n" + "    \"exp_ship_time\": \"2022-03-22 00:38:39\",\n" + "    \"appointment_ship_time\": \"\",\n" + "    \"trade_remark\": \"\",\n" + "    \"transit_fee\": 8,\n" + "    \"goods_fee\": 0.9,\n" + "    \"total_fee\": 8.9,\n" + "    \"create_date\": \"2022-03-22 00:38:38\",\n" + "    \"seller_nick\": \"XX旗舰店\",\n" + "    \"buyer_message\": \"\",\n" + "    \"ship_time\": \"\",\n" + "    \"promotion_amount\": 0,\n" + "    \"update_time\": \"2022-03-22 00:38:39\",\n" + "    \"complete_date\": \"\",\n" + "    \"cancel_reason\": \"\",\n" + "    \"open_id\": \"AAEU0YHcABD0D2GIOazDW_4L\",\n" + "    \"pay_time\": \"\",\n" + "    \"seller_flag\": \"0\",\n" + "    \"oaid\": \"1F6qicravk5YgSjSLSYd1RGvj2ImZe7bIpS9I6kTnSPcY2zicd3P5vgRsU3eMYM0YiaKiaRT6E3\",\n" + "    \"trade_source_type\": 0,\n" + "    \"op\": 1,\n" + "    \"out_trade_no\": \"DD202310250061\",\n" + "    \"orders\": [\n" + "      {\n" + "        \"order_id\": \"3581388577432263461\",\n" + "        \"product_id\": 547538216335,\n" + "        \"product_name\": \"地暖辅材 分集水器标识卡扣 标记盘管 16#管\",\n" + "        \"pic_url\": \"https://img.alicdn.com/bao/uploaded/i4/3192091320/O1CN01OJp8z21LcbT7prUGL_!!2-item_pic.png\",\n" + "        \"qty\": 1,\n" + "        \"price\": 0.9,\n" + "        \"sub_total\": 8.9,\n" + "        \"remark\": \"\",\n" + "        \"spec\": \"颜色分类:客厅\",\n" + "        \"product_code\": \"\",\n" + "        \"sku_code\": \"4977544349948\",\n" + "        \"post_origin_amount\": 0,\n" + "        \"refund_status\": \"WAIT_BUYER_RETURN_GOODS\",\n" + "        \"promotion_amount\": 0,\n" + "        \"pay_amount\": 8.9,\n" + "        \"sku_id\": 0\n" + "      }\n" + "    ]\n" + "  }\n" + "]";
        Map<String, String> data = new HashMap<String, String>();
        data.put("appid",  Config.AppId);
        data.put("trade_list",trades);
        long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp",String.valueOf(timestamp));
        // 参数签名
        data.put("sign", Utils.Sign(data,Config.AppSecret));
        doHttpRequest(Config.FCPrinterImportTradeUrl,data);
    }

三. 返回结果示例:

{"code":0,"message":"ok","data":"导入成功","trace_id":""}

说明： code为0表示成功，非0为失败，message会包含失败原因。