金蝶云星空与聚水潭对接集成发货通知单查询连通订单上传(发货通知单对接聚水潭订单ok) 源系统:金蝶云星空金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。对接目标系统:聚水潭聚水潭SaaSERP于2014年4月上线，目前累计超过2.5万商家注册使用，成为淘宝应用服务市场ERP类目商家数和商家月订单增速最快的ERP。2014年及2015年“双十一”当天，聚水潭SaaSERP平稳、安全、顺畅的处理了近千万订单，超过了淘宝对ERP系统吞吐量极限要求的16倍，成为行业里的新标杆。截止目前，聚水潭客户已超2.5万家，其中有南极人、POVOS奔腾，恒源祥，柚子美衣，洁丽雅，FLYCO飞科，波司登，满速，欧丝璐等，并与知名电商圈“老A电商学院”达成深度合作。系统对接接口配置通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：金蝶云星空，并且选择对应的连接器（关于金蝶云星空的接口连接器如何配置可以在轻易云系统数据集成交流社区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如😛UR_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 12385719 so_id 线上订单号 string {{FBillNo}} order_date 订单日期 string {{FDate}} shop_status 订单 string WAIT_SELLER_SEND_GOODS shop_buyer_id 买家帐号长度 <= 50 string {{FSALEORGID_Fname}} receiver_state 收货省份 string function case '{{FStockID_Fnumber}}' when '11157199' then '{' when '12063360' then '}' when '11102627' then '@' when '11211411' then '%' when '11416129' then '&' when '11777702' then '￥' when '12248114' then '？' else '{{FStockID_F_XC_Text}}' end receiver_city 收货市 string _function case '{{FStockID_Fnumber}}' when '11157199' then '{' when '12063360' then '}' when '11102627' then '@' when '11211411' then '%' when '11416129' then '&' when '11777702' then '￥' when '12248114' then '？' else '{{FStockID_F_XC_Text}}' end receiver_district 收货区 string function case '{{FStockID_Fnumber}}' when '11157199' then '{' when '12063360' then '}' when '11102627' then '@' when '11211411' then '%' when '11416129' then '&' when '11777702' then '￥' when '12248114' then '？' else '{{FStockID_F_XC_Text}}' end receiver_address 收货地址 string {{F_XC_REMARKS}} receiver_name 收件人 string {{F_XC_TEXT}} receiver_phone 联系电话 string {{F_XC_TEXT1}} receiver_mobile 手机 string {{F_XC_TEXT1}} pay_amount 应付金额 string 0.1 freight 运费 string 0.1 buyer_message 买家留言 string remark 卖家备注 string {{FNote}} l_id 快递单号 string logistics_company 快递公司名称 string {{F_XC_ASSISTANT_FDATAVALUE}} lc_id 快递公司di string {{F_XC_ASSISTANT_Fnumber}} question_desc 订单异常描述 string buyer_tax_no 发票税号 string node 线下备注 string {{FSalesMan}} items 商品明细 array items items.remark 订单明细备注 string items.sku_id ERP内商品编码 string {{items.FMaterialID_Fnumber}} items.shop_sku_id 店铺商品编码 string {{items.FMaterialID_Fnumber}} items.i_id ERP内款号/货号 string items.pic 图片地址 string items.properties_value 商品属性；长度<=100 string items.base_price 原价，保留两位小数，单位（元） string {{items.FTAXPRICE}} items.qty 数量 string {{items.FQty}} items.refund_status PS string items.outer_oi_id 商家系统订单商品明细主键 string {{FID}}{{FEntity_FEntryID}} items.amount 金额 string _function {{items.FTAXPRICE}} * {{items.FQty}} items.name 名称 string {{FMaterialID_Fname}} items.pay shop_status object items.pay.amount 支付总额 string 0.1 items.pay.outer_pay_id 外部支付单号 string {{FBillNo}} items.pay.pay_date 支付日期 string {{FDate}} items.pay.payment 支付方式，最大20 string 微信 items.pay.seller_account 卖家支付账号 string 来自金蝶 items.pay.buyer_account 买家支付账号 string 来自金蝶系统对接总览随着企业数字化业务的深入发展，对于企业的 IT 或者 CIO 来讲，正在面临一个愈发重要的问题——系统的结构太复杂了，尤其是头部企业，至少有十多套系统，这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统，如何整合企业的现有IT资源，使企业中计算机孤岛式的应用向集体协作的方向发展，发挥资源效益的最大化，降低企业成本，正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上，操作统一，以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中，轻易云应用集成平台负责实现异构、分布式系统之间互联互通，实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件，连接现有各孤立应用系统，以图形化、拖拽方式构建集成流程和服务，提高应用系统集成工作效率，降低异构系统集成风险。针对未来可能出现的业务需求变更，在应用集成平台上进行动态调整，实现各应用系统之间的集成策略平滑升级。

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

