赛意SMOM与金蝶云星空对接集成客户查询连通保存客户地址数据(k客户对接)

源系统:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
目标系统:赛意SMOM
广州赛意信息科技股份有限公司(简称“赛意信息”),成立于2005年,2017年8月在深圳证券交易所挂牌上市(证券代码:300687),是深交所创业板第666家上市企业。
系统对接接口配置
通过数据集成平台新增创建集成方案,然后在数据源平台中选择对应的源平台为:金蝶云星空,并且选择对应的连接器(关于金蝶云星空的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息)。选择对应的客户查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为赛意SMOM,并且选择对应连接器。选择对应的保存客户地址数据接口作为数据写入动作,既可以完成第一步的数据对接配置;打破跨系统连接,让数据轻易互通成为现实。

金蝶云星空接口明细
- 调用接口: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 | |
赛意SMOM接口明细
- API:InfWebApiController.SaveCustomerAddresss
- NAME:保存客户地址数据
- METHOD:POST
请求参数
| 接口字段 | 名称 | 预设值 |
| CustomerCode | 客户编码 | {{FNumber}} |
| Country | 国家 | |
| Province | 省份 | |
| City | 城市 | |
| Area | 区域 | |
| Address | 地址 | |
| Contacts | 联系人 | |
| Phone | 电话 | |
| Fax | 传真 | |
| Email | 邮箱 | |
| ZipCode | 邮政编码 | |
| State | 状态 | 1 |
| Remark | 备注 | |
| AddressType | 地址类型 | |
| ErpKey | ErpKey | |
| Code | 编码 | {{FNumber}} |
| Name | 名称 | {{FName}} |
| Infkey | Infkey | |
| IsDelete | 是否删除 | |
| LastUpdateDate | 上次更新日期 | |
系统对接概况
随着企业数字化业务的深入发展,对于企业的 IT 或者 CIO 来讲,正在面临一个愈发重要的问题——系统的结构太复杂了,尤其是头部企业,至少有十多套系统,这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统,如何整合企业的现有IT资源,使企业中计算机孤岛式的应用向集体协作的方向发展,发挥资源效益的最大化,降低企业成本,正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上,操作统一,以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中,轻易云应用集成平台负责实现异构、分布式系统之间互联互通,实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件,连接现有各孤立应用系统,以图形化、拖拽方式构建集成流程和服务,提高应用系统集成工作效率,降低异构系统集成风险。针对未来可能出现的业务需求变更,在应用集成平台上进行动态调整,实现各应用系统之间的集成策略平滑升级。


