金蝶云星空和金蝶云星空接口打通对接实战

金蝶云星空和金蝶云星空接口打通对接实战

接通系统：金蝶云星空

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

对接系统：金蝶云星空

金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。

数据集成方案配置

通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：金蝶云星空，然后选择对应的连接器。选择对应的executeBillQuery作为数据对接来源。然后再写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器（关于金蝶云星空的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的batchSave接口作为数据写入动作完成第一步的接口配置。

金蝶云星空接口明细

• 调用接口：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
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

金蝶云星空接口明细

• 接口：batchSave
• 接口名称：客户新增
• 接口方法：POST

请求参数

字段	名称	类型	描述
FName	客户名称	string
FNumber	客户编码	string
FCreateOrgId	创建组织	string
FUseOrgId	使用组织	string
FDescription	描述	string
FormId	业务对象表单Id	string	必须填写金蝶的表单ID如 UR_PurchaseOrder
Operation	执行的操作	string
IsAutoSubmitAndAudit	提交并审核	bool
IsVerifyBaseDataField	验证基础资料	bool	是否验证所有的基础资料有效性，布尔类，默认false（非必录）

数据对接价值

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