第三方平台密文订单需要下单时,需要使用各平台的平台面单,具体操作说明如下:
以拼多多为例
(1)需要在第三方平台服务市场购买快递管家服务
购买地址: https://api.kuaidi100.com/document/5fc769198277665dce5373b3
找到拼多多版本的快递管家服务,点击购买
注:除了淘宝/天猫/菜鸟的电商平台面单,其余主流的电商平台例如京东,拼多多,抖音,小红书,微信视频号小店都需要购买快递管家服务,可以在第三方平台账号授权接口文档最下方的快递管家服务购买地址里购买
(2)登录平台店铺主账号,申请快递公司电子面单服务
登录拼多多的店铺主账号,在店铺后台申请发货地的快递公司电子面单服务
(3)授权店铺主账号,获取授权信息
一、 通过第三方平台账号授权接口1—第三方平台账号授权拼多多店铺主账号,这里需要设置回调地址(目前只支持http,https预计6月底支持),用来接收对应店铺的授权信息。回调地址设置如下:
1. 如在调试工具进行授权,callBackUrl可以随便填个网址,例如http://www.baidu.com/callback
2. 需要使用真实的回调地址接收数据,需要客户自己设置,通过第三方平台账号授权接口2—第三方授权回调接口,接收授权成功的账号信息,成功接收后需要响应成功:
{ "result": true, "returnCode": "200", "message": "成功" }
注:
1、微信小店授权不通过此步骤,具体步骤查看:
https://api.kuaidi100.com/document/65604542bf77fb0fc14e33cb
2、假如有两个不同的店铺,可以通过不同的订单号orderId去设置不同的回调地址以区分不同的店铺, 例如把回调地址定义为:http://www.xxx.com/callback/kd100?orderId=123456和http://www.xxx.com/callback/kd100?orderId=654321
二、这里以调试工具授权为例,net选择拼多多,callBackUrl填入一个回调地址,点击发送请求后
三、将返回的URL复制到浏览器打开,登录拼多多店铺主账号
四、授权成功后页面会显示parterId等账号信息
(4)查询店铺主账号绑定的网点&面单余额信息
在下单前,可以使用第三方平台账号授权接口3—第三方平台网点&面单余额接口可以获取到该授权账户对应的绑定网点信息以及账户可用单量,如下图为各网点信息。如同一快递有申请多个发货地址,则下单时使用通过传入tbnet(按{"tbnet":"xxxx"}入参)来区分使用哪个网点下单。
注:另外,不同平台加密订单针对于一些快递会有特殊的入参规则(例如顺丰速运等)
电商平台加密订单入参规则
| 电商平台加密订单入参规则 | |
|---|---|
| 淘宝、天猫、菜鸟 | 1、顺丰:通过code字段传入顺丰月结账号,店铺后台去获取,和网点面单的sf_secret不一样2、德邦:一个店铺只能绑定一个客户编码,不支持多个,如需绑定多个需德邦总部配置3、京东:code传店铺后台配置的商家编码,tbNet传面单余额接口查到的值 |
| 京东 | 1、通过tbnet区分顺丰多个月结账号2、京东商城订单使用京东快递发货,面单上收件人手机号不会解密,可以自定义参数替换,快递员扫描可以查看到真实号码 |
| 拼多多 | tbNet传SF,寄件地址传申请顺丰时填的地址,根据寄件地址匹配顺丰月结卡号 |
| 抖音 | 根据tbNet匹配顺丰月结卡号 |
| 快手 | 根据tbNet匹配顺丰月结卡号 |
(5)下单时调用电子面单接口
不同平台的脱敏面单的要求如下:
一、拼多多:https://api.kuaidi100.com/document/61f3a49823938d4eae8f6ebd
二、抖音:https://api.kuaidi100.com/document/61de9fc43907346e14ab2470
三、快手:https://api.kuaidi100.com/document/62bbf97ba94cfe0eb70d0580
四、京东:https://api.kuaidi100.com/document/61dea3ec70d0d629239afaf4
五、唯品会:https://api.kuaidi100.com/document/63194fc6679e082b523cc782
六、小红书:https://api.kuaidi100.com/document/65af86977f582c1e68c3cde2
七、微信小店:https://api.kuaidi100.com/document/65727418bf77fb0fc14e3934
八、淘宝/天猫/菜鸟:https://api.kuaidi100.com/document/61dea42570d0d629239afaf5
(6)面单打印
下单成功后接口会返回快递单号及面单链接,链接是接口实时返回,面单文件异步生成,待文件生成后可通过本地打印机进行打印。
注:电商平台除了京东无界面单(图片格式,png/jpg)在使用云打印时生成的面单链接的Content-Type都是application/pdf,获取到面单链接后通过面单链接Content-Type判断是否生成成功面单生成成功(application/pdf为成功,application/json为生成中或生成失败),区分于网点面单,printType实际上不起作用,使用的云打印机实际上等同于使用本地打印机。
(7)第三方平台自定义模板&模板自定义区域设置
面单文件由平台返回,由基础模板+自定义区域组成,如需在面单上显示额外的内容(如 物品名称、备注等),需要使用到自定义区域,具体操作如下:
thirdTemplateURL:第三方平台面单基础模板链接
thirdCustomTemplateUrl:第三方平台自定义区域模板地址
不需要用templd字段传值
不同平台的自定义模板设置如下:
一、 拼多多:
1.编辑器地址:
https://mms.pinduoduo.com/waybill/
2.动态参数格式
<%=data.key1%>
3.编辑器使用教程地址:
https://open.pinduoduo.com/application/document/browse?idStr=1B2FB0F64744AC04 二、 抖音:
1.编辑器地址:
https://cloudprint.douyinec.com/my-documents/templates
2.动态参数格式
<%=_data.remark%>
3.编辑器使用教程地址:
https://bytedance.feishu.cn/docs/doccnhDm5ODLURMEnav6COJ2bhb
三、 快手:
1.编辑器地址:
https://cloudprint.kwaixiaodian.com/page/fangzhou/customTemplate
2.动态参数格式
<%=_data.remark%>
3.编辑器使用教程地址:
https://docs.qingque.cn/d/home/eZQBvXHiBCgqBsV3HXRVNC6Yk?identityId=EqGyfV3eId
四、 京东:
1.编辑器地址:
https://template-design.jd.com/
2.动态参数格式
@{***}
3.编辑器使用教程地址:
https://api.kuaidi100.com/document/63359d83157aa6725f2bf20f
五、 唯品会:
https://api.kuaidi100.com/document/6385a42ab4eda216743a3f98
六、 小红书:
https://api.kuaidi100.com/document/65aa11107f582c1e68c3cbed
七、 微信小店:
https://api.kuaidi100.com/document/657282107f582c1e68c3b87c
八、 淘宝/天猫/菜鸟:
1.编辑器地址:
https://cloudprint.cainiao.com/print/templates.htm?tbpm=3&identity=xxx&appKey=xxx
2.动态参数格式
<%=_data.remark%>
3.编辑器使用教程地址:
https://open.taobao.com/doc.htm?docId=107014&docType=1
(8)面单增值服务
一、如若需要开启OCR,需要传needOcr字段,通过boolen方式确认是否开启,开启则必传ocrInclude值,不开启(默认)则不用
二、如果需要在第三方平台订单上设置打印纸参数时(只有第三方平台订单支持),打印时要设置,如下图