电子面单云打印接口
电子面单云打印接口，本接口为批量处理。 收件人信息需要传入收件人的明文信息或密文信息，如果只是想通过订单号，而不传收件人信息，则可使用电子面单云打印接口V2版本。
1.请求参数:
| 参数名 | 类型 | 说明 | 示例 |
|---|---|---|---|
| appid | String | 合作伙伴AppId | uwkahf@jfs92 |
| timestamp | String | 当前时间戳 | |
| seller_nick | String | 拼多多商家账号，非店铺名称 | kingdo |
| sign | String | 接口签名 | 如何计算生成见示例代码 |
| request_data | String | 必填 请求的获取电子面单的json数据 |
如果一次多个单号，将不同的订单加入到trade_order_info_dtos集合中，最多一次可以取100个单号。
2. 请求示例代码(Java)
@Test
public void PddWayBillGet() throws Exception {
String result ="";
String seller_nick = Config.PddSellerNick ; // 拼多多卖家账号
CloseableHttpClient httpclient = HttpClients.createDefault();
HttpPost httpPost = new HttpPost( Config.PddWayBillGetUrl );
//业务参数
Map<String, String> data = new HashMap<String, String>();
data.put("appid", Config.AppId);
data.put("seller_nick", seller_nick);
Long timestamp = System.currentTimeMillis() / 1000;
data.put("timestamp", timestamp.toString());
String requestData = "{" +
" \"sender\":{" +
" \"address\":{" +
" \"city\": \"上海市\", " + //必填 城市，仅支持非空值
" \"detail\": \"东方路221\"," + //必填 详细地址，仅支持非空值
" \"district\": \"浦东新区\"," + //必填 区，仅支持非空值
" \"province\": \"上海市\"," + //必填 省，仅支持非空值
" \"town\":\"陆家嘴街道\"" + //非必填，街道
" }," +
" " +
" \"mobile\":\"13816123344\"," + //非必填
" \"name\":\"李先生\"," + //必填 姓名
" \"phone\":\"\"" + //非必填
" }," +
" \"trade_order_info_dtos\":[" +
" {" +
" \"logistics_services\":\"\"," + //非必填 物流服务内容链接
" \"object_id\":\"1000\"," + //必填 请求id
" \"order_info\":{" +
" \"order_channels_type\":\"pdd\"," + // 必填 订单渠道平台编码
" \"trade_order_list\":[" +
" \"210317-001532562392221\"" + //必填 订单号,数量限制100
" ]" +
" }," +
" \"package_info\":{" +
" \"goods_description\":\"11\"," + //非必填 快运货品描述
" \"id\":\"10\"," + // 非必填 包裹id,拆合单使用
" \"items\":[" + // 必填 商品信息,数量限制为100
" {" +
" \"count\":1," + // 必填 数量
" \"name\":\"A4打印纸\"" + // 必填 名称
" }" +
" ]," +
" \"packaging_description\":\"A4打印纸的包装说明\"," + // 非必填 快运包装方式描述
" \"total_packages_count\":1," + // 非必填 子母件总包裹数
" \"volume\":22," + //非必填 体积, 单位 ml
" \"weight\":22" + //非必填 重量,单位 g
" }," +
" \"recipient\":{" +
" \"address\":{" +
" \"city\": \"上海市\", " + //必填 城市，仅支持非空值
" \"detail\": \"~AgAAAACjmWAIZ1vG5AG+pNSXy3yNfQqkPwX83TI8H0IYyf0f3qi8Bdzs2b5+nfKniLc2NB+tLVUhUMWwHkN8dg==~4Uc5fqNUxr5Sntd4fXM7UZAPXpVNVVXr~1~~\"," + // 必填 详细地址，仅支持非空值
" \"district\": \"浦东新区\"," + // 必填 区，仅支持非空值
" \"province\": \"上海市\"," + // 必填 省，仅支持非空值
" \"town\":\"陆家嘴街道\"" + // 非必填 街道
" }," +
" \"mobile\":\"$WsuJt4Yh3K7a$AgAAAACjmWAGZ1vG5ABLUicfAzPuXzSdjyz1biPoE6E=$1$$\"," +// 非必填
" \"name\":\"~AgAAAACjmWAFZ1vG5ABcHJJ+v1G1LcKH2BRzsYjGe/s=~niqTGhCNifXk~1~~\"," + //必填 姓名
" \"phone\":\"\"" +// 非必填
" }," +
" \"template_url\":\"https://file-link.pinduoduo.com/xlobo_std\"," + // 必填 标准模板模板URL
" \"user_id\":133214" + // 必填， 使用者ID
" }" +
" ]," +
" \"wp_code\":\"SF\"" +"}"; // 必填，物流公司Code
data.put("request_data", requestData);
// 参数签名
data.put("sign", Utils.Sign(data,Config.AppSecret));
List<BasicNameValuePair> params = new ArrayList<BasicNameValuePair>();
for (Map.Entry<String, String> entry : data.entrySet()) {
params.add(new BasicNameValuePair(entry.getKey(), entry.getValue()));
}
//发起POST请求
try {
httpPost.setEntity(new UrlEncodedFormEntity(params, "UTF-8"));
HttpResponse httpResponse = httpclient.execute(httpPost);
if (httpResponse.getStatusLine().getStatusCode() == HttpStatus.SC_OK) {
result = EntityUtils.toString(httpResponse.getEntity());
} else {
result = ("doPost Error Response: " + httpResponse.getStatusLine().toString());
}
} catch (Exception e) {
e.printStackTrace();
}
System.out.println(result);- 需要注意的是package_info中的id为包裹id ，请不要相同，否则会取到相同的面单号。
- 买家收件人信息，如手机、姓名、地址等传入密文或明文均可。买家收件人的手机、姓名、地址等密文在获取订单信息时已有返回。
- 取号时发货地址设置为账户网点对应发货地址。
- 其他更多信息可参考拼多多官方说明， 拼多多电子面单接入指南。
- 取得电子面单后，可用拼多多打印组件，将面单信息通过打印机打印到纸质上，如何使用拼多多打印组件
3. 返回结果如下：
限于篇幅，以下json为部分数据
{
"code": 0,
"message": "ok",
"data": [{
"object_id": "1000",
"print_data": {
"encryptedData": "33f9c81088363be9118c836fa863ef056422b4967a9e6ba68bc2a6592a49199de14dc29b11fc5c553190c93ce4b740906fe6cd6980d7a1ca52c09d731b29dff58c0754f6b69f0422c536cdeea71a4f3519af9058c37a5c3c48f2d4eca9e8ceaa4118b7373c1451252decb0bad1fdab200662e6c056d06f0da6da22323b530a1cd283d27d8d874d380c93a45d324c03c1a1d3062e0c54227552ec966608940e95e995436db0a2c144705c0aa9c61dcd6b39ebd06971c68f24a6b93ce4113e03b0943ba4d32f3239e743ba828a57df4dfeb9cb4cc835fe1480f8f6de228bca5b6a6bb33b2cb9453f63f984f2f974c7a7d7e62c8e3f0ae8c277b0f6efe7e873f240fa866882df95b0deb9cb4444d5884665a9b4d276450d8d904d220ba320ca77dd447908f85c853a9b65c7d2e67632cd7723daa80f8ddf31f17747e651383b4fb0ff5e71f2240ed432ca2daf74d7e5d71290bce7a52c94c1e64a538e1fa62e2244a512a0d9ffb0843867df240b5daffbad603c69d17207e6914b0faacf292f4ae947221da038de4389a6e69d8637632773d3f7b1f2111d0419849077740a9314446dce036685fa364c96fd46cbe274633d668941c4b1e4fb95983f906b172034413e778e2a67d72197582db31933920943aa5213caf2b143d94e7358074e969b16d5b94645d34e8f09542c8b369c4f0499f4ffdbfffeb7c71e5f107e8d9ce737fe692d4f8871d97225053ca22e1d65f596041f34d25e99cb1af42a40a72b70e3031ec0b63dd1976f2341196faee436e182b3c97c2ba69941454c5084ed3dfe732128ff5b4e375f4832b1a05c4ca8103ca87ce5be0cca99c711983c35938e3460b6462d05cbb93b5ce1aa92ff7b7b1fc390cb4d8beb087d0b749e974958c56cd7b1de0bea03266930d69a2f5ae60a60b0072ad859b2b63fbf02cdc3d8cd4b24f2d8100d15a7912783946b96f4b26bf4eb82c29f1dd4042a1abdb4348ab1afe5eff49fba15e7a7abcebeb04220aaf9fd5a6e3be0159401caa7dd23c7101ac863e813b8713d8b12ebc4c326909972cfec7e344631a15b57a4f8fe365fcfb80861ca409253941ae61d8cbfb8c11ad8b116dd4c596769ce65bc36c448f07b6ab9c1f3f9ee9d1f3f73ee7e0152f0b7f61bb6a2f0d3d828b7f7da6403b225e916aea92229eeac5686e6826900fc6ab518f19519a9198f8e51d8ccf5f299fa827aa02ddf0b95faec3b61ebf91ba81535f122938bebd1a49c61664e5e9f5a6b7632d9befec994cfb42b7b7bbeed44b62a327a0ea09d3132f4e407a513e015aaf2011d2674c3510536b252e1c16c2c8e0d034df05a6714f2cea253451b236422c0befd4dd9105ef5b95f93338496b1359f5baaf2be009b94f2aaa63249d3a3d912255d903008fbe8d44f3023994917dd172987fc88f5f90d18724bab03cdc0f99cea18fddbddc3e626e52a454ac861bb53f2ecd55c545cf27ff3047dd004dbeaba5b04d5ef97fce2fd1c98f517387a39c84cca68e3c89c4ad54fad166abb2b19d0f8ebebbc132c91d72a03a4b8cf295541941a8f189a4018974b54c4456eb8570bca06cc408f",
"signature": "Sz7RdCEvZWPFjPgq5WoYGiGOBcpiZ4toS93E9xFAspGv85BPKJKGf+Mrr6AEU96lNMuNoYwsjVUpEZyIPvv99tXm7EqQIKSalCIFnYpqQ+vb3TU641M4f1570K14skpJrAyYwvArTw1wGT0PdEEdR+8zQB5ATHRsRP+Dx/dGcn8=",
"templateUrl": "https://file-link.pinduoduo.com/xlobo_std",
"ver": "3"
},
"waybill_code": "SF1310995855392"
}]
}返回字段说明
object_id ： 请求id，此id为开发者请求时的id,用于返回时标识哪个对象。
parent_waybill_code ： 快运母单号
print_data ： 面单信息
waybill_code STRING ： 面单号说明： code为0表示成功，非0为失败，message会包含失败原因。失败时一定要注意，可能商户授权过期，或是参数有误。
常见问题
1.电子面单支持给别的店铺获取面单吗？
回答 ：支持，举例：A店铺开通电子面单账号，想要用A店铺的面单打印B店铺的订单，在取号调用pdd.waybill.get接口时入参A店铺的账号然后user_id入参B店铺的pdduserid即可
2. 接口返回”发货地址非法”的错误
发货地址必须和店铺后台申请电子面单时的地址完全一致，省市区分别入参相应字段，其余入参detail字段；具体地址可在店铺后台查看或通过查询面单服务订购及面单使用情况接口获取
3. 使用pdd.waybill.get获得面单信息后怎么对接到云打印组件？
请参阅开放平台文档“电子面单”部分“云打印交互协议”https://open.pinduoduo.com/application/document/browse?idStr=3BBB4C229B6A8FCC
4. 顺丰取号时，提示“有必选的增值服务没有选择”
顺丰取号时，需要在logistics_services里增加如下相关参数。
{
"logistics_services":{
"TIMED-DELIVERY": {
"value": "2"},//时效产品
”INSURE": {
"value": "510.1"}//保价
}
} 注意代码中传值格式为："logistics_services": "{\"TIMED-DELIVERY\": {\"value\": \"247\"}}"
注意事项：
时效产品不传值则默认为“顺丰特快”；
【保价】服务需要传具体的报价金额，单位为“元”，精确到小数点后1位；
支持的时效产品可在pdd.waybill.search接口获取到；
5. 支持丰网吗
支持的，wp_code传入FENGWANG
文档更新时间: 2023-06-26 18:00 作者：admin
