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

对接系统吉客云
“吉客云”是一站式企业数字化解决方案系统,可实现业务、财务、办公、人事等一体化管理。相对于传统多套软件系统的集成方案,“吉客云”具有业务流程更流畅,数据共享更充分,使用成本更低廉等优势。不仅如此,通过“吉链”,可以快捷的与您的合作伙伴进行系统对接。同时“吉客云”还打造了供销关系、仓储委托关系、生产委外加工关系、物流代发关系等多种企业间数字化协作通道,数据对接就像加微信好友一样方便!
目标系统:金蝶云星空
金蝶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 是 | | |
abcCate | ABC分类(A类,B类,C类) | | A类 |
skuLength | 长 | | 2 |
skuWidth | 宽 | | 1 |
skuHeight | 高 | | 4 |
colorCode | 颜色编码 | | 1 |
goodsId | 货品ID | | 1123123 |
colorName | 颜色名称 | | 4 |
goodsNo | 货品编号 | | 货品编号 |
goodsName | 货品名称 | | 货品名称 |
sizeCode | 尺码编号 | | 1 |
sizeName | 尺寸名称 | | 2 |
skuName | 规格名称 | | 规格名称 |
skuWeight | 重量(g) | | 1.2 |
skuId | 规格ID | | 1212 |
volume | 体积(cm³) | | 1 |
skuBarcode | 条码 | | code_0001 |
goodsGmtModified | 货品修改时间 | | 1631020179000 |
unitName | 单位 | | 个 |
cateId | 分类ID | | 12 |
cateName | 分类 | | 服装 |
brandId | 品牌ID | | 12 |
brandName | 品牌 | | 活鼎红 |
skuCode | 外部货品code | | 123 |
goodsDesc | 货品描述 | | 货品描述 |
goodsAlias | 货品别名 | | 货品别名 |
goodsField | 货品自定义字段,对应吉客云自定义属性 | | 货品自定义字段 |
skuImgUrl | 规格图片 | | http:2qwuqweuq.png |
extendValue | 自定义项 | | "{\"extend843337487958029056\":\"121.0000\",\"extend855097154722339968\":\"驱蚊器二去\"}", |
imgUrlList | 货品图片详情 | | |
金蝶云星空接口明细
- 调用接口:batchSave
- 接口名称:收款单新增
- 方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
FBillNo | 单据编号 | string | |
FSETTLEORGID | 结算组织 | string | function CASE '{{settleAccountName}}' when '生和堂科技(天猫生和堂食品旗舰)支付宝' then 104 else 103 end |
FEXCHANGETYPE | 汇率类型 | string | HLTX01_SYS |
FCURRENCYID | 币别 | string | PRE001 |
FDATE | 业务日期 | string | {{bookTime_new}} |
FBillTypeID | 单据类型 | string | FKDLX02_SYS |
FPURCHASEORGID | 采购组织 | string | _function CASE '{{settleAccountName}}' when '生和堂科技(天猫生和堂食品旗舰)支付宝' then 104 else 103 end |
FCONTACTUNITTYPE | 往来单位类型 | string | BD_Customer |
FCONTACTUNIT | 往来单位 | string | {{settleAccountName}} |
FRECTUNITTYPE | 收款单位类型 | string | BD_Customer |
FRECTUNIT | 收款单位 | string | {{settleAccountName}} |
FBUSINESSTYPE | 业务类型 | string | 3 |
FPAYORGID | 付款组织 | string | function CASE '{{settleAccountName}}' when '生和堂科技(天猫生和堂食品旗舰)支付宝' then 104 else 103 end |
FSETTLECUR | 结算币别 | string | PRE001 |
FREMARK | 备注 | string | |
FPAYBILLENTRY | 付款单明细 | array | details |
FPAYBILLENTRY.FSETTLETYPEID | 结算方式 | string | JSFS04_SYS |
FPAYBILLENTRY.FPURPOSEID | 付款用途 | string | SFKYT2205100003 |
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 | 业务对象表单Id | string | AP_PAYBILL |
FPAYBILLENTRY.Operation | 执行的操作 | string | BatchSave |
FPAYBILLENTRY.IsAutoSubmitAndAudit | 提交并审核 | bool | true |
FPAYBILLENTRY.IsVerifyBaseDataField | 验证基础资料 | bool | false |
系统对接概况
随着企业数字化业务的深入发展,对于企业的 IT 或者 CIO 来讲,正在面临一个愈发重要的问题——系统的结构太复杂了,尤其是头部企业,至少有十多套系统,这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统,如何整合企业的现有IT资源,使企业中计算机孤岛式的应用向集体协作的方向发展,发挥资源效益的最大化,降低企业成本,正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上,操作统一,以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中,轻易云应用集成平台负责实现异构、分布式系统之间互联互通,实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件,连接现有各孤立应用系统,以图形化、拖拽方式构建集成流程和服务,提高应用系统集成工作效率,降低异构系统集成风险。针对未来可能出现的业务需求变更,在应用集成平台上进行动态调整,实现各应用系统之间的集成策略平滑升级。
