金蝶云星辰V1和聚水潭接口打通对接实战
来源系统:金蝶云星辰V1
金蝶云星辰是金蝶集团公司为小微型工商贸企业定制的一款集财务、进销存、订货商城和税务管理为一体的SAAS云平台,有标准版和专业版两个版本,标准版适用于小型企业(10-50人)业财一体化管理,专业版面向小型(10-100人)企业管理需求。金蝶云星辰聚焦小型企业在线经营和数字化管理,赋能小型企业拓客开源、智能管理和实时决策。
接入系统:聚水潭
聚水潭是SaaS协同平台、电商ERP软件。聚水潭成立于2014年,创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初,以电商SaaSERP切入市场,凭借出色的产品和服务,快速获得市场的肯定。
数据集成方案配置
轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线,所以对接方案的配置极其重要,方案可以选择一键复制,轻易云有海量的对接方案可支持一键复制,复制后直接启动使用(对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置,配置只要确认源平台:金蝶云星辰V1的取数逻辑,例如什么时间取什么样的数据。即可完成配置,目标平台:聚水潭,把获取的数据组装成目标系统需要的格式进行写入。
金蝶云星辰V1接口明细
- 接口:jdy/basedata/material_list
- 接口名称:商品查询
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
enable | 可用状态 | string | 可用状态,1:可用,0:禁用,-1:全部 |
search | 模糊搜索 | string | 模糊搜索-名称、编码、规格、条形码 |
parent | 商品类别 | string | 商品类别ID |
isdataperm | 数据权限 | string | 是否添加数据权限校验,默认false |
startdate | 创建开始日期 | string | 开始日期(格式:“yyyy-MM-dd”,为空表示不过滤),创建日期 |
enddate | 创建结束日期 | string | 结束日期(格式:“yyyy-MM-dd”,为空表示不过滤),创建日期 |
begindate | 修改开始日期 | string | 开始日期(格式:“yyyy-MM-dd”,为空表示不过滤),修改日期 |
expiredate | 修改结束日期 | string | 结束日期(格式:“yyyy-MM-dd”,为空表示不过滤),修改日期 |
starttime | 创建开始时间戳 | string | 开始时间(格式:“时间戳”,-1表示不过滤),创建时间 |
endtime | 创建结束时间戳 | string | 结束时间(格式:“时间戳”,-1表示不过滤),创建时间 |
begintime | 修改开始时间戳 | string | 开始时间(格式:“时间戳”,-1表示不过滤),修改时间 |
expiretime | 修改结束时间戳 | string | 结束时间(格式:“时间戳”,-1表示不过滤),修改时间 |
page | 当前页 | string | 当前页(默认1) |
pagesize | 每页显示条数 | string | 每页显示条数(默认10,最大100) |
showunits | 多单位信息 | string | 是否返回多单位信息,true:返回,默认false |
showimages | 图片信息 | string | 是否返回图片信息,true:返回,默认false |
number | 自定义返回字段 | string | 自定义返回字段(除默认字段外),多个字段用英文逗号隔开,具体看商品元数据的标识 |
splitArray | splitArray | string | |
响应参数
字段 | 名称 | 类型 | 描述 |
id | ID | string | |
number | 编码 | string | |
name | 名称 | string | |
parent_id | 类别id | string | |
parent_name | 类别名称 | string | |
parent_number | 类别编码 | string | |
ismulti_unit | 是否多单位 | string | |
isserial | 是否序列号 | string | |
isasstattr | 是否辅助属性是 | string | |
isweight | 启用称重 | string | |
iskfperiod | 是否保质期 | string | |
isbatch | 是否批次 | string | |
url | 商品主图 | string | |
model | 商品规格 | string | |
barcode | 商品条形码 | string | |
isshowauxbarcode | 是否开启辅助属性条码 | string | |
mullabel | 商品标签 | string | |
checktype | 商品类别1:普通2:套装3:服务 | string | |
brandid_id | 品牌id | string | |
brandid_name | 品牌名称 | string | |
brandid_number | 品牌编码 | string | |
producingpace | 产地 | string | |
helpcode | 助记码 | string | |
baseunitid_id | 计量单位id | string | |
baseunitid_number | 计量单位编码 | string | |
baseunitid_name | 计量单位名称 | string | |
remark | 备注 | string | |
聚水潭接口明细
- 接口:jushuitan.purchaseout.upload
- 接口名称:采购退货上传
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
is_confirm | 是否自动确认 | string | 是否自动确认 |
wms_co_id | 分仓编号 | string | 分仓编号 |
supplier_id | 供应商编号 | string | 供应商编号 |
po_id | 采购单号 | string | 采购单号 |
external_id | 外部单号 | string | 外部单号 |
remark | 备注 | string | 备注 |
warehouse | 仓库编号 | string | 仓库编号 主仓=1,销退仓=2, 进货仓=3,次品仓 = 4 |
items | items | array | items |
items.sku_id | 商品编码 | string | 商品编码 |
items.qty | 数量 | string | 数量 |
items.price | 单价 | string | 单价 |
items.batch_id | 批次单号 | string | 批次单号,系统中需开启相关配置 |
items.produced_date | 生产日期 | string | 生产日期,系统中需开启相关配置 |
系统集成总览
可视化配置,即便是普通业务人员也可以快速轻松对接多个平台,解决企业面临的数据孤岛,数据混乱等问题,实现数据可见、可用、可运营。进行统一化,模块化,标准化的服务能力和输出,实现对业务端数据需求的精准满足和高效响应,也可以在业务数据需求的不断增加下,让企业有整套的可复用的api资产以更换,支持业务的正常运转,节省开发成本。在不同的着重点和应用上解决数据共享,实现平台之间的独立管理。