金蝶云星空和聚水潭单据接口集成

数据源平台:聚水潭

聚水潭成立于2014年，创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初，以电商SaaSERP切入市场，凭借出色的产品和服务，快速获得市场的肯定。随着客户需求的不断变化，如今聚水潭已经发展成为以SaaSERP为核心，集多种商家服务为一体的SaaS协同平台。经过8年多的发展，公司员工从2014年成立之初的9人增加到现在近4000人。聚水潭已在全国设立了超过100个线下服务网点，服务范围覆盖超过400个城镇，为客户提供及时、周到和专业的服务。

写入目标:金蝶云星空

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

系统对接接口配置

集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：聚水潭，源系统 API：销售出库查询，目标系统：金蝶云星空，目标系统 API销售出库新增。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。数据管道ETL：构建一体化的数据融合平台。高级数据转换：支持公式转换数据格式、支持脚本直接进行数据转换、支持可视化多维度数据处理。高性能实时处理：针对不同数据节点类型提供TB级吞吐量，秒级延迟的增量数据处理能力。自动将旧版web服务转变为基于云端微服务的API，统一接口输出标准。支持接口开放服务，实现内外部能力接入。

聚水潭接口明细

API：/open/orders/out/simple/query
NAME：销售出库查询
METHOD：POST

请求参数

接口字段名称预设值 hop_id店铺编码 is_offline_shopshop_id为0且is_offline_shop为true查询线下店铺单据 status单据状态 modified_begin修改开始时间2022-11-07 00:00:00 modified_end修改结束时间2022-11-10 00:00:00 so_ids线上单号 page_index页数1 page_size每页行数50

响应参数

接口字段名称预设值 co_id公司编号 shop_id店铺编号 io_id出库单号 o_id内部单号 so_id线上单号 created创建时间 modified修改时间 status状态 order_type单据类型 invoice_title发票抬头 shop_buyer_id买家帐号 receiver_country国家 receiver_state省 receiver_city市 receiver_district区 receiver_town街道 receiver_address地址 receiver_name收件人姓名 receiver_phone收件人手机 receiver_mobile收件人电话 buyer_message买家留言 remark备注 is_cod是否货到付款 pay_amount应付金额 l_id物流单号 io_date出库时间 lc_id快递公司编码 stock_enabled是否启用库存管理 drp_co_id_from分销商编号 labels标记多标签 paid_amount实付金额 free_amount优惠金额 freight运费 weight预估重量 f_weight实称重量 merge_so_id合并订单号 wms_co_id分仓编号 business_staff业务人员 currency货币类型 items商品集合 items.ioi_id子单号 items.pic图片 items.sku_id商品编码 items.qty数量 items.name商品名称 items.properties_value颜色规格 items.sale_price单价 items.sale_amount金额 items.i_id款式编码 items.sale_base_price原价 items.batchs批次集合 items.batchs.batch_no批次号 items.batchs.product_date批次日期 items.batchs.supplier_id供应商编号 items.batchs.supplier_name供应商名称 items.batchs.expiration_date有效期至 items.batchs.sns唯一码集合 items.batchs.sns.sn唯一码 items.batchs.sns.pay_date支付时间 items.batchs.sns.code错误码 items.batchs.sns.issuccesstrue代表成功 items.batchs.sns.msg执行描述 items.batchs.sns.F_UYEP_Base_cw仓位

金蝶云星空接口明细

API：batchSave
NAME：销售出库新增
METHOD：POST

请求参数

接口字段名称预设值 FBillTypeID单据类型XSCKD01_SYS FBillNo单据编号{{io_id}} FDate日期{{io_date}} FSaleOrgId销售组织100 FCustomerID客户凤岗 FStockOrgId发货组织100 FNote备注{{remark}} FEntity明细信息items FEntity.FMaterialId物料编码{{items.sku_id}} FEntity.FRealQty实发数量{{items.qty}} FEntity.FPrice单价 FEntity.FTaxPrice含税单价{{items.sale_price}} FEntity.FIsFree是否赠品_function case '{{items.sale_price}}' when '0' then true else false end FEntity.FEntryTaxRate税率% FEntity.FAllAmount价税合计 FEntity.FStockId仓库11161780 FEntity.FEntrynote备注 FEntity.SubHeadEntity财务信息 FEntity.SubHeadEntity.FSettleOrgId结算组织100 FEntity.SubHeadEntity.FSETTLECURRID结算币别PRE001 FEntity.SubHeadEntity.FSalesManId业务员{{business_staff}} FEntity.SubHeadEntity.F_UYEP_Text1制单人 FEntity.SubHeadEntity.F_UYEP_Text内部订单号{{o_id}} FEntity.SubHeadEntity.FLot批次{{batchs.batch_no}} FEntity.SubHeadEntity.FormId业务对象表单IdSAL_OUTSTOCK FEntity.SubHeadEntity.Operation执行的操作BatchSave FEntity.SubHeadEntity.IsAutoSubmitAndAudit提交并审核false FEntity.SubHeadEntity.IsVerifyBaseDataField验证基础资料false

数据对接价值

异构系统都具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。采用“轻易云集成方案”的解决方案，可以满足客户的实际业务需求，推动软件工程的规范化，使开发人员遵循统一的概要设计开发实现，降低系统实现的风险，做到系统设计资料的规范性与全面性，以利于系统的实现、测试、维护、版本升级等。通过轻易云系统集成平台完美结合：打破企业内部数据孤岛，无需繁琐的处理工序，与数据集成服务完美结合，让数据真正通起来。资源互补：汇集各种行业解决方案，资源互补，企业管理融合提升。

金蝶云星空和聚水潭单据接口集成