金蝶云星空与钉钉对接集成客户查询连通更新表单数据（宜搭）(basic-（新环境）更新客户)

数据源系统:金蝶云星空

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

目标系统:钉钉

钉钉（DingTalk）是阿里巴巴集团专为中国企业打造的免费沟通和协同的多端平台，提供PC版，Web版和手机版，有考勤打卡、签到、审批、日志、公告、钉盘、钉邮等强大功能。

数据接口配置方案

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

金蝶云星空接口明细

• API：executeBillQuery

• NAME：客户查询

• METHOD：POST

请求参数

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

响应参数

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

钉钉接口明细

• 接口：/v1.0/yida/forms/instances

• 接口名称：更新表单数据（宜搭）

• 接口方法：POST

请求参数

字段	名称	类型	描述
textField_ku6aw61g	客户名称	string
textField_ku6aw61h	客户编码	string
appType	应用ID	string
systemToken	应用秘钥	string
language	语言	string
formInstId	要更新的表单数据ID	string
userId	钉钉的userId	string

数据对接价值

通过轻易云集成平台系列产品线可以协助企业轻易快捷的构建基于微服务架构的新一代企业服务总线，传统基于SOA架构的ESB产品主要解决的数据集成和协议转换等基础功能，已完全不能满足基于微服务架构、混合云集成架构、跨组织、跨单位的总线解决方案。 而轻易云集成平台的每个产品线都是新一代的按照最新的互联网架构模式进行研发的产品线，能快速协助企业从传统的SOA架构转向微服务架构的服务总线解决方案。