阿里宜搭对接打通金蝶云星空搜索表单实例详情列表接口与付款单新增接口

来源系统:阿里宜搭
宜搭为广大企业提供一套低成本的企业应用搭建解决方案。自2019年3月上云以来,宜搭已持续服务数百位合作伙伴,涉及新零售、医疗、银行、制造、酒店等多个行业领域。
对接目标平台:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践,面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司,提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于:集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
数据集成方案配置
集成方案是整个轻易云集成平台的核心,每一个集成方案代表一种业务的对接策略(对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息),用户可以根据业务的不同新建多个不同规则的集成方案。比如:采购订单同步,线上销售出库同步,线下销售出库同步。一个集成方案必须要配置源系统:阿里宜搭,源系统 API:搜索表单实例详情列表,目标系统:金蝶云星空,目标系统 API付款单新增。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。


阿里宜搭接口明细
- 调用接口:/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 | {{DAYS_AGO_1 datetime}} |
| modifiedTo | 修改结束时间 | string | {{CURRENT_TIME datetime}} |
响应参数
| 字段 | 字段名称 | 类型 | 配置值 |
| 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 | |
金蝶云星空接口明细
- 调用接口:batchSave
- 接口名称:付款单新增
- 方法:POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
| FBillNo | 单据编号 | string | {{textField_kwn9b11j}} |
| FCURRENCYID | 币别 | string | PRE001 |
| FDATE | 业务日期 | string | {{gmtModified date}} |
| FBillTypeID | 单据类型 | string | 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 | 往来单位类型 | string | {{radioField_l14f1ua0}} |
| FCONTACTUNIT | 往来单位 | string | _function case '{{radioField_l14f1ua0_id}}' when '员工' then '{{textField_kwbwf1sp}}' when '客户' then '{{textField_kwc795ay}}' when '供应商' then '{{textField_kwc795aw}}' end |
| FBUSINESSTYPE | 业务类型 | string | _function case '{{selectField_kvx7pmj8_id}}' when 'cg' then '2' when 'cg1' then '2' when 'qt' then '3' when 'qt1' then '3' end |
| FSETTLEORGID | 结算组织 | string | {{textField_kwc795az}} |
| FPAYORGID | 付款组织 | string | {{textField_kwc795az}} |
| FPURCHASEORGID | 采购组织 | string | {{textField_kwc795az}} |
| FSETTLECUR | 结算币别 | string | PRE001 |
| FREMARK | 备注 | string | {{textareaField_l1cvujne}} |
| FYDNUM1 | 宜搭流水号 | string | {{textField_kwn9b11j}} |
| FYDID | 宜搭ID | string | {{id}} |
| FPAYBILLENTRY | 付款单明细 | array | tableField_kvxg1udz |
| FPAYBILLENTRY.FSETTLETYPEID | 结算方式 | string | {{textField_kwc795b4}} |
| FPAYBILLENTRY.FPURPOSEID | 付款用途 | string | {{tableField_kvxg1udz.textField_kwc795b2}} |
| FPAYBILLENTRY.FHANDLINGCHARGEFOR | 手续费 | string | |
| FPAYBILLENTRY.FCOSTID | 费用项目 | string | |
| FPAYBILLENTRY.FPAYTOTALAMOUNTFOR | 应付金额 | string | {{numberField_kmtur429}}{{tableField_kvxg1udz.numberField_kvx63996}} |
| FPAYBILLENTRY.FISPOST | 是否登账 | string | |
| FPAYBILLENTRY.FPOSTDATE | 登账日期 | string | |
| FPAYBILLENTRY.FMATERIALID | 物料编码 | string | |
| FPAYBILLENTRY.FEXPENSEDEPTID_E | 费用承担部门 | string | {{tableField_kvxg1udz.textField_kwc795b3}} |
| FPAYBILLENTRY.FPayType | 支付类型 | string | |
| FPAYBILLENTRY.FPRICE | 含税单价 | string | |
| FPAYBILLENTRY.FQTY | 数量 | string | |
| FPAYBILLENTRY.FTaxAmt | 税额 | string | {{tableField_kvxg1udz.numberField_kwd8kkl9}} |
| FPAYBILLENTRY.FCOMMENT | 备注 | string | {{tableField_kvxg1udz.textareaField_kvx7pmjo}} |
| FPAYBILLENTRY.FACCOUNTID | 我方银行账号 | string | {{selectField_kvx7pml8}} |
| FPAYBILLENTRY.F_PAEZ_Assistant | 付款类别 | string | {{textField_kwn8dvvc}} |
| FPAYBILLENTRY.FPURCHASEDEPTID | 采购部门 | string | {{textField_kwc795b1}} |
| FPAYBILLENTRY.F_WX_User | 员工 | string | {{textField_kwc795b0}} |
| FPAYBILLENTRY.FormId | 业务对象表单Id | string | AP_PAYBILL |
| FPAYBILLENTRY.Operation | 执行的操作 | string | BatchSave |
| FPAYBILLENTRY.IsAutoSubmitAndAudit | 提交并审核 | bool | true |
| FPAYBILLENTRY.IsVerifyBaseDataField | 验证基础资料 | bool | false |
系统数据对接
可视化配置,即便是普通业务人员也可以快速轻松对接多个平台,解决企业面临的数据孤岛,数据混乱等问题,实现数据可见、可用、可运营。进行统一化,模块化,标准化的服务能力和输出,实现对业务端数据需求的精准满足和高效响应,也可以在业务数据需求的不断增加下,让企业有整套的可复用的api资产以更换,支持业务的正常运转,节省开发成本。在不同的着重点和应用上解决数据共享,实现平台之间的独立管理。
