客户同步
1. 简介
1.1 插件简介
客户同步场景指的是，能够根据表单业务数据，在金蝶星空旗舰版中同步客户数据。
1.2 应用场景
常用于在简道云中发生销售类业务时，通过该插件自动在金蝶星空旗舰版中同步客户信息。
1.3 预期效果
开启金蝶星空旗舰销售单据单同步插件，在「客户同步」表单中输入信息提交后，自动在金蝶星空旗舰中同步对应的客户信息。效果如下所示：
1.4 使用说明
该插件为付费插件，进入简道云「开放平台 >> 插件市场」，找到「金蝶星空旗舰销售单据同步」插件，点击插件进行购买：
.png)
2. 插件安装及启用
2.1 安装插件
1）直接安装
- 您可点击右方链接直接安装插件：金蝶星空旗舰销售单据同步插件安装。
- 安装成功后，可参考本文【2.2 配置插件】和【2.3 启用插件】，前往「开放平台 >> 插件管理」处启用插件。
2）在简道云「插件市场」处，安装「金蝶星空旗舰销售单据同步插件」插件。插件市场处安装方法可参见文档：插件市场中【2.3 插件安装】。
2.2 配置插件
在插件管理中，点击「调整插件配置」按钮，配置「应用编码」「应用密钥」「授权用户」「认证编码」「身份标识」「接口地址」，点击保存。
注：接口地址填写金蝶云星空旗舰版地址，并在 com 后添加固定值：/kapi
2.3 启用插件
在插件管理中，打开「金蝶星空旗舰销售单据同步插件」插件右侧开关，启用插件。
3. 表单搭建
插件使用体验可先安装：金蝶星空旗舰销售单据同步插件应用模板。本文将按照示例中对应表单进行讲解。
新建「客户同步」流程表单，字段设置如下所示：
字段分类 | 字段名称 | 字段类型 | 是否必填 | 字段说明 |
基础信息 | 客户编码 | 单行文本 | 是 | 自己定义一个客户编码，需要是唯一，同时作为金蝶星空旗舰版此客户的编码。公式举例： CONCATENATE(1000+RECNO()) |
客户名称 | 自定义客户的名称，同时作为金蝶星空旗舰版该客户的名称 | |||
创建组织 | 填写金蝶云星空旗舰版中对应的发货组织和销售组织编码。 | |||
业务职能 | 下拉框 | 否 | 下拉框选项为：
| |
联系人信息 | 姓名 | 子表单-单行文本 | 否 | 填写对应信息。 |
职务 | ||||
部门 | ||||
移动电话 | ||||
子表聚合字段 | 设置默认值为公式编辑，公式设置如下所示： CONCATENATE('{','"contactperson":联系人.姓名,"contactpersonpost":联系人.职务,"dept":联系人.部门,"cellphone":联系人.移动电话','}') 注：根据需要添加任意子表字段，最终通过在「子表聚合字段」中拼接字段名和字段值进行数据传递；（字段名可在 金蝶星空旗舰版API中心 查询） | |||
扩展信息 | 扩展字段 | 多行文本 | 否 | 设置默认值为公式编辑，公式设置如下所示： CONCATENATE('{','"bizfunction":业务职能,"entry_linkman":['+JOIN(联系人.聚合字段,",")+']','}') 注：根据需要添加任意主表字段，最终通过在「扩展字段」中拼接字段名和字段值进行数据传递；（字段名可在 金蝶星空旗舰版API中心 查询） |
返回信息 | 单据主键 | 单行文本 | 返回信息无需填写。 「单据状态」返回标识和含义如下所示： A 表示：创建；B 表示：审核中；C 表示：已审核；D 表示：重新审核；Z 表示：暂存。 | |
单据状态 |
4. 流程节点设置
该插件支持在 前端事件、 智能助手Pro 和 插件节点 中调用触发，本文以插件节点调用为例，进行插件的调用配置。
4.1 流程发起节点
点击流程发起节点，在「节点属性 >> 字段权限」处，勾选部分字段的「可见」「可编辑」权限：
注：除「子表聚合字段」和「扩展字段」等公式编辑字段，其余字段均勾选「可见」「可编辑」权限。
4.2 插件节点
4.2.1 添加插件节点
在「流程设定」中，从工具栏中选择「插件节点」，将其拖动至流程图中，通过流程连接线将全部流程节点串联起来，并修改插件节点的名称为「客户」，选中插件节点，在「节点属性 >> 插件」处，点击「插件配置」：
4.2.2 设置插件节点
插件节点配置如下所示：
- 插件：选择「金蝶星空旗舰销售单据同步插件>>客户」插件；
- 请求方法：设置为自定义，有自定义接口地址时需填写；
- 操作类型：设置为自定义，勾选「保存」、「提交」或「审核」；
- 客户编号：设置为字段值，即「客户编码」字段；
- 客户名称：设置为字段值，即「客户名称」字段；
- 创建组织：设置为字段值，即「创建组织」字段；
- 扩展字段：设置为字段值，即「扩展字段」。
- 字段存储关系：点击「添加」按钮，进行如下设置：
- 单据主键：的值存储到，「单据主键」字段；
- 单据状态：的值存储到，「单据状态」字段。
4.3 启用流程
流程设定完成后，点击「保存」后，再点击「启用流程」，即可启用当前流程。
4.4 效果演示
效果参见本文【1.3 预期效果】。
5. 注意事项
5.1 插件节点配置字段说明
字段分类 | 字段名称 | 是否必填 | 字段来源 | 字段说明 |
基础字段 | 请求方法 | 必填 | 自定义 | 默认为标准地址，如有单据自定义地址，可填写自定义地址，地址不包含域名。 |
操作类型 | 可根据表单提交后，金蝶云星空旗舰版进行哪些操作进行选择，提供以下 3 种操作：
| |||
客户编号 | 字段值 | 此客户的编号。 | ||
客户名称 | 此客户的名称。 | |||
创建组织 | 为金蝶云星空旗舰版中的创建组织编码，可点击对应字段查看。 | |||
扩展字段 | 扩展字段 | 非必填 | 字段值 | 根据需要添加任意主表字段，最终通过在「扩展字段」中拼接字段名和字段值进行主表数据传递；（字段名可在 金蝶云星空旗舰版API中心 查询） |
5.2 关于插件的测试说明
因客户同步后，涉及金蝶星空旗舰版关键单据/关联单据/关联事件的变化，建议大家测试时请自己的金蝶云星空服务顾问进行协助，以便更好的和自己的金蝶云星空旗舰版系统中的业务规则相结合。
6. 联系方式
该插件为官方合作的服务商开发，若您在使用过程中有任何疑问，可通过以下方式咨询：
- 公司：成都轻如燕企业服务有限公司
- 联系人：赵鹏
- 联系电话：18583980516（微信同号）
- 财务软件对接插件交流群，二维码如下：
400-111-0890
在线咨询