金蝶云星空与阿里宜搭对接集成客户查询打通新增表单实例
对接源平台:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。
对接目标系统:阿里宜搭
宜搭是阿里巴巴自研的基于钉钉和阿里云的低代码平台，可让用户通过简单的拖拽、配置即可完成应用搭建，为每个组织提供低门槛、高效率的数字化业务应用生产新模式。有效缩减企业应用开发时间，助力企业数字化升级。
多系统对接方案配置
通过数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：金蝶云星空，并且选择对应的连接器（关于金蝶云星空的接口连接器如何配置可以在轻易云系统数据集成交流社区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}}' | 示例写法 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 | 保证金比例（%） | | |
阿里宜搭接口明细
- API：/yida_vpc/form/saveFormData.json
- NAME：新增表单实例
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| textField_kvwdrbjp | 客户编码 | {{FNumber}} | |
| textField_kvwdrbjq | 客户名称 | {{FName}} | |
| textField_kvwdrbjs | 客户ID | {{FCUSTID}} | |
| textField_kvwdrbjr | 所属组织 | {{FUseOrgId_FNumber}} | |
| appType | 应用ID | APP_DYCTQDDB8CX2SDQ6YRJH | APP_PBKT0MFBEBTDO8T7SLVP |
| systemToken | 应用秘钥 | QQ766LD1J92V5NCVVQ5WZ20GDSL2201TCBWVK3W1 | 在应用数据中获取。 |
| language | 语言 | zh_CN | |
| formUuid | 表单ID | FORM-EX866CB1JV33I0MREW89Z8LY24CE2E63HUV6L1 | FORM-NJYJZELV8YZRDEI2N5IQ7L6VEDMR1VE9GMPCJB |
| userId | 钉钉的userId | 016654026426409112 | |
系统对接概况
采集并引入全业务、多终端、多形态的数据，经过处理以及对应平台接口的数据结构适配，形成以业务核心为对象为中心的连接和标签体系。配合企业根据自身的实际情况以及业务需求完成方案的规划、部署与实施，将沉淀的业务数据进入到平台进行体系化的加工，再以服务化的方式支持业务平台上的应用。达成高效支持业务敏捷创新的高质量和标准化的数据服务组合。
