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

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

数据源系统:聚水潭

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

接入系统：金蝶云星辰V1

金蝶云星辰是金蝶集团公司为小微型工商贸企业定制的一款集财务、进销存、订货商城和税务管理为一体的SAAS云平台，有标准版和专业版两个版本，标准版适用于小型企业(10-50人)业财一体化管理，专业版面向小型(10-100人)企业管理需求。金蝶云星辰聚焦小型企业在线经营和数字化管理，赋能小型企业拓客开源、智能管理和实时决策。

接口方案配置

通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：聚水潭，然后选择对应的连接器。选择对应的orders.single.query作为数据对接来源。然后再写入目标平台配置目标系统为金蝶云星辰V1，并且选择对应连接器（关于金蝶云星辰V1的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的jdy/sal/sal_order_save接口作为数据写入动作完成第一步的接口配置。

聚水潭接口明细

• 调用接口：/open/orders/single/query
• 接口名称：订单查询
• 方法：POST

请求参数

字段字段名称类型配置值 shop_id店铺string is_offline_shop线下店铺string so_ids单号string1748257394349939573 modified_begin起始时间string{{LAST_SYNC_TIME datetime}} modified_end结束时间string{{CURRENT_TIME datetime}} status状态stringSent page_index第几页string1 page_size每页条数string50

响应参数

字段字段名称类型配置值 is_cod是否货到付款string l_id快递单号string send_date发货日期string pay_date支付时间string freight运费string receiver_address收货地址string receiver_district区string wms_co_id发货仓编号string logistics_company快递公司string free_amount抵扣金额string shop_name店铺名称string question_type问题类型string outer_pay_id外部支付单号string so_id线上订单号string5002070589717265827 type订单类型string order_from订单来源string status状态string pay_amount应付金额string shop_buyer_id买家昵称string shop_status平台订单状态string receiver_mobile手机string order_date下单时间string question_desc问题描述string receiver_city收件信息-市string receiver_state收件信息-省string receiver_name收件信息-收件人string o_idERP 内部订单号，唯一string shop_id店铺编号string co_id公司编号string pays支付信息array pays.is_order_pay是否支付string pays.buyer_account支付帐号string pays.amount支付金额string pays.pay_date支付时间string pays.outer_pay_id外部支付单号string pays.pay_id支付单IDstring pays.payment支付渠道string pays.items商品信息array pays.items.is_gift是否赠品string pays.items.sku_id商家编码string pays.items.name商品名称string pays.items.refund_status申请退款状态string pays.items.refund_id退款的唯一单号string pays.items.price单价string pays.items.outer_oi_id子订单号string pays.items.item_status商品状态string pays.items.i_id款式编码string pays.items.properties_value属性string pays.items.oi_id子订单号string pays.items.amount总额string pays.items.shop_sku_id外部sku_idstring pays.items.raw_so_id原始线上单号string pays.items.qty数量string pays.items.is_presale是否预售string pays.items.base_price基本售价string pays.items.pic商品图片string pays.items.sku_type商品类型string pays.items.remark订单备注；卖家备注string pays.items.drp_co_id_from分销商编号string pays.items.modified修改时间string pays.items.labels多标签string pays.items.paid_amount实际支付金额string pays.items.currency币种string pays.items.buyer_message买家留言string pays.items.lc_id物流公司编码string pays.items.invoice_title发票抬头string pays.items.invoice_type发票类型string pays.items.buyer_tax_no发票税号string pays.items.creator_name业务员string pays.items.plan_delivery_date计划发货时间string pays.items.node线下备注string pays.items.receiver_town收件信息-街道string pays.items.drp_co_id_to供销商编号string

金蝶云星辰V1接口明细

• API：jdy/sal/sal_order_save
• NAME：新增或者修改一张销售订单
• METHOD：POST

请求参数

接口字段字段名称预设值描述 billdate单据日期,格式：2019-01-01{{order_date}}出库日期,格式：2019-01-01 billno单据编号{{so_id}}单据编号 customerid_id客户信息findCollection find id from cf6895b4-1a77-312f-aaa5-abe33be737a9 where number={{shop_id}}客户信息 material_entity商品分录new_bomentity material_entity.materialid_id商品_findCollection find id from 673a1464-d665-376c-8f2d-58d9cbe67249 where number={{new_bomentity.materialid_number}}商品 material_entity.stockid_id仓库1404426243096477699仓库 material_entity.qty数量{{new_bomentity.count}}数量 material_entity.unit_id单位单位（只能填商品关联的单位，来源于商品单位查询接口或商品详情中的baseunitid_id、fixunit1_id等） material_entity.taxprice单价{{new_bomentity.new_amount}}单价（如果在“系统参数”的“基础资料参数”中勾选了“商品价格为含税单价”，则price指示含税单价） material_entity.is_free是否赠品是否赠品；true-是，false-否（默认） material_entity.taxprice价税合计 material_entity.custom_field12kpbjiar9ijm5k物流单号{{l_id}} material_entity.custom_field12u80yx5t892z物流公司{{logistics_company}}

系统集成总览

数据集成中台设计中心Web界面以“拖拽”式交互设计，使用鼠标即可构建设计多异构系统数据集成流程，低代码平台大大降低流程设计者上手门槛。还有丰富的组件库快速满足复杂业务需求，结合不同模块即可生成不同业务流程，提升流程设计效率。平台支持多种高度灵活部署，高并发、高性能、高可用，可以通过多节点组成集群实现性能的横向扩展。适度集群配置其数据集成处理能力可达GB级/秒，为业务流提供更高数据吞吐量。平台已集成数据回压、优先级队列等能力，保障运行稳定性。完善的企业API运营管理机制帮助您构建“API生产者、API管理者、API消费者”三者结合的统一API数字化生态。支持市面上主流厂家软件如：金蝶、用友、SAP、泛微、蓝凌、旺店通、聚水潭、马帮、小满CRM等等。