1 功能介绍

适用于通过“快递100”查询与单据上货物相关的快递物流动态，以便根据货物到货情况做出单据审核决策。仅支持审核销售订单和采购订单，其他业务对象暂时不可用。方案无需详情配置，不支持评分，但需在其他模块进行配置。

2 字段说明

方案无需详情配置，但需在其他模块进行配置。

3 应用举例

3.1 配置说明

步骤一：在系统参数-OpenAPI参数中，勾选“显示API1.0新增按钮”，然后在开放平台注册快递管家的回调接口，注册路径为：OpenAPI>其它>API服务管理1.0>新增>自定义服务，并填写如下信息：

• API名称：快递100回调接口 

• API编号：kuaidi100

• 请求地址：/app/idi/kuaidi100

• 注册插件：kd.data.idi.engine.courier.service.CourierManageWebApiPlugin

步骤二：在“快递100”官网（https://b.kuaidi100.com/） 注册账号密码，并开通API服务。首次注册充值用户前30个单号查询免费。

注：因获取token需使用手机号码，最好使用手机号码注册

步骤三：填写“快递100”的回调路径和白名单。填写“步骤一”设置的回调路径，格式：域名+/kapi+请求地址（API服务）。

例如：http://localhost:8080/ierp/kapi/app/idi/express100Callback

IP白名单：公司电脑请求“快递管家”，请求被拦截，需要在“快递管家”中找到被拦截请求的ip，配置到白名单。

步骤四：路径：智能数据洞察>API配置，新增“快递管家”请求信息。需填写如下信息：

• URL：“快递管家”域名（https://b.kuaidi100.com）

• client_id：“快递100”的API管理中的APP Key

• client_secret：“快递100”的API管理中的APP Secret

• 请求方式：post

• 参数名：mobile

• 参数值：注册账号的手机号码

步骤五：使用之前，需要在采购订单或者销售订单单据编辑界面，手动维护单据相关的快递物流信息。包括单据类型、单据编号、快递单号、快递公司名称、快递公司编码等。审核采购订单时，会获取单据附带的快递单号，传到“快递100”进行查询。

                    步骤六：在“智能数据洞察”应用中选用“物流查询”检查项类型，无需进行详情配置，保存方案即可。只支持审核销售订单和采购订单时使用，其他业务对象暂时不可用。

3.2 展示效果

若通过“快递100”成功查询到快递信息，在单据右侧栏以轮播图（一页4个单号）的形式展示所有快递物流信息（包括快递公司、快递单号、发件日期、发件时间）。悬停到快递单号可查看货物具体流转情况（包括日期、时间以及物流状态），点击<翻页>按钮可查看更多快递信息。