金蝶云-快递100参数配置与功能说明需求场景：涉及到快递100的两个接口：A.快递接口API,分基础版和企业版；B.快递管家API，分导入服务和推送服务。1、只需查询物流信息并刷新回金蝶云上,需手工维护好单据上的快递公司和快递单号。2、申请电子面单，然后得到电子面单链接，在浏览器中打开链接右键可实现打印，但无法批量打印。2021-3-25补丁支持按模板批量打印。3、导入快递管家，批量打印电子面单，自动回填快递单号到单据上，实时更新物流信息到金蝶云。以下是对应3种场景所需配置的情况：场景是否配置查询物流申请电子面单订单导入快递管家，批量打印电子面单，回填快递单号快递100参数配置公司编号(customer)√√授权秘钥(comkey)√√电子面单授权key√电子面单秘钥(secret)√快递管家参数配置快递管家授权key√快递管家秘钥(secret)√快递公司电子面单参数配置√一、获取快递物流信息到（销售订单，发货单，销售出库单）：1、参数配置：配置如下：实时查询customer，客户授权Key，分别填到金蝶云快递100参数的公司编号和授权秘钥中1/36参数来源：2、参数来源获取方式：2.a、授权信息申请方法如下，https://api.kuaidi100.com/register/enterprise,注册企业版帐号2.b、申请通过后，直接使用刚申请的用户名和密码在页面https://api.kuaidi100.com/login进行登录，进入企业管理后台，在【我的信息】中的【企业信息】里面查看参数2/362.c、将上面的实时查询customer，客户授权Key，分别填到金蝶云快递100参数的公司编号和授权秘钥中。3、功能说明：获取快递单号，有两种方式：1、申请电子面单后自动回填快递单号；2、导入快递管家后打印快递单时自动回填快递单号。3/363.1申请电子面单除了维护授权信息外，还需将上面的客户授权Key，电子面单secret，分别填到电子面单授权key和电子面单密钥(secret)中，并且维护快递公司电子面单参数配置中的电子面单（月结）账号密码等信息，电子面单（月结）账号密码需用户单独向合作的快递公司索取。然后打开获取电子面单，在明细中点击单据编号，选择返回数据，然后点击申请电子面单即可进行申请3.2申请成功后打开列表可以看到快递单号回填到单据上了，并且多了一个电子面单链接。4/363.3在浏览器中打开电子面单链接，如图3.4通过申请电子面单获取物流单号到单据上后，通过物流查询跳转到销售物流信息列表。此外手工维护好物流公司和物流单号，也是可以刷新物流信息回来的。5/363.5销售物流信息列表，点击刷新物流信息，即可将物流信息更新回金蝶云系统中。3.6支持子母单返回，在获取电子面单中，维护物品数量，并勾选是否需要子单，然后点击申请电子面单。即可返回子单，例如录5则返回母单1个，子单4个3.7支持签回单，在获取电子面单中勾选“是否需要签回单”即可6/364、其他选项参数说明：4.a定时更新销售物流信息并进行时间范围控制勾选该参数后，只要单据上维护好了物料跟踪信息，则金蝶云系统自动按执行计划“销售物流更新”获取单据的物流信息。这样就不用手工去销售物流信息列表上刷新物流信息。4.b控制范围内的天数：设置每次获取单据的时间范围（最多只能设置30天）；如果设置7天，则系统根据业务单据的日期判断7天内的业务单据则更新物流信息。4.c出库单保存回填上游通知单、订单物流单号和公司勾选该参数，则在销售出库单上填写的物流单号等的物流信息可以自动回填到销售订单、发货通知单。5、更新更好的获取物流方式：除上面获取物流信息的方式外，推荐使用快递管家的推送服务，可以实现自动实时更新物流信息。文档后面的快递管家充值中有介绍。7/36二、导入快递管家并打印电子面单说明：1、参数配置：配置如下：参数来源：2、参数来源获取方式：2.a、注册快递100并登陆，找到快递管家2.b、打开快递管家首页后，找到API服务进入8/362.c、点击开发者接口申请-立即申请置，填写资料查看APIkey即可。2.d、然后将上面的APPkey和APPSecret填回金蝶云快递管家参数配置中。3、回调接口配置：除了在金蝶云中快递100参数配置快递管家的APIKey外，还需要设置回调url，位置：快递管家-更多-API服务-AppKey管理-回调url9/36回调url地址格式:网站域名/k3cloud/ScmKuaidiService/Kuaidi100HttpHandler?Action=CallBackReault示例：http://app.kd.com/k3cloud/ScmKuaidiService/Kuaidi100HttpHandler?Action=CallBackReault注意区分http和https，例如“公有云”配置快递管家回调url，需用https，即https://xxx.com/k3cloud/ScmKuaidiService/Kuaidi100HttpHandler?Action=CallBackReault4、快递管家充值说明：共两种服务，订单导入和订单导入+推送服务。推荐购买订单导入+推送服务，因为它不仅包含了导入服务的功能，另外即使没有申请授权信息，在快递管家打印快递单后，如物流信息发生变化，能实现自动实时更新物流信息到金蝶云销售物流信息列表和单据的物流跟踪页签上。而不用去勾选“定时更新销售物流信息并进行时间范围控制”参数。即比原来的定时更新服务，能更及时地更新的快递物流状态。10/365、导入与打印功能说明：4.a、除了快递管家key和secret设置外，下面的默认寄件信息也需设置。4.b在获取电子面单中选择要导入至快递管家的订单信息点击“快递管家订单导入”按钮即可完成订单导入功能。4.c收件人和寄件信息说明：收件人信息来源单据上的收货方信息，寄件人信息来源快递100参数中设置的默认寄件人信息。11/364.d导入成功后，点击列表，即可以看到电子面单列表中多一条记录。并且登录快递管家的待打印页签也多一条记录，点击打印快递单打印完后会回填快递单号到电子面单列表和单据物流跟踪页签上。12/366、电子面单列表打印操作：跳转打印，自动打印，自动打印（云设备）。6.a跳转打印：就是跳转到快递管家官网并弹出快速打印窗口。具体操作如下所述：（1）在获取电子面单中选择要导入至快递管家的订单信息点击快递管家订单导入按钮将订单信息导入至快递管家（2）点击获取电子面单上的列表按钮，前往申请电子面单列表中需要打印的相关面单信息，在业务操作按钮下选择跳转打印，会弹出一个提示框，请点击打开，会在浏览器中直接打开一个页签窗口，并弹出快速打印窗口，选择物流公司、打印模板和打印机。点击立即打印即可完成量申请面单、打印并回填物流公司、物流单号至相关单据和电子面单列表上。13/366.b自动打印：提供自动打印快递单服务，无须页面嵌套，无须弹出快速打印窗口，但必须购买快递100云盒，并在快递管家中绑定快递100云盒，并启用”自动打印“功能设置。方便快捷地进行快递单打印。打印时在金蝶云系统发起打印操作，即可完成批量申请面单、打印并回填物流公司、物流单号至相关单据和面单列表上。具体操作如下所述：（1）登录快递管家，购买快递100云盒，并在快递管家中绑定快递100云盒，并启用”自动打印“功能设置及设置相应的默认打印模板（一次性配置即可）14/36（2）在获取电子面单中选择要导入至快递管家的订单信息，点击快递管家订单导入按钮将金蝶云订单信息导入至快递管家15/36（3）点击获取电子面单上的列表按钮，前往申请电子面单列表中需要打印的相关面单信息，在业务操作按钮下选择自动打印，即可完成批量申请面单、打印并回填物流公司、物流单号至相关单据和面单列表上，打印完成之后请刷新电子面单列表查看物流单号信息是否正确回填至面单列表，如下图所示：6.c自动打印（云设备）存在多个云打印机时，使用该方式打印，可以选择指定某台云打印机进行打印。16/36三、补充说明：1.因快递100企业API接口参数变动，顺丰获取物流信息需提供寄件人手机号码获取顺丰物流信息，金蝶云相关单据获取物流信息调用快递100企业API接口时必须需提供寄件人的手机号码。2.百世baishiwuliu，在金蝶云上要用汇通huitongkuaidi，才能正常获取物流信息。3.打印物料清单。要使用“快递管家订单导入”，导入快递管家，在打印快递单后，可以使用“快递管家小程序”扫码拣货功能，查看物品清单并打印等，手机端已经不支持了，只支持在电脑端打印发货单。打印后的物品清单如下图所示。17/364.物流跟踪页签的起始地点和终止地点字段用于精确获取同城件物流状态，需要手工输入。例如深圳南山区寄-深圳宝安区收，起始地点为深圳南山区，终止地点为深圳宝安区。5.快递100参数配置，收件人信息设置，增加自定义字段，如图。对应单据类型设置自定义信息后，获取电子面单选单时，需要把关联的字段展示在单据列表，这些字段值才会根据所有单据携带显示在获取电子面单界面18/36四、新增功能：2020-11-26电子面单参数增加【模板，功能控制，快递类型，组织】字段1、维护【模板】参数，在申请电子面单后，系统打开电子面单可以直接显示面单。参数编码来源快递100后台中的电子面单模板编码2、维护【功能控制】字段，例如输入sf_srcret，表示启用顺丰的丰密面单，其他快递公司是否必录可以参考快递100API帮助文档中电子面单的参数字典中的code字段https://api.kuaidi100.com/help/doc?code=5f0ff6e82977d50a94e10237&openKey=%E7%94%B5%E5%AD%90%E9%9D%A2%E5%8D%9519/363、维护【快递类型】字段，则在获取电子面单中，自动带出对应快递公司的快递类型，支持手工修改。申请电子面单后，在浏览器中打开申请电子面单后回填的电子面单链接，会显示快递类型，例如顺丰的“限时KC24”。具体快递公司的快递类型同样可以在上面的快递100API帮助文档中找到20/364、维护【组织】字段，电子面单参数中相同快递公司但是有多个电子面单账号，应用在不同的组织，则可以通过维护组织字段来指定专门的使用组织2021-03-25电子面单参数增加【设备码，商家名称，客户秘钥，检视员】字段21/36使用设备码功能，需购买快递100二代打印机。设备码位于打印机底部的标签中的SERIALNO.（序号）。维护【模板】字段，再维护【设备码】字段。打印机设置运行正常后，在获取电子单中点击“申请电子面单”即可获取电子面单的同时，根据设置好的模板打印出纸质版面单。2021-04-25获取电子面单增加【保价金额，代收货款额度】字段22/362021-05-25快递100参数设置增加自定义设置页签，支持自定义设置2021-06-25快递100参数设置增加启用日志功能，默认不显示，不启用，需在BOS扩展设为可见。此功能用于记录日志排查问题，日常使用不推荐启用。23/362021-06-25快递100API，增加重量和体积参数对接，在获取电子面单中，选择单据后，默认携带物料上的重量体积2021-10-21增加电子面单重复打印接口对接，在“电子面单列表”内增加重复打印按钮2021-11-04增加国际下单接口对接，包含UPS、DHL、FedEx等1.首先维护好电子面单参数2.打开“获取电子面单（国际）”，手工返回单据，并维护好收件人，寄件人等信息后，点击申请国际电子面单，申请成功后，直接点击列表，就可以打开国际电子面单列表；另外可以通过电子面单列表的下拉按钮“国际电子面单列表”同样可以打开。24/363.申请成功后会返回电子面单URL，一般都是PDF文档格式，下载后再打印即可。---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------2022-03-31增加物流推送服务接口1.首先维护好快递100参数配置的物流推送回调地址。25/362.销售物流信息列表中，增加了“物流推送配置”菜单项。2.点击“物流推送配置”，跳转到销售物流信息自动推送订阅方案列表，会显示已有的订阅方案，可以根据需要新增订阅方案。3.新增界面中选择“过滤方案”字段，可选择已有的过滤方案，也可以如下图操作步骤新增过滤方案。26/364．新增的销售物流信息自动推送订阅方案没有任何记录，也不能手工输入。需要后台通过执行计划“快递100物流推送订阅”自动刷新，执行计划会在后台查询订阅方案列表中所有已审核且未禁用的订阅方案。然后根据订阅方案中的过滤方案查询对应的销售物流信息列表，从销售物流信息中获取物流单号和快递公司进行订阅。（如果订阅方案中的订阅记录的订阅标识为成功，不会重复订阅）本执行计划默认未开启，新增推送订阅方案后需手工开启此执行计划，设置任务状态为准备并测试，执行计划每天执行一次。注意事项：1.同一星空账套的同一物流单号只会订阅一次，已成功订阅的物流单号的物流信息更新时，会通过回调地址实时更新物流详细信息。快递100官网企业管理后台的实时订阅与订阅推送的数据明细中可查询哪些物流单号已订阅和推送成功。2.建议过滤方案用单据日期当条件，比如单据日期在今天之前的30天内。3.使用此功能时建议禁用执行计划中的“销售物流更新”，否则可能会存在重复收费情况。详情请参阅：https://vip.kingdee.com/article/2230338556188945922022-06-30增加快递100复打功能增加快递100重复打印、快递100签回单复打、快递100子单复打功能，入口如截图27/361、快递100复打功能，仅支持打印接口生成的电子面单不符合的面单重复打印部分提示如截图2、如果是之前版本的电子面单打印接口生成的电子面单，回单及子单复打功能则提示仅在2022.7月之后的版本才支持（子单、回单为空时，也有相同的提示，如图）28/36注：1、同一单支持2天内复打10次；2、由于快递公司单号有一定回收机制，超过30天单号一般无效。2022-09-22增加【快递100取消面单】功能1、电子面单列表勾选数据，点击【快递100取消面单】，弹出框点击【确定】后，即可取消电子面单2、仅快递100申请的电子面单支持取消，快递管家导入的电子面单不支持取消，会提示如图信息3、电子面单只支持取消一次，再次取消会提示如图信息4、目前只有部分快递公司支持取消电子面单功能，支持的公司如图29/365、不支持的快递公司电子面单取消，会提示如下信息2022-11-10支持设备码和快递类型使用分号分隔配置，支持多电子面单账号关联1、快递类型用分号分隔不同快递类型（格式如：标准快递;顺丰标快;顺丰空运），注意是英文分号，配置好后，获取电子面单自动按分号拆分快递类型并填充到“快递类型”下拉列表中。如图30/362、设备码用分号分隔不同的设备码，冒号分隔设备ID和显示别名（格式如：KX100L205110251:打印机一;KX100L205110252:打印机二）它的格式多了显示别名，其中英文冒号用于分隔设备ID和显示别名，英文分号用于分隔不同设备码。配置好后，获取电子面单将自动显示设备码，内部使用设备ID，但界面显示设备别名，如图3、支持多电子面单账号关联如果客户同一物流公司有多个电子面单账号，除了使用'获取电子面单'上的'扩展属性'字段外(比如在扩展属性字段中输入{"partnerId":"1234"}，则此行记录获取电子面单时将使用1234的电子面单账号去申请电子面单)，还可以使用快递100参数配置中的关联面单账号字段功能，配置如下图31/36如果是寄件人'未关联账号'，由于它没有配置字段'关联面单账号'，那么在获取电子面单时如果寄件人信息列表中的选择的是'未关联账号'（寄件人信息列表的值），则使用10001的电子面单账号去获取，这是默认逻辑，如果选择的寄件人是'关联某一账号'，则使用10002电子面单账号去获取，因为它配置了关联面单账号为10002，如下图2023-01-12增加快递管家地址校验快递100参数配置增加参数【快递管家地址校验】32/36获取电子面单界面收件人、寄件人信息中增加省/州、城市、区县字段当参数【快递管家地址校验】勾选，快递管家订单导入时，收件人、寄件人的省/州、城市、区县字段必须全部都维护；未勾选参数时不做校验。2023-01-12物流跟踪信息增加【类型】标识；快递管家官网删除订单同步状态1、销售订单、发货通知单、销售出库单、销售退货单的物流跟踪信息中增加字段【类型】，值包含母单、子单、签回单、后缀单、取消单（部分类型显示如截图）33/362、快递管家官网删除订单，电子面单状态回更新为C（仅快递管家未打印、未回填快递单号之前删除，取消状态会回传）34/36注：仅如图快递管家官网待打印列表的订单删除后回传删除状态给星空35/36快递100企业接口（查询API、电子面单API）对接（电话/微信）：19926654047快递管家官方产品交流群：795059050快递管家API对接技术：851669532快递100服务热线：400-000-038736/36
