金蝶云星空和阿里宜搭单据接口对接
对接源平台:阿里宜搭
宜搭是阿里巴巴自研的低代码应用搭建平台,传统情况下需要2周才能搭建完成的应用,用宜搭2小时就可完成。宜搭于2019年3月上线,用户可以在可视化界面上以拖拉拽的方式编辑和配置页面,表单和流程,并一键发布到PC和手机端。
目标系统:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上,提供了标准的管理模式;通过标准的业务架构:多会计准则、多币别、多地点、多组织、多税制应用框架等,有效支持企业的运营管理;K/3Cloud提供了标准的业务建模:35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合,288个业务服务构件,让企业及伙伴可快速构建出行业化及个性化的应用。
多系统对接方案配置
通过轻易云系统数据集成平台新增创建集成方案,然后在数据源平台中选择对应的源平台为:阿里宜搭,并且选择对应的连接器(关于阿里宜搭的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息)。选择对应的搜索表单实例详情列表接口作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空,并且选择对应连接器。选择对应的付款单新增接口作为数据写入动作,既可以完成第一步的数据对接配置;打破跨系统连接,让数据轻易互通成为现实。
阿里宜搭接口明细
- 接口:/yida_vpc/process/getInstances.json
- 接口名称:搜索表单实例详情列表
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
appType | 应用ID | string | 示例:APP_PBKT0MFBEBTDO8T7SLVP |
systemToken | 应用秘钥 | string | |
userId | 管理员用户钉钉ID | string | 钉钉的userId |
language | 语言 | string | |
formUuid | 表单ID | string | |
currentPage | 当前页 | string | |
pageSize | 每页记录数 | string | |
originatorId | 数据提交人工号 | string | 用户钉钉ID |
createFrom | 创建开始时间 | string | |
createTo | 创建结束时间 | string | |
modifiedFrom | 修改开始时间 | string | |
modifiedTo | 修改结束时间 | string | |
响应参数
字段 | 名称 | 类型 | 描述 |
gmtCreate | 创建时间 | string | |
gmtModified | 最近修改时间 | string | |
originatorUserId | 创建人ID | string | |
originator | 创建人 | string | |
attachmentField_kvx7pmjz | 附件 | string | |
imageField_kvx7pmjy | 图片上传 | string | |
dateField_kw0bado7 | 付款日期 | string | |
selectField_kvx7pml8 | 支付银行账号 | string | |
textField_kwc795b4 | 结算方式编码 | string | |
selectField_kvx7pml7 | 结算方式 | string | |
textareaField_kvx7pmjp | 事由 | string | |
numberField_kvxgr707 | 核销后还需付款金额 | string | |
numberField_kvxgr706 | 核销金额 | string | |
numberField_kw2uuo99 | 总申请金额 | string | |
textareaField_kvx7pmjj | 业务描述 | string | |
textField_kw1faw4z | 银行账号 | string | |
textField_kvx7pmiw | 开户行名称 | string | |
textField_kvx7pmkl | 收款人 | string | |
textField_kwc795ay | 客户编码 | string | |
selectField_kvxrloav | 客户 | string | |
textField_kwc795aw | 供应商编码 | string | |
selectField_kvxrloau | 供应商 | string | |
textField_kwbwf1sp | 员工编码 | string | |
selectField_kvxrloas | 员工 | string | |
radioField_l14f1ua0 | 类型 | string | |
dateField_kvx7pmkc | 预计核销日期 | string | |
selectField_l0q0zz7v | 采购品牌 | string | |
textField_kwn9b11j | 流水号 | string | |
textField_kwn8dvvc | 付款类别编码 | string | |
selectField_kvx7pmj8 | 付款类别 | string | |
textField_kw01ezvb | 付款类别-文本 | string | |
textField_kwc795b1 | 申请部门编码 | string | |
dateField_kvx7pmi1 | 申请日期 | string | |
selectField_kvx7pmkd | 申请部门 | string | |
selectField_kwlknqm8 | 营销公司 | string | |
textField_kvxjvp6n | 部门-文本 | string | |
textField_kwc795b0 | 申请人编码 | string | |
selectField_kvx6398f | 申请人 | string | |
textField_kvxjvp6m | 组织-文本 | string | |
textField_kwc795az | 组织编码 | string | |
selectField_kvx6398d | 申请组织 | string | |
tableField_kvxg1udz | 明细 | array | |
tableField_kvxg1udz.dateField_kvx7pmka | 明细-预算日期 | string | |
tableField_kvxg1udz.textareaField_kvx7pmjo | 明细-财务备注 | string | |
tableField_kvxg1udz.numberField_kwd8kkl9 | 明细-税额 | string | |
tableField_kvxg1udz.numberField_kwd8kkl8 | 明细-税率 | string | |
tableField_kvxg1udz.numberField_kvx63996 | 明细-申请金额 | string | |
tableField_kvxg1udz.textField_kwc795b3 | 明细-费用承担部门编码 | string | |
tableField_kvxg1udz.selectField_kvx7pmk9 | 明细-费用承担部门 | string | |
tableField_kvxg1udz.textField_kwc795b2 | 明细-收付款用途编码 | string | |
tableField_kvxg1udz.selectField_kvx63994 | 明细-收付款用途 | string | |
金蝶云星空接口明细
- API:batchSave
- NAME:付款单新增
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
FBillNo | 单据编号 | {{textField_kwn9b11j}} | |
FCURRENCYID | 币别 | PRE001 | |
FDATE | 业务日期 | {{gmtModified date}} | |
FBillTypeID | 单据类型 | function case '{{selectField_kvx7pmj8_id}}' when 'cg' then 'FKDLX01_SYS' when 'cg1' then 'FKDLX01_SYS' when 'qt' then 'FKDLX02_SYS' when 'qt1' then 'FKDLX02_SYS' when 'gz' then 'FKDLX03_SYS' end | |
FCONTACTUNITTYPE | 往来单位类型 | {{radioField_l14f1ua0}} | |
FCONTACTUNIT | 往来单位 | _function case '{{radioField_l14f1ua0_id}}' when '员工' then '{{textField_kwbwf1sp}}' when '客户' then '{{textField_kwc795ay}}' when '供应商' then '{{textField_kwc795aw}}' end | |
FBUSINESSTYPE | 业务类型 | _function case '{{selectField_kvx7pmj8_id}}' when 'cg' then '2' when 'cg1' then '2' when 'qt' then '3' when 'qt1' then '3' end | |
FSETTLEORGID | 结算组织 | {{textField_kwc795az}} | |
FPAYORGID | 付款组织 | {{textField_kwc795az}} | |
FPURCHASEORGID | 采购组织 | {{textField_kwc795az}} | |
FSETTLECUR | 结算币别 | PRE001 | |
FREMARK | 备注 | {{textareaField_l1cvujne}} | |
FYDNUM1 | 宜搭流水号 | {{textField_kwn9b11j}} | |
FYDID | 宜搭ID | {{id}} | |
FPAYBILLENTRY | 付款单明细 | tableField_kvxg1udz | |
FPAYBILLENTRY.FSETTLETYPEID | 结算方式 | {{textField_kwc795b4}} | |
FPAYBILLENTRY.FPURPOSEID | 付款用途 | {{tableField_kvxg1udz.textField_kwc795b2}} | |
FPAYBILLENTRY.FHANDLINGCHARGEFOR | 手续费 | | |
FPAYBILLENTRY.FCOSTID | 费用项目 | | |
FPAYBILLENTRY.FPAYTOTALAMOUNTFOR | 应付金额 | {{numberField_kmtur429}}{{tableField_kvxg1udz.numberField_kvx63996}} | |
FPAYBILLENTRY.FISPOST | 是否登账 | | |
FPAYBILLENTRY.FPOSTDATE | 登账日期 | | |
FPAYBILLENTRY.FMATERIALID | 物料编码 | | |
FPAYBILLENTRY.FEXPENSEDEPTID_E | 费用承担部门 | {{tableField_kvxg1udz.textField_kwc795b3}} | |
FPAYBILLENTRY.FPayType | 支付类型 | | |
FPAYBILLENTRY.FPRICE | 含税单价 | | |
FPAYBILLENTRY.FQTY | 数量 | | |
FPAYBILLENTRY.FTaxAmt | 税额 | {{tableField_kvxg1udz.numberField_kwd8kkl9}} | |
FPAYBILLENTRY.FCOMMENT | 备注 | {{tableField_kvxg1udz.textareaField_kvx7pmjo}} | |
FPAYBILLENTRY.FACCOUNTID | 我方银行账号 | {{selectField_kvx7pml8}} | |
FPAYBILLENTRY.F_PAEZ_Assistant | 付款类别 | {{textField_kwn8dvvc}} | |
FPAYBILLENTRY.FPURCHASEDEPTID | 采购部门 | {{textField_kwc795b1}} | |
FPAYBILLENTRY.F_WX_User | 员工 | {{textField_kwc795b0}} | |
FPAYBILLENTRY.FormId | 业务对象表单Id | AP_PAYBILL | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
FPAYBILLENTRY.Operation | 执行的操作 | BatchSave | |
FPAYBILLENTRY.IsAutoSubmitAndAudit | 提交并审核 | true | |
FPAYBILLENTRY.IsVerifyBaseDataField | 验证基础资料 | false | 是否验证所有的基础资料有效性,布尔类,默认false(非必录) |
系统对接概况
可视化配置,即便是普通业务人员也可以快速轻松对接多个平台,解决企业面临的数据孤岛,数据混乱等问题,实现数据可见、可用、可运营。进行统一化,模块化,标准化的服务能力和输出,实现对业务端数据需求的精准满足和高效响应,也可以在业务数据需求的不断增加下,让企业有整套的可复用的api资产以更换,支持业务的正常运转,节省开发成本。在不同的着重点和应用上解决数据共享,实现平台之间的独立管理。