金蝶云星空和阿里宜搭接口打通对接实战
对接系统金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
对接系统：阿里宜搭
宜搭为广大企业提供一套低成本的企业应用搭建解决方案。自2019年3月上云以来，宜搭已持续服务数百位合作伙伴，涉及新零售、医疗、银行、制造、酒店等多个行业领域。
接口方案配置
通过轻易云系统数据集成平台新增创建集成方案，通过轻易云的方案市场可以一键复制，并且可以借鉴其他的方案配置完成方案制作，方案制作只需要两步，第一步先确定好对应的数据来源；源系统：金蝶云星空接口：银行查询通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统：阿里宜搭接口：新增表单实例，通过写入调度者匹配获取到的数据和写入的映射关系，即可自动生成符合目标系统：阿里宜搭写入的数据自动产生写入队列，通过运行概况，系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况
金蝶云星空接口明细
- API：executeBillQuery
- NAME：银行查询
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| FBANKACNTID | 实体主键 | FBANKACNTID | |
| FDocumentStatus | 数据状态 | FDocumentStatus | |
| FForbidStatus | 禁用状态 | FForbidStatus | |
| FName | 账户名称 | FName | |
| FNumber | 银行账号 | FNumber | |
| FDescription | 备注 | FDescription | |
| FCreateOrgId_Fnumber | 创建组织 | FCreateOrgId.Fnumber | |
| FUseOrgId_Fnumber | 使用组织 | FUseOrgId.Fnumber | |
| FCreateDate | 创建日期 | FCreateDate | |
| FModifyDate | 修改日期 | FModifyDate | |
| FACNTBRANCHNUMBER | 开户银行联行号 | FACNTBRANCHNUMBER | |
| FACNTAREACODE | 账户地区码 | FACNTAREACODE | |
| FACNTAREANAME | 账户地区名 | FACNTAREANAME | |
| FBANKID_Fnumber | 开户银行 | FBANKID.Fnumber | |
| FApproveDate | 审核日期 | FApproveDate | |
| FBANKADDRESS | 银行地址 | FBANKADDRESS | |
| FBankType | 银行 | FBankType | |
| FInOrOut | 账户收支属性 | FInOrOut | |
| FSRCBILLID | 源单内码 | FSRCBILLID | |
| FINNERACCOUNTID | 内部账户 | FINNERACCOUNTID | |
| FIsFundUp | 资金上划 | FIsFundUp | |
| FUpType | 上划方式 | FUpType | |
| FUpAmount | 上划定额 | FUpAmount | |
| FBaseAmount | 留底余额 | FBaseAmount | |
| FMinUpAmount | 最小上划金额 | FMinUpAmount | |
| FIsCancel | 是否销户 | FIsCancel | |
| FIsSupBank | 支持网银 | FIsSupBank | |
| FISDEFAULTBANK | 默认账号 | FISDEFAULTBANK | |
| FACCOUNTTYPE | 账号类型 | FACCOUNTTYPE | |
| FLICENSEKEY | 授权密码 | FLICENSEKEY | |
| FPUBLICACNT | 对公账号 | FPUBLICACNT | |
| FBankServiceLoginId | 登录配置编号 | FBankServiceLoginId | |
| FBankServiceLoginDesc | 银行版本 | FBankServiceLoginDesc | |
| FCURRENCYID | 币别 | FCURRENCYID | |
| FIsSupBBC | 支持BBC分销门户显示 | FIsSupBBC | |
| FNProvince | 省 | FNProvince | |
| FNCity | 城市 | FNCity | |
| FNDistrict | 地区 | FNDistrict | |
| FCountry | 国别 | FCountry | |
| FKDPAYNUMBER | 聚合收款商户号 | FKDPAYNUMBER | |
| FIsImpNegativeBal | 支持导入负余额对账单 | FIsImpNegativeBal | |
| Limit | 最大行数 | {{PAGINATION_PAGE_SIZE}} | 金蝶的查询分页参数 |
| StartRow | 开始行索引 | {{PAGINATION_START_ROW}} | 金蝶的查询分页参数 |
| TopRowCount | 返回总行数 | | 金蝶的查询分页参数 |
| FilterString | 过滤条件 | FApproveDate>='2010-01-01' | 示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= |
| FieldKeys | 需查询的字段key集合 | | 金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber |
| FormId | 业务对象表单Id | CN_BANKACNT | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| FBANKACNTID | 实体主键 | | |
| FDocumentStatus | 数据状态 | | |
| FForbidStatus | 禁用状态 | | |
| FName | 账户名称 | | |
| FNumber | 银行账号 | | |
| FDescription | 备注 | | |
| FCreateOrgId_Fnumber | 创建组织 | | |
| FUseOrgId_Fnumber | 使用组织 | | |
| FCreateDate | 创建日期 | | |
| FModifyDate | 修改日期 | | |
| FACNTBRANCHNUMBER | 开户银行联行号 | | |
| FACNTAREACODE | 账户地区码 | | |
| FACNTAREANAME | 账户地区名 | | |
| FBANKID_Fnumber | 开户银行 | | |
| FApproveDate | 审核日期 | | |
| FBANKADDRESS | 银行地址 | | |
| FBankType | 银行 | | |
| FInOrOut | 账户收支属性 | | |
| FSRCBILLID | 源单内码 | | |
| FINNERACCOUNTID | 内部账户 | | |
| FIsFundUp | 资金上划 | | |
| FUpType | 上划方式 | | |
| FUpAmount | 上划定额 | | |
| FBaseAmount | 留底余额 | | |
| FMinUpAmount | 最小上划金额 | | |
| FIsCancel | 是否销户 | | |
| FIsSupBank | 支持网银 | | |
| FISDEFAULTBANK | 默认账号 | | |
| FACCOUNTTYPE | 账号类型 | | |
| FLICENSEKEY | 授权密码 | | |
| FPUBLICACNT | 对公账号 | | |
| FBankServiceLoginId | 登录配置编号 | | |
| FBankServiceLoginDesc | 银行版本 | | |
| FCURRENCYID | 币别 | | |
| FIsSupBBC | 支持BBC分销门户显示 | | |
| FNProvince | 省 | | |
| FNCity | 城市 | | |
| FNDistrict | 地区 | | |
| FCountry | 国别 | | |
| FKDPAYNUMBER | 聚合收款商户号 | | |
| FIsImpNegativeBal | 支持导入负余额对账单 | | |
阿里宜搭接口明细
- 接口：/yida_vpc/form/saveFormData.json
- 接口名称：新增表单实例
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| textField_kw1f0ad8 | 银行账号编码 | string | |
| textField_kw1f0ad9 | 银行账号名称 | string | |
| textField_kw1f0ada | 银行账号ID | string | |
| appType | 应用ID | string | APP_PBKT0MFBEBTDO8T7SLVP |
| systemToken | 应用秘钥 | string | 在应用数据中获取。 |
| language | 语言 | string | |
| formUuid | 表单ID | string | FORM-NJYJZELV8YZRDEI2N5IQ7L6VEDMR1VE9GMPCJB |
| userId | 钉钉的userId | string | |
系统打通概况
通过数据集成平台可视化的快速配置调用接口打通金蝶云星空与阿里宜搭之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。
