更新面单

POST/ark/open_api/v3/common_controller

请求参数

cpCode

string

快递公司编码

必需

waybillCode

string

快递单号

必需

objectId

string

请求id

必需

logisticsServices

string

可选

增值服务,见对接说明附录物流增值服务

packageInfo

object

可选

items

array [object {3}]

商品信息

可选

volume

string

体积, 单位 ml

可选

weight

string

重量,单位 g

可选

length

string

包裹长，单位厘米

可选

width

string

包裹宽，单位厘米

可选

height

string

包裹高，单位厘米

可选

recipient

object

可选

address

object

可选

mobile

string

可选

手机号码，明文或者密文

name

string

姓名，明文或者密文

可选

phone

string

电话号码

可选

openAddressId

string

可选

用来查询收件人详情，需要和orderId匹配使用

sender

object

可选

mobile

string

手机号码，明文

可选

name

string

姓名，明文

可选

phone

string

电话号码

可选

templateId

string

电子面单模板ID

可选

{
  "cpCode": "",
  "waybillCode": "",
  "objectId": "1",
  "logisticsServices": "",
  "packageInfo": {
    "items": [
      {
        "count": "",
        "name": "",
        "specification": ""
      }
    ],
    "volume": "",
    "weight": "",
    "length": "",
    "width": "",
    "height": ""
  },
  "recipient": {
    "address": {
      "city": "",
      "detail": "",
      "district": "",
      "province": "",
      "town": ""
    },
    "mobile": "",
    "name": "",
    "phone": "",
    "openAddressId": ""
  },
  "sender": {
    "mobile": "",
    "name": "",
    "phone": ""
  },
  "templateId": ""
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

error_code

string

错误码

必需

error_msg

string

错误描述

必需

success

string

请求是否成功

必需

data

object

必需

waybill

object

必需

subErrorCode

string

子错误码

必需

{
  "error_code": "",
  "error_msg": "",
  "success": "true",
  "data": {
    "waybill": {
      "objectId": "1",
      "waybillCode": "78689455849606",
      "printData": "{\\\"encryptedData\\\":\\\"打印数据密文\\\",\\\"signature\\\":\\\"MD:lH0r2gNxcIuY7dY3VvV4ag==\\\",\\\"templateURL\\\":\\\"http://cloudprint.cainiao.com/template/standard/644703\\\",\\\"ver\\\":\\\"waybill_print_xiaohongshu_secret\\\"}",
      "parentWaybillCode": "",
      "extraInfo": "",
      "cpCode": "",
      "customerPrintData": "{\\\"data\\\":{\\\"item\\\":[\\\"商品名称\\\"],\\\"order\\\":[\\\"P000000001\\\"]},\\\"templateURL\\\":\\\"https://cloudprint.cainiao.com/template/standard/629505/24\\\"}"
    },
    "subErrorCode": ""
  }
}

最后修改时间： 1 年前