庄颜_qeasy

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

源系统:金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

对接目标系统:聚水潭

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

系统对接接口配置

通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：金蝶云星空，并且选择对应的连接器（关于金蝶云星空的接口连接器如何配置可以在轻易云系统数据集成交流社区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如😛UR_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	12385719
so_id	线上订单号	string	{{FBillNo}}
order_date	订单日期	string	{{FDate}}
shop_status	订单	string	WAIT_SELLER_SEND_GOODS
shop_buyer_id	买家帐号长度 <= 50	string	{{FSALEORGID_Fname}}
receiver_state	收货省份	string	function case '{{FStockID_Fnumber}}' when '11157199' then '{' when '12063360' then '}' when '11102627' then '@' when '11211411' then '%' when '11416129' then '&' when '11777702' then '￥' when '12248114' then '？' else '{{FStockID_F_XC_Text}}' end
receiver_city	收货市	string	_function case '{{FStockID_Fnumber}}' when '11157199' then '{' when '12063360' then '}' when '11102627' then '@' when '11211411' then '%' when '11416129' then '&' when '11777702' then '￥' when '12248114' then '？' else '{{FStockID_F_XC_Text}}' end
receiver_district	收货区	string	function case '{{FStockID_Fnumber}}' when '11157199' then '{' when '12063360' then '}' when '11102627' then '@' when '11211411' then '%' when '11416129' then '&' when '11777702' then '￥' when '12248114' then '？' else '{{FStockID_F_XC_Text}}' end
receiver_address	收货地址	string	{{F_XC_REMARKS}}
receiver_name	收件人	string	{{F_XC_TEXT}}
receiver_phone	联系电话	string	{{F_XC_TEXT1}}
receiver_mobile	手机	string	{{F_XC_TEXT1}}
pay_amount	应付金额	string	0.1
freight	运费	string	0.1
buyer_message	买家留言	string
remark	卖家备注	string	{{FNote}}
l_id	快递单号	string
logistics_company	快递公司名称	string	{{F_XC_ASSISTANT_FDATAVALUE}}
lc_id	快递公司di	string	{{F_XC_ASSISTANT_Fnumber}}
question_desc	订单异常描述	string
buyer_tax_no	发票税号	string
node	线下备注	string	{{FSalesMan}}
items	商品明细	array	items
items.remark	订单明细备注	string
items.sku_id	ERP内商品编码	string	{{items.FMaterialID_Fnumber}}
items.shop_sku_id	店铺商品编码	string	{{items.FMaterialID_Fnumber}}
items.i_id	ERP内款号/货号	string
items.pic	图片地址	string
items.properties_value	商品属性；长度<=100	string
items.base_price	原价，保留两位小数，单位（元）	string	{{items.FTAXPRICE}}
items.qty	数量	string	{{items.FQty}}
items.refund_status	PS	string
items.outer_oi_id	商家系统订单商品明细主键	string	{{FID}}{{FEntity_FEntryID}}
items.amount	金额	string	_function {{items.FTAXPRICE}} * {{items.FQty}}
items.name	名称	string	{{FMaterialID_Fname}}
items.pay	shop_status	object
items.pay.amount	支付总额	string	0.1
items.pay.outer_pay_id	外部支付单号	string	{{FBillNo}}
items.pay.pay_date	支付日期	string	{{FDate}}
items.pay.payment	支付方式，最大20	string	微信
items.pay.seller_account	卖家支付账号	string	来自金蝶
items.pay.buyer_account	买家支付账号	string	来自金蝶

系统对接总览

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