快递管家功能主要集成在星空供应链领域中的销售模块下，此功能是通过星空的动态表单'获取电子面单'中的'快递管家订单导入'按钮完成的，此按钮点击后会在快递管家官网生成一张单据。与快递100电子面单接口不同的是，快递管家订单导入后并不会立即生成物流单号给星空，由于快递管家订单导入接口异步处理的原因，'获取电子面单界面'显示的导入成功的信息并不100%地保证就是成功导入了，真实的是否导入成功的信息是通过回调地址传给星空的(仅log4net消息配置成包含INFO级别才能看到)。星空对接的快递管家支持两种版本接口，即V5和V6版本的管家接口。

1，V5版本快递管家接口：

    当快递100参数配置的'快递管家参数配置'中不启用多用户打单时，将使用快递管家V5版本接口，如下图1-1所示：

图1-1

    本次显示使用发货通知单导入快递管家，首先在星空里面创建一张发货通知单，然后去获取电子面单，点击'快递管家订单导入'按钮后，如果没有失败，则会在快递管家官网看到导入的订单数据同时会在日志文件里看到导入成功的回调信息，如下图1-2、图1-3和图1-4所示：

图1-2

图1-3

图1-4

    快递管家官网配置好打印机和电子面单模板后，可选择单据进行打印，打印成功后会将快递单号回填到星空对应的电子面单和销售单据上，如下图1-5、图1-6、图1-7和图1-8所示：

图1-5

图1-6

图1-7

图1-8

2，V6版本快递管家接口：

    当快递100参数配置的'快递管家参数配置'中启用多用户打单时，将使用快递管家V6版本接口，如下图2-1所示：

图2-1

    V6版本快递管家接口本次演示的是销售出库单，首先创建一张销售出库单，然后获取电子面单，快递管家订单导入成功后，会在快递管家官网生成一张单据，同时星空系统上也会生成一个电子面单基础资料，如下图2-2和图2-3所示：

图2-2

图2-3

    快递管家官网的V6的打印和V5的打印没什么区别，只不过登录的账号有点区别，可以从星空电子面单列表中点击'快递管家跳转打印'，此操作会使用星空当前用户的手机号打开并登录快递管家官网的待打印列表界面并弹出要打印的对话框，打印成功后物流单号会回填到星空的电子面单和对应的销售单据上，如下图2-4、图2-5、图2-6、图2-7和图2-8所示：

图2-4

图2-5

图2-6

图2-7

图2-8

写在最后：

    如果存在快递管家官网大批量打印时，由于管家官网批量打印后会将多个物流单号通过回调地址回填到星空系统上且管家回调后需要几分钟内响应成功，而星空对于物流单号的回调处理逻辑有点复杂（比如仅一个物流单号就要回写到电子面单上，还要回写到相关销售单据的物流跟踪页签上并可能更新销售单据的修改时间，且可能存在回写到批量回填的销售单号和上游相关单据），因些这里可能存在性能问题，星空在参数配置中提供了后台延迟处理物流单号回填星空逻辑，如下图3-1所示：

图3-1

    星空电子面单列表的管家打印操作不支持混打，即要么都勾选V5版本的电子面单去打印，要么都勾选V6版本的电子面单，不支持混合勾选V5和V6，电子面单列表中的管家版本字段可以标识电子面单的版本（快递公司订单号有值且管家版本为V6才是V6的管家接口生成的电子面单，如果快递公司订单号有值，但管家版本没值或者是V5才是V5管家接口生成的）。另外快递管家官网需要先配置好回调URL和IP白名单才能让快递管家物流单号回填到星空系统中，如下图3-2所示：