金蝶云星空对接打通聚水潭发货通知单查询接口与订单上传接口|轻易云数据集成平台

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

对接系统金蝶云星空

金蝶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如: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

系统集成总览

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