全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试

电子面单云打印接口


接口地址: http://www.yunyingtool.com/papi/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 未授权店铺 根据返回链接进行扫码授权