金蝶云星空和轻易云集成平台接口打通对接实战
对接源平台:金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
集成系统:轻易云集成平台
从API服务总线层面解决企业烟囱式业务系统集成现状相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成
数据接口配置
通过轻易云系统数据集成平台新增创建集成方案，通过轻易云的方案市场可以一键复制，并且可以借鉴其他的方案配置完成方案制作，方案制作只需要两步，第一步先确定好对应的数据来源；源系统：金蝶云星空接口：银行查询通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统：轻易云集成平台接口：写入空操作，通过写入调度者匹配获取到的数据和写入的映射关系，即可自动生成符合目标系统：轻易云集成平台写入的数据自动产生写入队列，通过运行概况，系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况通过该系统数据集成平台的能力，可以集成的应用系统包括CRM、ERP、钉钉、企业微信、MES、飞书、用友、金蝶等 177 个不同应用系统之间的无代码接口集成，并且每周都在增加新的应用系统接入。
金蝶云星空接口明细
- API：executeBillQuery
- NAME：银行查询
- METHOD：POST
请求参数
| 接口字段 | 名称 | 预设值 |
|---|
| FBANKACNTID | 实体主键 | FBANKACNTID |
| FDocumentStatus | 数据状态 | FDocumentStatus |
| FName | 账户名称 | FName |
| FNumber | 银行账号 | FNumber |
| FDescription | 备注 | FDescription |
| FCreateOrgId_Fnumber | 创建组织 | FCreateOrgId.Fnumber |
| FUseOrgId_Fnumber | 使用组织 | FUseOrgId.Fnumber |
| FUseOrgId | 使用组织内码 | FUseOrgId |
| FModifyDate | 修改日期 | FModifyDate |
| FACNTBRANCHNUMBER | 开户银行联行号 | FACNTBRANCHNUMBER |
| FACNTAREACODE | 账户地区码 | FACNTAREACODE |
| FACNTAREANAME | 账户地区名 | FACNTAREANAME |
| FBANKID_Fnumber | 开户银行 | FBANKID.Fnumber |
| FApproveDate | 审核日期 | FApproveDate |
| FBANKADDRESS | 银行地址 | FBANKADDRESS |
| FBankType | 银行 | FBankType |
| FInOrOut | 账户收支属性 | FInOrOut |
| FSRCBILLID | 源单内码 | FSRCBILLID |
| FINNERACCOUNTID | 内部账户 | FINNERACCOUNTID |
| FIsFundUp | 资金上划 | FIsFundUp |
| FUpType | 上划方式 | FUpType |
| FUpAmount | 上划定额 | FUpAmount |
| FBaseAmount | 留底余额 | FBaseAmount |
| FMinUpAmount | 最小上划金额 | FMinUpAmount |
| FIsCancel | 是否销户 | FIsCancel |
| FIsSupBank | 支持网银 | FIsSupBank |
| FISDEFAULTBANK | 默认账号 | FISDEFAULTBANK |
| FACCOUNTTYPE | 账号类型 | FACCOUNTTYPE |
| FLICENSEKEY | 授权密码 | FLICENSEKEY |
| FPUBLICACNT | 对公账号 | FPUBLICACNT |
| FBankServiceLoginId | 登录配置编号 | FBankServiceLoginId |
| FBankServiceLoginDesc | 银行版本 | FBankServiceLoginDesc |
| FCURRENCYID | 币别 | FCURRENCYID |
| FIsSupBBC | 支持BBC分销门户显示 | FIsSupBBC |
| FNProvince | 省 | FNProvince |
| FNCity | 城市 | FNCity |
| FNDistrict | 地区 | FNDistrict |
| FCountry | 国别 | FCountry |
| FKDPAYNUMBER | 聚合收款商户号 | FKDPAYNUMBER |
| FIsImpNegativeBal | 支持导入负余额对账单 | FIsImpNegativeBal |
| FForbidStatus | 禁用状态 | FForbidStatus |
| Limit | 最大行数 | {{PAGINATION_PAGE_SIZE}} |
| StartRow | 开始行索引 | {{PAGINATION_START_ROW}} |
| TopRowCount | 返回总行数 | |
| FilterString | 过滤条件 | FApproveDate>='{{LAST_SYNC_TIME dateTime}}' and FForbidStatus='A' and (FUseOrgId.Fnumber = '103' or FUseOrgId.Fnumber = '104') |
| FieldKeys | 需查询的字段key集合 | |
| FormId | 业务对象表单Id | CN_BANKACNT |
响应参数
| 接口字段 | 名称 | 预设值 |
|---|
| FBANKACNTID | 实体主键 | |
| FDocumentStatus | 数据状态 | |
| FName | 账户名称 | |
| FNumber | 银行账号 | |
| FDescription | 备注 | |
| FCreateOrgId_Fnumber | 创建组织 | |
| FUseOrgId_Fnumber | 使用组织 | |
| FUseOrgId | 创建组织内码 | |
| FModifyDate | 修改日期 | |
| FACNTBRANCHNUMBER | 开户银行联行号 | |
| FACNTAREACODE | 账户地区码 | |
| FACNTAREANAME | 账户地区名 | |
| FBANKID_Fnumber | 开户银行 | |
| FApproveDate | 审核日期 | |
| FBANKADDRESS | 银行地址 | |
| FBankType | 银行 | |
| FInOrOut | 账户收支属性 | |
| FSRCBILLID | 源单内码 | |
| FINNERACCOUNTID | 内部账户 | |
| FIsFundUp | 资金上划 | |
| FUpType | 上划方式 | |
| FUpAmount | 上划定额 | |
| FBaseAmount | 留底余额 | |
| FMinUpAmount | 最小上划金额 | |
| FIsCancel | 是否销户 | |
| FIsSupBank | 支持网银 | |
| FISDEFAULTBANK | 默认账号 | |
| FACCOUNTTYPE | 账号类型 | |
| FLICENSEKEY | 授权密码 | |
| FPUBLICACNT | 对公账号 | |
| FBankServiceLoginId | 登录配置编号 | |
| FBankServiceLoginDesc | 银行版本 | |
| FCURRENCYID | 币别 | |
| FIsSupBBC | 支持BBC分销门户显示 | |
| FNProvince | 省 | |
| FNCity | 城市 | |
| FNDistrict | 地区 | |
| FCountry | 国别 | |
| FKDPAYNUMBER | 聚合收款商户号 | |
| FIsImpNegativeBal | 支持导入负余额对账单 | |
| FForbidStatus | 禁用状态 | |
轻易云集成平台接口明细
- API：写入空操作
- NAME：写入空操作
- METHOD：POST
系统数据集成价值
当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。
