聚水潭和金蝶云星空接口打通对接实战

聚水潭和金蝶云星空接口打通对接实战

接入系统：聚水潭

聚水潭SaaSERP于2014年4月上线，目前累计超过2.5万商家注册使用，成为淘宝应用服务市场ERP类目商家数和商家月订单增速最快的ERP。2014年及2015年“双十一”当天，聚水潭SaaSERP平稳、安全、顺畅的处理了近千万订单，超过了淘宝对ERP系统吞吐量极限要求的16倍，成为行业里的新标杆。截止目前，聚水潭客户已超2.5万家，其中有南极人、POVOS奔腾，恒源祥，柚子美衣，洁丽雅，FLYCO飞科，波司登，满速，欧丝璐等，并与知名电商圈“老A电商学院”达成深度合作。

写入目标:金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

数据接口配置

集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：聚水潭，源系统 API：采购退货查询，目标系统：金蝶云星空，目标系统 API采购退货新增。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。

聚水潭接口明细

• API：/open/purchaseout/query
• NAME：采购退货查询
• METHOD：POST

请求参数

接口字段字段名称预设值描述 page_index开始页码1第几页，从第一页开始，默认1 page_size每页条数50每页多少条，默认30，最大50 modified_begin修改开始时间{{LAST_SYNC_TIME datetime}}修改起始时间，和结束时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空 modified_end修改结束时间{{CURRENT_TIME datetime}}修改结束时间，和起始时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空 status单据状态Confirmed单据状态，Confirmed=生效，WaitConfirm待审核，Creating=草拟，Archive=归档，Cancelled=作废

响应参数

接口字段字段名称预设值描述 io_date单据日期单据日期 status状态状态，Confirmed=生效，WaitConfirm待审核，Creating=草拟，Archive=归档，Cancelled=作废 so_id线上单号线上单号 f_status财务状态财务状态，WaitConfirm=待审核，Confirmed=待审核 warehouse仓库名仓库名 receiver_name收货人/供应商名称收货人/供应商名称 receiver_mobile收货电话收货电话 receiver_state收货状态收货状态 receiver_city市市 receiver_district区区 receiver_address地址地址 wh_id仓库编号1仓库编号，1=主仓，2=销退仓，3=进货仓，4=次品仓 modified修改时间修改时间 po_id采购单号采购单号 wms_co_id分仓编号分仓编号 seller_id供应商ID供应商ID labels标记多标签标记 多标签 logistics_company物流公司物流公司 lc_id物流公司编号物流公司编号 l_id物流单号物流单号 archived财务审核日期财务审核日期 creator_name创建人创建人 items商品合集 items.io_id退货单号退货单号 items.remark备注备注 items.ioi_id明细id明细id items.sku_id商品编码商品编码 items.name商品名称商品名称 items.properties_value属性属性 items.qty数量数量 items.cost_price单价单价 items.cost_amount金额金额 items.i_id款式编码款式编码 items.co_id公司编号公司编号 items.batchs批次集合 items.batchs.batch_no批次号批次号 items.batchs.product_date批次日期批次日期 items.batchs.code错误码，0代表成功错误码，0代表成功 items.batchs.issuccess是否成功，true代表成功是否成功，true代表成功 items.batchs.msg执行描述执行描述 items.batchs.io_id退货单号

金蝶云星空接口明细

• 调用接口：batchSave
• 接口名称：采购退货新增
• 方法：POST

请求参数

字段字段名称类型配置值 FBILLTYPEID单据类型stringTLD01_SYS FStockOrgId退料组织string100 FBillNo单据编号string{{io_id}} FDate退料日期string{{io_date}} FSupplierID供应商string{{seller_id}} FMRTYPE退料类型stringB FMRDeptId退料部门string FDESCRIPTION备注string FSettleOrgId结算组织string100 FSettleCurrId结算币别stringPRE001 FPayOrgId付款组织string100 FOwnerTypeIdHead货主类型stringBD_OwnerOrg FOwnerIdHead货主string100 FPURMRBENTRY明细信息arrayitems FPURMRBENTRY.FMATERIALID物料编码string{{items.i_id}} FPURMRBENTRY.FRMREALQTY实退数量string{{items.qty}} FPURMRBENTRY.FSTOCKID仓库stringCK FPURMRBENTRY.FNOTE备注string FPURMRBENTRY.FPrice单价string FPURMRBENTRY.FGiveAway是否赠品string FPURMRBENTRY.FOWNERTYPEID货主类型stringBD_OwnerOrg FPURMRBENTRY.FOWNERID货主string100 FPURMRBENTRY.FENTRYTAXRATE税率string FPURMRBENTRY.FTAXPRICE含税单价string{{items.cost_price}} FPURMRBENTRY.FormId业务对象表单IdstringPUR_MRB FPURMRBENTRY.Operation执行的操作stringbatchSave FPURMRBENTRY.IsAutoSubmitAndAudit提交并审核booltrue FPURMRBENTRY.IsVerifyBaseDataField验证基础资料boolfalse FPURMRBENTRY.SubSystemId系统模块string21

系统集成总览

基于轻易云的连接器和数据服务能力，轻松实现供应链异构系统的“相互沟通”，通过数据应用自动化业务流程管理，全面管控供应链的每一环节。从要货、销售出库、退货入库、到盘点、调拨，无需人工参与，实时更新，自动化流转。通过快速连接聚水潭接口抽取数据后再自动分发到金蝶云星空， 解放生产力，自动生成数据、并分发推送到业务应用，数据传递时效性提升10倍以上。