金蝶云星空与吉客云对接集成逐个单据查询打通客户新增
接入系统：金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
接入系统：吉客云
“吉客云”是一站式企业数字化解决方案系统，可实现业务、财务、办公、人事等一体化管理。相对于传统多套软件系统的集成方案，“吉客云”具有业务流程更流畅，数据共享更充分，使用成本更低廉等优势。不仅如此，通过“吉链”，可以快捷的与您的合作伙伴进行系统对接。同时“吉客云”还打造了供销关系、仓储委托关系、生产委外加工关系、物流代发关系等多种企业间数字化协作通道，数据对接就像加微信好友一样方便！
数据接口配置方案
轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线，所以对接方案的配置极其重要，方案可以选择一键复制，轻易云有海量的对接方案可支持一键复制，复制后直接启动使用（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置，配置只要确认源平台：金蝶云星空的取数逻辑，例如什么时间取什么样的数据。即可完成配置，目标平台：吉客云，把获取的数据组装成目标系统需要的格式进行写入。
金蝶云星空接口明细
- API：ExecuteBillQuery
- NAME：逐个单据查询
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| Limit | 最大行数 | {{PAGINATION_PAGE_SIZE}} | 金蝶的查询分页参数 |
| StartRow | 开始行索引 | {{PAGINATION_START_ROW}} | 金蝶的查询分页参数 |
| TopRowCount | 返回总行数 | | 金蝶的查询分页参数 |
| FilterString | 过滤条件 | | 示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= |
| FieldKeys | 需查询的字段key集合 | | 金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber |
| FormId | 业务对象表单Id | ECC_Shop | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| 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 | 预留库存 | | |
吉客云接口明细
- 接口：crm.customer.add
- 接口名称：客户新增
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| customerCode | 客户编号 | string | C201907050001 |
| nickname | 客户名称 | string | 张三 |
| alias | 别名 | string | 张飞 |
| vipLevel | 会员等级id | string | ad1a2w3q1ada65zc5621asd |
| vipLevelName | 会员等级名称 | string | 金牌会员 |
| contacts | 联系人 | string | 李四 |
| country | 国家 | string | 中国 |
| state | 省份 | string | 浙江省 |
| city | 城市 | string | 杭州市 |
| district | 区 | string | 西湖区 |
| town | 镇 | string | 三墩镇 |
| address | 基本信息地址-地址 | string | 浙江省杭州市西湖区三墩镇 |
| detailedAddress | 基本信息地址-详细地址 | string | 西园十路8号笛佛大厦 |
| zip | 邮编 | string | 310000 |
| gender | 性别（枚举） | string | 0（男），1（女） |
| age | 年龄 | string | 18 |
| birthday | 生日 | string | 43671 |
| calendarType | 生日日期类型（枚举） | string | 0（公历），1（阴历） |
| phone | 联系电话 | string | 13588889999 |
| email | email | string | 13588889999@163.com |
| qq | QQ | string | 1135888899 |
| weiXin | 微信 | string | chat11111 |
| taxNumber | 开票税号 | string | SH123456798 |
| customerManager | 客户经理id | string | a1d56ad1q56da321 |
| customerManagerName | 客户经理名称 | string | 王五 |
| refereeId | 客户经理名称 | string | 52691345816821 |
| referee | 推荐人名称 | string | 王五 |
| specialReminding | 特别提醒 | string | 重点客户 |
| customerType | 客户类别id | string | ada8z32c1a56asdc |
| customerTypeName | 客户类别名称 | string | 类别1 |
系统集成总览
通过数据集成平台可视化的快速配置调用接口打通金蝶云星空与吉客云之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。
