金蝶云星空和轻易云集成平台接口打通对接实战对接系统：金蝶云星空金蝶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 请求参数字段字段名称类型配置值 FCUSTID FCUSTID string FCUSTID FNumber 编码 string FNumber FName 名称 string FName FCreateOrgId_FNumber 创建组织 string FCreateOrgId.FNumber FUseOrgId_FNumber 使用组织 string FUseOrgId.FNumber FDescription 描述 string FDescription FIsTrade 是否交易客户 string FIsTrade FCustTypeId_FNumber 客户类别 string FCustTypeId.FNumber FGroup_FNumber 客户分组 string FGroup.FNumber FSALDEPTID_FNumber 销售部门 string FSALDEPTID.FNumber FSELLER_FNumber 销售员 string FSELLER.FNumber FSETTLETYPEID_FNumber 结算方式 string FSETTLETYPEID.FNumber FRECCONDITIONID_FNumber 收款条件 string FRECCONDITIONID.FNumber FDISCOUNTLISTID_FNumber 折扣表 string FDISCOUNTLISTID.FNumber FPRICELISTID_FNumber 价目表 string FPRICELISTID.FNumber FTRANSLEADTIME 运输提前期 string FTRANSLEADTIME FInvoiceType 发票类型 string FInvoiceType FTaxType_FNumber 税分类 string FTaxType.FNumber FShortName 简称 string FShortName FADDRESS 地址 string FADDRESS FZIP 邮编 string FZIP FWEBSITE 首页 string FWEBSITE FTEL 电话 string FTEL FFAX 传真 string FFAX FCompanyClassify_FNumber 公司类别 string FCompanyClassify.FNumber FCompanyNature_FNumber 公司性质 string FCompanyNature.FNumber FCompanyScale_FNumber 公司规模 string FCompanyScale.FNumber FINVOICETITLE 发票抬头 string FINVOICETITLE FTAXREGISTERCODE 纳税登记号 string FTAXREGISTERCODE FINVOICEBANKNAME 开户银行 string FINVOICEBANKNAME FINVOICETEL 开票联系电话 string FINVOICETEL FINVOICEBANKACCOUNT 银行账号 string FINVOICEBANKACCOUNT FINVOICEADDRESS 开票通讯地址 string FINVOICEADDRESS FSUPPLIERID_FNumber 对应供应商 string FSUPPLIERID.FNumber FIsGroup 集团客户 string FIsGroup FIsDefPayer 默认付款方 string FIsDefPayer FGROUPCUSTID_FNumber 对应集团客户 string FGROUPCUSTID.FNumber FCOUNTRY1_FNumber 开户国家 string FCOUNTRY1.FNumber FBANKCODE 银行账号 string FBANKCODE FACCOUNTNAME 账户名称 string FACCOUNTNAME FBankTypeRec_FNumber 收款银行 string FBankTypeRec.FNumber FTextBankDetail 网点名称 string FTextBankDetail FBankDetail_FNumber 银行网点 string FBankDetail.FNumber FOpenAddressRec 开户行地址 string FOpenAddressRec FCNAPS 联行号 string FCNAPS FCURRENCYID_FNumber 币别 string FCURRENCYID.FNumber FISDEFAULT1 默认 string FISDEFAULT1 FDefaultConsiLoc_FNumber 默认收货地点 string FDefaultConsiLoc.FNumber FDefaultSettleLoc_FNumber 默认开票地点 string FDefaultSettleLoc.FNumber FDefaultPayerLoc_FNumber 默认付款地点 string FDefaultPayerLoc.FNumber FDefaultContact_FNumber 默认联系人 string FDefaultContact.FNumber FMarginLevel 保证金比例（%） string FMarginLevel FCorrespondOrgId 对应组织 string FCorrespondOrgId.FNumber Limit 最大行数 string {{PAGINATION_PAGE_SIZE}} StartRow 开始行索引 string {{PAGINATION_START_ROW}} TopRowCount 返回总行数 int FilterString 过滤条件 string FApproveDate>='{{LAST_SYNC_TIME dateTime}}' FieldKeys 需查询的字段key集合 array FormId 业务对象表单Id string BD_Customer 响应参数字段字段名称类型配置值 FCUSTID FCUSTID string 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 业务对象表单Id BD_Customer Operation 执行的操作 BatchSave IsAutoSubmitAndAudit 提交并审核 true IsVerifyBaseDataField 验证基础资料 false 系统对接总览通过数据集成平台可视化的快速配置调用接口打通金蝶云星空与轻易云集成平台之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。

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

刘培强qeasy

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

对接系统：金蝶云星空

金蝶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

请求参数

