从吉客云到金蝶云星空通过接口配置打通数据

关一帆qeasy

从吉客云到金蝶云星空通过接口配置打通数据

数据源系统:吉客云

吉客云是基于“网店管家”十五年电商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 是 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货品图片详情

金蝶云星空接口明细

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业务对象表单IdAP_REFUNDBILL必须填写金蝶的表单ID如😛UR_PurchaseOrder FREFUNDBILLENTRY.Operation执行的操作BatchSave FREFUNDBILLENTRY.IsAutoSubmitAndAudit提交并审核true FREFUNDBILLENTRY.IsVerifyBaseDataField验证基础资料false是否验证所有的基础资料有效性，布尔类，默认false（非必录）

系统集成总览

可视化配置，即便是普通业务人员也可以快速轻松对接多个平台，解决企业面临的数据孤岛，数据混乱等问题，实现数据可见、可用、可运营。进行统一化，模块化，标准化的服务能力和输出，实现对业务端数据需求的精准满足和高效响应，也可以在业务数据需求的不断增加下，让企业有整套的可复用的api资产以更换，支持业务的正常运转，节省开发成本。在不同的着重点和应用上解决数据共享，实现平台之间的独立管理。