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

来源系统:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
对接目标系统:每刻
每刻报销是杭州每刻科技有限公司的主打产品,为企业提供差旅预订、费用报销管理、全流程费用管控服务,降低企业费用采购成本,提高费用采购和审批审核的效率
数据集成方案配置
轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线,所以对接方案的配置极其重要,方案可以选择一键复制,轻易云有海量的对接方案可支持一键复制,复制后直接启动使用(对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置,配置只要确认源平台:金蝶云星空的取数逻辑,例如什么时间取什么样的数据。即可完成配置,目标平台:每刻,把获取的数据组装成目标系统需要的格式进行写入。



金蝶云星空接口明细
- 接口:executeBillQuery
- 接口名称:银行查询
- 接口方法:POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
| FBANKACNTID | 实体主键 | string | |
| FDocumentStatus | 数据状态 | string | |
| FForbidStatus | 禁用状态 | string | |
| FName | 账户名称 | string | |
| FNumber | 银行账号 | string | |
| FDescription | 备注 | string | |
| FCreateOrgId_Fnumber | 创建组织 | string | |
| FUseOrgId_Fnumber | 使用组织 | string | |
| FCreateDate | 创建日期 | string | |
| FModifyDate | 修改日期 | string | |
| FACNTBRANCHNUMBER | 开户银行联行号 | string | |
| FACNTAREACODE | 账户地区码 | string | |
| FACNTAREANAME | 账户地区名 | string | |
| FBANKID_Fnumber | 开户银行 | string | |
| FApproveDate | 审核日期 | string | |
| FBANKADDRESS | 银行地址 | string | |
| FBankType | 银行 | string | |
| FInOrOut | 账户收支属性 | string | |
| FSRCBILLID | 源单内码 | string | |
| FINNERACCOUNTID | 内部账户 | string | |
| FIsFundUp | 资金上划 | string | |
| FUpType | 上划方式 | string | |
| FUpAmount | 上划定额 | string | |
| FBaseAmount | 留底余额 | string | |
| FMinUpAmount | 最小上划金额 | string | |
| FIsCancel | 是否销户 | string | |
| FIsSupBank | 支持网银 | string | |
| FISDEFAULTBANK | 默认账号 | string | |
| FACCOUNTTYPE | 账号类型 | string | |
| FLICENSEKEY | 授权密码 | string | |
| FPUBLICACNT | 对公账号 | string | |
| FBankServiceLoginId | 登录配置编号 | string | |
| FBankServiceLoginDesc | 银行版本 | string | |
| FCURRENCYID | 币别 | string | |
| FIsSupBBC | 支持BBC分销门户显示 | string | |
| FNProvince | 省 | string | |
| FNCity | 城市 | string | |
| FNDistrict | 地区 | string | |
| FCountry | 国别 | string | |
| FKDPAYNUMBER | 聚合收款商户号 | string | |
| FIsImpNegativeBal | 支持导入负余额对账单 | string | |
| Limit | 最大行数 | string | 金蝶的查询分页参数 |
| StartRow | 开始行索引 | string | 金蝶的查询分页参数 |
| TopRowCount | 返回总行数 | int | 金蝶的查询分页参数 |
| FilterString | 过滤条件 | string | 示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= |
| FieldKeys | 需查询的字段key集合 | array | 金蝶分录主键ID格式:FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber |
| FormId | 业务对象表单Id | string | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
响应参数
| 字段 | 名称 | 类型 | 描述 |
| FBANKACNTID | 实体主键 | string | |
| FDocumentStatus | 数据状态 | string | |
| FForbidStatus | 禁用状态 | string | |
| FName | 账户名称 | string | |
| FNumber | 银行账号 | string | |
| FDescription | 备注 | string | |
| FCreateOrgId_Fnumber | 创建组织 | string | |
| FUseOrgId_Fnumber | 使用组织 | string | |
| FCreateDate | 创建日期 | string | |
| FModifyDate | 修改日期 | string | |
| FACNTBRANCHNUMBER | 开户银行联行号 | string | |
| FACNTAREACODE | 账户地区码 | string | |
| FACNTAREANAME | 账户地区名 | string | |
| FBANKID_Fnumber | 开户银行 | string | |
| FApproveDate | 审核日期 | string | |
| FBANKADDRESS | 银行地址 | string | |
| FBankType | 银行 | string | |
| FInOrOut | 账户收支属性 | string | |
| FSRCBILLID | 源单内码 | string | |
| FINNERACCOUNTID | 内部账户 | string | |
| FIsFundUp | 资金上划 | string | |
| FUpType | 上划方式 | string | |
| FUpAmount | 上划定额 | string | |
| FBaseAmount | 留底余额 | string | |
| FMinUpAmount | 最小上划金额 | string | |
| FIsCancel | 是否销户 | string | |
| FIsSupBank | 支持网银 | string | |
| FISDEFAULTBANK | 默认账号 | string | |
| FACCOUNTTYPE | 账号类型 | string | |
| FLICENSEKEY | 授权密码 | string | |
| FPUBLICACNT | 对公账号 | string | |
| FBankServiceLoginId | 登录配置编号 | string | |
| FBankServiceLoginDesc | 银行版本 | string | |
| FCURRENCYID | 币别 | string | |
| FIsSupBBC | 支持BBC分销门户显示 | string | |
| FNProvince | 省 | string | |
| FNCity | 城市 | string | |
| FNDistrict | 地区 | string | |
| FCountry | 国别 | string | |
| FKDPAYNUMBER | 聚合收款商户号 | string | |
| FIsImpNegativeBal | 支持导入负余额对账单 | string | |
每刻接口明细
- 接口:/api/openapi/enterprise/account/import
- 接口名称:批量导入支付账户
- 接口方法:POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
| payerPaymentType | 账户类型 | string | |
| bankAcctName | 户名 | string | |
| bankAcctNumber | 账号 | string | 部分必填 |
| bankName | 开户银行 | string | 部分必填 |
| bankCountry | 国家和地区 | string | 部分必填 |
数据对接效果
当企业规模逐渐增大时,作为支撑业务运营的IT建设也变得越来越重要,不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程,这样的结果就是,企业上的IT系统很多很全,从ERP到HR、CRM、PDM、OA等,貌似所有的业务都覆盖到了,但实际上因为这些系统的不集成,而形成了企业很多新的信息孤岛,非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看,也不可避免会遇到上述问题,毕竟企业经营的多样化,并不是所有的业务都能在一个系统中完成,所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升API利用率,发挥业务系统价值,实现企业IT资产的可插拔、可复用、可组成。
