从金蝶云星空到聚水潭通过接口集成数据

从金蝶云星空到聚水潭通过接口集成数据

接入系统：金蝶云星空

金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。

对接目标系统:聚水潭

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

数据接口配置方案

通过轻易云系统数据集成平台新增创建集成方案，通过轻易云的方案市场可以一键复制，并且可以借鉴其他的方案配置完成方案制作，方案制作只需要两步，第一步先确定好对应的数据来源；源系统：金蝶云星空接口：发货通知单查询通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统：聚水潭接口：订单上传，通过写入调度者匹配获取到的数据和写入的映射关系，即可自动生成符合目标系统：聚水潭写入的数据自动产生写入队列，通过运行概况，系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况

金蝶云星空接口明细

• API：executeBillQuery
• NAME：发货通知单查询
• METHOD：POST

请求参数

接口字段字段名称预设值描述 FEntity_FEntryIDFEntity_FEntryIDFEntity_FEntryID FIDFIDFID FORDERNO销售订单号FORDERNO FBillNo单据编号FBillNo FDate日期FDate FCustomerID_Fnumber客户FCustomerID.Fnumber F_XC_ASSISTANT_Fnumber快递公司编码F_XC_ASSISTANT.Fnumber F_XC_ASSISTANT_FDATAVALUE快递公司名称F_XC_ASSISTANT.FDATAVALUE F_XC_TEXT联系人F_XC_TEXT F_XC_TEXT1联系电话F_XC_TEXT1 FSALEORGID_Fname销售组织FSALEORGID.Fname FSALEORGID_Fnumber销售组织编码FSALEORGID.Fnumber F_XC_REMARKS送货地址F_XC_REMARKS FMaterialID_Fnumber物料编码FMaterialID.Fnumber FMaterialID_Fname物料FMaterialID.Fname FQty销售数量FQty FTAXPRICE含税单价FTAXPRICE FStockID_Fnumber仓库编码FStockID.Fnumber FNote备注FNote FSalesManID销售员FSalesManID.FNumber FSalesMan销售员名称FSalesManID.FName F_XC_Base跟单员F_XC_Base.FSTAFFNUMBER F_XC_Base1运营员F_XC_Base1.FSTAFFNUMBER FStockID_F_XC_Text仓库对应省市区FStockID.F_XC_Text Limit最大行数{{PAGINATION_PAGE_SIZE}}金蝶的查询分页参数 StartRow开始行索引{{PAGINATION_START_ROW}}金蝶的查询分页参数 TopRowCount返回总行数金蝶的查询分页参数 FilterString过滤条件FApproveDate>='{{LAST_SYNC_TIME dateTime}}'示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= FieldKeys需查询的字段key集合金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber FormId业务对象表单IdSAL_DELIVERYNOTICE必须填写金蝶的表单ID如😛UR_PurchaseOrder

响应参数

接口字段字段名称预设值描述 FEntity_FEntryIDFEntity_FEntryID FIDFIDFID FORDERNO订单单号FORDERNO FBillNo单据编号 FDate日期 FCustomerID_Fnumber客户 F_XC_ASSISTANT_Fnumber快递公司 F_XC_ASSISTANT_FDATAVALUE快递公司名称 F_XC_TEXT联系人 F_XC_TEXT1联系电话 FSALEORGID_Fname销售组织 FSALEORGID_Fnumber销售组织编码 F_XC_REMARKS送货地址 FMaterialID_Fnumber物料编码 FMaterialID_Fname物料FMaterialID.Fname FQty销售数量 FTAXPRICE含税单价 FStockID_Fnumber仓库编码 FNote单据体备注 FSalesManID销售员FSalesManID.FNumber FSalesMan销售员名称FSalesManID.FName F_XC_Base跟单员F_XC_Base.FSTAFFNUMBER F_XC_Base1运营员F_XC_Base1.FSTAFFNUMBER FStockID_F_XC_Text仓库对应省市区FStockID.F_XC_Text

聚水潭接口明细

• 接口：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买家帐号 长度 <= 50string买家帐号 长度 <= 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快递公司distring快递公司名称 question_desc订单异常描述string订单异常描述 buyer_tax_no发票税号string发票税号 node线下备注string线下备注 items商品明细array商品明细 items.remark订单明细备注string订单明细备注 items.sku_idERP内商品编码stringERP内商品编码 长度 <=40 PS: 设置预售标识订单，修改商品编码=商品编码+预售（或==）+预计交货日期（可选） 比如: "A321232" 修改为 "A321232预售2015-12-12" 或者 "A321232" 修改为 "A321232==2015-12-12" 当商品被购买后ERP将自动识别为预售订单并更正商品编码为正确商品编码 items.shop_sku_id店铺商品编码string店铺商品编码 长度<=128 items.i_idERP内款号/货号stringERP内款号/货号 长度<=40 items.pic图片地址string图片地址 长度<=300 items.properties_value商品属性；长度<=100string商品属性；长度<=100 items.base_price原价，保留两位小数，单位（元）string原价，保留两位小数，单位（元） items.qty数量string数量 items.refund_statusPSstringPS：值存在，会自动将订单转异常,success 状态的，发货将不发该商品，不支持单商品发部分; 退款状态:可选 退款中=waiting; 退款成功=success,closed=退款关闭:发货前可更新 items.outer_oi_id商家系统订单商品明细主键string商家系统订单商品明细主键,为了拆单合单时溯源，最长不超过 50,保持唯一 items.amount金额string items.name名称string items.payshop_statusobjectshop_status=WAIT_BUYER_PAY 的时候可不给 items.pay.amount支付总额string支付总额 items.pay.outer_pay_id外部支付单号string外部支付单号，最大50 items.pay.pay_date支付日期string支付日期 items.pay.payment支付方式，最大20string支付方式，最大20 items.pay.seller_account卖家支付账号string卖家支付账号，最大 50 items.pay.buyer_account买家支付账号string买家支付账号，最大 200

系统数据对接

将传统的统计分析转变为预测分析，从被动分析到主动分析，从非实时分析转变为实时分析，从结构化的数据变成多元化的数据。精准查询数据流同步状况，实时监管队列任务以及数据资产的有序管理。为业务赋能，降本增效，让企业能够更加合理的布局团队；结合业务需求实现与OA，CRM，WMS等系统之间的数据交流与同步，为企业定制自定义的数据管理方案，用技术拓展商业边界，为新业务、新部门提供成长空间。