金蝶云星空对接打通聚水潭发货通知单查询接口与订单上传接口对接系统金蝶云星空金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。目标系统:聚水潭聚水潭是SaaS协同平台、电商ERP软件。聚水潭成立于2014年，创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初，以电商SaaSERP切入市场，凭借出色的产品和服务，快速获得市场的肯定。多系统对接方案配置通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：金蝶云星空，然后选择对应的连接器。选择对应的executeBillQuery作为数据对接来源。然后再写入目标平台配置目标系统为聚水潭，并且选择对应连接器（关于聚水潭的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的jushuitan.orders.upload接口作为数据写入动作完成第一步的接口配置。金蝶云星空接口明细接口： 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 店铺编号 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 数据对接价值全新的API数据集成模式，赋能企业业务创新传统企业集成主要采用点对点或ESB集成方式，基于全新API战略中台的API新型集成方式通过解耦系统资源，降低系统间对接难度，实现快速业务需求响应，提升对接效率，助力企业满足快速业务交付需求，实现业务创新。通过构建API生态，助力能力开放与共享基于API战略中台梳理并整合内部API资源与IT资产，可实现内部资源共享，满足内部开发人员资源使用需求，例如：聚水潭与金蝶云星空之间数据集成；并将API资源对外可控开放，打造面向开发者的生态服务，为您打通自身和上下游合作伙伴，创造共赢价值链。开展API战略中台，重塑IT 帮助您基于内部资源构建不同业务能力中心，打造企业统一API战略中台，赋能企业发展，实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时，无需从“零”组建各业务模块，提升开发效率，重塑IT组织及交付能力。

金蝶云星空对接打通聚水潭发货通知单查询接口与订单上传接口

关一帆qeasy

金蝶云星空对接打通聚水潭发货通知单查询接口与订单上传接口

对接系统金蝶云星空

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

目标系统:聚水潭

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

多系统对接方案配置

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

金蝶云星空接口明细

接口：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	店铺编号
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

数据对接价值

全新的API数据集成模式，赋能企业业务创新传统企业集成主要采用点对点或ESB集成方式，基于全新API战略中台的API新型集成方式通过解耦系统资源，降低系统间对接难度，实现快速业务需求响应，提升对接效率，助力企业满足快速业务交付需求，实现业务创新。通过构建API生态，助力能力开放与共享基于API战略中台梳理并整合内部API资源与IT资产，可实现内部资源共享，满足内部开发人员资源使用需求，例如：聚水潭与金蝶云星空之间数据集成；并将API资源对外可控开放，打造面向开发者的生态服务，为您打通自身和上下游合作伙伴，创造共赢价值链。开展API战略中台，重塑IT 帮助您基于内部资源构建不同业务能力中心，打造企业统一API战略中台，赋能企业发展，实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时，无需从“零”组建各业务模块，提升开发效率，重塑IT组织及交付能力。