阿里宜搭对接打通金蝶云星空搜索表单实例详情列表接口与收款退款新增接口
对接系统阿里宜搭
宜搭是阿里巴巴自研的低代码应用搭建平台，传统情况下需要2周才能搭建完成的应用，用宜搭2小时就可完成。宜搭于2019年3月上线，用户可以在可视化界面上以拖拉拽的方式编辑和配置页面，表单和流程，并一键发布到PC和手机端。
写入目标:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
接口方案配置
轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线，所以对接方案的配置极其重要，方案可以选择一键复制，轻易云有海量的对接方案可支持一键复制，复制后直接启动使用（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置，配置只要确认源平台：阿里宜搭的取数逻辑，例如什么时间取什么样的数据。即可完成配置，目标平台：金蝶云星空，把获取的数据组装成目标系统需要的格式进行写入。
阿里宜搭接口明细
- 调用接口：/yida_vpc/process/getInstances.json
- 接口名称：搜索表单实例详情列表
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| appType | 应用ID | string | APP_KFJOIBQ7VRMTDLQSLKQG |
| systemToken | 应用秘钥 | string | JR766WA1S5PON0QZXMNBZZKZKPGT1VMYM5OMKO |
| userId | 管理员用户钉钉ID | string | 16000443318138909 |
| language | 语言 | string | zh_CN |
| formUuid | 表单ID | string | FORM-TH866OD15SXQ06T31UZP06CVXI3J31C6B3TPKV |
| instanceStatus | 实例状态 | string | COMPLETED |
| currentPage | 当前页 | string | {{PAGINATION_START_PAGE}} |
| pageSize | 每页记录数 | string | {{PAGINATION_PAGE_SIZE}} |
| originatorId | 数据提交人工号 | string | |
| createFrom | 创建开始时间 | string | 2021-12-01 00:00:00 |
| createTo | 创建结束时间 | string | 2032-02-06 09:24:14 |
| modifiedFrom | 修改开始时间 | string | |
| modifiedTo | 修改结束时间 | string | |
| searchFieldJson | 条件 | object | |
| searchFieldJson.selectField_kne9dbah | 类型 | string | 收款退款 |
| searchFieldJson.selectField_kzihphju | 部门过滤 | string | 浪鲸项目团队 |
响应参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| gmtCreate | 创建时间 | string | |
| gmtModified | 最近修改时间 | string | |
| originatorUserId | 创建人ID | string | |
| originator | 创建人 | string | |
| attachmentField_kne13swd | 附件 | string | |
| textareaField_kmrhm14v | 支付备注 | string | |
| textField_krrik8kb | 月周 | string | |
| dateField_kmrhm14u | 支付日期 | string | |
| textField_kqkdldg0 | 收付款类型编码 | string | |
| selectField_kqhc3rpp | 名称 | string | |
| selectField_kqhc3rpo | 收付款类型 | string | |
| textField_kr4t0q6j | 开户行编码 | string | |
| selectField_kq97ayh5 | 收付款账号 | string | |
| selectField_kq97ayh4 | 银行名称 | string | |
| selectField_kq8ryql2 | 收付款账户 | string | |
| textField_krltbok3 | 收款方账号 | string | |
| textField_kse8m7d6 | 收款方开户行（平台） | string | |
| textField_krltbok1 | 收款方户名 | string | |
| textField_kmzzc949 | 汇款账号 | string | |
| textField_kse8m7d5 | 汇款开户行（平台） | string | |
| textField_kniia1wi | 汇款账户户名 | string | |
| textField_kse9l95k | 退款方式编码 | string | |
| selectField_krltbojq | 退款方式 | string | |
| textField_kse9l95j | 汇款方式编码 | string | |
| selectField_kmrhm14t | 汇款方式 | string | |
| textField_kr0e8dd7 | 大写金额 | string | |
| numberField_kmrhm14s | 金额 | string | |
| textField_krvrp44e | 费用收款组织编码 | string | |
| selectField_krvrp44d | 费用收款组织 | string | |
| textField_kr4od4a5 | 费用结算组织编码 | string | |
| selectField_knib34jo | 费用结算组织 | string | |
| textField_ksdy7bcw | 往来单位类型编码 | string | |
| textField_ksdy7bcv | 付款单位类型编码 | string | |
| textField_krvw0tz5 | 往来单位编码 | string | |
| selectField_krvw0tz4 | 往来单位 | string | |
| selectField_krvw0tz3 | 往来单位类型 | string | |
| textField_kr4ijmtn | 付款单位编码 | string | |
| selectField_kqgcfms2 | 付款单位 | string | |
| selectField_kr38pggy | 付款单位类型 | string | |
| selectField_kne9dbah | 费用类别 | string | |
| textField_krk9d78n | 部门中所有子部门ID（报表使用） | string | |
| selectField_kmrhm14p | 费用结算部门 | string | |
| textField_kmvrv5xl | 申请人 | string | |
| text_klkn4yn7 | | string | |
金蝶云星空接口明细
- 接口：batchSave
- 接口名称：收款退款新增
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| FBillNo | 单据编号 | string | |
| FBillTypeID | 单据类型 | string | |
| FDATE | 日期 | string | |
| FPAYORGID | 支付组织 | string | |
| FSETTLEORGID | 结算组织 | string | |
| FRECTUNITTYPE | 收款单位类型 | string | |
| FRECTUNIT | 收款单位 | string | |
| FCONTACTUNITTYPE | 往来类型 | string | |
| FCONTACTUNIT | 往来单位 | string | |
| FCURRENCYID | 币别 | string | |
| FSALEORGID | 销售组织 | string | |
| FBUSINESSTYPE | 业务类型 | string | |
| FEXCHANGERATE | 汇率 | string | |
| FREFUNDBILLENTRY | 明细 | array | |
| FREFUNDBILLENTRY.FSETTLETYPEID | 结算方式 | string | |
| FREFUNDBILLENTRY.FPURPOSEID | 原收款用途 | string | |
| FREFUNDBILLENTRY.FCOSTDEPARTMENTID | 费用承担部门 | string | |
| FREFUNDBILLENTRY.FREFUNDAMOUNTFOR | 退款金额 | string | |
| FREFUNDBILLENTRY.FACCOUNTID | 我方银行账号 | string | |
| FREFUNDBILLENTRY.FNOTE | 摘要 | string | |
| FREFUNDBILLENTRY.FPOSTDATE | 登账日期 | string | |
| FREFUNDBILLENTRY.FCOMMENT | 备注 | string | |
| FREFUNDBILLENTRY.FREMARK | 备注 | string | |
| FREFUNDBILLENTRY.FormId | 业务对象表单Id | string | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
| FREFUNDBILLENTRY.Operation | 执行的操作 | string | |
| FREFUNDBILLENTRY.IsAutoSubmitAndAudit | 提交并审核 | bool | |
| FREFUNDBILLENTRY.IsVerifyBaseDataField | 验证基础资料 | bool | 是否验证所有的基础资料有效性，布尔类，默认false（非必录） |
系统对接总览
通过数据集成平台可视化的快速配置调用接口打通阿里宜搭与金蝶云星空之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。
