阿里宜搭和金蝶云星空接口打通对接实战来源系统:阿里宜搭宜搭为广大企业提供一套低成本的企业应用搭建解决方案。自2019年3月上云以来，宜搭已持续服务数百位合作伙伴，涉及新零售、医疗、银行、制造、酒店等多个行业领域。对接目标系统:金蝶云星空金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。数据对接方案数据集成平台对应的配置阿里宜搭与金蝶云星空的对接只要三步就能完成两个系统之间的数据对接。第一步根据阿里宜搭的接口参数要求记录在轻易云集成平台。第二步配置阿里宜搭与金蝶云星空之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。阿里宜搭接口明细 API： /yida_vpc/process/getInstances.json NAME：搜索表单实例详情列表 METHOD： POST 请求参数接口字段字段名称预设值描述 appType 应用ID APP_DYCTQDDB8CX2SDQ6YRJH 示例：APP_PBKT0MFBEBTDO8T7SLVP systemToken 应用秘钥 QQ766LD1J92V5NCVVQ5WZ20GDSL2201TCBWVK3W1 userId 管理员用户钉钉ID 016654026426409112 钉钉的userId language 语言 zh_CN formUuid 表单ID FORM-UX866Q615XJY30VQ4YH4785EEFLT2YH4RWI0LJ currentPage 当前页 {{PAGINATION_START_PAGE}} pageSize 每页记录数 {{PAGINATION_PAGE_SIZE}} originatorId 数据提交人工号用户钉钉ID createFrom 创建开始时间 createTo 创建结束时间 modifiedFrom 修改开始时间 {{DAYS_AGO_1 datetime}} modifiedTo 修改结束时间 {{CURRENT_TIME datetime}} 响应参数接口字段字段名称预设值描述 gmtCreate 创建时间 gmtModified 最近修改时间 originatorUserId 创建人ID originator 创建人 attachmentField_kvx7pmjz 附件 imageField_kvx7pmjy 图片上传 dateField_kw0bado7 付款日期 selectField_kvx7pml8 支付银行账号 textField_kwc795b4 结算方式编码 selectField_kvx7pml7 结算方式 textareaField_kvx7pmjp 事由 numberField_kvxgr707 核销后还需付款金额 numberField_kvxgr706 核销金额 numberField_kw2uuo99 总申请金额 textareaField_kvx7pmjj 业务描述 textField_kw1faw4z 银行账号 textField_kvx7pmiw 开户行名称 textField_kvx7pmkl 收款人 textField_kwc795ay 客户编码 selectField_kvxrloav 客户 textField_kwc795aw 供应商编码 selectField_kvxrloau 供应商 textField_kwbwf1sp 员工编码 selectField_kvxrloas 员工 radioField_l14f1ua0 类型 dateField_kvx7pmkc 预计核销日期 selectField_l0q0zz7v 采购品牌 textField_kwn9b11j 流水号 textField_kwn8dvvc 付款类别编码 selectField_kvx7pmj8 付款类别 textField_kw01ezvb 付款类别-文本 textField_kwc795b1 申请部门编码 dateField_kvx7pmi1 申请日期 selectField_kvx7pmkd 申请部门 selectField_kwlknqm8 营销公司 textField_kvxjvp6n 部门-文本 textField_kwc795b0 申请人编码 selectField_kvx6398f 申请人 textField_kvxjvp6m 组织-文本 textField_kwc795az 组织编码 selectField_kvx6398d 申请组织 tableField_kvxg1udz 明细 tableField_kvxg1udz.dateField_kvx7pmka 明细-预算日期 tableField_kvxg1udz.textareaField_kvx7pmjo 明细-财务备注 tableField_kvxg1udz.numberField_kwd8kkl9 明细-税额 tableField_kvxg1udz.numberField_kwd8kkl8 明细-税率 tableField_kvxg1udz.numberField_kvx63996 明细-申请金额 tableField_kvxg1udz.textField_kwc795b3 明细-费用承担部门编码 tableField_kvxg1udz.selectField_kvx7pmk9 明细-费用承担部门 tableField_kvxg1udz.textField_kwc795b2 明细-收付款用途编码 tableField_kvxg1udz.selectField_kvx63994 明细-收付款用途金蝶云星空接口明细接口： batchSave 接口名称：付款单新增接口方法： POST 请求参数字段名称类型描述 FBillNo 单据编号 string FCURRENCYID 币别 string FDATE 业务日期 string FBillTypeID 单据类型 string FCONTACTUNITTYPE 往来单位类型 string FCONTACTUNIT 往来单位 string FBUSINESSTYPE 业务类型 string FSETTLEORGID 结算组织 string FPAYORGID 付款组织 string FPURCHASEORGID 采购组织 string FSETTLECUR 结算币别 string FREMARK 备注 string FYDNUM1 宜搭流水号 string FYDID 宜搭ID string FPAYBILLENTRY 付款单明细 array FPAYBILLENTRY.FSETTLETYPEID 结算方式 string FPAYBILLENTRY.FPURPOSEID 付款用途 string FPAYBILLENTRY.FHANDLINGCHARGEFOR 手续费 string FPAYBILLENTRY.FCOSTID 费用项目 string FPAYBILLENTRY.FPAYTOTALAMOUNTFOR 应付金额 string FPAYBILLENTRY.FISPOST 是否登账 string FPAYBILLENTRY.FPOSTDATE 登账日期 string FPAYBILLENTRY.FMATERIALID 物料编码 string FPAYBILLENTRY.FEXPENSEDEPTID_E 费用承担部门 string FPAYBILLENTRY.FPayType 支付类型 string FPAYBILLENTRY.FPRICE 含税单价 string FPAYBILLENTRY.FQTY 数量 string FPAYBILLENTRY.FTaxAmt 税额 string FPAYBILLENTRY.FCOMMENT 备注 string FPAYBILLENTRY.FACCOUNTID 我方银行账号 string FPAYBILLENTRY.F_PAEZ_Assistant 付款类别 string FPAYBILLENTRY.FPURCHASEDEPTID 采购部门 string FPAYBILLENTRY.F_WX_User 员工 string FPAYBILLENTRY.FormId 业务对象表单Id string 必须填写金蝶的表单ID如😛UR_PurchaseOrder FPAYBILLENTRY.Operation 执行的操作 string FPAYBILLENTRY.IsAutoSubmitAndAudit 提交并审核 bool FPAYBILLENTRY.IsVerifyBaseDataField 验证基础资料 bool 是否验证所有的基础资料有效性，布尔类，默认false（非必录）数据对接效果通过数据集成平台可视化的快速配置调用接口打通阿里宜搭与金蝶云星空之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。

