快递100参数配置主要包含快递100，快递管家，物流查询等功能的参数配置。本文以PT-151005 [8.2.0.20231109] 版本为背景详细介绍下快递100参数配置里的各个参数，整体参数如下图1-1所示：

图1-1

快递100参数：

    1，公司编号(customer)：此参数为 快递100企业管理后台->我的信息->企业信息->授权信息->customer 的值，查询物流详细信息时需要用到此参数生成签名，如下图1-2所示：

图1-2

    2，授权秘钥(comkey)：此参数为 快递100企业管理后台->我的信息->企业信息->授权信息->授权key 的值，查询物流详细信息，物流订阅推送时需要用到此参数生成签名。

    3，电子面单授权key：此参数与授权秘钥(comkey)参数值一样，由于历史原因冗余了此参数，在申请快递100电子面单时要用到此参数生成签名。

    4，电子面单密钥(secret)：此参数为 快递100企业管理后台->我的信息->企业信息->授权信息->secret 的值，在申请快递100电子面单时要用到此参数生成签名。

    5，物流推送回调地址：此参数为快递100物流订阅推送回调地址，此地址必须配置成公网可访问或者使用白名单让快递100的服务能访问到，格式一般为 http://xxx.ik3cloud.com/k3cloud/ScmKuaidiService/Kuaidi100HttpHandler ，在浏览器中访问此地址要能返回  { "status": 500, "message": "快递管家回调处理出错！type=" } 即可 ，其中的 xxx.ik3cloud.com 要根据星空环境自行替换，一般就是星空服务器发布后的域名或IP外加端口号，并且Kuaidi100HttpHandler后面不允许追加任何查询字符中，有关此参数的详细介绍可参阅：https://vip.kingdee.com/article/449297154960605440?productLineId=1&isKnowledge=2  。

    6，电子面单通用设置：此页签是快递100申请电子面单时要用到的相关参数配置汇总，其中有些参数与快递100参数字典有对应关系，详细信息可参阅：https://vip.kingdee.com/article/469225211162946816?productLineId=1&isKnowledge=2 ，另外的一些参数在下文中介绍：

        6.1，模板版本：此参数标识模板参数的版本类型，快递100官方建议要配置成V2版本。

        6.2，模板：此参数为模板编码，与模板版本要匹配到，不能V1版本然后模板参数又是V2的，反过来也是，不能V2版本但模板又是V1的，模板参数的值可从快递100官网企业管理后台拷贝，如下图1-3所示：

图1-3

        6.3，V2子模板：此参数在需要子单时配置子单的模板编码，只适用V2模板，不适用V1模板。

        6.4，V2签回单模板：此参数为在需要签回单时配置签回单的模板编码，只适用V2模板，不适用V1模板。

        6.5，快递类型：此参数为快递类型，支持按分号隔离值，详情可参阅：https://vip.kingdee.com/article/469225487148231680?productLineId=1&isKnowledge=2  。

        6.6，设备码：此参数为快递100打印机标识，支持按分号和冒号隔离不同设备码及名称。

        6.7，组织：此参数为星空系统中的组织机构，优先按单据上的主业务组织从寄件信息中匹配一条寄件人配置信息，再通过寄件人设置中的物流公司匹配一条电子面单账号配置信息。

    7，电子面单扩展属性设置：此页签为快递100电子面单功能附加属性配置，有关快递100扩展属性详细介绍可参阅：https://vip.kingdee.com/article/469226538156860672?productLineId=1&isKnowledge=2 

快递管家参数：

    1，快递管家授权key：此参数为 快递管家官网->API导入->APIKey管理->App Key 的值，快递管家订单导入时要用到此参数生成签名，如下图1-4所示：

图1-4

    2，快递管家密钥(secret)：此参数为 快递管家官网->API导入->APIKey管理->App Secret 的值，快递管家订单导入时要用到此参数生成签名。

    3，启用多用户打单：此参数控制快递管家接口版本，启用此参数时将使用管家V6（不用户此参数时将使用管家V5版本接口）版本接口导入订单，并使用星空登录用户的手机自动注册管家账号（如果没有注册过的话），这样导入的订单就只能通过特定手机号登录快递管家官网查看，有关此参数详细说明可参阅：https://vip.kingdee.com/article/423058776543890688?productLineId=1&isKnowledge=2  。

    4，启用执行计划回填快递管家物流单号：如果勾选此参数，则使用执行计划'快递管家单号回填'（此执行计划默认20分钟执行一次）回填物流单号到星空电子面单基础资料和相关销售单据中，如果不勾选，则在快递管家官网打印订单后立即回填物流单号信息到星空系统中。因为管家物流单号回填星空是通过快递管家官网配置的回调地址实现的，这个地址接口必须要在几分钟内完成， 所以如果存在快递管家官网大批量打印订单，建议勾选此参数，否则可能存在回填单号不成功。

    5，快递管家账号设置：此页签配置按组织隔离管家账号，当客户有多个不同的快递管家总账号时，可以在此页签配置信息，系统将自动根据销售单据的主业务组织找到一个管家账号进行订单导入。

其它选项参数：

    1，定时更新销售物流信息并进行时间范围控制：勾选此参数后，将使用执行计划'销售物流更新'去更新物流详细信息。

    2，控制范围内的天数：此参数要与前面参数配合使用才能生效，控制某段日期内的销售单据的物流跟踪页签中的物流单号去刷新详细信息，详细信息可参阅：https://vip.kingdee.com/article/469227469845996800?productLineId=1&isKnowledge=2  。

    3，出库单保存回填上游通知单、订单物流单号和公司：勾选此参数，则在销售出库单保存后会将出库单上的物流跟踪页签中的物流单号，物流公司等信息回填到上游发货通知单和销售订单上。

    4，发货通知单保存回填上游订单物流单号和公司：此参数与上面参数类似（两个参数只能勾选一个），只不过是在发货通知单保存时就回填到上游销售订单上。如果这两个参数都不勾选，则在销售订单下推发货通知单或销售出库单时会将上游销售订单上的物流信息携带到下游发货通知单和销售出库单上。

    5，仅申请或导入一次电子面单：此参数控制一个销售单据只能申请一次快递100电子面单或者只能快递管家订单导入一次（如果混用快递100和快递管家，也只能使用其中的一次）。

    6，省市区必录校验：此参数为控制寄件或收件信息中的地址必录省市区，升级到星空2024年1月的版本则默认会勾选此参数，快递100官方也建议勾选此参数。在2024年1月之前的版本中，如果收件地址输入不规范又不录省市区，快递100地址解析逻辑可能会误判最终的收件地址，所以建议客户对收件地址录入规范。

    7，启用日志：此参数专为排查快递100，快递管家相关接口问题配置的参数，默认不显示也不勾选，当有问题时可启用此参数，有关快递100日志功能介绍可参阅：https://vip.kingdee.com/article/469227224076626944?productLineId=1&isKnowledge=2 。

寄件收件相关设置

    1，默认寄件信息设置：此页签配置默认寄件人相关信息，寄件相关信息不支持从单据上动态配置，只支持按组织机构来隔离寄件地址。获取电子面单界面选择一个销售单据后，会根据单据的主业务组织从此配置中选择组织相同的，勾选默认的那条寄件配置信息。

    2，收件人信息设置：此页签配置收件人相关信息外加其它一些信息，支持动态配置为单据上的某些类型的表头字段（含自定义字段），如果配置为表体字段，则只会读取第一行表体信息的值，如果不配置，则默认是会读取销售单据上的客户信息页签中的信息当收件信息，配置界面如下图1-5所示：

图1-5