从金蝶云星空到阿里宜搭通过接口配置打通数据
接通系统：金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
对接目标平台:阿里宜搭
宜搭是阿里巴巴自研的基于钉钉和阿里云的低代码平台，可让用户通过简单的拖拽、配置即可完成应用搭建，为每个组织提供低门槛、高效率的数字化业务应用生产新模式。有效缩减企业应用开发时间，助力企业数字化升级。
系统对接接口配置
通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：金蝶云星空，并且选择对应的连接器（关于金蝶云星空的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的供应商查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为阿里宜搭，并且选择对应连接器。选择对应的更新表单中指定组件值接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。
金蝶云星空接口明细
API：executeBillQuery
NAME：供应商查询
METHOD：POST
请求参数
接口字段 |
字段名称 |
预设值 |
描述 |
FSupplierId |
FSupplierId |
FSupplierId |
|
FNumber |
编码 |
FNumber |
|
FName |
名称 |
FName |
|
FCreateOrgId_FNumber |
创建组织 |
FCreateOrgId.FNumber |
|
FUseOrgId_FNumber |
使用组织 |
FUseOrgId.FNumber |
|
FDescription |
描述 |
FDescription |
|
FShortName |
简称 |
FShortName |
|
FMinPOValue |
最小订单量 |
FMinPOValue |
小数 |
FCountry_FNumber |
国家 |
FCountry.FNumber |
单选辅助资料列表 |
FBusinessStatus |
业务状态 |
FBusinessStatus |
单据状态 |
FProvincial_FNumber |
地区 |
FProvincial.FNumber |
单选辅助资料列表 |
FFreezeLimit |
冻结范围 |
FFreezeLimit |
多选下拉列表 |
FAddress |
通讯地址 |
FAddress |
多行文本 |
FZip |
邮政编码 |
FZip |
文本 |
FFreezeDate |
冻结日期 |
FFreezeDate |
日期 |
FPurchaserGroupId_FNumber |
采购组 |
FPurchaserGroupId.FNumber |
基础资料 |
FParentSupplierId_FNumber |
汇总公司 |
FParentSupplierId.FNumber |
基础资料 |
FLanguage_FNumber |
语言 |
FLanguage.FNumber |
单选辅助资料列表 |
FWebSite |
公司网址 |
FWebSite |
多行文本 |
FCustomerId_FNumber |
对应客户 |
FCustomerId.FNumber |
基础资料 |
FPayCurrencyId_FNumber |
结算币别 |
FPayCurrencyId.FNumber |
基础资料 |
FSettleTypeId_FNumber |
结算方式 |
FSettleTypeId.FNumber |
基础资料 |
FPayCondition_FNumber |
付款条件 |
FPayCondition.FNumber |
基础资料 |
FSettleId_FNumber |
结算方 |
FSettleId.FNumber |
基础资料 |
FPayAdvanceAmount |
单次预付额度 |
FPayAdvanceAmount |
小数 |
FTaxType_FNumber |
税分类 |
FTaxType.FNumber |
单选辅助资料列表 |
FTaxRegisterCode |
税务登记号 |
FTaxRegisterCode |
文本 |
FTendType_FNumber |
经营类型 |
FTendType.FNumber |
单选辅助资料列表 |
FChargeId_FNumber |
收款方 |
FChargeId.FNumber |
基础资料 |
FInvoiceType |
发票类型 |
FInvoiceType |
下拉列表 |
FTaxRateId_FNumber |
默认税率 |
FTaxRateId.FNumber |
基础资料 |
FFinanceDesc |
描述 |
FFinanceDesc |
多行文本 |
FTrade_FNumber |
行业 |
FTrade.FNumber |
单选辅助资料列表 |
FPRICELISTID_FNumber |
默认价目表 |
FPRICELISTID.FNumber |
基础资料 |
FDiscountListId_FNumber |
默认折扣表 |
FDiscountListId.FNumber |
基础资料 |
FFoundDate |
创立日期 |
FFoundDate |
日期 |
FNeedConfirm |
需要确认 |
FNeedConfirm |
复选框 |
FProviderId_FNumber |
供货方 |
FProviderId.FNumber |
基础资料 |
FLegalPerson |
法人代表 |
FLegalPerson |
文本 |
FWipStockId_FNumber |
默认WIP仓库 |
FWipStockId.FNumber |
基础资料 |
FRegisterFund |
注册资金(万元) |
FRegisterFund |
小数 |
FRegisterCode |
工商登记号 |
FRegisterCode |
文本 |
FVmiBusiness |
VMI业务 |
FVmiBusiness |
复选框 |
FSOCIALCRECODE |
统一社会信用代码 |
FSOCIALCRECODE |
文本 |
FTendPermit |
生产经营许可证 |
FTendPermit |
文本 |
FVmiStockId_FNumber |
VMI仓库 |
FVmiStockId.FNumber |
基础资料 |
FRegisterAddress |
注册地址 |
FRegisterAddress |
多行文本 |
FDeptId_FNumber |
负责部门 |
FDeptId.FNumber |
基础资料 |
FStaffId_FNumber |
负责人 |
FStaffId.FNumber |
基础资料 |
FSupplierClassify_FNumber |
供应商分类 |
FSupplierClassify.FNumber |
单选辅助资料列表 |
FSupplyClassify |
供应类别 |
FSupplyClassify |
下拉列表 |
FSupplierGrade_FNumber |
供应商等级 |
FSupplierGrade.FNumber |
单选辅助资料列表 |
FGroup |
供应商分组 |
FGroup |
分组 |
FCompanyClassify_FNumber |
公司类别 |
FCompanyClassify.FNumber |
单选辅助资料列表 |
FCompanyNature_FNumber |
公司性质 |
FCompanyNature.FNumber |
单选辅助资料列表 |
FCompanyScale_FNumber |
公司规模 |
FCompanyScale.FNumber |
单选辅助资料列表 |
FCorrespondOrgId_FNumber |
对应组织 |
FCorrespondOrgId.FNumber |
组织 |
FStartDate |
生效日期 |
FStartDate |
日期 |
FEndDate |
失效日期 |
FEndDate |
日期 |
Limit |
最大行数 |
{{PAGINATION_PAGE_SIZE}} |
金蝶的查询分页参数 |
StartRow |
开始行索引 |
{{PAGINATION_START_ROW}} |
金蝶的查询分页参数 |
TopRowCount |
返回总行数 |
金蝶的查询分页参数 |
|
FilterString |
过滤条件 |
FAuditDate>='{{LAST_SYNC_TIME datetime}}' |
示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= |
FieldKeys |
需查询的字段key集合 |
金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber |
|
FormId |
业务对象表单Id |
BD_Supplier |
必须填写金蝶的表单ID如 UR_PurchaseOrder |
响应参数
接口字段 |
字段名称 |
预设值 |
描述 |
FSupplierId |
FSupplierId |
||
FNumber |
编码 |
||
FName |
名称 |
||
FCreateOrgId_FNumber |
创建组织 |
||
FUseOrgId_FNumber |
使用组织 |
||
FDescription |
描述 |
||
FShortName |
简称 |
||
FMinPOValue |
最小订单量 |
小数 |
|
FCountry_FNumber |
国家 |
单选辅助资料列表 |
|
FBusinessStatus |
业务状态 |
单据状态 |
|
FProvincial_FNumber |
地区 |
单选辅助资料列表 |
|
FFreezeLimit |
冻结范围 |
多选下拉列表 |
|
FAddress |
通讯地址 |
多行文本 |
|
FZip |
邮政编码 |
文本 |
|
FFreezeDate |
冻结日期 |
日期 |
|
FPurchaserGroupId_FNumber |
采购组 |
基础资料 |
|
FParentSupplierId_FNumber |
汇总公司 |
基础资料 |
|
FLanguage_FNumber |
语言 |
单选辅助资料列表 |
|
FWebSite |
公司网址 |
多行文本 |
|
FCustomerId_FNumber |
对应客户 |
基础资料 |
|
FPayCurrencyId_FNumber |
结算币别 |
基础资料 |
|
FSettleTypeId_FNumber |
结算方式 |
基础资料 |
|
FPayCondition_FNumber |
付款条件 |
基础资料 |
|
FSettleId_FNumber |
结算方 |
基础资料 |
|
FPayAdvanceAmount |
单次预付额度 |
小数 |
|
FTaxType_FNumber |
税分类 |
单选辅助资料列表 |
|
FTaxRegisterCode |
税务登记号 |
文本 |
|
FTendType_FNumber |
经营类型 |
单选辅助资料列表 |
|
FChargeId_FNumber |
收款方 |
基础资料 |
|
FInvoiceType |
发票类型 |
下拉列表 |
|
FTaxRateId_FNumber |
默认税率 |
基础资料 |
|
FFinanceDesc |
描述 |
多行文本 |
|
FTrade_FNumber |
行业 |
单选辅助资料列表 |
|
FPRICELISTID_FNumber |
默认价目表 |
基础资料 |
|
FDiscountListId_FNumber |
默认折扣表 |
基础资料 |
|
FFoundDate |
创立日期 |
日期 |
|
FNeedConfirm |
需要确认 |
复选框 |
|
FProviderId_FNumber |
供货方 |
基础资料 |
|
FLegalPerson |
法人代表 |
文本 |
|
FWipStockId_FNumber |
默认WIP仓库 |
基础资料 |
|
FRegisterFund |
注册资金(万元) |
小数 |
|
FRegisterCode |
工商登记号 |
文本 |
|
FVmiBusiness |
VMI业务 |
复选框 |
|
FSOCIALCRECODE |
统一社会信用代码 |
文本 |
|
FTendPermit |
生产经营许可证 |
文本 |
|
FVmiStockId_FNumber |
VMI仓库 |
基础资料 |
|
FRegisterAddress |
注册地址 |
多行文本 |
|
FDeptId_FNumber |
负责部门 |
基础资料 |
|
FStaffId_FNumber |
负责人 |
基础资料 |
|
FSupplierClassify_FNumber |
供应商分类 |
单选辅助资料列表 |
|
FSupplyClassify |
供应类别 |
下拉列表 |
|
FSupplierGrade_FNumber |
供应商等级 |
单选辅助资料列表 |
|
FGroup |
供应商分组 |
分组 |
|
FCompanyClassify_FNumber |
公司类别 |
单选辅助资料列表 |
|
FCompanyNature_FNumber |
公司性质 |
单选辅助资料列表 |
|
FCompanyScale_FNumber |
公司规模 |
单选辅助资料列表 |
|
FCorrespondOrgId_FNumber |
对应组织 |
组织 |
|
FStartDate |
生效日期 |
日期 |
|
FEndDate |
失效日期 |
日期 |
阿里宜搭接口明细
API：/yida_vpc/form/updateFormData.json
NAME：更新表单中指定组件值
METHOD：POST
请求参数
接口字段 |
字段名称 |
预设值 |
描述 |
textField_ku6aw61h |
编码 |
{{FNumber}} |
|
textField_ku6aw61g |
供应商名称 |
{{FName}} |
|
appType |
应用ID |
APP_KFJOIBQ7VRMTDLQSLKQG |
|
systemToken |
应用秘钥 |
JR766WA1S5PON0QZXMNBZZKZKPGT1VMYM5OMKO |
|
language |
语言 |
zh_CN |
|
formInstId |
要更新的表单数据ID |
_findCollection find resultId from baf6be05-595e-3f59-86bd-89af4fa29a41 where FSupplierId={{FSupplierId}} |
|
userId |
钉钉的userId |
16000443318138909 |
系统对接概况
当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。
