韵达 API

电子面单更新接口

POST/v1/accountOrder/updateBmOrder

接口描述

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

pdf_info重点字段说明

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

请求参数

appid

string

必需

合作商appid（等同app-key）

partner_id

string

必需

韵达白马账号（合作网点提供）

secret

string

必需

韵达白马账号的联调密码（合作网点提供）

orders

array [object {22}]

订单详情

必需

collect_branch

string

揽件网点编码

可选

collection_value

number

可选

代收货款金额目前仅用于cod订单，cod订单必填

cus_area1

string

可选

可以自定义显示信息1，打印在客户自定义区域1，换行请用\n

cus_area2

string

可选

可以自定义显示信息2，打印在客户自定义区域2，换行请用\n

isProtectPrivacy

string

可选

判断订单是否是隐私订单，如果是隐私订单把收件人姓名和电话进行脱敏处理（1表示是，0表示否）隐私面单业务对接需与韵达方确认业务需求

items

array [object {3}]

商品信息集合

可选

khddh

integer

必需

大客户系统订单的订单号可与订单唯一序列号相同

node_id

string

350（默认）

必需

order_serial_no

integer

必需

订单唯一序列号由字母、数字、下划线组成，必须保证唯一，请对特殊符号进行过滤

order_type

string

必需

运单类型参数值对照order_type字典表可固定为common

platform_source

string

平台来源

可选

receiver

object

收件人

必需

remark

string

备注

可选

sender

object

寄件人信息

必需

size

string

物品大小(单位米)

可选

special

integer

可选

商品类型保留字段，暂时不用(见商品类型字段)

value

number

货物金额

可选

weight

number

物品重量

可选

wave_no

string

可选

客户波次号，按照此号进行批量打印校验，批量下单时，此波次号需要相同

other_charges

number

其他费用

可选

multi_pack

object

一票多件

可选

markingInfos

array [object {2}]

可选

增值服务标签增值服务必填，json字符串

{
  "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)

失败(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

code

string

响应编码

必需

message

string

响应内容

必需

result

boolean

是否成功

必需

data

array [object {7}]

返回对象信息

必需

order_serial_no

string

客户订单号

必需

pdf_info

string

必需

pdf参数信息（根据客户的需求返回json格式数据或对json格式进行加密后的数据

mail_no

string

运单号

必需

status

string

必需

返回状态，1表示成功，0表示失败

msg

string

必需

成功或者错误的提示信息

orderId

string

必需

remark

string | null

必需

{
    "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": "订单修改成功"
    }]
}

最后修改时间： 3 年前