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

数据源平台:吉客云
吉客云是基于“网店管家”十五年电商ERP行业和技术积累基础上顺应产业发展需求,重新定位、全新设计推出的换代产品,从业务数字化和组织数字化两个方向出发,以构建流程的闭环为依归,致力于为企业的数字化升级提供落地工具。
目标系统:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上,提供了标准的管理模式;通过标准的业务架构:多会计准则、多币别、多地点、多组织、多税制应用框架等,有效支持企业的运营管理;K/3Cloud提供了标准的业务建模:35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合,288个业务服务构件,让企业及伙伴可快速构建出行业化及个性化的应用。
数据对接方案
异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下,这两个系统都是分别独立部署和运行的,各自拥有不同的技术栈和编程模型,甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则,例如取数就要根据查询接口获取吉客云的数据,并且根据对应的条件进行取数,目标系统就必须根据目标系统的格式,以及获取的数据进行加工处理后进行写入到金蝶云星空中。轻易云集成平台的可视化配置轻松实现。


吉客云接口明细
- 调用接口:acs.billinfo.get
- 接口名称:分页查询货品信息
- 方法:Get
请求参数
字段 | 字段名称 | 类型 | 配置值 |
pageIndex | 分页页码 | string | |
pageSize | 分页页数 | string | 20 |
settleAccountNameHeader | 账户名 | string | |
bookTimeStart | 开始时间 | string | _function from_unixtime(({{CURRENT_TIME}}-5184000),'%Y-%m-%d %h:%i:%s') |
bookTimeEnd | 结束时间 | string | {{CURRENT_TIME datetime}} |
tradeNos | 网店订单号 | string | |
billAccountNos | 账务流水号 | string | |
bizNos | 业务流水号 | string | |
billType | 账单类型 | string | |
auditStatus | 账单状态 | string | 1 |
checkStatus | 对账状态 | string | 1 |
oppAccountNum | 对方帐号 | string | |
oppAccountName | 对方户名 | string | |
tradeMemoHeader | 备注 | string | |
itemName | 收支项目 | string | |
gmtModifiedStart | 修改时间开始值 | string | {{LAST_SYNC_TIME datetime}} |
gmtModifiedEnd | 修改时间结束值 | string | {{CURRENT_TIME datetime}} |
响应参数
字段 | 字段名称 | 类型 | 配置值 |
imgUrl | 图片地址 | string | |
isMainImage | 是否主图 0-是 1-否 | string | |
imagePosition | 图片位置main-主图 left-左侧图 right-右侧图 | string | |
imgKey | 图片地址key | string | |
skuIsBlockup | 规格是否停用 0 否 1 是 | string | |
abcCate | ABC分类(A类,B类,C类) | string | |
skuLength | 长 | string | |
skuWidth | 宽 | string | |
skuHeight | 高 | string | |
colorCode | 颜色编码 | string | |
goodsId | 货品ID | string | |
colorName | 颜色名称 | string | |
goodsNo | 货品编号 | string | |
goodsName | 货品名称 | string | |
sizeCode | 尺码编号 | string | |
sizeName | 尺寸名称 | string | |
skuName | 规格名称 | string | |
skuWeight | 重量(g) | string | |
skuId | 规格ID | string | |
volume | 体积(cm³) | string | |
skuBarcode | 条码 | string | |
goodsGmtModified | 货品修改时间 | string | |
unitName | 单位 | string | |
cateId | 分类ID | string | |
cateName | 分类 | string | |
brandId | 品牌ID | string | |
brandName | 品牌 | string | |
skuCode | 外部货品code | string | |
goodsDesc | 货品描述 | string | |
goodsAlias | 货品别名 | string | |
goodsField | 货品自定义字段,对应吉客云自定义属性 | string | |
skuImgUrl | 规格图片 | string | |
extendValue | 自定义项 | string | |
imgUrlList | 货品图片详情 | string | |
金蝶云星空接口明细
- 接口:batchSave
- 接口名称:收款单新增
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
FBillNo | 单据编号 | string | 单据编号 |
FSETTLEORGID | 结算组织 | string | 结算组织 |
FEXCHANGETYPE | 汇率类型 | string | |
FCURRENCYID | 币别 | string | 币别 |
FDATE | 业务日期 | string | 业务日期 |
FBillTypeID | 单据类型 | string | 单据类型 |
FSALEORGID | 销售组织 | string | |
FCONTACTUNITTYPE | 往来单位类型 | string | 往来单位类型 |
FCONTACTUNIT | 往来单位 | string | 往来单位 |
FRECTUNITTYPE | 付款单位类型 | string | 付款单位类型 |
FRECTUNIT | 付款单位 | string | 付款单位 |
FBUSINESSTYPE | 业务类型 | string | 业务类型 |
FPAYORGID | 收款组织 | string | 收款组织 |
FSETTLECUR | 结算币别 | string | |
FREMARK | 摘要 | string | |
FREFUNDBILLENTRY | 退款单明细 | array | |
FREFUNDBILLENTRY.FSETTLETYPEID | 结算方式 | string | |
FREFUNDBILLENTRY.FPURPOSEID | 原收款用途 | string | 收款用途 |
FREFUNDBILLENTRY.FREFUNDAMOUNTFOR | 表体-应退金额 | string | 表体-应收金额 |
FREFUNDBILLENTRY.FACCOUNTID | 我方银行账号 | string | 我方银行账号 |
FREFUNDBILLENTRY.FNOTE | 备注 | string | |
FREFUNDBILLENTRY.FormId | 业务对象表单Id | string | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
FREFUNDBILLENTRY.Operation | 执行的操作 | string | |
FREFUNDBILLENTRY.IsAutoSubmitAndAudit | 提交并审核 | bool | |
FREFUNDBILLENTRY.IsVerifyBaseDataField | 验证基础资料 | bool | 是否验证所有的基础资料有效性,布尔类,默认false(非必录) |
系统打通概况
全新的API数据集成模式,赋能企业业务创新 传统企业集成主要采用点对点或ESB集成方式,基于全新API战略中台的API新型集成方式通过解耦系统资源,降低系统间对接难度,实现快速业务需求响应,提升对接效率,助力企业满足快速业务交付需求,实现业务创新。通过构建API生态,助力能力开放与共享 基于API战略中台梳理并整合内部API资源与IT资产,可实现内部资源共享,满足内部开发人员资源使用需求,例如:金蝶云星空与吉客云之间数据集成;并将API资源对外可控开放,打造面向开发者的生态服务,为您打通自身和上下游合作伙伴,创造共赢价值链。开展API战略中台,重塑IT 帮助您基于内部资源构建不同业务能力中心,打造企业统一API战略中台,赋能企业发展,实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时,无需从“零”组建各业务模块,提升开发效率,重塑IT组织及交付能力。
