聚水潭和金蝶云星辰V1集成接口设计

接通系统：聚水潭

聚水潭是SaaS协同平台、电商ERP软件。聚水潭成立于2014年，创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初，以电商SaaSERP切入市场，凭借出色的产品和服务，快速获得市场的肯定。

对接目标平台:金蝶云星辰V1

金蝶云·星辰基于金蝶云·苍穹云原生PaaS平台构建，聚焦小型企业在线经营和数字化管理，提供财务云、税务云、进销存云、零售云、订货商城等SaaS服务，支持企业拓客开源、智能管理、实时决策；金蝶云·星辰还提供轻量级PaaS平台和全面的API接口，广泛连接生态伙伴，为小微企业提供一站式服务，助力企业快速成长

系统对接接口配置

轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线，所以对接方案的配置极其重要，方案可以选择一键复制，轻易云有海量的对接方案可支持一键复制，复制后直接启动使用（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置，配置只要确认源平台：聚水潭的取数逻辑，例如什么时间取什么样的数据。即可完成配置，目标平台：金蝶云星辰V1，把获取的数据组装成目标系统需要的格式进行写入。数据管道ETL：构建一体化的数据融合平台。高级数据转换：支持公式转换数据格式、支持脚本直接进行数据转换、支持可视化多维度数据处理。高性能实时处理：针对不同数据节点类型提供TB级吞吐量，秒级延迟的增量数据处理能力。自动将旧版web服务转变为基于云端微服务的API，统一接口输出标准。支持接口开放服务，实现内外部能力接入。

聚水潭接口明细

调用接口：/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接口明细

调用接口：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集成接口设计