金蝶云星辰V1与聚水潭对接集成商品查询打通采购退货上传
数据源平台:金蝶云星辰V1
金蝶云·星辰基于金蝶云·苍穹云原生PaaS平台构建,聚焦小型企业在线经营和数字化管理,提供财务云、税务云、进销存云、零售云、订货商城等SaaS服务,支持企业拓客开源、智能管理、实时决策;金蝶云·星辰还提供轻量级PaaS平台和全面的API接口,广泛连接生态伙伴,为小微企业提供一站式服务,助力企业快速成长
集成系统:聚水潭
聚水潭SaaSERP于2014年4月上线,目前累计超过2.5万商家注册使用,成为淘宝应用服务市场ERP类目商家数和商家月订单增速最快的ERP。2014年及2015年“双十一”当天,聚水潭SaaSERP平稳、安全、顺畅的处理了近千万订单,超过了淘宝对ERP系统吞吐量极限要求的16倍,成为行业里的新标杆。截止目前,聚水潭客户已超2.5万家,其中有南极人、POVOS奔腾,恒源祥,柚子美衣,洁丽雅,FLYCO飞科,波司登,满速,欧丝璐等,并与知名电商圈“老A电商学院”达成深度合作。
数据接口配置
通过轻易云系统数据集成平台新增创建集成方案,通过轻易云的方案市场可以一键复制,并且可以借鉴其他的方案配置完成方案制作,方案制作只需要两步,第一步先确定好对应的数据来源;源系统:金蝶云星辰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服务总线层面解决企业烟囱式业务系统集成现状 相互连接企业各业务系统,实现流程端到端打通,复用已有的业务系统能力,让集成架构、服务关系更清晰 使用统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升API利用率,发挥业务系统价值,实现企业IT资产的可插拔、可复用、可组成。