景：

涉及到快递100的两个接口：A.快递接口API, 分基础版和企业版； B. 快递管家API ，分导入服务和推送服务。

1、只需查询物流信息并刷新回金蝶云上,需手工维护好单据上的快递公司和快递单号。

2、申请电子面单，然后得到电子面单链接，在浏览器中打开链接右键可实现打印，但无法批量打印。2021-3-25补丁支持按模板批量打印，具体使用操作参考文章最后的新增功能介绍。

3、导入快递管家，批量打印电子面单，自动回填快递单号到单据上，实时更新物流信息到金蝶云。

以下是对应3种场景所需配置的情况：

一、获取快递物流信息到（销售订单，发货单，销售出库单）：

1、参数配置：

配置如下：

实时查询customer，客户授权Key，分别填到金蝶云快递100参数的公司编号和授权秘钥中

参数来源：

2、参数来源获取方式：

2.a、授权信息申请方法如下，https://api.kuaidi100.com/register/enterprise ,注册企业版帐号

2.b、申请通过后，直接使用刚申请的用户名和密码在页面 https://api.kuaidi100.com/login 进行登录，进入企业管理后台，在【我的信息】中的【企业信息】里面查看参数

2.c、将上面的实时查询customer，客户授权Key，分别填到金蝶云快递100参数的公司编号和授权秘钥中。

3、功能说明：

获取快递单号，有两种方式：1、申请电子面单后自动回填快递单号；2、导入快递管家后打印快递单时自动回填快递单号。

3.1 申请电子面单

除了维护授权信息外，还需将上面的客户授权Key，电子面单secret，分别填到电子面单授权key和电子面单密钥(secret)中，并且维护快递公司电子面单参数配置中的电子面单（月结）账号密码等信息，电子面单（月结）账号密码需用户单独向合作的快递公司索取。

然后打开获取电子面单，在明细中点击单据编号，选择返回数据，然后点击申请电子面单即可进行申请

3.2 申请成功后打开列表可以看到快递单号回填到单据上了，并且多了一个电子面单链接。

3.3 在浏览器中打开电子面单链接，如图

           3.4通过申请电子面单获取物流单号到单据上后，通过物流查询跳转到销售物流信息列表。此外手工维护好物流公司和物流单号，也是可以刷新物流信息回来的。

3.5 销售物流信息列表，点击刷新物流信息，即可将物流信息更新回金蝶云系统中。

3.6 支持子母单返回，在获取电子面单中，维护物品数量，并勾选是否需要子单，然后点击申请电子面单。即可返回子单，例如录5则返回母单1个，子单4个

3.7 支持签回单，在获取电子面单中勾选“是否需要签回单”即可

4、其他选项参数说明：

4.a 定时更新销售物流信息并进行时间范围控制

勾选该参数后，只要单据上维护好了物料跟踪信息，则金蝶云系统自动按执行计划“销售物流更新”获取单据的物流信息。这样就不用手工去销售物流信息列表上刷新物流信息。

4.b 控制范围内的天数：

设置每次获取单据的时间范围（最多只能设置30天）；如果设置7天，则系统根据业务单据的日期判断7天内的业务单据则更新物流信息。

4.c 出库单保存回填上游通知单、订单物流单号和公司

勾选该参数，则在销售出库单上填写的物流单号等的物流信息可以自动回填到销售订单、发货通知单。

5、更新更好的获取物流方式：

除上面获取物流信息的方式外，推荐使用快递管家的推送服务，可以实现自动实时更新物流信息。文档后面的快递管家充值中有介绍。

二、导入快递管家并打印电子面单说明：

1、参数配置：

配置如下：

参数来源：

2、参数来源获取方式：

2.a、注册快递100并登陆，找到 快递管家
                 

2.b、打开快递管家首页后，找到API服务进入

2.c、点击 开发者接口申请-立即申请置，填写资料 查看API key 即可。

2.d、然后将上面的APP key 和APP Secret 填回金蝶云快递管家参数配置中。

3、回调接口配置：

          除了在金蝶云中快递100参数配置快递管家的API Key外，还需要设置回调url，位置：快递管家-更多-API服务-AppKey管理-回调url

          回调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=CallBackReault

4、快递管家充值说明：

共两种服务，订单导入和订单导入 推送服务。推荐购买订单导入 推送服务，因为它不仅包含了导入服务的功能，另外即使没有申请授权信息，在快递管家打印快递单后，如物流信息发生变化，能实现自动实时更新物流信息到金蝶云销售物流信息列表和单据的物流跟踪页签上。而不用去勾选“定时更新销售物流信息并进行时间范围控制”参数。即比原来的定时更新服务，能更及时地更新的快递物流状态。

5、导入与打印功能说明：

4.a、除了快递管家key和secret设置外，下面的默认寄件信息也需设置。

4.b 在获取电子面单中选择要导入至快递管家的订单信息点击“快递管家订单导入”按钮即可完成订单导入功能。

4.c 收件人和寄件信息说明：

收件人信息来源单据上的收货方信息，寄件人信息来源快递100参数中设置的默认寄件人信息。

4.d 导入成功后，点击列表，即可以看到电子面单列表中多一条记录。并且登录快递管家的待打印页签也多一条记录，点击打印快递单打印完后会回填快递单号到电子面单列表和单据物流跟踪页签上。

