全部
电子面单
物流轨迹
物流发货
在线测试

菜鸟电子面单云打印更新接口


接口地址: http://api.vv-tool.com/tool/erps/cnUpdateElectronicSheet


接口介绍: 商家更新电子面单号对应的面单信息。


请求方式: POST


返回格式: JSON


接口收费: 联系客服


频率限制: 10 次/秒


请求头参数

参数 类型 必选 示例
Authorization string 授权 access_token Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx

请使用新的生成 token 接口 点击查看详情

请求参数

参数 类型 必选 描述
account_id string 面单 id
data object 数据
--cpCode string 物流公司 CODE
--waybillCode string 面单号
--objectId string 请求 ID(只限传入数字、字母和下划线)
--logisticsServices string 物流服务值
--packageInfo PackageInfoDto 包裹信息
----items List 商品信息,数量限制为 100
------items Item 商品信息
--------count int 数量
--------name string 名称
----volume long 体积, 单位 ml
----weight long 重量,单位 g
--recipient Recipient 收件人信息
----address AddressDto 发货地址
--------city string 城市
--------detail string 详细地址
--------district string
--------province string
--------town string 街道
----mobile string 手机号码
----name string 姓名
----phone string 固定电话
--sender Sender 发件人信息
----mobile string 手机号码
----name string 姓名
----phone string 固定电话
--templateUrl string 云打印标准模板 URL

请求示例

{
  "account_id": "123456",
  "data": {
    "cpCode":"POSTB",
    "logisticsServices":"json串",
    "sender":{
        "phone":"057123222",
        "mobile":"1326443654",
        "name":"Bar"
    },
    "recipient":{
        "address":{
            "province":"北京",
            "town":"望京街道",
            "city":"北京市",
            "district":"朝阳区",
            "detail":"花家地社区卫生服务站"
        },
        "phone":"057123222",
        "mobile":"1326443654",
        "name":"Bar"
    },
    "waybillCode":"9890000160004",
    "packageInfo":{
        "volume":"1",
        "weight":"1",
        "items":[
            {
                "count":"1",
                "name":"衣服"
            }
        ]
    },
    "objectId":"1",
    "templateUrl":"http://cloudprint.cainiao.com/template/standard/101"
},
}

请求代码示例

cURL请求代码示例

PHP请求代码示例


JAVA请求代码示例


响应参数

名称 类型 示例值 描述
code int 返回状态码
msg string 返回码描述
msec int 接口执行时间
time int 接口返回时间
data object 数据信息
--data String x 云打印内容
--templateURL String x 云打印标准模板 URL
--withholding_money int 该接口扣费金额(点券)

返回数据

{
  "code": 0,
  "msg": "操作成功",
  "msec": 1469,
  "time": 1617270403,
  "data":{
        "withholding_money":1,
        "data":"",
         "templateURL":"http://cloudprint.cainiao.com/template/standard/101"
    }
}

响应代码

代码 代码描述 解决方案
0 成功
100 请求参数错误 检查您的请求参数是否正确
101 请求超时,请重试 检查您的网络情况或者联系客服解决
103 旺旺账号不存在 检查您输入的旺旺号是否正确
200 系统错误,请联系客服 检查您的接口地址填写是否正确,其他问题联系客服解决
203 暂不支持当前接口
204 请求异常:无该接口权限,请前往官网开通正式接口。 前往官网开通该接口权限
204 请求异常:API 调用次数不足,请前往网站兑换次数。 前往官网充值该接口调用次数
302 未授权店铺 根据返回链接进行扫码授权