金蝶云星辰V1与聚水潭对接集成商品查询打通采购退货上传
来源系统:金蝶云星辰V1
金蝶云星辰是金蝶集团公司为小微型工商贸企业定制的一款集财务、进销存、订货商城和税务管理为一体的SAAS云平台，有标准版和专业版两个版本，标准版适用于小型企业(10-50人)业财一体化管理，专业版面向小型(10-100人)企业管理需求。金蝶云星辰聚焦小型企业在线经营和数字化管理，赋能小型企业拓客开源、智能管理和实时决策。
接通系统：聚水潭
聚水潭成立于2014年，创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初，以电商SaaSERP切入市场，凭借出色的产品和服务，快速获得市场的肯定。随着客户需求的不断变化，如今聚水潭已经发展成为以SaaSERP为核心，集多种商家服务为一体的SaaS协同平台。经过8年多的发展，公司员工从2014年成立之初的9人增加到现在近4000人。聚水潭已在全国设立了超过100个线下服务网点，服务范围覆盖超过400个城镇，为客户提供及时、周到和专业的服务。
数据集成方案配置
通过轻易云系统数据集成平台新增创建集成方案，通过轻易云的方案市场可以一键复制，并且可以借鉴其他的方案配置完成方案制作，方案制作只需要两步，第一步先确定好对应的数据来源；源系统：金蝶云星辰V1接口：商品查询通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统：聚水潭接口：采购退货上传，通过写入调度者匹配获取到的数据和写入的映射关系，即可自动生成符合目标系统：聚水潭写入的数据自动产生写入队列，通过运行概况，系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况
金蝶云星辰V1接口明细
- API：jdy/basedata/material_list
- NAME：商品查询
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| enable | 可用状态 | 1 | 可用状态，1：可用，0：禁用,-1：全部 |
| search | 模糊搜索 | | 模糊搜索-名称、编码、规格、条形码 |
| parent | 商品类别 | | 商品类别ID |
| isdataperm | 数据权限 | | 是否添加数据权限校验，默认false |
| startdate | 创建开始日期 | | 开始日期（格式：“yyyy-MM-dd”，为空表示不过滤），创建日期 |
| enddate | 创建结束日期 | | 结束日期（格式：“yyyy-MM-dd”，为空表示不过滤），创建日期 |
| begindate | 修改开始日期 | | 开始日期（格式：“yyyy-MM-dd”，为空表示不过滤），修改日期 |
| expiredate | 修改结束日期 | | 结束日期（格式：“yyyy-MM-dd”，为空表示不过滤），修改日期 |
| starttime | 创建开始时间戳 | | 开始时间（格式：“时间戳”，-1表示不过滤），创建时间 |
| endtime | 创建结束时间戳 | | 结束时间（格式：“时间戳”，-1表示不过滤），创建时间 |
| begintime | 修改开始时间戳 | function {{LAST_SYNC_TIME}}0001 | 开始时间（格式：“时间戳”，-1表示不过滤），修改时间 |
| expiretime | 修改结束时间戳 | _function {{CURRENT_TIME}}000*1 | 结束时间（格式：“时间戳”，-1表示不过滤），修改时间 |
| page | 当前页 | {{PAGINATION_START_PAGE}} | 当前页（默认1） |
| pagesize | 每页显示条数 | {{PAGINATION_PAGE_SIZE}} | 每页显示条数（默认10，最大100） |
| showunits | 多单位信息 | | 是否返回多单位信息，true：返回，默认false |
| showimages | 图片信息 | | 是否返回图片信息，true：返回，默认false |
| number | 自定义返回字段 | | 自定义返回字段（除默认字段外），多个字段用英文逗号隔开,具体看商品元数据的标识 |
| splitArray | splitArray | jdy/basedata/material_detail | |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| id | ID | | |
| number | 编码 | | |
| name | 名称 | | |
| parent_id | 类别id | | |
| parent_name | 类别名称 | | |
| parent_number | 类别编码 | | |
| ismulti_unit | 是否多单位 | | |
| isserial | 是否序列号 | | |
| isasstattr | 是否辅助属性是 | | |
| isweight | 启用称重 | | |
| iskfperiod | 是否保质期 | | |
| isbatch | 是否批次 | | |
| url | 商品主图 | | |
| model | 商品规格 | | |
| barcode | 商品条形码 | | |
| isshowauxbarcode | 是否开启辅助属性条码 | | |
| mullabel | 商品标签 | | |
| checktype | 商品类别1：普通2：套装3：服务 | | |
| brandid_id | 品牌id | | |
| brandid_name | 品牌名称 | | |
| brandid_number | 品牌编码 | | |
| producingpace | 产地 | | |
| helpcode | 助记码 | | |
| baseunitid_id | 计量单位id | | |
| baseunitid_number | 计量单位编码 | | |
| baseunitid_name | 计量单位名称 | | |
| remark | 备注 | | |
聚水潭接口明细
- 调用接口：jushuitan.purchaseout.upload
- 接口名称：采购退货上传
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| is_confirm | 是否自动确认 | string | |
| wms_co_id | 分仓编号 | string | |
| supplier_id | 供应商编号 | string | |
| po_id | 采购单号 | string | |
| external_id | 外部单号 | string | |
| remark | 备注 | string | |
| warehouse | 仓库编号 | string | |
| items | items | array | |
| items.sku_id | 商品编码 | string | |
| items.qty | 数量 | string | |
| items.price | 单价 | string | |
| items.batch_id | 批次单号 | string | |
| items.produced_date | 生产日期 | string | |
数据对接效果
大部分的企业都可能只用一套系统组织架构复杂，业务流程繁琐，内部同时有OA系统、BI系统、ERP系统......且各个系统都需要独立登陆，造成IT部门数据监管困难！如何在同一套中台系统上关联多管理系统呢？系统集成平台，就可以无缝集成各个业务系统，主数不统一、交易数据来回导出导入、业务融合等问题。通过轻易云系统集成平台完美结合：打破企业内部数据孤岛，无需繁琐的处理工序，与数据集成服务完美结合，让数据真正通起来。 资源互补：汇集各种行业解决方案，资源互补，企业管理融合提升。让对接开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。
