全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
电子面单云打印接口
接口地址: http://api.vv-tool.com/tool/erps/pdd-waybill
接口介绍: 电子面单云打印接口。点击查看详情
必须用户授权 : 需要用户的授权,才能拿到被授权的数据
请求方式: POST
返回格式: JSON
接口收费: 请求次数收费,联系运营
频率限制: 10 次/秒
请求头参数
参数 | 类型 | 必选 | 值 | 示例 |
---|---|---|---|---|
Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请求参数
参数 | 类型 | 必选 | 描述 |
---|---|---|---|
owner_id | INT | 必填 | 店铺 id |
param_waybill_cloud_print_apply_new_request | OBJECT | 必填 | 入参信息 |
need_encrypt | BOOLEAN | 非必填 | 设定取号返回的云打印报文是否加密 |
sender | OBJECT | 必填 | 发货人信息 |
address | OBJECT | 必填 | 地址 |
city | STRING | 必填 | 城市,仅支持非空值 |
country | STRING | 非必填 | 国家/地区 |
detail | STRING | 必填 | 详细地址,仅支持非空值 |
district | STRING | 必填 | 区,仅支持非空值 |
province | STRING | 必填 | 省,仅支持非空值 |
town | STRING | 非必填 | 街道 |
mobile | STRING | 非必填 | 手机号码 |
name | STRING | 必填 | 姓名 |
phone | STRING | 非必填 | 固定电话 |
trade_order_info_dtos | OBJECT[] | 非必填 | 请求面单信息,数量限制为 10 |
logistics_services | STRING | 非必填 | 物流服务内容链接 |
object_id | STRING | 必填 | 请求 id |
order_info | OBJECT | 必填 | 订单信息 |
order_channels_type | STRING | 必填 | 订单渠道平台编码 拼多多-PDD,淘宝-TB,天猫-TM,京东-JD,阿里巴巴-ALBB,有赞-YZ,微店-WD,蘑菇街-MGJ,云集-YJ,贝贝网-BB,转转-ZZ,快手小店-KS,当当网-DD,小米有品-XMYP,寺库-SK,聚美优品-JM,蜜芽-MY,小红书-XHS,萌推-MT,唯品会-WPH,拍拍-PP,ebay-EBAY,亚马逊-AMAZON,苏宁-SN,国美-GM,1 号店-YHD,凡客-VANCL,邮乐-YL,优购-YG,乐蜂-LF,聚尚-JS,拍鞋-PX,银泰-YT,抖音-DY,其他-OTHERS |
trade_order_list | STRING[] | 必填 | 订单号,数量限制 100 |
package_info | OBJECT | 必填 | 包裹信息 |
goods_description | STRING | 非必填 | 快运货品描述 |
id | STRING | 非必填 | 包裹 id,拆合单使用 |
items | OBJECT[] | 必填 | 商品信息,数量限制为 100 |
count | INTEGER | 必填 | 数量 |
name | STRING | 必填 | 名称 |
packaging_description | STRING | 非必填 | 快运包装方式描述 |
total_packages_count | INTEGER | 非必填 | 子母件总包裹数 |
volume | LONG | 非必填 | 体积, 单位 ml |
weight | LONG | 非必填 | 重量,单位 g |
recipient | OBJECT | 非必填 | 收件人信息 |
address | OBJECT | 必填 | 地址 |
city | STRING | 必填 | 城市,仅支持非空值 |
country | STRING | 非必填 | 国家/地区 |
detail | STRING | 必填 | 详细地址,仅支持非空值 |
district | STRING | 必填 | 区,仅支持非空值 |
province | STRING | 必填 | 省,仅支持非空值 |
town | STRING | 非必填 | 街道 |
mobile | STRING | 非必填 | 手机号码 |
name | STRING | 必填 | 姓名 |
phone | STRING | 非必填 | 固定电话 |
template_url | STRING | 必填 | 标准模板模板 URL |
user_id | LONG | 必填 | 使用者 ID |
wp_code | STRING | 必填 | 物流公司 Code |
vvtype | INT | 非必填 | 默认:1 1:增强版 增强版专属,3:专业版 |
请求示例
{
"owner_id": "23312123",
"param_waybill_cloud_print_apply_new_request": {
"need_encrypt": "true",
"sender": {
"address": {
"province": "啊啊省",
"city": "啊啊市",
"district": "啊啊县",
"detail": "啊啊啊啊啊"
},
"mobile": "12312321312",
"name": "嗷嗷嗷"
},
"trade_order_info_dtos": [{
"logistics_services": null,
"object_id": "1212",
"order_info": {
"order_channels_type": "PDD",
"trade_order_list": ["211215-2132131231"]
},
"package_info": {
"items": [{
"count": "1",
"name": "打印"
}]
},
"recipient": {
"address": {
"detail": "啊啊啊啊啊啊啊",
"province": "啊啊省",
"city": "啊啊市",
"district": "啊啊区"
},
"name": "啊啊啊",
"mobile": "23213213123"
},
"template_url": "https://file-link.pinduoduo.com/yto_one",
"user_id": 123
}],
"wp_code": "YTO"
}
}
请求代码示例
cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
Pyton请求代码示例
响应参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
pdd_waybill_get_response | OBJECT | response | |
modules | OBJECT[] | 系统自动生成 | |
object_id | STRING | 请求 id | |
parent_waybill_code | STRING | 快运母单号 | |
print_data | STRING | 面单信息 | |
waybill_code | STRING | 面单号 | |
withholding_money | int | 该接口扣费金额(点券) |
返回数据
{
"code": 0,
"msg": "操作成功",
"msec": 586,
"time": 1640660672,
"data": {
"pdd_waybill_get_response": {
"request_id": "12332131233",
"modules": [
{
"print_data": "{\"encryptedData\":\"a67321321313bzEMdtDemOttWObODjRglg22W0=\",\"templateUrl\":\"https://file-link.pinxxxxxxxxxxx_one\",\"ver\":\"3\"}",
"waybill_code": "YT991213212",
"object_id": "123"
}
]
},
"withholding_money": 1
}
}
响应代码
代码 | 代码描述 | 解决方案 |
---|---|---|
0 | 成功 | |
100 | 请求参数错误 | 检查您的请求参数是否正确 |
101 | 请求超时,请重试 | 检查您的网络情况或者联系客服解决 |
103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
200 | 系统错误,请联系客服 | 检查您的接口地址填写是否正确,其他问题联系客服解决 |
203 | 暂不支持当前接口 | |
204 | 请求异常:无该接口权限,请前往官网开通正式接口。 | 前往官网开通该接口权限 |
204 | 请求异常:API 调用次数不足,请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
302 | 未授权店铺 | 根据返回链接进行扫码授权 |