金蝶云星空和轻易云集成平台接口打通对接实战

金蝶云星空和轻易云集成平台接口打通对接实战

对接系统：金蝶云星空

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

对接目标平台:轻易云集成平台

从API服务总线层面解决企业烟囱式业务系统集成现状相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成

多系统对接方案配置

通过数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：金蝶云星空，并且选择对应的连接器（关于金蝶云星空的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的客户查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为轻易云集成平台，并且选择对应连接器。选择对应的客户新增接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。通过该系统数据集成平台的能力，可以集成的应用系统包括CRM、ERP、钉钉、企业微信、MES、飞书、用友、金蝶等 177 个不同应用系统之间的无代码接口集成，并且每周都在增加新的应用系统接入。

金蝶云星空接口明细

• 调用接口：executeBillQuery
• 接口名称：客户查询
• 方法：POST

请求参数

字段字段名称类型配置值 FCUSTIDFCUSTIDstringFCUSTID FNumber编码stringFNumber FName名称stringFName FCreateOrgId_FNumber创建组织stringFCreateOrgId.FNumber FUseOrgId_FNumber使用组织stringFUseOrgId.FNumber FDescription描述stringFDescription FIsTrade是否交易客户stringFIsTrade FCustTypeId_FNumber客户类别stringFCustTypeId.FNumber FGroup_FNumber客户分组stringFGroup.FNumber FSALDEPTID_FNumber销售部门stringFSALDEPTID.FNumber FSELLER_FNumber销售员stringFSELLER.FNumber FSETTLETYPEID_FNumber结算方式stringFSETTLETYPEID.FNumber FRECCONDITIONID_FNumber收款条件stringFRECCONDITIONID.FNumber FDISCOUNTLISTID_FNumber折扣表stringFDISCOUNTLISTID.FNumber FPRICELISTID_FNumber价目表stringFPRICELISTID.FNumber FTRANSLEADTIME运输提前期stringFTRANSLEADTIME FInvoiceType发票类型stringFInvoiceType FTaxType_FNumber税分类stringFTaxType.FNumber FShortName简称stringFShortName FADDRESS地址stringFADDRESS FZIP邮编stringFZIP FWEBSITE首页stringFWEBSITE FTEL电话stringFTEL FFAX传真stringFFAX FCompanyClassify_FNumber公司类别stringFCompanyClassify.FNumber FCompanyNature_FNumber公司性质stringFCompanyNature.FNumber FCompanyScale_FNumber公司规模stringFCompanyScale.FNumber FINVOICETITLE发票抬头stringFINVOICETITLE FTAXREGISTERCODE纳税登记号stringFTAXREGISTERCODE FINVOICEBANKNAME开户银行stringFINVOICEBANKNAME FINVOICETEL开票联系电话stringFINVOICETEL FINVOICEBANKACCOUNT银行账号stringFINVOICEBANKACCOUNT FINVOICEADDRESS开票通讯地址stringFINVOICEADDRESS FSUPPLIERID_FNumber对应供应商stringFSUPPLIERID.FNumber FIsGroup集团客户stringFIsGroup FIsDefPayer默认付款方stringFIsDefPayer FGROUPCUSTID_FNumber对应集团客户stringFGROUPCUSTID.FNumber FCOUNTRY1_FNumber开户国家stringFCOUNTRY1.FNumber FBANKCODE银行账号stringFBANKCODE FACCOUNTNAME账户名称stringFACCOUNTNAME FBankTypeRec_FNumber收款银行stringFBankTypeRec.FNumber FTextBankDetail网点名称stringFTextBankDetail FBankDetail_FNumber银行网点stringFBankDetail.FNumber FOpenAddressRec开户行地址stringFOpenAddressRec FCNAPS联行号stringFCNAPS FCURRENCYID_FNumber币别stringFCURRENCYID.FNumber FISDEFAULT1默认stringFISDEFAULT1 FDefaultConsiLoc_FNumber默认收货地点stringFDefaultConsiLoc.FNumber FDefaultSettleLoc_FNumber默认开票地点stringFDefaultSettleLoc.FNumber FDefaultPayerLoc_FNumber默认付款地点stringFDefaultPayerLoc.FNumber FDefaultContact_FNumber默认联系人stringFDefaultContact.FNumber FMarginLevel保证金比例（%）stringFMarginLevel FCorrespondOrgId对应组织stringFCorrespondOrgId.FNumber Limit最大行数string{{PAGINATION_PAGE_SIZE}} StartRow开始行索引string{{PAGINATION_START_ROW}} TopRowCount返回总行数int FilterString过滤条件stringFApproveDate>='{{LAST_SYNC_TIME dateTime}}' FieldKeys需查询的字段key集合array FormId业务对象表单IdstringBD_Customer

响应参数

字段字段名称类型配置值 FCUSTIDFCUSTIDstring FNumber编码string FName名称string FCreateOrgId_FNumber创建组织string FUseOrgId_FNumber使用组织string FDescription描述string FIsTrade是否交易客户string FCustTypeId_FNumber客户类别string FGroup_FNumber客户分组string FSALDEPTID_FNumber销售部门string FSELLER_FNumber销售员string FSETTLETYPEID_FNumber结算方式string FRECCONDITIONID_FNumber收款条件string FDISCOUNTLISTID_FNumber折扣表string FPRICELISTID_FNumber价目表string FTRANSLEADTIME运输提前期string FInvoiceType发票类型string FTaxType_FNumber税分类string FShortName简称string FADDRESS地址string FZIP邮编string FWEBSITE首页string FTEL电话string FFAX传真string FCompanyClassify_FNumber公司类别string FCompanyNature_FNumber公司性质string FCompanyScale_FNumber公司规模string FINVOICETITLE发票抬头string FTAXREGISTERCODE纳税登记号string FINVOICEBANKNAME开户银行string FINVOICETEL开票联系电话string FINVOICEBANKACCOUNT银行账号string FINVOICEADDRESS开票通讯地址string FSUPPLIERID_FNumber对应供应商string FIsGroup集团客户string FIsDefPayer默认付款方string FGROUPCUSTID_FNumber对应集团客户string FCOUNTRY1_FNumber开户国家string FBANKCODE银行账号string FACCOUNTNAME账户名称string FBankTypeRec_FNumber收款银行string FTextBankDetail网点名称string FBankDetail_FNumber银行网点string FOpenAddressRec开户行地址string FCNAPS联行号string FCURRENCYID_FNumber币别string FISDEFAULT1默认string FDefaultConsiLoc_FNumber默认收货地点string FDefaultSettleLoc_FNumber默认开票地点string FDefaultPayerLoc_FNumber默认付款地点string FDefaultContact_FNumber默认联系人string FMarginLevel保证金比例（%）string FCorrespondOrgId对应组织string

轻易云集成平台接口明细

• API：batchSave
• NAME：客户新增
• METHOD：POST

请求参数

接口字段名称预设值 FName客户名称 FNumber客户编码 FCreateOrgId创建组织100 FUseOrgId使用组织100 FDescription描述 FormId业务对象表单IdBD_Customer Operation执行的操作BatchSave IsAutoSubmitAndAudit提交并审核true IsVerifyBaseDataField验证基础资料false

系统对接总览

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