供应商同步
1. 简介
1.1 场景简介
供应商同步场景指的是，根据表单业务数据，通过供应商同步函数在金蝶云星空企业版中同步供应商数据。
1.2 应用场景
常用于在简道云中发生采购入库相关业务时，通过该插件自动在金蝶云星空企业版中同步供应商信息。
1.3 预期效果
开启金蝶云星空-采购入库单同步插件，在「供应商同步」表单中输入信息提交后，自动在金蝶云星空中同步对应的供应商信息。效果如下所示：
1.4 使用说明
该插件为付费插件，进入简道云「开放平台 >> 插件市场」，找到「金蝶云星空-采购入库单同步」插件，点击进去进行购买：
2. 插件安装及启用
2.1 安装插件
1）直接安装
- 您可点击右方链接直接安装插件：金蝶云星空-采购入库单同步插件安装。
- 安装成功后，可参考本文【2.2 配置插件】和【2.3 启用插件】，前往「开放平台 >> 插件管理」处启用插件。
2）在简道云「插件市场」处，安装「金蝶云星空-采购入库单同步」插件。插件市场处安装方法可参见文档：插件市场中【2.3 插件安装】。
2.2 配置插件
在插件管理中，点击「调整插件配置」按钮，配置「授权模式」「账套 ID」「授权用户」「用户密码」「用户ID」「应用密钥」「接口地址」，点击保存。
注：
1）金蝶云星空全部公有云版本和私有云 7.3 以上版本可使用三方授权模式，私有云 7.3 以下版本需使用账号密码授权模式。
2）三方授权模式无需填写用户密码，其他参数必填；账号密码授权模式无需填写应用 ID /应用密钥，其他参数必填。不同的授权模式，插件配置参数的获取方式不同。详情可见 金蝶云星空-采购入库单同步【2. 金蝶云星空平台配置 】。
2.3 启用插件
在插件管理中，打开「金蝶云星空-采购入库单同步」插件右侧开关，启用插件。
3. 表单搭建
插件使用体验可先安装：金蝶云星空-采购入库单同步插件应用模板。本文将按照示例中的「供应商同步」表单进行讲解。
新建「供应商同步」流程表单，字段设置如下所示：
分类 | 字段名称 | 字段类型 | 字段说明 |
基础信息 | 供应商编码 | 单行文本 | 必填，注：自己定义一个供应商编号，需要是唯一，同时作为金蝶云星空此供应商的编号。公式举例： CONCATENATE("B",TEXT(INT(RAND()*10000)),RIGHT("0"+RECNO(),1)) |
供应商名称 | 必填 | ||
创建组织 | 必填，一般这个编码是固定的，特殊业务可动态传对应的编码。 | ||
使用组织 | 必填，一般这个编码是固定的，特殊业务可动态传对应的编码 | ||
供应商信息 | 国家 | 非必填 | |
地区 | |||
创立日期 | 日期时间 | ||
法人代表 | 单行文本 | ||
银行信息 | 银行信息-银行账号 | 子表单-单行文本 | 非必填 |
银行信息-账号名称 | |||
银行信息-银行网点 | |||
银行信息-开户行地址 | |||
银行信息-开户银行 | |||
银行信息-银行信息聚合 | 设置默认值为公式编辑，公式设置如下所示： CONCATENATE('{','"FBANKCODE":银行信息.银行账号,"FACCOUNTNAME":银行信息.账户名称,"FBankDetail.fnumber":银行信息.银行网点,"FOpenAddressRec":银行信息.开户行地址,"FOPENBANKNAME":银行信息.开户银行','}') | ||
扩展参数 | 扩展字段 | 单行文本 | 设置默认值为公式编辑，公式设置如下所示： CONCATENATE('{','"FCOUNTRY.fnumber":国家,"FPROVINCIAL.fnumber":地区,"FBaseInfo":{"FFoundDate":创立日期,"FLegalPerson":法人代表},"FBankInfo":['+TEXT(银行信息.银行信息聚合)+']','}') |
4. 流程节点设置
4.1 流程发起节点
点击流程发起节点，在「节点属性 >> 字段权限」处，勾选部分字段的「可见」「可编辑」权限：
注：除「银行信息聚合」和「扩展字段」，其余字段均勾选「可见」「可编辑」权限。
4.2 添加审批节点
新增流程节点，在「节点属性 >> 节点名称」处，修改节点名称为「审批节点」；在「节点属性 >> 字段权限」处，在「节点属性 >> 字段权限」处，勾选部分字段的「可见」、「可编辑」权限：
4.3 启用流程
流程设定完成后，点击「保存」后，再点击「启用流程」，即可启用当前流程。
5. 智能助手Pro配置
5.1 新建智能助手Pro
进入「供应商同步」流程表单中，在「扩展功能 >> 智能助手」处，点击「新增智能助手」，修改智能助手Pro 的名称为「供应商同步」，并选择触发方式为表单触发，触发表单选择「供应商同步」表。
5.2 配置触发动作
触发动作进行如下设置：
- 触发动作：
- 选择「新增数据」时；
- 或「修改数据」勾选「任意字段」修改时；
- 或「流程结束」时。
5.3 配置插件节点
点击节点连接线上的加号按钮，添加插件节点，进行如下设置：
- 执行插件：选择「金蝶云星空-采购入库单 >>供应商」；
- 操作类型：选择自定义，勾选「审核」；
- 编码：选择字段值，勾选「触发数据--供应商编码」；
- 名称：选择字段值，勾选「触发数据--供应商名称」；
- 创建组织：选择字段值，勾选「触发数据--创建组织」；
- 使用组织：选择字段值，勾选「触发数据--使用组织」；
- 扩展字段：选择字段值，勾选「触发数据--扩展字段」。
5.4 保存并启用
全部设置完成后，点击右上方「保存并启用」，启用智能助手。
5.5 效果演示
效果参见本文【1.3 预期效果】。
6. 注意事项
6.1 插件节点配置字段说明
字段名称 | 是否必填 | 字段来源 | 字段说明 |
操作类型 | 必填 | 自定义/字段值 | 可根据表单提交后，金蝶云进行哪些操作进行选择，提供以下 3 种操作：
|
编码 | 金蝶云星空供应商的编码，编码需要是唯一的。 | ||
名称 | 金蝶云星空供应商的名称，字段填写供应商名称。 | ||
创建组织/使用组织 | 通常情况下，这两个编码是固定且相同的，特殊业务可分别传对应的编码。 | ||
扩展字段 | 非必填 | 字段值 | 即表单中的「扩展字段」。 可根据需要添加任意字段，最终通过在「扩展字段」中拼接字段名和字段值进行数据传递；（字段名可在 金蝶云星空API中心 查询） |
6.2 关于插件的测试说明
因供应商同步后，涉及金蝶云星空关键单据/关联单据/关联事件的变化，建议大家测试时请自己的金蝶云星空服务顾问进行协助，以便更好的和自己的金蝶云星空系统中的业务规则相结合。
7. 联系方式
该插件为官方合作的服务商开发，若您在使用过程中有任何疑问，可通过以下方式咨询：
- 公司：成都轻如燕企业服务有限公司
- 联系人：赵鹏
- 联系电话：18583980516（微信同号）
400-111-0890
在线咨询