阿里宜搭和金蝶云星空接口打通对接实战

汪淼_轻易云

阿里宜搭和金蝶云星空接口打通对接实战

来源系统:阿里宜搭

宜搭为广大企业提供一套低成本的企业应用搭建解决方案。自2019年3月上云以来，宜搭已持续服务数百位合作伙伴，涉及新零售、医疗、银行、制造、酒店等多个行业领域。

对接目标系统:金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

数据对接方案

数据集成平台对应的配置阿里宜搭与金蝶云星空的对接只要三步就能完成两个系统之间的数据对接。第一步根据阿里宜搭的接口参数要求记录在轻易云集成平台。第二步配置阿里宜搭与金蝶云星空之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。

阿里宜搭接口明细

API：/yida_vpc/process/getInstances.json
NAME：搜索表单实例详情列表
METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
appType	应用ID	APP_DYCTQDDB8CX2SDQ6YRJH	示例：APP_PBKT0MFBEBTDO8T7SLVP
systemToken	应用秘钥	QQ766LD1J92V5NCVVQ5WZ20GDSL2201TCBWVK3W1
userId	管理员用户钉钉ID	016654026426409112	钉钉的userId
language	语言	zh_CN
formUuid	表单ID	FORM-UX866Q615XJY30VQ4YH4785EEFLT2YH4RWI0LJ
currentPage	当前页	{{PAGINATION_START_PAGE}}
pageSize	每页记录数	{{PAGINATION_PAGE_SIZE}}
originatorId	数据提交人工号		用户钉钉ID
createFrom	创建开始时间
createTo	创建结束时间
modifiedFrom	修改开始时间	{{DAYS_AGO_1 datetime}}
modifiedTo	修改结束时间	{{CURRENT_TIME datetime}}

响应参数

