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

接入系统:吉客云
吉客云是基于“网店管家”十五年电商ERP行业和技术积累基础上顺应产业发展需求,重新定位、全新设计推出的换代产品,从业务数字化和组织数字化两个方向出发,以构建流程的闭环为依归,致力于为企业的数字化升级提供落地工具。
目标系统:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践,面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司,提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于:集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
数据接口配置
集成方案是整个轻易云集成平台的核心,每一个集成方案代表一种业务的对接策略(对接方案借鉴可以在轻易云系统数据集成交流社区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}} | |
响应参数
接口字段 | 字段名称 | 预设值 | 描述 |
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 | 货品图片详情 | | |
金蝶云星空接口明细
- 调用接口: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 | FKTKDLX02_SYS |
FPURCHASEORGID | 采购组织 | string | _function CASE '{{settleAccountName}}' when '生和堂科技(天猫生和堂食品旗舰)支付宝' then 104 else 103 end |
FCONTACTUNITTYPE | 往来单位类型 | string | BD_Customer |
FCONTACTUNIT | 往来单位 | string | {{settleAccountName}} |
FPAYUNITTYPE | 付款单位类型 | string | BD_Customer |
FPAYUNIT | 付款单位 | string | {{settleAccountName}} |
FBUSINESSTYPE | 业务类型 | string | 3 |
FPAYORGID | 付款组织 | string | function CASE '{{settleAccountName}}' when '生和堂科技(天猫生和堂食品旗舰)支付宝' then 104 else 103 end |
FSETTLECUR | 结算币别 | string | PRE001 |
FREMARK | 备注 | string | |
FREFUNDBILLENTRY | 付款单明细 | array | details |
FREFUNDBILLENTRY.FSETTLETYPEID | 结算方式 | string | JSFS04_SYS |
FREFUNDBILLENTRY.FPURPOSEID | 原付款用途 | string | SFKYT2205100003 |
FREFUNDBILLENTRY.FREFUNDAMOUNTFOR | 表体-应退金额 | string | {{details.inAmount}} |
FREFUNDBILLENTRY.FACCOUNTID | 我方银行账号 | string | _findCollection find FNumber from e0411585-ebc3-30fb-ac16-872da1e0bfde where FName={{settleAccountName}} |
FREFUNDBILLENTRY.FNOTE | 备注 | string | {{bizType}} |
FREFUNDBILLENTRY.FormId | 业务对象表单Id | string | AP_REFUNDBILL |
FREFUNDBILLENTRY.Operation | 执行的操作 | string | BatchSave |
FREFUNDBILLENTRY.IsAutoSubmitAndAudit | 提交并审核 | bool | true |
FREFUNDBILLENTRY.IsVerifyBaseDataField | 验证基础资料 | bool | false |
系统对接总览
通过无代码的数据集成与数据建模的智能数据管道技术,帮助企业将所有应用程序、数据库、事件和文件等数据信息提取到数据仓库中,并快速将分散的数据转化为数据集、API、自动化流程等开箱即用的数据服务。配置接口的模式对接吉客云和金蝶云星空,使得单据无缝互通。打造企业内部数据一体化,让企业日常运营管理实现敏捷数据化运营。实现供应链业务信息流的互通,同时支持供应链数据分析流程自动化,结果推送,推进相关供应链问题优化。及时打通供应链孤岛,实现数据驱动供应链协同,进一步提升企业竞争力。

