从吉客云到金蝶云星空通过接口配置打通数据
数据源系统:吉客云
吉客云是基于“网店管家”十五年电商ERP行业和技术积累基础上顺应产业发展需求,重新定位、全新设计推出的换代产品,从业务数字化和组织数字化两个方向出发,以构建流程的闭环为依归,致力于为企业的数字化升级提供落地工具。
对接系统:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
数据集成方案配置
数据集成平台对应的配置吉客云与金蝶云星空的对接只要三步就能完成两个系统之间的数据对接。第一步根据吉客云的接口参数要求记录在轻易云集成平台。第二步配置吉客云与金蝶云星空之间的字段对应关系(更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息)第三步完成方案的检查参数设置:传递时间、重试次数、是否启动、前置条件等上线运行。
吉客云接口明细
- 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}} | |
响应参数
接口字段 | 字段名称 | 预设值 | 描述 |
imgUrl | 图片地址 | | http:asasda.png |
isMainImage | 是否主图 0-是 1-否 | | 1 |
imagePosition | 图片位置main-主图 left-左侧图 right-右侧图 | | left |
imgKey | 图片地址key | | 美美哒.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 | 货品图片详情 | | |
金蝶云星空接口明细
- API:batchSave
- NAME:收款单新增
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
FBillNo | 单据编号 | | 单据编号 |
FSETTLEORGID | 结算组织 | function CASE '{{settleAccountName}}' when '生和堂科技(天猫生和堂食品旗舰)支付宝' then 104 else 103 end | 结算组织 |
FEXCHANGETYPE | 汇率类型 | HLTX01_SYS | |
FCURRENCYID | 币别 | PRE001 | 币别 |
FDATE | 业务日期 | {{bookTime_new}} | 业务日期 |
FBillTypeID | 单据类型 | FKTKDLX02_SYS | 单据类型 |
FPURCHASEORGID | 采购组织 | _function CASE '{{settleAccountName}}' when '生和堂科技(天猫生和堂食品旗舰)支付宝' then 104 else 103 end | |
FCONTACTUNITTYPE | 往来单位类型 | BD_Customer | 往来单位类型 |
FCONTACTUNIT | 往来单位 | {{settleAccountName}} | 往来单位 |
FPAYUNITTYPE | 付款单位类型 | BD_Customer | 付款单位类型 |
FPAYUNIT | 付款单位 | {{settleAccountName}} | 付款单位 |
FBUSINESSTYPE | 业务类型 | 3 | 业务类型 |
FPAYORGID | 付款组织 | function CASE '{{settleAccountName}}' when '生和堂科技(天猫生和堂食品旗舰)支付宝' then 104 else 103 end | 收款组织 |
FSETTLECUR | 结算币别 | PRE001 | |
FREMARK | 备注 | | |
FREFUNDBILLENTRY | 付款单明细 | details | |
FREFUNDBILLENTRY.FSETTLETYPEID | 结算方式 | JSFS04_SYS | |
FREFUNDBILLENTRY.FPURPOSEID | 原付款用途 | SFKYT2205100003 | 收款用途 |
FREFUNDBILLENTRY.FREFUNDAMOUNTFOR | 表体-应退金额 | {{details.inAmount}} | 表体-应收金额 |
FREFUNDBILLENTRY.FACCOUNTID | 我方银行账号 | _findCollection find FNumber from e0411585-ebc3-30fb-ac16-872da1e0bfde where FName={{settleAccountName}} | 我方银行账号 |
FREFUNDBILLENTRY.FNOTE | 备注 | {{bizType}} | |
FREFUNDBILLENTRY.FormId | 业务对象表单Id | AP_REFUNDBILL | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
FREFUNDBILLENTRY.Operation | 执行的操作 | BatchSave | |
FREFUNDBILLENTRY.IsAutoSubmitAndAudit | 提交并审核 | true | |
FREFUNDBILLENTRY.IsVerifyBaseDataField | 验证基础资料 | false | 是否验证所有的基础资料有效性,布尔类,默认false(非必录) |
系统集成总览
可视化配置,即便是普通业务人员也可以快速轻松对接多个平台,解决企业面临的数据孤岛,数据混乱等问题,实现数据可见、可用、可运营。进行统一化,模块化,标准化的服务能力和输出,实现对业务端数据需求的精准满足和高效响应,也可以在业务数据需求的不断增加下,让企业有整套的可复用的api资产以更换,支持业务的正常运转,节省开发成本。在不同的着重点和应用上解决数据共享,实现平台之间的独立管理。