系统数据集成方案

金蝶云星空与聚水潭对接集成发货通知单查询连通订单上传(发货通知单对接聚水潭订单ok)

接通系统：金蝶云星空

集成系统:聚水潭

接口方案配置

通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：金蝶云星空，并且选择对应的连接器（关于金蝶云星空的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的发货通知单查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为聚水潭，并且选择对应连接器。选择对应的订单上传接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。

金蝶云星空接口明细

• 接口：executeBillQuery
• 接口名称：发货通知单查询
• 接口方法：POST

请求参数

字段	名称	类型	描述
FEntity_FEntryID	FEntity_FEntryID	string
FID	FID	string
FORDERNO	销售订单号	string
FBillNo	单据编号	string
FDate	日期	string
FCustomerID_Fnumber	客户	string
F_XC_ASSISTANT_Fnumber	快递公司编码	string
F_XC_ASSISTANT_FDATAVALUE	快递公司名称	string
F_XC_TEXT	联系人	string
F_XC_TEXT1	联系电话	string
FSALEORGID_Fname	销售组织	string
FSALEORGID_Fnumber	销售组织编码	string
F_XC_REMARKS	送货地址	string
FMaterialID_Fnumber	物料编码	string
FMaterialID_Fname	物料	string
FQty	销售数量	string
FTAXPRICE	含税单价	string
FStockID_Fnumber	仓库编码	string
FNote	备注	string
FSalesManID	销售员	string
FSalesMan	销售员名称	string
F_XC_Base	跟单员	string
F_XC_Base1	运营员	string
FStockID_F_XC_Text	仓库对应省市区	string
Limit	最大行数	string	金蝶的查询分页参数
StartRow	开始行索引	string	金蝶的查询分页参数
TopRowCount	返回总行数	int	金蝶的查询分页参数
FilterString	过滤条件	string	示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>=
FieldKeys	需查询的字段key集合	array	金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber
FormId	业务对象表单Id	string	必须填写金蝶的表单ID如:PUR_PurchaseOrder

响应参数

字段	名称	类型	描述
FEntity_FEntryID	FEntity_FEntryID	string
FID	FID	string
FORDERNO	订单单号	string
FBillNo	单据编号	string
FDate	日期	string
FCustomerID_Fnumber	客户	string
F_XC_ASSISTANT_Fnumber	快递公司	string
F_XC_ASSISTANT_FDATAVALUE	快递公司名称	string
F_XC_TEXT	联系人	string
F_XC_TEXT1	联系电话	string
FSALEORGID_Fname	销售组织	string
FSALEORGID_Fnumber	销售组织编码	string
F_XC_REMARKS	送货地址	string
FMaterialID_Fnumber	物料编码	string
FMaterialID_Fname	物料	string
FQty	销售数量	string
FTAXPRICE	含税单价	string
FStockID_Fnumber	仓库编码	string
FNote	单据体备注	string
FSalesManID	销售员	string
FSalesMan	销售员名称	string
F_XC_Base	跟单员	string
F_XC_Base1	运营员	string
FStockID_F_XC_Text	仓库对应省市区	string

聚水潭接口明细

• 接口：jushuitan.orders.upload
• 接口名称：订单上传
• 接口方法：POST

请求参数

字段	名称	类型	描述
shop_id	店铺编号	string	店铺编号
so_id	线上订单号	string	线上订单号, 长度 <= 50
order_date	订单日期	string	订单日期
shop_status	订单	string	订单： 等待买家付款=WAIT_BUYER_PAY， 等待卖家发货=WAIT_SELLER_SEND_GOODS,等待买家确认收货=WAIT_BUYER_CONFIRM_GOODS, 交易成功=TRADE_FINISHED, 付款后交易关闭=TRADE_CLOSED,付款前交易关闭=TRADE_CLOSED_BY_TAOBAO；发货前可更新
shop_buyer_id	买家帐号 长度 <= 50	string	买家帐号 长度 <= 50
receiver_state	收货省份	string	收货省份 长度 <= 50；发货前可更新
receiver_city	收货市	string	收货市 长度<=50；发货前可更新
receiver_district	收货区	string	收货区 长度<=50；发货前可更新
receiver_address	收货地址	string	收货地址 长度<=200；发货前可更新
receiver_name	收件人	string	收件人 长度<=50；发货前可更新
receiver_phone	联系电话	string	联系电话 长度<=50；发货前可更新
receiver_mobile	手机	string	手机 长度<=50；发货前可更新
pay_amount	应付金额	string	应付金额，保留两位小数，单位元）
freight	运费	string	运费
buyer_message	买家留言	string	买家留言 长度<=400；可更新
remark	卖家备注	string	买家留言 长度<=400；可更新
l_id	快递单号	string	快递单号
logistics_company	快递公司名称	string	快递公司名称
lc_id	快递公司di	string	快递公司名称
question_desc	订单异常描述	string	订单异常描述
buyer_tax_no	发票税号	string	发票税号
node	线下备注	string	线下备注
items	商品明细	array	商品明细
items.remark	订单明细备注	string	订单明细备注
items.sku_id	ERP内商品编码	string	ERP内商品编码 长度 <=40 PS: 设置预售标识订单，修改商品编码=商品编码+预售（或==）+预计交货日期（可选） 比如: "A321232" 修改为 "A321232预售2015-12-12" 或者 "A321232" 修改为 "A321232==2015-12-12" 当商品被购买后ERP将自动识别为预售订单并更正商品编码为正确商品编码
items.shop_sku_id	店铺商品编码	string	店铺商品编码 长度<=128
items.i_id	ERP内款号/货号	string	ERP内款号/货号 长度<=40
items.pic	图片地址	string	图片地址 长度<=300
items.properties_value	商品属性；长度<=100	string	商品属性；长度<=100
items.base_price	原价，保留两位小数，单位（元）	string	原价，保留两位小数，单位（元）
items.qty	数量	string	数量
items.refund_status	PS	string	PS：值存在，会自动将订单转异常,success 状态的，发货将不发该商品，不支持单商品发部分; 退款状态:可选 退款中=waiting; 退款成功=success,closed=退款关闭:发货前可更新
items.outer_oi_id	商家系统订单商品明细主键	string	商家系统订单商品明细主键,为了拆单合单时溯源，最长不超过 50,保持唯一
items.amount	金额	string
items.name	名称	string
items.pay	shop_status	object	shop_status=WAIT_BUYER_PAY 的时候可不给
items.pay.amount	支付总额	string	支付总额
items.pay.outer_pay_id	外部支付单号	string	外部支付单号，最大50
items.pay.pay_date	支付日期	string	支付日期
items.pay.payment	支付方式，最大20	string	支付方式，最大20
items.pay.seller_account	卖家支付账号	string	卖家支付账号，最大 50
items.pay.buyer_account	买家支付账号	string	买家支付账号，最大 200

系统集成总览

随着企业数字化业务的深入发展，对于企业的 IT 或者 CIO 来讲，正在面临一个愈发重要的问题——系统的结构太复杂了，尤其是头部企业，至少有十多套系统，这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统，如何整合企业的现有IT资源，使企业中计算机孤岛式的应用向集体协作的方向发展，发挥资源效益的最大化，降低企业成本，正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上，操作统一，以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中，轻易云应用集成平台负责实现异构、分布式系统之间互联互通，实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件，连接现有各孤立应用系统，以图形化、拖拽方式构建集成流程和服务，提高应用系统集成工作效率，降低异构系统集成风险。针对未来可能出现的业务需求变更，在应用集成平台上进行动态调整，实现各应用系统之间的集成策略平滑升级。

系统数据对接方案元数据代码