私域订单导入

私域订单导入接口

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

一. 请求参数

请求URL:

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

trade_list 请求数据示例

1. 主订单字段描述

2. 子订单字段描述

接口导入订单时，如果报错：　传入的订单格式有误，请检查trade_list的json格式。则核实对上面订单字段的类型，即数字类型的字段，不要加双引号“”，字符串类型才加双引号“”。

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

下面是请求示例，相关参数根据实际业务修改。

  [  
  {  
    "buyer_message": "尽快发货",  
    "create_date": "2025-09-21 20:30:00",  
    "goods_fee": 10,  
    "op": 9,  
    "orders": [  
      {  
        "order_id": "DD202509100002",  
        "pay_amount": 10,  
        "pic_url": "https://static.earthmother.cn/upload/product/product__1f016de233c74a8d89638d898e0ca4a4.jpg",  
        "price": 10,  
        "product_id": 8016,  
        "product_name": "遥控器【锦昱】",  
        "qty": 1,  
        "refund_status": "0",  
        "sku_code": "6503035",  
        "sku_id": 8016,  
        "spec": "YCWA16NCWQ",  
        "sub_total": 10  
      }  
    ],  
    "out_trade_no": "DD202509100002",  
    "pay_time": "2025-09-22 20:30:00",  
    "promotion_amount": 0,  
    "receiver_city_name": "上海市",  
    "receiver_detail_address": "宋园路30弄1号302室古城公寓",  
    "receiver_distrct_name": "长宁区",  
    "receiver_mobile": "13699998888",  
    "receiver_name": "测试",  
    "receiver_province_name": "上海",  
    "seller_flag": "0",  
    "seller_nick": "东方明珠",  
    "status": "2",  
    "total_fee": 10,  
    "trade_no": "DD202509100002",  
    "trade_remark": "明文订单",  
    "trade_source_type": 1,  
    "transit_fee": 0,  
    "update_time": "2025-09-22 20:30:00"  
  }  
]

二. 请求示例代码(Java)

@Test  
public void importTrade() throws Exception {  
    String trades = "[{\"buyer_message\":\"尽快发货\",\"create_date\":\"2025-09-21 20:30:00\",\"goods_fee\":10,\"op\":9,\"orders\":[{\"order_id\":\"DD202509100002\",\"pay_amount\":10,\"pic_url\":\"https://static.earthmother.cn/upload/product/product__1f016de233c74a8d89638d898e0ca4a4.jpg\",\"price\":10,\"product_id\":8016,\"product_name\":\"遥控器【锦昱】\",\"qty\":1,\"refund_status\":\"0\",\"sku_code\":\"6503035\",\"sku_id\":8016,\"spec\":\"YCWA16NCWQ\",\"sub_total\":10}],\"out_trade_no\":\"DD202509100002\",\"pay_time\":\"2025-09-22 20:30:00\",\"promotion_amount\":0,\"receiver_city_name\":\"上海市\",\"receiver_detail_address\":\"宋园路30弄1号302室古城公寓\",\"receiver_distrct_name\":\"长宁区\",\"receiver_mobile\":\"13699998888\",\"receiver_name\":\"测试\",\"receiver_province_name\":\"上海\",\"seller_flag\":\"0\",\"seller_nick\":\"东方明珠\",\"status\":\"2\",\"total_fee\":10,\"trade_no\":\"DD202509100002\",\"trade_remark\":\"明文订单\",\"trade_source_type\":1,\"transit_fee\":0,\"update_time\":\"2025-09-22 20:30:00\"}]";  

    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":"06ce72de-bc5f-47db-bebf-3bc221675a9d"}

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