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

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

接通系统：聚水潭·奇门

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

接入系统：金蝶云星辰V1

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

配置集成方案

数据集成平台对应的配置聚水潭·奇门与金蝶云星辰V1的对接只要三步就能完成两个系统之间的数据对接。第一步根据聚水潭·奇门的接口参数要求记录在轻易云集成平台。第二步配置聚水潭·奇门与金蝶云星辰V1之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。

聚水潭·奇门接口明细

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

请求参数

字段	名称	类型	描述
shop_id	店铺	string	店铺编号
is_offline_shop	线下店铺	string	shop_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_id	ERP 内部订单号，唯一	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	支付单ID	string
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_id	string
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-01	date	{{order_date}}
billno	单据编号	string	{{so_id}}
customerid_id	客户信息	string	findCollection find id from cf6895b4-1a77-312f-aaa5-abe33be737a9 where number={{shop_id}}
material_entity	商品分录	array	details
material_entity.materialid_id	商品	string	_findCollection find id from 673a1464-d665-376c-8f2d-58d9cbe67249 where number={{details.new_bomentity_materialid_number}}
material_entity.stockid_id	仓库	string	1404426243096477699
material_entity.qty	数量	string	{{details.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}}

系统数据集成价值

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