易快报和金蝶云星空接口打通对接实战
对接系统易快报
易快报为企业提供移动报销,预算费控,台账管理,报表分析,电子发票验真查重,全流程费控等一站式解决方案.全方位满足企业的报销费控需求,以连接为核心,促进企业降低成本、提升效率.
对接目标系统:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
数据接口配置
集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：易快报，源系统 API：获取指定状态单据列表(包含已删除单据)，目标系统：金蝶云星空，目标系统 API付款单新增。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。
易快报接口明细
- 调用接口：/api/openapi/v1/docSequences
- 接口名称：获取指定状态单据列表(包含已删除单据)
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|---|---|---|
| fields | 需要过滤掉的字段 | object | |
| fields.docData | 单据数据 | object | |
| fields.docData.logs | 审批日志 | string | |
| fields.docData.flowPlan | 审批流信息 | string | |
| fields.type | 单据类型 | string | expense |
| fields.index | 分页查询的起始索引序号 | string | {{LAST_SYNC_TIME}}000 |
| fields.count | 查询数据条数 | string | 10 |
| fields.state | 单据状态 | string | PAID |
响应参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|---|---|---|
| type | type | string | |
| id | id | string | |
| corporationId | corporationId | string | |
| ownerId | ownerId | string | |
| dataType | dataType | string | |
| remark | remark | string | |
| title | title | string | |
| updateTime | updateTime | string | |
| specificationId | specificationId | string | |
| owner | owner | object | |
| owner.id | id | string | |
| owner.name | name | string | |
| owner.departments | departments | string | |
| owner.code | code | string | |
| owner.department | department | object | |
| owner.department.id | id | string | |
| owner.department.name | name | string | |
| owner.department.code | code | string | |
| owner.department.code | code | string | |
| owner.department.userProps | userProps | object | |
| owner.department.userProps.payeeId | payeeId | string | |
| owner.department.userProps.description | description | string | |
| owner.department.userProps.submitterId | submitterId | string | |
| owner.department.userProps.companyRealPay | companyRealPay | string | |
| owner.department.userProps.specificationId | specificationId | string | |
| owner.department.userProps.expenseDepartment | expenseDepartment | string | |
| owner.department.userProps.companyRealPay_rate | companyRealPay_rate | string | |
| owner.department.userProps.companyRealPay_budget | companyRealPay_budget | string | |
| owner.department.userProps.companyRealPay_foreign | companyRealPay_foreign | string | |
| owner.department.userProps.companyRealPay_budgetRate | companyRealPay_budgetRate | string | |
| owner.department.userProps.companyRealPay_budgetUnit | companyRealPay_budgetUnit | string | |
| owner.department.userProps.companyRealPay_budgetScale | companyRealPay_budgetScale | string | |
| owner.department.userProps.companyRealPay_foreignUnit | companyRealPay_foreignUnit | string | |
| owner.department.userProps.companyRealPay_budgetSymbol | companyRealPay_budgetSymbol | string | |
| owner.department.userProps.companyRealPay_standardUnit | companyRealPay_standardUnit | string | |
| owner.department.userProps.companyRealPay_budgetNumCode | companyRealPay_budgetNumCode | string | |
| owner.department.userProps.companyRealPay_budgetStrCode | companyRealPay_budgetStrCode | string | |
| owner.department.userProps.companyRealPay_foreignSymbol | companyRealPay_foreignSymbol | string | |
| owner.department.userProps.companyRealPay_foreignNumCode | companyRealPay_foreignNumCode | string | |
| owner.department.userProps.companyRealPay_foreignStrCode | companyRealPay_foreignStrCode | string | |
| owner.department.userProps.companyRealPay_standardSymbol | companyRealPay_standardSymbol | string | |
| owner.department.userProps.companyRealPay_standardNumCode | companyRealPay_standardNumCode | string | |
| owner.department.userProps.companyRealPay_standardStrCode | companyRealPay_standardStrCode | string | |
| owner.department.userProps.state | state | string | |
| owner.department.userProps.project | project | string | |
| owner.department.userProps.logs | logs | string | |
| owner.department.userProps.flowPlan | flowPlan | string | |
| owner.department.userProps.sumAmount | sumAmount | string | |
| owner.department.userProps.writeOffAmount | writeOffAmount | string | |
| owner.department.userProps.expenseDate | expenseDate | string | |
| owner.department.userProps.details | details | array | |
| owner.department.userProps.details.amount | amount | string | |
| owner.department.userProps.details.amount_standardStrCode | amount_standardStrCode | string | |
| owner.department.userProps.details.amount_standardNumCode | amount_standardNumCode | string | |
| owner.department.userProps.details.amount_standardSymbol | amount_standardSymbol | string | |
| owner.department.userProps.details.amount_standardUnit | amount_standardUnit | string | |
| owner.department.userProps.details.amount_rate | amount_rate | string | |
| owner.department.userProps.details.amount_foreignStrCode | amount_foreignStrCode | string | |
| owner.department.userProps.details.amount_foreignNumCode | amount_foreignNumCode | string | |
| owner.department.userProps.details.amount_foreign | amount_foreign | string | |
| owner.department.userProps.details.amount_foreignSymbol | amount_foreignSymbol | string | |
| owner.department.userProps.details.amount_foreignUnit | amount_foreignUnit | string | |
| owner.department.userProps.details.date | date | string | |
| owner.department.userProps.details.remark | remark | string | |
| owner.department.userProps.details.feeTypeId | feeTypeId | string | |
| owner.department.userProps.details.userProps | userProps | string | |
| owner.department.userProps.details.invoiceCount | invoiceCount | string | |
| owner.department.userProps.details.taxAmount | taxAmount | string | |
| owner.department.userProps.details.noTaxAmount | noTaxAmount | string | |
| owner.department.userProps.details.invoices | invoices | string | |
| owner.department.userProps.details.invoiceFormType | invoiceFormType | string | |
| owner.department.userProps.details.payeeInfo | payeeInfo | string | |
| owner.department.userProps.details.writtenOffRecords | writtenOffRecords | object | |
| owner.department.userProps.details.submitTime | submitTime | string | |
| owner.department.userProps.details.payeeInfo | payeeInfo | object | |
| owner.department.userProps.details.payeeInfo.sort | sort | string | |
| owner.department.userProps.details.payeeInfo.name | name | string | |
| owner.department.userProps.details.payeeInfo.cardNo | cardNo | string | |
| owner.department.userProps.details.payeeInfo.bank | bank | string | |
| owner.department.userProps.details.payeeInfo.branch | branch | string | |
| owner.department.userProps.details.payeeInfo.type | type | string | |
| owner.department.userProps.details.payeeInfo.province | province | string | |
| owner.department.userProps.details.payeeInfo.city | city | string | |
| owner.department.userProps.details.payeeInfo.certificateType | certificateType | string | |
| owner.department.userProps.details.payeeInfo.certificateNo | certificateNo | string | |
| owner.department.userProps.details.payeeInfo.bankLinkNo | bankLinkNo | string | |
| owner.department.userProps.details.payeeInfo.bankName | bankName | string | |
| owner.department.userProps.details.payeeInfo.swiftCode | swiftCode | string | |
| owner.department.userProps.details.payeeInfo.bankCode | bankCode | string | |
| owner.department.userProps.details.payeeInfo.branchCode | branchCode | string | |
| owner.department.userProps.details.payeeInfo.remark | remark | string | |
| owner.department.userProps.details.payeeInfo.id | id | string | |
| owner.department.userProps.details.payeeInfo.payorId | payorId | string | |
| owner.department.userProps.details.payeeInfo.paymentChannel | paymentChannel | string | |
| owner.department.userProps.details.payeeInfo.paymentAccountId | paymentAccountId | string | |
| owner.department.userProps.details.payeeInfo.payTime | payTime | string | |
| owner.department.userProps.details.payeeInfo.multiplePayeesMode | multiplePayeesMode | string | |
| owner.department.userProps.details.payeeInfo.channelTradeNo | channelTradeNo | string | |
| owner.department.userProps.details.payeeInfo.payPlan | payPlan | string | |
| owner.department.userProps.details.payeeInfo.receiptState | receiptState | string | |
| owner.department.userProps.details.payeeInfo.paymentAccount | paymentAccount | string |
金蝶云星空接口明细
- API：batchSave
- NAME：付款单新增
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|---|---|---|
| FBillNo | 单据编号 | _function case when '{{details_userProps_u_归属组织_code}}'='' then '{{code}}{{userProps_u_归属组织_code}}' else '{{code}}{{details_userProps_u_归属组织_code}}' end | |
| FCURRENCYID | 币别 | PRE001 | |
| FDATE | 业务日期 | _function FROM_UNIXTIME( ( {{payTime}} / 1000 ) ,'%Y-%m-%d %H:%i:%S' ) | |
| FBillTypeID | 单据类型 | clbxd | |
| FCONTACTUNITTYPE | 往来单位类型 | BD_Department | |
| FCONTACTUNIT | 往来单位 | _findCollection find code from 19c94f4e-612d-3b26-8952-edf9168371d5 where name={{department.name}} | |
| FRECTUNITTYPE | 收款单位类型 | BD_Department | |
| FRECTUNIT | 收款单位 | _findCollection find code from 19c94f4e-612d-3b26-8952-edf9168371d5 where name={{department.name}} | |
| FSETTLEORGID | 结算组织 | _function case when '{{details.userProps.u_归属组织.code}}'>0 then '{{details.userProps.u_归属组织.code}}' else '{{userProps.u_归属组织.code}}' end | |
| FDepartment | 部门 | _findCollection find code from 19c94f4e-612d-3b26-8952-edf9168371d5 where name={{department_name}} | |
| FPAYORGID | 付款组织 | ||
| FPAYAMOUNTFOR | 付款金额 | _function sum({{sumAmount}}-{{writeOffAmount}}) | |
| FEXCHANGETYPE | 汇率类型 | HLTX01_SYS | |
| FSETTLECUR | 结算币别 | PRE001 | |
| FREMARK | 备注 | {{remark}} | |
| FPAYBILLENTRY | 付款单明细 | details | |
| FPAYBILLENTRY.FSETTLETYPEID | 结算方式 | _function case when '{{paymentAccount_accountNo}}' in ('') then '10' else 'JSFS04_SYS' end | |
| FPAYBILLENTRY.FPAYTOTALAMOUNTFOR | 付款金额 | {{details_amount}} | |
| FPAYBILLENTRY.FPURPOSEID | 收付款用途 | SFKYT12_SYS | |
| FPAYBILLENTRY.FACCOUNTID | 我方银行账号 | {{paymentAccount_accountNo}} | |
| FPAYBILLENTRY.FCOMMENT | 备注 | {{details_remark}} | |
| FPAYBILLENTRY.FCOSTID | 费用项目 | _findCollection find code from 0e3410bc-d1ad-3810-bd5f-639ce883690a where id={{details_feeTypeId}} | |
| FPAYBILLENTRY.FEXPENSEDEPTID_E | 费用承担部门 | _findCollection find code from 19c94f4e-612d-3b26-8952-edf9168371d5 where id={{details_userProps_expenseDepartment}} | |
| FPAYBILLENTRY.F_wk_KH | 客户 | {{details_userProps_u_客户_code}} | |
| FPAYBILLENTRY.F_PBLH_YKBHEXJE | 易快报核销金额 | {{details_amount}} | |
| FPAYBILLENTRY.F_wk_bxje1 | 报销金额 | {{sumAmount}} | |
| FPAYBILLENTRY.F_wk_hxje | 核销金额 | {{writeOffAmount}} | |
| FPAYBILLENTRY.F_wk_YG | 员工 | _function case when '{{userProps_u_原借款人_code}}'='' then '{{userProps_u_实际报销人_code}}' else '{{userProps_u_原借款人_code}}' end | |
| FPAYBILLENTRY.FormId | 业务对象表单Id | AP_PAYBILL | 必须填写金蝶的表单ID如:PUR_PurchaseOrder |
| FPAYBILLENTRY.Operation | 执行的操作 | BatchSave | |
| FPAYBILLENTRY.IsAutoSubmitAndAudit | 提交并审核 | false | |
| FPAYBILLENTRY.IsVerifyBaseDataField | 验证基础资料 | false | 是否验证所有的基础资料有效性，布尔类，默认false（非必录） |
系统数据对接
将传统的统计分析转变为预测分析，从被动分析到主动分析，从非实时分析转变为实时分析，从结构化的数据变成多元化的数据。精准查询数据流同步状况，实时监管队列任务以及数据资产的有序管理。为业务赋能，降本增效，让企业能够更加合理的布局团队；结合业务需求实现与OA，CRM，WMS等系统之间的数据交流与同步，为企业定制自定义的数据管理方案，用技术拓展商业边界，为新业务、新部门提供成长空间。
