快递100电子面单V2模板使用简介
金蝶云星空供应链领域销售模块预计在2023年4月发布的正式补丁中支持快递100V2模板,届时客户升级后将支持两种电子面单模板,即V1和V2版本的快递100模板,V1模板为星空原有的功能,V2为新增功能。本文将简单地介绍下如何配置。首先打开快递100参数配置界面,在电子面单通用设置中将多出三个字段,分别为模板版本,V2子模板,V2签回单模板,这三个字段和原有的模板字段共同指定对接快递100何种接口,如下图1-1所示:
图1-1
这里需要注意的是,配置'模板'和'模板版本'字段时一定要对应的上,即不能配置模板版本为V2,但里面的模板值又是V1的模板,至于是V1还是V2模板可以通过快递100官网上找到。当模板版本配置为V1时(或者升级后默认为空时也代表为V1模板),则可以对接快递100三种接口,即电子面单HTML接口,电子面单图片接口,电子面单打印接口。如果模板字段和设备码字段都不输入,则对接的是快递100电子面单HTML接口,如果模板字段有值(且模板版本为V1或模板版本为空)但设备码字段无值,则对接的是快递100电子面单图片接口,如果模板字段(且模板版本为V1或模板版本为空)和设备码都有值,则对接的是快递100电子面单打印接口。快递100V1版本的电子面单接口官方介绍如下图1-2所示:
图1-2
当且仅当模板版本字段为V2,且模板字段有值时(下文将此条件引用为V2基础条件)才正式切换成V2版本的电子面单接口,当V2基础条件满足时,如果设备码有值,则在获取电子面单时请求快递100 V2版本的电子面单接口中的参数printType将被置为CLOUD。当V2基础条件满足时,如果设备码没有值,则printType将被设置为IMAGE,快递100V2版本的电子面单官方接口文档说明如下图1-3所示:
图1-3
当printType为IMAGE时,会在生成的电子面单中的'电子面单链接'字段中保存有相关URL地址,可通过浏览器打开相关URL地址并通过浏览器进行打印,当然如果配置有签回单或子单时,相关信息也会保存在电子面单基础资料中的'回单号链接'字段和'子单详细信息'中。当printType为CLOUD时,则'电子面单链接'字段无值(因为这是通过快递100打印机自动打印的),星空是通过电子面单基础资料中的'快递100电子面单版本'字段来区分是V1还是V2版本的,下图2-1为不同快递100参数配置生成的不同类型的电子面单:
图2-1
从上面的介绍信息可以看出,V2版本的电子面单默认在星空是不支持HTML接口(即printType为HTML),如果客户想对接电子面单V2版本的HTML接口(V2版本的电子面单HTML和IMAGE接口都是返回一个URL链接,这与V1版本接口是有区别的,V1版本中的电子面单图片接口是返回一个图片,没有链接),则可以在获取电子面单界面中的扩展属性中输入{"printType": "HTML"},当在扩展属性中输入{"printType": "NON"} 时,则只下单不打印。如下图2-2所示:
图2-2
如果客户混合使用快递100 V1和V2 版本的电子面单打印接口,则在电子面单列表中重复打印时要记住不能混合复打,即同一批次复打时要么都只勾选'快递100电子面单版本'字段为V1的记录(为空时也是V1),要么都只勾选V2的记录。
快递100电子面单V2模板使用简介
本文2024-09-23 02:47:34发表“云星空知识”栏目。
本文链接:https://wenku.my7c.com/article/kingdee-k3cloud-154739.html