接口字段	字段名称	预设值	描述
gmtCreate	创建时间
gmtModified	最近修改时间
originatorUserId	创建人ID
originator	创建人
attachmentField_kvx7pmjz	附件
imageField_kvx7pmjy	图片上传
dateField_kw0bado7	付款日期
selectField_kvx7pml8	支付银行账号
textField_kwc795b4	结算方式编码
selectField_kvx7pml7	结算方式
textareaField_kvx7pmjp	事由
numberField_kvxgr707	核销后还需付款金额
numberField_kvxgr706	核销金额
numberField_kw2uuo99	总申请金额
textareaField_kvx7pmjj	业务描述
textField_kw1faw4z	银行账号
textField_kvx7pmiw	开户行名称
textField_kvx7pmkl	收款人
textField_kwc795ay	客户编码
selectField_kvxrloav	客户
textField_kwc795aw	供应商编码
selectField_kvxrloau	供应商
textField_kwbwf1sp	员工编码
selectField_kvxrloas	员工
radioField_l14f1ua0	类型
dateField_kvx7pmkc	预计核销日期
selectField_l0q0zz7v	采购品牌
textField_kwn9b11j	流水号
textField_kwn8dvvc	付款类别编码
selectField_kvx7pmj8	付款类别
textField_kw01ezvb	付款类别-文本
textField_kwc795b1	申请部门编码
dateField_kvx7pmi1	申请日期
selectField_kvx7pmkd	申请部门
selectField_kwlknqm8	营销公司
textField_kvxjvp6n	部门-文本
textField_kwc795b0	申请人编码
selectField_kvx6398f	申请人
textField_kvxjvp6m	组织-文本
textField_kwc795az	组织编码
selectField_kvx6398d	申请组织
tableField_kvxg1udz	明细
tableField_kvxg1udz.dateField_kvx7pmka	明细-预算日期
tableField_kvxg1udz.textareaField_kvx7pmjo	明细-财务备注
tableField_kvxg1udz.numberField_kwd8kkl9	明细-税额
tableField_kvxg1udz.numberField_kwd8kkl8	明细-税率
tableField_kvxg1udz.numberField_kvx63996	明细-申请金额
tableField_kvxg1udz.textField_kwc795b3	明细-费用承担部门编码
tableField_kvxg1udz.selectField_kvx7pmk9	明细-费用承担部门
tableField_kvxg1udz.textField_kwc795b2	明细-收付款用途编码
tableField_kvxg1udz.selectField_kvx63994	明细-收付款用途

金蝶云星空接口明细

接口：batchSave
接口名称：付款单新增
接口方法：POST

请求参数

字段	名称	类型	描述
FBillNo	单据编号	string
FCURRENCYID	币别	string
FDATE	业务日期	string
FBillTypeID	单据类型	string
FCONTACTUNITTYPE	往来单位类型	string
FCONTACTUNIT	往来单位	string
FBUSINESSTYPE	业务类型	string
FSETTLEORGID	结算组织	string
FPAYORGID	付款组织	string
FPURCHASEORGID	采购组织	string
FSETTLECUR	结算币别	string
FREMARK	备注	string
FYDNUM1	宜搭流水号	string
FYDID	宜搭ID	string
FPAYBILLENTRY	付款单明细	array
FPAYBILLENTRY.FSETTLETYPEID	结算方式	string
FPAYBILLENTRY.FPURPOSEID	付款用途	string
FPAYBILLENTRY.FHANDLINGCHARGEFOR	手续费	string
FPAYBILLENTRY.FCOSTID	费用项目	string
FPAYBILLENTRY.FPAYTOTALAMOUNTFOR	应付金额	string
FPAYBILLENTRY.FISPOST	是否登账	string
FPAYBILLENTRY.FPOSTDATE	登账日期	string
FPAYBILLENTRY.FMATERIALID	物料编码	string
FPAYBILLENTRY.FEXPENSEDEPTID_E	费用承担部门	string
FPAYBILLENTRY.FPayType	支付类型	string
FPAYBILLENTRY.FPRICE	含税单价	string
FPAYBILLENTRY.FQTY	数量	string
FPAYBILLENTRY.FTaxAmt	税额	string
FPAYBILLENTRY.FCOMMENT	备注	string
FPAYBILLENTRY.FACCOUNTID	我方银行账号	string
FPAYBILLENTRY.F_PAEZ_Assistant	付款类别	string
FPAYBILLENTRY.FPURCHASEDEPTID	采购部门	string
FPAYBILLENTRY.F_WX_User	员工	string
FPAYBILLENTRY.FormId	业务对象表单Id	string	必须填写金蝶的表单ID如😛UR_PurchaseOrder
FPAYBILLENTRY.Operation	执行的操作	string
FPAYBILLENTRY.IsAutoSubmitAndAudit	提交并审核	bool
FPAYBILLENTRY.IsVerifyBaseDataField	验证基础资料	bool	是否验证所有的基础资料有效性，布尔类，默认false（非必录）

数据对接效果

通过数据集成平台可视化的快速配置调用接口打通阿里宜搭与金蝶云星空之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。