从每刻到金蝶云星空通过接口配置打通数据

源系统:每刻
每刻报销是杭州每刻科技有限公司的主打产品,为企业提供差旅预订、费用报销管理、全流程费用管控服务,降低企业费用采购成本,提高费用采购和审批审核的效率
对接系统:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
多系统对接方案配置
集成方案是整个轻易云集成平台的核心,每一个集成方案代表一种业务的对接策略(对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息),用户可以根据业务的不同新建多个不同规则的集成方案。比如:采购订单同步,线上销售出库同步,线下销售出库同步。一个集成方案必须要配置源系统:每刻,源系统 API:报销单列表查询,目标系统:金蝶云星空,目标系统 API写入空操作。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。

每刻接口明细
- 接口:/api/openapi/paymenttransaction/paid/list
- 接口名称:报销单列表查询
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
startPaidTime | 支付完成时间-开始范围,毫秒的时间戳,非必填 | string | |
endPaidTime | 支付完成时间-结束范围,毫秒的时间戳,非必填 | string | |
pageSize | 分页条数 | string | |
pageNum | 当前页首条数据在所有数据中的偏移量 | string | |
paymentNo | 付款单ID,非必填,对应form_pay_order中的payment_order_id | string | 可选值: APPROVING(审批中),AUDITING(审核中),SIGNING(签收等待)(仅支持报销单),SETTLEMENT(结算中),COMPLETED(已完成),DELETED(已删除),ABANDON(已作废),REJECTED(被驳回)SUBMIT_FAILED(提交失败),DRAFT(草稿)。默认值为所有未删除单据。 |
响应参数
字段 | 名称 | 类型 | 描述 |
payeeTargetBusinessCode | 单据号 | string | |
payerAccountName | 支付账户 | string | |
payerAccountNumber | 支付账号 | string | |
payerAccountType | 付款方式 | string | |
金蝶云星空接口明细
- 调用接口:Push
- 接口名称:写入空操作
- 方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
Ids | id集合 | string | |
FormId | 业务对象表单Id | string | CN_PAYAPPLY |
Numbers | 编码集合 | string | {{payeeTargetBusinessCode}} |
RuleId | 单据转换规则内码 | string | 994f9913-a23f-46fb-b5d9-f1f271b4ef6c |
TargetOrgId | 目标组织内码 | string | _findCollection find FUseOrgId from c2b5e68c-1b80-398b-bec8-59612f54e804 where FNumber={{payerAccountNumber}} |
TargetFormId | TargetFormId | string | AP_PAYBILL |
IsEnableDefaultRule | 是否启用默认单据转换 | string | true |
IsDraftWhenSaveFail | IsDraftWhenSaveFail | string | false |
响应参数
字段 | 字段名称 | 类型 | 配置值 |
primaryWriteback | primaryWriteback | object | |
primaryWriteback.id | id | string | {{Id}} |
primaryWriteback.number | number | string | {{Number}} |
primaryWriteback.callBackStrategy | 回写方案 | object | |
primaryWriteback.callBackStrategy.strategyId | 方案ID | string | 718db844-82f4-3b91-bf64-65ce06dc2025 |
primaryWriteback.callBackStrategy.paymentBizCode | 原始ID | string | {{paymentBizCode}} |
primaryWriteback.callBackStrategy.payeeTargetBusinessCode | 原始单据编号 | string | {{payeeTargetBusinessCode}} |
primaryWriteback.callBackStrategy.Id | 目标写入 | string | {{primaryWriteback.id}} |
primaryWriteback.callBackStrategy.number | 目标写入 | string | {{primaryWriteback.number}} |
primaryWriteback.callBackStrategy.payerAccountNumber | 银行账号 | string | {{payerAccountNumber}} |
primaryWriteback.callBackStrategy.payableAmount | 付款金额 | string | {{payableAmount}} |
primaryWriteback.callBackStrategy.paidTimeStamp | 付款时间 | string | {{paidTimeStamp}} |
系统数据对接
从API服务总线层面解决企业烟囱式业务系统集成现状 相互连接企业各业务系统,实现流程端到端打通,复用已有的业务系统能力,让集成架构、服务关系更清晰 使用统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升API利用率,发挥业务系统价值,实现企业IT资产的可插拔、可复用、可组成。

