从聚水潭到金蝶云星辰V1通过接口配置打通数据

对接系统聚水潭

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

集成系统:金蝶云星辰V1

金蝶云·星辰聚焦小微企业在线经营和数字化管理，以“新生产、新零售、新商贸、新财税、新生态”五大特性赋能企业，以财税智能化、门店数字化、供应链流程化、业财税一体化、订货在线化、营销社交化、需求个性化、决策实时化、办公移动化等九大价值赋能企业，助力企业实现数字化、智能化转型升级。

系统对接接口配置

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

聚水潭接口明细

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

请求参数

字段名称类型描述 shop_id店铺string店铺编号 is_offline_shop线下店铺stringshop_id为0且is_offline_shop为true查询线下店铺单据 so_ids单号string线上单号，最大限制20条 modified_begin起始时间string修改起始时间，和结束时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空 modified_end结束时间string修改结束时间，和起始时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空 status状态string待付款：WaitPay；发货中：Delivering；被合并：Merged；异常：Question；被拆分：Split；等供销商外仓发货：WaitOuterSent；已付款待审核：WaitConfirm；已客审待财审：WaitFConfirm；已发货：Sent；取消：Cancelled page_index第几页string第几页，从1开始 page_size每页条数string最每页多少条，最大50条

响应参数

字段名称类型描述 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线上订单号string 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接口明细

调用接口：jdy/sal/sal_order_save
接口名称：新增或者修改一张销售订单
方法：POST

请求参数

字段字段名称类型配置值 billdate单据日期,格式：2019-01-01date{{order_date}} billno单据编号string{{so_id}} customerid_id客户信息stringfindCollection find id from cf6895b4-1a77-312f-aaa5-abe33be737a9 where number={{shop_id}} material_entity商品分录arraynew_bomentity material_entity.materialid_id商品string_findCollection find id from 673a1464-d665-376c-8f2d-58d9cbe67249 where number={{new_bomentity.materialid_number}} material_entity.stockid_id仓库string1404426243096477699 material_entity.qty数量string{{new_bomentity.count}} material_entity.unit_id单位string material_entity.taxprice单价string{{new_bomentity.new_amount}} material_entity.is_free是否赠品string material_entity.taxprice价税合计string material_entity.custom_field12kpbjiar9ijm5k物流单号string{{l_id}} material_entity.custom_field12u80yx5t892z物流公司string{{logistics_company}}

系统集成总览

采集并引入全业务、多终端、多形态的数据，经过处理以及对应平台接口的数据结构适配，形成以业务核心为对象为中心的连接和标签体系。配合企业根据自身的实际情况以及业务需求完成方案的规划、部署与实施，将沉淀的业务数据进入到平台进行体系化的加工，再以服务化的方式支持业务平台上的应用。达成高效支持业务敏捷创新的高质量和标准化的数据服务组合。

从聚水潭到金蝶云星辰V1通过接口配置打通数据