从金蝶云星空到钉钉通过接口集成数据

从金蝶云星空到钉钉通过接口集成数据

源系统:金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

对接目标平台:钉钉

钉钉是阿里巴巴集团打造的企业级智能移动办公平台，是数字经济时代的企业组织协同办公和应用开发平台。钉钉将IM即时沟通、钉钉文档、钉闪会、钉盘、Teambition、OA审批、智能人事、钉工牌、工作台深度整合，打造简单、高效、安全、智能的数字化未来工作方式，助力企业的组织数字化和业务数字化。

数据接口配置方案

通过数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：金蝶云星空，并且选择对应的连接器（关于金蝶云星空的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的供应商查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为钉钉，并且选择对应连接器。选择对应的保存表单数据（无审批流程）(宜搭)接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。

金蝶云星空接口明细

• API：executeBillQuery
• NAME：供应商查询
• METHOD：POST

请求参数

接口字段字段名称预设值描述 FSupplierIdFSupplierIdFSupplierId 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文本 FVmiBusinessVMI业务FVmiBusiness复选框 FSOCIALCRECODE统一社会信用代码FSOCIALCRECODE文本 FTendPermit生产经营许可证FTendPermit文本 FVmiStockId_FNumberVMI仓库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业务对象表单IdBD_Supplier必须填写金蝶的表单ID如😛UR_PurchaseOrder

响应参数

接口字段字段名称预设值描述 FSupplierIdFSupplierId 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工商登记号文本 FVmiBusinessVMI业务复选框 FSOCIALCRECODE统一社会信用代码文本 FTendPermit生产经营许可证文本 FVmiStockId_FNumberVMI仓库基础资料 FRegisterAddress注册地址多行文本 FDeptId_FNumber负责部门基础资料 FStaffId_FNumber负责人基础资料 FSupplierClassify_FNumber供应商分类单选辅助资料列表 FSupplyClassify供应类别下拉列表 FSupplierGrade_FNumber供应商等级单选辅助资料列表 FGroup供应商分组分组 FCompanyClassify_FNumber公司类别单选辅助资料列表 FCompanyNature_FNumber公司性质单选辅助资料列表 FCompanyScale_FNumber公司规模单选辅助资料列表 FCorrespondOrgId_FNumber对应组织组织 FStartDate生效日期日期 FEndDate失效日期日期

钉钉接口明细

• API：/v1.0/yida/forms/instances
• NAME：保存表单数据（无审批流程）(宜搭)
• METHOD：POST

请求参数

接口字段字段名称预设值描述 textField_ku6aw61g供应商名称{{FName}} textField_ku6aw61h供应商编码{{FNumber}} textField_ku6aw61f类型供应商 appType应用IDAPP_KFJOIBQ7VRMTDLQSLKQGAPP_PBKT0MFBEBTDO8T7SLVP systemToken应用秘钥JR766WA1S5PON0QZXMNBZZKZKPGT1VMYM5OMKO在应用数据中获取。 language语言zh_CN formUuid表单IDFORM-OS566L91Z0D0MNC4F7MXM8YUB7E934L7YK53LJFORM-PU866D91181UGOZDYPVC4EX18VPT1Y5YVA6UKZ9 userId钉钉的userId16000443318138909

系统数据集成价值

通过数据集成平台可视化的快速配置调用接口打通金蝶云星空与钉钉之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。