韵达 API
  1. 电子面单
韵达 API
  • 接口简介
  • API 鉴权说明
    • API 鉴权说明
  • 电子面单
    • 电子面单取消接口
      POST
    • 电子面单下单
      POST
    • 电子面单余量查询接口
      POST
    • 电子面单更新接口
      POST
  • 散件下单
    • 运单推送接口
      POST
    • 散单取消接口
      POST
    • 预估运费接口
      POST
    • 散件下单接口
      POST
  • 物流轨迹
    • 物流轨迹推送
      POST
    • 物流轨迹查询
      POST
    • 物流轨迹订阅
      POST
  • 国际件
    • 国际进口下单接口
      POST
  • 页面嵌入
    • 微信小程序嵌入
    • 微信公众号接入
    • h5页面嵌入
  1. 电子面单

电子面单更新接口

POST
/v1/accountOrder/updateBmOrder

接口描述#


签名详见 官网API鉴权说明;请求参数和签名方法
下单后如果订单信息(不包括订单类型)需要更新,请用此接口
下单成功后获取不到三段码可使用更新接口重新获取
更新订单后会将运单号,打印信息(密文或者明文json)返回,错误信息
错误信息类型有:
1. 超过下单时间15天,不允许更新
2. 已经有物流信息,不允许更新

pdf_info重点字段说明#


参数参数说明
position一段码
position_no二段码和三段码
tp_status四段码
package_wdjc集包地

请求参数

Header 参数

Body 参数application/json

示例

返回响应

🟢200成功
application/json
Body

🟢200失败
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://openapi.yundaex.com/openapi-api/v1/accountOrder/updateBmOrder' \
--header 'app-key;' \
--header 'sign;' \
--header 'req-time;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appid": "999999",
    "partner_id": "201700101001",
    "secret": "123456789",
    "orders": [
        {
            "collect_branch": "",
            "collection_value": 126.5,
            "cus_area1": "",
            "cus_area2": "",
            "isProtectPrivacy": "",
            "items": [
                {
                    "name": "衣服",
                    "number": 1,
                    "remark": "袜子"
                }
            ],
            "khddh": 2012121715001,
            "node_id": "350",
            "order_serial_no": 2012121715001,
            "order_type": "common",
            "platform_source": "",
            "receiver": {
                "address": "上海市,青浦区,盈港东路 6679 号",
                "city": "上海市",
                "company": "",
                "county": "青浦区",
                "mobile": "17601206977",
                "name": "李四",
                "province": "上海市"
            },
            "remark": "",
            "sender": {
                "address": "上海市,青浦区,盈港东路 7766 号",
                "city": "上海市",
                "company": "",
                "county": "青浦区",
                "mobile": "17601206977",
                "name": "张三",
                "province": "上海市"
            },
            "size": "0.12,0.23,0.11",
            "special": 0,
            "value": 126.5,
            "weight": 0,
            "wave_no": "string"
        }
    ]
}'
响应示例响应示例
200 - 成功 - 成功示例2
{
    "code": "0000",
    "message": "请求成功",
    "result": true,
    "data": [{
        "order_serial_no": "0000019876576897",
        "pdf_info": "[[{"order_id":"5160533654","order_serial_no":"test_191021002","partner_id":"2017001068","partner_orderid":"test_191021002","order_type":"common","mailno":"4060005469862","customer_id":"","sender_name":"\u738b\u5c0f\u864e","sender_company":"\u51ef\u5229","sender_area_ids":"","sender_area_names":"\u6c5f\u82cf\u7701\uff0c\u5f90\u5dde\u5e02\uff0c\u65b0\u6c82\u5e02","sender_address":"\u6e56\u4e1c\u8def999\u53f7","sender_postcode":"221435","sender_phone":"021-85926525","sender_mobile":"13761960078","sender_branch":"201700","receiver_name":"\u9646\u5927\u6709","receiver_company":"\u5343\u5343","receiver_area_ids":"310118","receiver_area_names":"\u4e0a\u6d77\u5e02,\u4e0a\u6d77\u5e02,\u9752\u6d66\u533a","receiver_address":"\u4e0a\u6d77\u5e02\u9752\u6d66\u533a\u76c8\u6e2f\u4e1c\u8def6633\u53f7","receiver_postcode":"201700","receiver_phone":"020-57720341","receiver_mobile":"13761960075","receiver_branch":"200230","weight":"11.00","remark":"","status":"rs10","time":"2019-10-21 11:16:26","position_no":"G096-00 20","position_zz":"0","options":"","send_num":"0","nb_ckh":"2001123","cus_area1":"\u8ba2\u5355\u53f7:test_191021002\n\u8ba2\u5355\u53f7\uff1a123 \n\u6279\u6b21\u53f7\uff1a456212","cus_area2":"","position":"300","receiver_flag":"1","package_wd":"J200000","callback_id":"","wave_no":"","node_id":"","ems_flag":"","cus_area3":"","trade_code":"","shi1":null,"sheng1":null,"shi2":"310100","sheng2":"310000","collection_value":"100.00","value":"20.00","zffs":"0","innerProvinceName":"\u7701\u5185\u4ef6","package_wdjc":"\u96c6\u5305\u5730\uff1a\u4e0a\u6d77\u5206\u62e8\u5305  ","sender_branch_jc":"\u9752\u6d66\u533aYD","bigpen_code":"G096-00","lattice_mouth_no":"20","mailno_barcode":"406000546986204240","tname":"mailtmp_s12","dispatch_code":"20","qrcode":"4060005469862\/300 G096-00 20","privacy_receiver_name":"\u9646**","privacy_receiver_phone":"020-****0341","privacy_receiver_mobile":"137****0075"},["0424",0]]]",
        "mailno": "5300010219368",
        "status": "1",
        "remark": null,
        "msg": "订单修改成功"
    }]
}

【韵达】API开发者 微信交流群

用微信扫右侧二维码,加入【韵达】API开发者 交流群,互助沟通

扫码加入交流群
修改于 2021-11-10 04:26:26
上一页
电子面单余量查询接口
下一页
运单推送接口
Built with