6、电子面单列表打印操作：跳转打印，自动打印，自动打印（云设备）。

6.a跳转打印：

就是跳转到快递管家官网并弹出快速打印窗口。 具体操作如下所述：

           （1）在获取电子面单中选择要导入至快递管家的订单信息点击快递管家订单导入按钮将订单信息导入至快递管家
          （2）点击获取电子面单上的列表按钮，前往申请电子面单列表中需要打印的相关面单信息，在业务操作按钮下选择跳转打印，会弹出一个提示框，请点击打开，会在浏览器中直接打开一个页签窗口，并弹出快速打印窗口，选择物流公司、打印模板和打印机。点击立即打印即可完成量申请面单、打印并回填物流公司、物流单号至相关单据和电子面单列表上。

6.b自动打印：

提供自动打印快递单服务，无须页面嵌套，无须弹出快速打印窗口，但必须购买快递100 云盒，并在快递管家中绑定快递100 云盒，并启用”自动打印“功能设置。方便快捷地进行快递单打印。打印时在金蝶云系统发起打印操作，即可完成批量申请面单、打印并回填物流公司、物流单号至相关单据和面单列表上。具体操作如下所述：
    （1） 登录快递管家，购买快递100 云盒，并在快递管家中绑定快递100 云盒，并启用”自动打印“功能设置及设置相应的默认打印模板（一次性配置即可）

        （2） 在获取电子面单中选择要导入至快递管家的订单信息，点击快递管家订单导入按钮将金蝶云订单信息导入至快递管家
 

       （3）点击获取电子面单上的列表按钮，前往申请电子面单列表中需要打印的相关面单信息，在业务操作按钮下选择自动打印，即可完成批量申请面单、打印并回填物流公司、物流单号至相关单据和面单列表上，打印完成之后请刷新电子面单列表查看物流单号信息是否正确回填至面单列表，如下图所示：

6.c 自动打印（云设备）
 

           存在多个云打印机时，使用该方式打印，可以选择指定某台云打印机进行打印。

三、补充说明：

1. 因快递100企业API接口参数变动，顺丰获取物流信息需提供寄件人手机号码获取顺丰物流信息，金蝶云相关单据获取物流信息调用快递100企业API接口时必须需提供寄件人的手机号码。

2.百世baishiwuliu，在金蝶云上要用 汇通huitongkuaidi，才能正常获取物流信息。

3.打印物料清单。要使用“快递管家订单导入”，导入快递管家，在打印快递单后，可以使用“快递管家小程序” 扫码拣货功能，查看物品清单并打印等，手机端已经不支持了，只支持在电脑端打印发货单。打印后的物品清单如下图所示

四、新增功能：

2020-11-26 电子面单参数增加【模板，功能控制，快递类型，组织】字段

1、维护【模板】参数，在申请电子面单后，系统打开电子面单可以直接显示面单。参数编码来源快递100后台中的电子面单模板编码

2、维护【功能控制】字段，例如输入sf_srcret，表示启用顺丰的丰密面单，其他快递公司是否必录可以参考快递100API帮助文档中电子面单的参数字典中的code字段

https://api.kuaidi100.com/help/doc?code=5f0ff6e82977d50a94e10237&openKey=电子面单

3、维护【快递类型】字段，则申请电子面单后 ，在浏览器中打开申请电子面单后回填的电子面单链接，会显示快递类型，例如顺丰的“限时KC24”。具体快递公司的快递类型同样可以在上面的快递100API帮助文档中找到

4、维护【组织】字段，电子面单参数中相同快递公司但是有多个电子面单账号，应用在不同的组织，则可以通过维护组织字段来指定专门的使用组织

2021-03-25 电子面单参数增加【设备码，商家名称，客户秘钥，检视员】字段

使用设备码功能，需购买快递100二代打印机。设备码位于打印机底部的标签中的SERIAL NO.（序号）。

维护【模板】字段，再维护【设备码】字段。打印机设置运行正常后，在获取电子单中点击“申请电子面单”即可获取电子面单的同时，根据设置好的模板打印出纸质版面单。

2021-04-25 获取电子面单增加【保价金额，代收货款额度】 字段

2021-05-25 快递100参数设置增加自定义设置页签，支持自定义设置

2021-06-25 快递100参数设置增加启用日志功能，默认不显示，不启用，需在BOS扩展设为可见。此功能用于记录日志排查问题，日常使用不推荐启用。

2021-06-25 快递100API，增加重量和体积参数对接，在获取电子面单中，选择单据后，默认携带物料上的重量体积

2021-10-21 增加电子面单重复打印接口对接，在“电子面单列表”内增加重复打印按钮

2021-11-04 增加国际下单接口对接，包含UPS、DHL、FedEx等

1.首先维护好电子面单参数

2.打开“获取电子面单（国际）”，手工返回单据，并维护好收件人，寄件人等信息后，点击申请国际电子面单，申请成功后，直接点击列表，就可以打开国际电子面单列表；另外可以通过电子面单列表的下拉按钮“国际电子面单列表”同样可以打开。

3.申请成功后会返回电子面单URL，一般都是PDF文档格式，下载后再打印即可。