金蝶云星空与阿里宜搭对接集成供应商查询打通新增表单实例
对接系统金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。
对接目标平台:阿里宜搭
宜搭为广大企业提供一套低成本的企业应用搭建解决方案。自2019年3月上云以来，宜搭已持续服务数百位合作伙伴，涉及新零售、医疗、银行、制造、酒店等多个行业领域。
系统对接接口配置
通过系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：金蝶云星空，然后选择对应的连接器。选择对应的executeBillQuery作为数据对接来源。然后再写入目标平台配置目标系统为阿里宜搭，并且选择对应连接器。选择好对应的/yida_vpc/form/saveFormData.json接口作为数据写入动作完成第一步的接口配置。
金蝶云星空接口明细
- 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 | 过滤条件 | FGroup.FNumber not in ('003') and FForbidStatus in ('A') and FUseOrgId.FNumber in ('100') |
| FieldKeys | 需查询的字段key集合 | |
| FormId | 业务对象表单Id | BD_Supplier |
响应参数
| 接口字段 | 名称 | 预设值 |
|---|
| 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 | 失效日期 | |
阿里宜搭接口明细
- 调用接口：/yida_vpc/form/saveFormData.json
- 接口名称：新增表单实例
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| textField_ku6aw61g | 供应商名称 | string | {{FName}} |
| textField_ku6aw61h | 编码 | string | {{FNumber}} |
| textField_ku6aw61f | 类型 | string | 供应商 |
| appType | 应用ID | string | APP_KFJOIBQ7VRMTDLQSLKQG |
| systemToken | 应用秘钥 | string | JR766WA1S5PON0QZXMNBZZKZKPGT1VMYM5OMKO |
| language | 语言 | string | zh_CN |
| formUuid | 表单ID | string | FORM-PU866D91181UGOZDYPVC4EX18VPT1Y5YVA6UKZ9 |
| userId | 钉钉的userId | string | 16000443318138909 |
系统数据对接
当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。
