电子面单更新
200
1
1
0
封面图
REQUEST URL
POST
发送
请求 Header
参数名
类型
必填
参数示例
说明
app-key
string
是
开放平台发放
sign
string
是
签名说明参看附录《鉴权说明》
req-time
string
是
当前时间戳(毫秒)
请求 Body
{ "appid": "合作商appid(等同app-key)", "partner_id": "韵达白马账号(合作网点提供)", "secret": "韵达白马账号的联调密码(合作网点提供)", "orders": [ { "collect_branch": "揽件网点编码", "collection_value": "代收货款金额 目前仅用于cod订单,cod订单必填", "cus_area1": "可以自定义显示信息1,打印在客户自定义区域1,换行请用\\n", "cus_area2": "可以自定义显示信息2,打印在客户自定义区域2,换行请用\\n", "isProtectPrivacy": "判断订单是否是隐私订单,如果是隐私订单把收件人姓名和电话进行脱敏处理(1表示是,0表示否)隐私面单业务对接需与韵达方确认业务需求", "items": [ { "name": "商品名称 cod订单必填", "number": "数量", "remark": "说明" } ], "khddh": "大客户系统订单的订单号可与订单唯一序列号相同", "node_id": "350(默认)", "order_serial_no": "订单唯一序列号 由字母、数字、下划线组成,必须保证唯一,请对特殊符号进行过滤", "order_type": "运单类型参数值对照order_type字典表可固定为common", "platform_source": "平台来源", "receiver": { "address": "详细地址 必须添加省市区并以半角逗号隔开", "city": "收件人市", "company": "收件人公司", "county": "收件人区/县", "mobile": "手机号", "name": "收件人姓名", "province": "收件人省份", "phone": "固定电话固定电话或移动电话至少填一项" }, "remark": "备注", "sender": { "address": "详细地址 必须添加省市区并以半角逗号隔开", "city": "寄件人市", "company": "寄件人公司", "county": "寄件人区/县", "mobile": "手机号", "name": "寄件人姓名", "province": "寄件人省份", "phone": "固定电话 固定电话或移动电话至少填一项" }, "size": "物品大小(单位米)", "special": "商品类型保留字段,暂时不用(见商品类型字段)", "value": "货物金额", "weight": "物品重量", "wave_no\t": "客户波次号,按照此号进行批量打印校验,批量下单时,此波次号需要相同", "other_charges": "其他费用", "multi_pack": { "mulpck": "是否一票多件一票多件必填 是:填1; 否:空,不填 (必须走增值服务才能生效{\"type\":\"MUL\",\"markingValue\":{\"value\":10(总单量)}})", "total": "总包裹数量:当最后一件时,传输此值", "endmark": "结束标记,当最后一件时,传输此值 0:否,1:是" }, "markingInfos": [ { "type": "", "markingValue": { "value": "" } } ] } ] }
返回成功示例
{ "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": "订单修改成功" }] }
返回失败示例
{ "result": false, "code": "7777", "message": "内部接口服务失败", "sub_code": "s10", "sub_msg": "参数校验不合法" }
散件下单
POST
散件下单接口
POST
散单取消接口
POST
预估运费接口
POST
运单推送接口
物流轨迹
POST
物流轨迹订阅
GET
物流轨迹查询
GET
物流轨迹推送
国际件
GET
国际进口下单接口
电子面单
POST
电子面单更新
POST
电子面单余量查询接口
POST
电子面单下单
POST
电子面单取消
返回顶部
留言
留言
评论