字段	字段名称	类型	配置值
FCUSTID	FCUSTID	string	FCUSTID
FNumber	编码	string	FNumber
FName	名称	string	FName
FCreateOrgId_FNumber	创建组织	string	FCreateOrgId.FNumber
FUseOrgId_FNumber	使用组织	string	FUseOrgId.FNumber
FDescription	描述	string	FDescription
FIsTrade	是否交易客户	string	FIsTrade
FCustTypeId_FNumber	客户类别	string	FCustTypeId.FNumber
FGroup_FNumber	客户分组	string	FGroup.FNumber
FSALDEPTID_FNumber	销售部门	string	FSALDEPTID.FNumber
FSELLER_FNumber	销售员	string	FSELLER.FNumber
FSETTLETYPEID_FNumber	结算方式	string	FSETTLETYPEID.FNumber
FRECCONDITIONID_FNumber	收款条件	string	FRECCONDITIONID.FNumber
FDISCOUNTLISTID_FNumber	折扣表	string	FDISCOUNTLISTID.FNumber
FPRICELISTID_FNumber	价目表	string	FPRICELISTID.FNumber
FTRANSLEADTIME	运输提前期	string	FTRANSLEADTIME
FInvoiceType	发票类型	string	FInvoiceType
FTaxType_FNumber	税分类	string	FTaxType.FNumber
FShortName	简称	string	FShortName
FADDRESS	地址	string	FADDRESS
FZIP	邮编	string	FZIP
FWEBSITE	首页	string	FWEBSITE
FTEL	电话	string	FTEL
FFAX	传真	string	FFAX
FCompanyClassify_FNumber	公司类别	string	FCompanyClassify.FNumber
FCompanyNature_FNumber	公司性质	string	FCompanyNature.FNumber
FCompanyScale_FNumber	公司规模	string	FCompanyScale.FNumber
FINVOICETITLE	发票抬头	string	FINVOICETITLE
FTAXREGISTERCODE	纳税登记号	string	FTAXREGISTERCODE
FINVOICEBANKNAME	开户银行	string	FINVOICEBANKNAME
FINVOICETEL	开票联系电话	string	FINVOICETEL
FINVOICEBANKACCOUNT	银行账号	string	FINVOICEBANKACCOUNT
FINVOICEADDRESS	开票通讯地址	string	FINVOICEADDRESS
FSUPPLIERID_FNumber	对应供应商	string	FSUPPLIERID.FNumber
FIsGroup	集团客户	string	FIsGroup
FIsDefPayer	默认付款方	string	FIsDefPayer
FGROUPCUSTID_FNumber	对应集团客户	string	FGROUPCUSTID.FNumber
FCOUNTRY1_FNumber	开户国家	string	FCOUNTRY1.FNumber
FBANKCODE	银行账号	string	FBANKCODE
FACCOUNTNAME	账户名称	string	FACCOUNTNAME
FBankTypeRec_FNumber	收款银行	string	FBankTypeRec.FNumber
FTextBankDetail	网点名称	string	FTextBankDetail
FBankDetail_FNumber	银行网点	string	FBankDetail.FNumber
FOpenAddressRec	开户行地址	string	FOpenAddressRec
FCNAPS	联行号	string	FCNAPS
FCURRENCYID_FNumber	币别	string	FCURRENCYID.FNumber
FISDEFAULT1	默认	string	FISDEFAULT1
FDefaultConsiLoc_FNumber	默认收货地点	string	FDefaultConsiLoc.FNumber
FDefaultSettleLoc_FNumber	默认开票地点	string	FDefaultSettleLoc.FNumber
FDefaultPayerLoc_FNumber	默认付款地点	string	FDefaultPayerLoc.FNumber
FDefaultContact_FNumber	默认联系人	string	FDefaultContact.FNumber
FMarginLevel	保证金比例（%）	string	FMarginLevel
FCorrespondOrgId	对应组织	string	FCorrespondOrgId.FNumber
Limit	最大行数	string	{{PAGINATION_PAGE_SIZE}}
StartRow	开始行索引	string	{{PAGINATION_START_ROW}}
TopRowCount	返回总行数	int
FilterString	过滤条件	string	FApproveDate>='{{LAST_SYNC_TIME dateTime}}'
FieldKeys	需查询的字段key集合	array
FormId	业务对象表单Id	string	BD_Customer

响应参数

字段	字段名称	类型
FCUSTID	FCUSTID	string
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	业务对象表单Id	BD_Customer
Operation	执行的操作	BatchSave
IsAutoSubmitAndAudit	提交并审核	true
IsVerifyBaseDataField	验证基础资料	false

系统对接总览

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