金蝶云星空和阿里宜搭单据接口对接

对接源平台:阿里宜搭
宜搭是阿里巴巴自研的基于钉钉和阿里云的低代码平台,可让用户通过简单的拖拽、配置即可完成应用搭建,为每个组织提供低门槛、高效率的数字化业务应用生产新模式。有效缩减企业应用开发时间,助力企业数字化升级。
对接目标平台:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
多系统对接方案配置
数据集成平台对应的配置阿里宜搭与金蝶云星空的对接只要三步就能完成两个系统之间的数据对接。第一步根据阿里宜搭的接口参数要求记录在轻易云集成平台。第二步配置阿里宜搭与金蝶云星空之间的字段对应关系(更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息)第三步完成方案的检查参数设置:传递时间、重试次数、是否启动、前置条件等上线运行。


阿里宜搭接口明细
- 调用接口:/yida_vpc/process/getInstances.json
- 接口名称:搜索表单实例详情列表
- 方法:POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
| appType | 应用ID | string | APP_DYCTQDDB8CX2SDQ6YRJH |
| systemToken | 应用秘钥 | string | QQ766LD1J92V5NCVVQ5WZ20GDSL2201TCBWVK3W1 |
| userId | 管理员用户钉钉ID | string | 016654026426409112 |
| language | 语言 | string | zh_CN |
| formUuid | 表单ID | string | FORM-UX866Q615XJY30VQ4YH4785EEFLT2YH4RWI0LJ |
| currentPage | 当前页 | string | {{PAGINATION_START_PAGE}} |
| pageSize | 每页记录数 | string | {{PAGINATION_PAGE_SIZE}} |
| originatorId | 数据提交人工号 | string | |
| createFrom | 创建开始时间 | string | |
| createTo | 创建结束时间 | string | |
| modifiedFrom | 修改开始时间 | string | {{LAST_SYNC_TIME datetime}} |
| modifiedTo | 修改结束时间 | string | {{CURRENT_TIME datetime}} |
| searchFieldJson | searchFieldJson | object | |
| searchFieldJson.selectField_kvx7pmj8 | selectField_kvx7pmj8 | string | gz |
响应参数
| 字段 | 字段名称 | 类型 | 配置值 |
| 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 | 单据类型 | FKDLX03_SYS | |
| FCONTACTUNITTYPE | 往来单位类型 | ORG_Organizations | |
| FCONTACTUNIT | 往来单位 | {{textField_kwc795az}} | |
| FBUSINESSTYPE | 业务类型 | 4 | |
| 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(非必录) |
系统对接概况
基于轻易云的连接器和数据服务能力,轻松实现供应链异构系统的“相互沟通”,通过数据应用自动化业务流程管理,全面管控供应链的每一环节。从要货、销售出库、退货入库、到盘点、调拨,无需人工参与,实时更新,自动化流转。通过快速连接阿里宜搭接口抽取数据后再自动分发到金蝶云星空, 解放生产力,自动生成数据、并分发推送到业务应用,数据传递时效性提升10倍以上。


