阿里宜搭和金蝶云星空单据接口集成
对接系统金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。
对接目标系统:阿里宜搭
宜搭为广大企业提供一套低成本的企业应用搭建解决方案。自2019年3月上云以来，宜搭已持续服务数百位合作伙伴，涉及新零售、医疗、银行、制造、酒店等多个行业领域。
接口方案配置
异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则，例如取数就要根据查询接口获取金蝶云星空的数据，并且根据对应的条件进行取数，目标系统就必须根据目标系统的格式，以及获取的数据进行加工处理后进行写入到阿里宜搭中。轻易云集成平台的可视化配置轻松实现。数据管道ETL：构建一体化的数据融合平台。高级数据转换： 支持公式转换数据格式、支持脚本直接进行数据转换、支持可视化多维度数据处理。高性能实时处理：针对不同数据节点类型提供TB级吞吐量，秒级延迟的增量数据处理能力。自动将旧版web服务转变为基于云端微服务的API，统一接口输出标准。支持接口开放服务，实现内外部能力接入。
金蝶云星空接口明细
- API：executeBillQuery
- NAME：客户查询
- METHOD：POST
请求参数
| 接口字段 | 名称 | 预设值 |
|---|
| FCUSTID | FCUSTID | FCUSTID |
| FNumber | 编码 | FNumber |
| FName | 名称 | FName |
| FCreateOrgId_FNumber | 创建组织 | FCreateOrgId.FNumber |
| FUseOrgId_FNumber | 使用组织 | FUseOrgId.FNumber |
| FDescription | 描述 | FDescription |
| FIsTrade | 是否交易客户 | FIsTrade |
| FCustTypeId_FNumber | 客户类别 | FCustTypeId.FNumber |
| FGroup_FNumber | 客户分组 | FGroup.FNumber |
| FSALDEPTID_FNumber | 销售部门 | FSALDEPTID.FNumber |
| FSELLER_FNumber | 销售员 | FSELLER.FNumber |
| FSETTLETYPEID_FNumber | 结算方式 | FSETTLETYPEID.FNumber |
| FRECCONDITIONID_FNumber | 收款条件 | FRECCONDITIONID.FNumber |
| FDISCOUNTLISTID_FNumber | 折扣表 | FDISCOUNTLISTID.FNumber |
| FPRICELISTID_FNumber | 价目表 | FPRICELISTID.FNumber |
| FTRANSLEADTIME | 运输提前期 | FTRANSLEADTIME |
| FInvoiceType | 发票类型 | FInvoiceType |
| FTaxType_FNumber | 税分类 | FTaxType.FNumber |
| FShortName | 简称 | FShortName |
| FADDRESS | 地址 | FADDRESS |
| FZIP | 邮编 | FZIP |
| FWEBSITE | 首页 | FWEBSITE |
| FTEL | 电话 | FTEL |
| FFAX | 传真 | FFAX |
| FCompanyClassify_FNumber | 公司类别 | FCompanyClassify.FNumber |
| FCompanyNature_FNumber | 公司性质 | FCompanyNature.FNumber |
| FCompanyScale_FNumber | 公司规模 | FCompanyScale.FNumber |
| FINVOICETITLE | 发票抬头 | FINVOICETITLE |
| FTAXREGISTERCODE | 纳税登记号 | FTAXREGISTERCODE |
| FINVOICEBANKNAME | 开户银行 | FINVOICEBANKNAME |
| FINVOICETEL | 开票联系电话 | FINVOICETEL |
| FINVOICEBANKACCOUNT | 银行账号 | FINVOICEBANKACCOUNT |
| FINVOICEADDRESS | 开票通讯地址 | FINVOICEADDRESS |
| FSUPPLIERID_FNumber | 对应供应商 | FSUPPLIERID.FNumber |
| FIsGroup | 集团客户 | FIsGroup |
| FIsDefPayer | 默认付款方 | FIsDefPayer |
| FGROUPCUSTID_FNumber | 对应集团客户 | FGROUPCUSTID.FNumber |
| FCOUNTRY1_FNumber | 开户国家 | FCOUNTRY1.FNumber |
| FBANKCODE | 银行账号 | FBANKCODE |
| FACCOUNTNAME | 账户名称 | FACCOUNTNAME |
| FBankTypeRec_FNumber | 收款银行 | FBankTypeRec.FNumber |
| FTextBankDetail | 网点名称 | FTextBankDetail |
| FBankDetail_FNumber | 银行网点 | FBankDetail.FNumber |
| FOpenAddressRec | 开户行地址 | FOpenAddressRec |
| FCNAPS | 联行号 | FCNAPS |
| FCURRENCYID_FNumber | 币别 | FCURRENCYID.FNumber |
| FISDEFAULT1 | 默认 | FISDEFAULT1 |
| FDefaultConsiLoc_FNumber | 默认收货地点 | FDefaultConsiLoc.FNumber |
| FDefaultSettleLoc_FNumber | 默认开票地点 | FDefaultSettleLoc.FNumber |
| FDefaultPayerLoc_FNumber | 默认付款地点 | FDefaultPayerLoc.FNumber |
| FDefaultContact_FNumber | 默认联系人 | FDefaultContact.FNumber |
| FMarginLevel | 保证金比例（%） | FMarginLevel |
| Limit | 最大行数 | {{PAGINATION_PAGE_SIZE}} |
| StartRow | 开始行索引 | {{PAGINATION_START_ROW}} |
| TopRowCount | 返回总行数 | |
| FilterString | 过滤条件 | FCreateOrgId.FNumber in ('100') and FForbidStatus = 'A' and FUseOrgId.FNumber in ('100') |
| FieldKeys | 需查询的字段key集合 | |
| FormId | 业务对象表单Id | BD_Customer |
响应参数
| 接口字段 | 名称 | 预设值 |
|---|
| FCUSTID | FCUSTID | |
| FNumber | 编码 | |
| FName | 名称 | |
| FCreateOrgId_FNumber | 创建组织 | |
| FUseOrgId_FNumber | 使用组织 | |
| FDescription | 描述 | |
| FIsTrade | 是否交易客户 | |
| FCustTypeId_FNumber | 客户类别 | |
| FGroup_FNumber | 客户分组 | |
| FSALDEPTID_FNumber | 销售部门 | |
| FSELLER_FNumber | 销售员 | |
| FSETTLETYPEID_FNumber | 结算方式 | |
| FRECCONDITIONID_FNumber | 收款条件 | |
| FDISCOUNTLISTID_FNumber | 折扣表 | |
| FPRICELISTID_FNumber | 价目表 | |
| FTRANSLEADTIME | 运输提前期 | |
| FInvoiceType | 发票类型 | |
| FTaxType_FNumber | 税分类 | |
| FShortName | 简称 | |
| FADDRESS | 地址 | |
| FZIP | 邮编 | |
| FWEBSITE | 首页 | |
| FTEL | 电话 | |
| FFAX | 传真 | |
| FCompanyClassify_FNumber | 公司类别 | |
| FCompanyNature_FNumber | 公司性质 | |
| FCompanyScale_FNumber | 公司规模 | |
| FINVOICETITLE | 发票抬头 | |
| FTAXREGISTERCODE | 纳税登记号 | |
| FINVOICEBANKNAME | 开户银行 | |
| FINVOICETEL | 开票联系电话 | |
| FINVOICEBANKACCOUNT | 银行账号 | |
| FINVOICEADDRESS | 开票通讯地址 | |
| FSUPPLIERID_FNumber | 对应供应商 | |
| FIsGroup | 集团客户 | |
| FIsDefPayer | 默认付款方 | |
| FGROUPCUSTID_FNumber | 对应集团客户 | |
| FCOUNTRY1_FNumber | 开户国家 | |
| FBANKCODE | 银行账号 | |
| FACCOUNTNAME | 账户名称 | |
| FBankTypeRec_FNumber | 收款银行 | |
| FTextBankDetail | 网点名称 | |
| FBankDetail_FNumber | 银行网点 | |
| FOpenAddressRec | 开户行地址 | |
| FCNAPS | 联行号 | |
| FCURRENCYID_FNumber | 币别 | |
| FISDEFAULT1 | 默认 | |
| FDefaultConsiLoc_FNumber | 默认收货地点 | |
| FDefaultSettleLoc_FNumber | 默认开票地点 | |
| FDefaultPayerLoc_FNumber | 默认付款地点 | |
| FDefaultContact_FNumber | 默认联系人 | |
| FMarginLevel | 保证金比例（%） | |
阿里宜搭接口明细
- API：/yida_vpc/form/saveFormData.json
- NAME：新增表单实例
- METHOD：POST
请求参数
| 接口字段 | 名称 | 预设值 |
|---|
| textField_ku6aw61g | 客户名称 | {{FName}} |
| textField_ku6aw61h | 客户编码 | {{FNumber}} |
| textField_ku6aw61f | 类型 | 客户 |
| appType | 应用ID | APP_KFJOIBQ7VRMTDLQSLKQG |
| systemToken | 应用秘钥 | JR766WA1S5PON0QZXMNBZZKZKPGT1VMYM5OMKO |
| language | 语言 | zh_CN |
| formUuid | 表单ID | FORM-PU866D91181UGOZDYPVC4EX18VPT1Y5YVA6UKZ9 |
| userId | 钉钉的userId | 16000443318138909 |
数据对接价值
全新的API数据集成模式，赋能企业业务创新 传统企业集成主要采用点对点或ESB集成方式，基于全新API战略中台的API新型集成方式通过解耦系统资源，降低系统间对接难度，实现快速业务需求响应，提升对接效率，助力企业满足快速业务交付需求，实现业务创新。通过构建API生态，助力能力开放与共享 基于API战略中台梳理并整合内部API资源与IT资产，可实现内部资源共享，满足内部开发人员资源使用需求，例如：阿里宜搭与金蝶云星空之间数据集成；并将API资源对外可控开放，打造面向开发者的生态服务，为您打通自身和上下游合作伙伴，创造共赢价值链。开展API战略中台，重塑IT 帮助您基于内部资源构建不同业务能力中心，打造企业统一API战略中台，赋能企业发展，实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时，无需从“零”组建各业务模块，提升开发效率，重塑IT组织及交付能力。
