从金蝶云星空到聚水潭通过接口集成数据
接入系统：金蝶云星空
金蝶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_FEntryID | FEntity_FEntryID | FEntity_FEntryID | |
| FID | FID | FID | |
| 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 | 业务对象表单Id | SAL_DELIVERYNOTICE | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| FEntity_FEntryID | FEntity_FEntryID | | |
| FID | FID | FID | |
| 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 | 买家帐号 长度 <= 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 |
系统数据对接
将传统的统计分析转变为预测分析，从被动分析到主动分析，从非实时分析转变为实时分析，从结构化的数据变成多元化的数据。精准查询数据流同步状况，实时监管队列任务以及数据资产的有序管理。为业务赋能，降本增效，让企业能够更加合理的布局团队；结合业务需求实现与OA，CRM，WMS等系统之间的数据交流与同步，为企业定制自定义的数据管理方案，用技术拓展商业边界，为新业务、新部门提供成长空间。
