金蝶云星空和吉客云集成接口设计
对接源平台:金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
接通系统：吉客云
杭州吉客云网络技术有限公司是经国家认定的高新技术企业，是国内领先的SaaSERP软件服务商，致力于为企业提供安全稳定、高可用性和高扩展性的一站式数字化解决方案。
数据集成方案配置
异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则，例如取数就要根据查询接口获取金蝶云星空的数据，并且根据对应的条件进行取数，目标系统就必须根据目标系统的格式，以及获取的数据进行加工处理后进行写入到吉客云中。轻易云集成平台的可视化配置轻松实现。
金蝶云星空接口明细
- API：ExecuteBillQuery
- NAME：逐个单据查询
- METHOD：POST
请求参数
| 接口字段 | 名称 | 预设值 |
|---|
| Limit | 最大行数 | {{PAGINATION_PAGE_SIZE}} |
| StartRow | 开始行索引 | {{PAGINATION_START_ROW}} |
| TopRowCount | 返回总行数 | |
| FilterString | 过滤条件 | |
| FieldKeys | 需查询的字段key集合 | |
| FormId | 业务对象表单Id | ECC_Shop |
响应参数
| 接口字段 | 名称 | 预设值 |
|---|
| DocumentStatus | 单据状态 | |
| ForbidStatus | 禁用状态 | |
| Name | 名称 | |
| Number | 编码 | |
| ModifierId_Id | 修改人Id | |
| ModifierId_Name | 修改人_名称 | |
| ModifierId_Number | 修改人编码 | |
| CreatorId_Id | 创建人_Id | |
| CreatorId_Name | 创建人名称 | |
| CreatorId_Number | 创建人_编码 | |
| CreateDate | 创建日期 | |
| FModifyDate | 修改日期 | |
| Description | 描述 | |
| SaleOrgId_Id | 对应销售组织Id | |
| SaleOrgId_Name | 对应销售组织_名称 | |
| SaleOrgId_Number | 对应销售组织编码 | |
| CreateOrgId_Id | 创建组织_Id | |
| CreateOrgId_Name | 创建组织名称 | |
| CreateOrgId_Number | 创建组织_编码 | |
| ShopType | 网店类型 | |
| ShopName | 店铺名称 | |
| Token | 网店特征码 | |
| EnterAddress | 接入网址 | |
| StartDate | 开通时间 | |
| CustomerId_Id | 对应客户Id | |
| CustomerId_Name | 对应客户_名称 | |
| CustomerId_Number | 对应客户编码 | |
| SettlementCurrency_Id | 结算币别_Id | |
| SettlementCurrency_Name | 结算币别名称 | |
| SettlementCurrency_Number | 结算币别_编码 | |
| SettlementOrgId_Id | 对应结算组织Id | |
| SettlementOrgId_Name | 对应结算组织_名称 | |
| SettlementOrgId_Number | 对应结算组织编码 | |
| EnableDown | 启用下载 | |
| IsTBYZShop | 默认菜鸟接入网店 | |
| ShopCustomerCode | 京东快递店铺商家编码 | |
| ServiceMaterialID_Id | 对应运费物料_Id | |
| ServiceMaterialID_Name | 对应运费物料名称 | |
| ServiceMaterialID_Number | 对应运费物料_编码 | |
| LogisticsFilterByStockOrg | 按库存组织匹配物流公司 | |
| LogisticsFilterByNetShop | 按网店匹配物流公司 | |
| LogisticsFilterByAreaScope | 按配送区域范围匹配物流公司 | |
| LogisticsFilterByMaterialScope | 按配送物料范围匹配物流公司 | |
| LogisticsFilterByFare | 按最小运费匹配物流公司 | |
| BillOrgID_Id | 收付款组织Id | |
| BillOrgID_Name | 收付款组织_名称 | |
| BillOrgID_Number | 收付款组织编码 | |
| Nick | 昵称 | |
| TBYZJoinNetShopId_Id | 菜鸟面单接入网店_Id | |
| TBYZJoinNetShopId_Name | 菜鸟面单接入网店名称 | |
| TBYZJoinNetShopId_Number | 菜鸟面单接入网店_编码 | |
| FServiceMaterial_Id | 对应服务物料Id | |
| FServiceMaterial_Name | 对应服务物料_名称 | |
| FServiceMaterial_Number | 对应服务物料编码 | |
| LSBranch_Id | 门店信息_Id | |
| LSBranch_Name | 门店信息名称 | |
| LSBranch_Number | 门店信息_编码 | |
| DownloadByGY | 管易对接网店 | |
| GYShopType | 管易网店类型 | |
| GYModifyDate | 管易网店修改日期 | |
| IsSMSNotice | 生成出库单短信通知收货人 | |
| IsOneSMSNotice | 拆分发货仅发一次短信通知 | |
| ShopStock | 配送网络 | |
| ShopStock.StockOrgId_Id | 库存组织Id | |
| ShopStock.StockOrgId_Name | 库存组织_名称 | |
| ShopStock.StockOrgId_Number | 库存组织编码 | |
| ShopStock.StockId_Id | 仓库_Id | |
| ShopStock.StockId_Name | 仓库名称 | |
| ShopStock.StockId_Number | 仓库_编码 | |
| ShopStock.EnableInvSync | 启用库存同步 | |
| ShopStock.SyncPercent | 同步比例 | |
| ShopStock.SenderName | 发件人信息&名称 | |
| ShopStock.CompanyName | 发件人信息&单位名称 | |
| ShopStock.SenderAddress | 发件人信息&寄件地址 | |
| ShopStock.Telephone | 发件人信息&联系电话 | |
| ShopStock.ZipCode | 发件人信息&邮政编码 | |
| ShopStock.IsSupportCarry | 支持自提 | |
| ShopStock.CarryAddress_Id | 自提地址Id | |
| ShopStock.CarryAddress_Name | 自提地址_名称 | |
| ShopStock.CarryAddress_Number | 自提地址编码 | |
| ShopStock.SendAddress_Id | 发货地址_Id | |
| ShopStock.SendAddress_Name | 发货地址名称 | |
| ShopStock.SendAddress_Number | 发货地址_编码 | |
| ShopStock.ReturnAddress_Id | 退货地址Id | |
| ShopStock.ReturnAddress_Name | 退货地址_名称 | |
| ShopStock.ReturnAddress_Number | 退货地址编码 | |
| ShopStock.IsEnable | 启用 | |
| ShopStock.Level | 优先级 | |
| ShopStock.TransType | 流转类型 | |
| ShopStock.ShopMD | 门店配送网络 | |
| ShopStock.ShopMD.EnableSyn | 启用库存同步 | |
| ShopStock.ShopMD.SynRate | 同步比例(%) | |
| ShopStock.ShopMD.MDChannel_Id | 门店_Id | |
| ShopStock.ShopMD.MDChannel_Name | 门店名称 | |
| ShopStock.ShopMD.MDChannel_Number | 门店_编码 | |
| ShopStock.ShopMD.ShopWB | 外部配送网络 | |
| ShopStock.ShopMD.ShopWB.WBChannel_Id | 外部渠道Id | |
| ShopStock.ShopMD.ShopWB.WBChannel_Name | 外部渠道_名称 | |
| ShopStock.ShopMD.ShopWB.WBChannel_Number | 外部渠道_编码 | |
| ShopStock.ShopMD.ShopWB.WBKeepInvQty | 预留库存 | |
| ShopStock.ShopMD.ShopWB.ShopGYS | 供应商配送网络 | |
| ShopStock.ShopMD.ShopWB.ShopGYS.GYSKeepInvQty | 预留库存 | |
吉客云接口明细
- API：crm.customer.add
- NAME：客户新增
- METHOD：POST
请求参数
| 接口字段 | 名称 | 预设值 |
|---|
| customerCode | 客户编号 | |
| nickname | 客户名称 | |
| alias | 别名 | |
| vipLevel | 会员等级id | |
| vipLevelName | 会员等级名称 | |
| contacts | 联系人 | |
| country | 国家 | |
| state | 省份 | |
| city | 城市 | |
| district | 区 | |
| town | 镇 | |
| address | 基本信息地址-地址 | |
| detailedAddress | 基本信息地址-详细地址 | |
| zip | 邮编 | |
| gender | 性别（枚举） | |
| age | 年龄 | |
| birthday | 生日 | |
| calendarType | 生日日期类型（枚举） | |
| phone | 联系电话 | |
| email | email | |
| qq | QQ | |
| weiXin | 微信 | |
| taxNumber | 开票税号 | |
| customerManager | 客户经理id | |
| customerManagerName | 客户经理名称 | |
| refereeId | 客户经理名称 | |
| referee | 推荐人名称 | |
| specialReminding | 特别提醒 | |
| customerType | 客户类别id | |
| customerTypeName | 客户类别名称 | |
系统数据集成价值
数据集成中台设计中心Web界面以“拖拽”式交互设计，使用鼠标即可构建设计多异构系统数据集成流程，低代码平台大大降低流程设计者上手门槛。还有丰富的组件库快速满足复杂业务需求，结合不同模块即可生成不同业务流程，提升流程设计效率。平台支持多种高度灵活部署，高并发、高性能、高可用，可以通过多节点组成集群实现性能的横向扩展。适度集群配置其数据集成处理能力可达GB级/秒，为业务流提供更高数据吞吐量。平台已集成数据回压、优先级队列等能力，保障运行稳定性。完善的企业API运营管理机制帮助您构建“API生产者、API管理者、API消费者”三者结合的统一API数字化生态。支持市面上主流厂家软件如：金蝶、用友、SAP、泛微、蓝凌、旺店通、聚水潭、马帮、小满CRM等等。
