从每刻到金蝶云星空通过接口配置打通数据
接入系统:每刻
每刻报销是杭州每刻科技有限公司的主打产品,为企业提供差旅预订、费用报销管理、全流程费用管控服务,降低企业费用采购成本,提高费用采购和审批审核的效率
对接目标平台:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
数据接口配置
系统对接前期需要通过调研公司的业务,规划出最便捷,效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地,轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台:每刻的接口参数设置,以及设定好目标平台:金蝶云星空的映射,即可启动方案进行测试
每刻接口明细
- 接口:/api/openapi/form/reimburse
- 接口名称:报销单列表查询
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
createdAtStart | 根据单据的创建时间 | string | |
createdAtEnd | 根据单据的结束时间 | string | |
pageSize | 分页条数 | string | |
offset | 当前页首条数据在所有数据中的偏移量 | string | |
formStatus | 单据状态 | string | 可选值: APPROVING(审批中),AUDITING(审核中),SIGNING(签收等待)(仅支持报销单),SETTLEMENT(结算中),COMPLETED(已完成),DELETED(已删除),ABANDON(已作废),REJECTED(被驳回)SUBMIT_FAILED(提交失败),DRAFT(草稿)。默认值为所有未删除单据。 |
formSubTypeBizCode | 单据小类业务编码 | string | |
formCodes | 单据号 | string | |
approvedAtStart | 根据单据的审批通过时间 | string | |
approvedAtEnd | 根据单据的审批通过时间 | string | |
auditedAtStart | 最后审核节点的通过时间 | string | |
auditedAtEnd | 最后审核节点的通过时间 | string | |
detailApi | detailApi | string | |
响应参数
字段 | 名称 | 类型 | 描述 |
formDataCode | 单据内码 | string | |
formCode | 单据号 | string | |
formSubTypeBizCode | 单据小类编码 | string | |
formSubTypeName | 单据小类名称 | string | |
reimburseName | 事由 | string | |
coverEmployeeName | 承担人 | string | |
coverEmployeeId | 承担人工号 | string | |
departmentBizCode | 部门业务编码 | string | |
departmentDingtalkId | 钉钉部门ID | string | |
departmentName | 部门Name | string | |
comment | 备注 | string | |
payeeAccount | 收款账户 | string | |
payerAccounts | 支付信息 | string | |
legalEntityBizCode | 公司抬头编码 | string | |
legalEntityName | 公司抬头 | string | |
consumeApplicationCodes | 关联申请单的codes | string | |
associatedFormCodes | 关联内部单据codes | string | |
associatedExternalFormList | 关联外部单据对象数组 | string | |
tradingPartnerBizCode | 往来单位code | string | |
tradingPartnerParentBizCode | 当前往来单位的上一级分类的编码 | string | |
tradingPartnerName | 往来单位名称 | string | |
submittedAt | 提单时间 | string | |
amount | 报销金额 | string | |
baseAmount | 报销本币金额 | string | |
reimEmployeeName | 提单人姓名 | string | |
reimEmployeeId | 提单人工号 | string | |
fillEmployeeName | 填单人姓名 | string | |
fillEmployeeId | 填单人工号 | string | |
formStatus | 单据状态 | string | |
paymentAmount | 应支付金额 | string | |
paymentBaseAmount | 应支付本币金额 | string | |
approvedAt | 审批通过时间 | string | |
approvedAmount | 审批通过金额 | string | |
approvedBaseAmount | 审批通过本币金额 | string | |
settledAt | 支付时间 | string | |
auditedAt | 审核时间 | string | |
createdAt | 单据创建时间 | string | |
attachments | 附件 | string | |
expenseList | 费用列表 | string | |
customObject | 非系统级字段的一个Map集合 | string | |
loanDeductions | 借款核销信息 | string | |
collectionSchedule | 多人收款 | string | |
installment | 是否使用分期付款 | string | |
installmentStatus | 分期状态 | string | |
externalVoucherCodes | 外部凭证编码 | string | |
validationResult | 校验结果 | string | |
signEmployeeName | 签收人姓名(最后一个) | string | |
signEmployeeId | 签收人工号(最后一个) | string | |
creditScore | 信用分 | string | |
creditRank | 信用等级 | string | |
applyRules | 适用费用标准列表 | string | |
formDeductionAmount | 核销金额 | string | |
firstPeriodPayment | 分期情况下首期是否随本单支付 | string | |
generateVoucher | 单据生成凭证标识(false-不生成凭证 true-生成凭证) | string | |
invoiceBagCode | 发票袋编码 | string | |
taxDeductBaseAmount | 单据税额抵扣本币金额 | string | |
taxDeductAcceptAmount | 单据税额抵扣收款金额 | string | |
payerAccountObject | 支付账户组件 | string | |
travelRouteList | 行程 | string | |
submitUserDepartmentBizCode | 提单人部门的编码 | string | |
submitUserDepartmentName | 提单人部门的名称 | string | |
dynaTagList | 标签列表 | string | |
金蝶云星空接口明细
- 接口:batchSave
- 接口名称:付款申请单新增
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
FBillNo | 单据编号 | string | 单据编号 |
FSETTLEORGID | 结算组织 | string | 100 |
FPAYAMOUNTFOR_H | 应付金额 | string | |
FDATE | 申请日期 | string | |
FBillTypeID | 单据类型 | string | 单据类型 |
FAPPLYAMOUNTFOR_H | 申请付款金额 | string | |
FCONTACTUNITTYPE | 往来单位类型 | string | 往来单位类型 |
FCONTACTUNIT | 往来单位 | string | 往来单位 |
FRECTUNITTYPE | 收款单位类型 | string | 收款单位类型 |
FRECTUNIT | 收款单位 | string | |
FPAYORGID | 付款组织 | string | 100 |
FAPPLYORGID | 申请组织 | string | |
FPAYAPPLYENTRY | 付款申请单明细 | array | |
FPAYAPPLYENTRY.FCOSTID | 费用项目 | string | |
FPAYAPPLYENTRY.FAPPLYAMOUNTFOR | 申请付款金额 | string | |
FPAYAPPLYENTRY.FAFTTAXTOTALAMOUNT | 应付金额 | string | |
FPAYAPPLYENTRY.FPAYPURPOSEID | 付款用途 | string | |
FPAYAPPLYENTRY.FEXPIRY | 到期日 | string | |
FPAYAPPLYENTRY.FEXPECTPAYDATE | 期望付款日期 | string | |
FPAYAPPLYENTRY.FDescription | 备注 | string | |
FPAYAPPLYENTRY.F_JSJT_Base_FYCDZZ | 费用承担组织 | string | |
FPAYAPPLYENTRY.FEXPENSEDEPTID | 费用承担部门 | string | |
FPAYAPPLYENTRY.F_JSJT_Base_FKKH | 费用承担客户 | string | |
FPAYAPPLYENTRY.F_JSJT_Base_CK | 仓库 | string | |
FPAYAPPLYENTRY.F_JSJT_Assistant | 股东 | string | |
FPAYAPPLYENTRY.F_JSJT_Assistant1 | 投资项目 | string | |
FPAYAPPLYENTRY.F_JSJT_Assistant2 | 公司 | string | |
FPAYAPPLYENTRY.F_JSJT_FDBL | 返点比率 | string | |
FPAYAPPLYENTRY.FormId | 业务对象表单Id | string | 必须填写金蝶的表单ID如:PUR_PurchaseOrder |
FPAYAPPLYENTRY.Operation | 执行的操作 | string | |
FPAYAPPLYENTRY.IsAutoSubmitAndAudit | 提交并审核 | bool | |
FPAYAPPLYENTRY.IsVerifyBaseDataField | 验证基础资料 | bool | 是否验证所有的基础资料有效性,布尔类,默认false(非必录) |
系统对接概况
当企业规模逐渐增大时,作为支撑业务运营的IT建设也变得越来越重要,不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程,这样的结果就是,企业上的IT系统很多很全,从ERP到HR、CRM、PDM、OA等,貌似所有的业务都覆盖到了,但实际上因为这些系统的不集成,而形成了企业很多新的信息孤岛,非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看,也不可避免会遇到上述问题,毕竟企业经营的多样化,并不是所有的业务都能在一个系统中完成,所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升API利用率,发挥业务系统价值,实现企业IT资产的可插拔、可复用、可组成。
系统数据对接方案元数据代码