吉客云对接打通金蝶云星空分页查询货品信息接口与收款单新增接口

对接系统吉客云

“吉客云”是一站式企业数字化解决方案系统，可实现业务、财务、办公、人事等一体化管理。相对于传统多套软件系统的集成方案，“吉客云”具有业务流程更流畅，数据共享更充分，使用成本更低廉等优势。不仅如此，通过“吉链”，可以快捷的与您的合作伙伴进行系统对接。同时“吉客云”还打造了供销关系、仓储委托关系、生产委外加工关系、物流代发关系等多种企业间数字化协作通道，数据对接就像加微信好友一样方便！

目标系统:金蝶云星空

金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。

接口方案配置

集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：吉客云，源系统 API：分页查询货品信息，目标系统：金蝶云星空，目标系统 API收款单新增。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。

吉客云接口明细

API：acs.billinfo.get
NAME：分页查询货品信息
METHOD：Get

请求参数

接口字段字段名称预设值描述 pageIndex分页页码 pageSize分页页数20 settleAccountNameHeader账户名 bookTimeStart开始时间_function from_unixtime(({{CURRENT_TIME}}-5184000),'%Y-%m-%d %h:%i:%s') bookTimeEnd结束时间{{CURRENT_TIME datetime}} tradeNos网店订单号 billAccountNos账务流水号 bizNos业务流水号 billType账单类型1 auditStatus账单状态1 checkStatus对账状态1 oppAccountNum对方帐号 oppAccountName对方户名 tradeMemoHeader备注 itemName收支项目 gmtModifiedStart修改时间开始值{{LAST_SYNC_TIME datetime}} gmtModifiedEnd修改时间结束值{{CURRENT_TIME datetime}}

响应参数

接口字段字段名称预设值描述 outAmount金额http:asasda.png bookTime_new付款时间1 settleAccountName帐号名称left bizType类型美美哒.png skuIsBlockup规格是否停用 0 否 1 是 abcCateABC分类(A类,B类,C类)A类 skuLength长2 skuWidth宽1 skuHeight高4 colorCode颜色编码1 goodsId货品ID1123123 colorName颜色名称4 goodsNo货品编号货品编号 goodsName货品名称货品名称 sizeCode尺码编号1 sizeName尺寸名称2 skuName规格名称规格名称 skuWeight重量(g)1.2 skuId规格ID1212 volume体积（cm³）1 skuBarcode条码code_0001 goodsGmtModified货品修改时间1631020179000 unitName单位个 cateId分类ID12 cateName分类服装 brandId品牌ID12 brandName品牌活鼎红 skuCode外部货品code123 goodsDesc货品描述货品描述 goodsAlias货品别名货品别名 goodsField货品自定义字段，对应吉客云自定义属性货品自定义字段 skuImgUrl规格图片http:2qwuqweuq.png extendValue自定义项"{\"extend843337487958029056\":\"121.0000\",\"extend855097154722339968\":\"驱蚊器二去\"}", imgUrlList货品图片详情

金蝶云星空接口明细

调用接口：batchSave
接口名称：收款单新增
方法：POST

请求参数

字段字段名称类型配置值 FBillNo单据编号string FSETTLEORGID结算组织stringfunction CASE '{{settleAccountName}}' when '生和堂科技（天猫生和堂食品旗舰）支付宝' then 104 else 103 end FEXCHANGETYPE汇率类型stringHLTX01_SYS FCURRENCYID币别stringPRE001 FDATE业务日期string{{bookTime_new}} FBillTypeID单据类型stringFKDLX02_SYS FPURCHASEORGID采购组织string_function CASE '{{settleAccountName}}' when '生和堂科技（天猫生和堂食品旗舰）支付宝' then 104 else 103 end FCONTACTUNITTYPE往来单位类型stringBD_Customer FCONTACTUNIT往来单位string{{settleAccountName}} FRECTUNITTYPE收款单位类型stringBD_Customer FRECTUNIT收款单位string{{settleAccountName}} FBUSINESSTYPE业务类型string3 FPAYORGID付款组织stringfunction CASE '{{settleAccountName}}' when '生和堂科技（天猫生和堂食品旗舰）支付宝' then 104 else 103 end FSETTLECUR结算币别stringPRE001 FREMARK备注string FPAYBILLENTRY付款单明细arraydetails FPAYBILLENTRY.FSETTLETYPEID结算方式stringJSFS04_SYS FPAYBILLENTRY.FPURPOSEID付款用途stringSFKYT2205100003 FPAYBILLENTRY.FPAYTOTALAMOUNTFOR表体-应付金额string{{details.outAmount}} FPAYBILLENTRY.FACCOUNTID我方银行账号string_findCollection find FNumber from e0411585-ebc3-30fb-ac16-872da1e0bfde where FName={{settleAccountName}} FPAYBILLENTRY.FCOMMENT备注string{{bizType}} FPAYBILLENTRY.FormId业务对象表单IdstringAP_PAYBILL FPAYBILLENTRY.Operation执行的操作stringBatchSave FPAYBILLENTRY.IsAutoSubmitAndAudit提交并审核booltrue FPAYBILLENTRY.IsVerifyBaseDataField验证基础资料boolfalse

系统对接概况

随着企业数字化业务的深入发展，对于企业的 IT 或者 CIO 来讲，正在面临一个愈发重要的问题——系统的结构太复杂了，尤其是头部企业，至少有十多套系统，这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统，如何整合企业的现有IT资源，使企业中计算机孤岛式的应用向集体协作的方向发展，发挥资源效益的最大化，降低企业成本，正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上，操作统一，以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中，轻易云应用集成平台负责实现异构、分布式系统之间互联互通，实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件，连接现有各孤立应用系统，以图形化、拖拽方式构建集成流程和服务，提高应用系统集成工作效率，降低异构系统集成风险。针对未来可能出现的业务需求变更，在应用集成平台上进行动态调整，实现各应用系统之间的集成策略平滑升级。

吉客云对接打通金蝶云星空分页查询货品信息接口与收款单新增接口