快递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的记录。