订单上传接口

此接口每次上传一个订单信息到云帆，如果有订单更新(不能变更和增减订单的商品的交易明细id)，也使用本接口直接推送订单到云帆，开发者请注意严格遵守报文结构要求。
订单状态Status的取值说明：
WAIT_SELLER_SEND_GOODS：等待卖家发货，即：买家已付款
WAIT_BUYER_CONFIRM_GOODS ：等待买家确认收货，即：卖家已发货
TRADE_SUCCESS：买家已签收或交易成功
TRADE_CLOSED：交易关闭
订单上传状态流转顺序： 注意：订单状态变更重复推送时，请保证 【tid】和【oid】保持一致
等待卖家发货—>交易成功；
等待卖家发货—>交易关闭；
等待卖家发货—>等待买家确认收货—>交易成功；
等待卖家发货—>等待买家确认收货—>交易关闭；

接口请求地址

测试地址：http://erppushtest.kuaidaoyun.com/api/yunfan/extopentrade
正式地址：

测试账号
【app_id】: i1hY3vOmCBWAB9ddDSDTN1RL
【appSecret】: 37f2af0405eaea09c363115273eb02df05cdba7f
正式环境的请求地址及账号信息，请在云帆ERP系统中进行申请。

请求参数

Headers参数

PostBody数据

签名说明：

sign=MD5(app_id + PostBody + appSecret)转小写
注意：由于JSON没有明确的跨语言规范，因此对JSON解析之后再进行重新编码，并不一定能还原原始JSON字符串。所以请严格按照原始报文进行签名和验签！

订单详情结构体 Data

订单详情结构体 OrderInfo

地址详情结构体 AddressInfo

支付结构体 PayInfo

商品明细结构体 Orders

备注详情结构体 RemarkInfo

商品规格信息结构体 SkuPropertiesName

云帆请求的说明

1、数据编码采用UTF-8格式，application/json格式
2、采用HTTP或HTTPS传输协议，POST方法

{
    "app_id":"i1hY3vOmCBWAB9ddDSDTN1RL",
    "msg_id":"eeced9cc441942ff8ec2002178c2ff9b",
    "data":{
        "address_info":{
            "delivery_address":"水印城 1-4-1143",
            "delivery_postal_code":"",
            "receiver_name":"周XX",
            "delivery_province":"四川省",
            "delivery_city":"成都市",
            "delivery_district":"双流区",
            "receiver_tel":"18012630000"
        },
        "remark_info":{
            "buyer_message":"卖家留言",
            "trade_memo":"买家备注",
            "star":0
        },
        "pay_info":{
            "outer_transactions":[
                "396201909050781205290"
            ],
            "post_fee":0,
            "total_fee":18970,
            "payment":18170,
            "transaction":[
                "190905210136000381"
            ]
        },
        "orders":[
            {
                "outer_item_id":"",
                "discount_price":8990,
                "item_type":0,
                "num":1,
                "oid":"4200000396201909050781205290",
                "title":"看得见的放心越光大米4KG",
                "fenxiao_payment":0,
                "buyer_messages":"{}",
                "is_present":false,
                "price":8990,
                "fenxiao_price":0,
                "total_fee":8990,
                "alias":"35y166a13ppl1",
                "payment":8990,
                "outer_sku_id":"6957048900110",
                "customs_code":"",
                "item_id":425430756,
                "item_no":"",
                "sku_properties_name":"[{\"k\":\"规格\",\"k_id\":14,\"v\":\"袋\",\"v_id\":10710}]",
                "sku_id":36243074,
                "pic_path":"https://img.yzcdn.cn/upload_files/2019/05/23/FiCeZY7Sexk3GGdKmPGHI_Dkuy-7.jpg",
                "points_price":0,
                "express_no":"YD202012345689",
                "delivery_time":"2020-05-22 09:53:28",
                "express_code":"1",
                "status":"TRADE_SUCCESS",
                "refund_type":1,
                "refund_time":"2020-09-02 12:00:00",
                "refund_fee":1500,
                "refund_state":60
            }
        ],
        "order_info":{
            "consign_time":"2020-05-07 16:14:04",
            "created":"2020-05-07 16:10:36",
            "offline_id":56307550,
            "expired_time":"2020-05-07 16:40:36",
            "success_time":"2020-05-22 09:53:27",
            "type":0,
            "confirm_time":"",
            "tid":"E20200507161036078000002",
            "pay_time":"2020-05-07 16:10:50",
            "update_time":"2020-05-22 09:53:28",
            "is_retail_order":"false",
            "pay_type":10,
            "close_type":0,
            "status":"TRADE_SUCCESS"
        }
    },
    "timestamp":1603452082572
}

订单详情结构体Json数据示例

{
“address_info”: {
“delivery_address”: “水印城 1-4-1143”,
“delivery_postal_code”: “”,
“receiver_name”: “周XX”,
“delivery_province”: “四川省”,
“delivery_city”: “成都市”,
“delivery_district”: “双流区”,
“receiver_tel”: “18012630000”
},
“remark_info”: {
“buyer_message”: “卖家留言”,
“trade_memo”: “买家备注”,
“star”: 0
},
“pay_info”: {
“outer_transactions”: [“396201909050781205290”],
“post_fee”: 0,
“total_fee”: 18970,
“payment”: 18170,
“transaction”: [“190905210136000381”]
},
“orders”: [{
“outer_item_id”: “”,
“discount_price”: 8990,
“item_type”: 0,
“num”: 1,
“oid”: “4200000396201909050781205290”,
“title”: “看得见的放心越光大米4KG”,
“fenxiao_payment”: 0,
“buyer_messages”: “{}”,
“is_present”: false,
“price”: 89.9,
“fenxiao_price”: 0,
“total_fee”: 8990,
“alias”: “35y166a13ppl1”,
“payment”: 8990,
“outer_sku_id”: “6957048900110”,
“customs_code”: “”,
“item_id”: 425430756,
“item_no”: “”,
“sku_properties_name”: “[{\”k\”:\”规格\”,\”k_id\”:14,\”v\”:\”袋\”,\”v_id\”:10710}]”,
“sku_id”: 36243074,
“pic_path”: “https://img.yzcdn.cn/upload_files/2019/05/23/FiCeZY7Sexk3GGdKmPGHI_Dkuy-7.jpg“,
“points_price”: 0,
“express_no”: “YD202012345689”,
“delivery_time”: “2020-05-22 09:53:28”,
“express_code”: “1”,
“status”: “TRADE_SUCCESS”,
“refund_type”: 1,
“refund_time”: “2020-09-02 12:00:00”,
“refund_fee”: 1500,
“refund_state”: 60
}],
“order_info”: {
“consign_time”: “2020-05-07 16:14:04”,
“created”: “2020-05-07 16:10:36”,
“offline_id”: 56307550,
“expired_time”: “2020-05-07 16:40:36”,
“success_time”: “2020-05-22 09:53:27”,
“type”: 0,
“confirm_time”: “”,
“tid”: “E20200507161036078000002”,
“pay_time”: “2020-05-07 16:10:50”,
“update_time”: “2020-05-22 09:53:28”,
“is_retail_order”: “false”,
“pay_type”: 10,
“close_type”: 0,
“status”: “TRADE_SUCCESS”
}
}

响应参数

成功示例

{
“status”: 200, //状态码
“success”: true,
“message”: null,
“data”: null
}

异常示例（注意大小写格式）

{
“Status”: 1001, //状态码
“Success”: false,
“Message”: “sign is error”,
“Data”: null
}