从金蝶云星空到旺店通·企业版通过接口配置打通数据

数据源系统:金蝶云星空

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

目标系统:旺店通·企业版

旺店通是北京掌上先机网络科技有限公司旗下品牌，国内的零售云服务提供商，基于云计算SaaS服务模式，以体系化解决方案，助力零售企业数字化智能化管理升级。为零售电商企业的订单管理及仓储管理提供解决方案，致力于帮助企业实现数字化转型，企业规模化发展

数据接口配置

在轻易云平台进行集成方案的配置时，为了实现快速搭建，轻易云平台还提供了现有的市场方案进行复制参考。用户可以在创建集成方案的时候在第四步选择引用市场方案，参考市场主流所进行的字段配置完成集成方案的自定义化快速配置，即便是第一次使用轻易云平台的用户也能轻松搭建属于自己的数据同步方案。向导式配置，让配置更加清晰，首先确定该方方案的对接内容，第二歩获取筛选数据源平台的数据，第三步数据源与写入目标形成映射关系配置。完成配置后一键启用

金蝶云星空接口明细

调用接口：executeBillQuery
接口名称：销售出库单查询
方法：POST

请求参数

字段字段名称类型配置值 FBillTypeID_FNumber单据类型stringFBillTypeID.FNumber FBillNo单据编号stringFBillNo FDate日期stringFDate FSaleOrgId_FNumber销售组织stringFSaleOrgId.FNumber FCustomerID_FNumber客户stringFCustomerID.FNumber FCarriageNO运输单号stringFCarriageNO FStockOrgId_FNumber发货组织stringFStockOrgId.FNumber FLinkPhone联系电话stringFLinkPhone FLinkMan收货人姓名stringFLinkMan FReceiveAddress收货方地址stringFReceiveAddress FSettleTypeID_FNumber结算方式stringFSettleTypeID.FNumber FReceiverAddress收货人地址stringFReceiverAddress FReceiverMobile收货人手机stringFReceiverMobile FReceiverCountry收货人国家stringFReceiverCountry FReceiverState收货人省份stringFReceiverState FReceiverCity收货人城市stringFReceiverCity FReceiverDistrict收货人地区stringFReceiverDistrict FReceiverPhone收货人电话stringFReceiverPhone FSHOPNUMBER网店编码stringFSHOPNUMBER FSALECHANNEL销售渠道stringFSALECHANNEL FVIPCODE会员编码stringFVIPCODE FCustMatID_FNumber客户物料编码stringFCustMatID.FNumber FMaterialID_FNumber物料编码stringFMaterialID.FNumber FBarcode零售条形码stringFBarcode FMustQty应发数量stringFMustQty FRealQty实发数量stringFRealQty FPrice单价stringFPrice FTaxPrice含税单价stringFTaxPrice FIsFree是否赠品stringFIsFree FLot批号stringFLot FProduceDate生产日期stringFProduceDate FExpiryDate有效期至stringFExpiryDate FEntryTaxRate税率%stringFEntryTaxRate FEntryTaxAmount税额stringFEntryTaxAmount FAmount金额stringFAmount FAllAmount价税合计stringFAllAmount FStockID_FNumber仓库stringFStockID.FNumber FStockStatusID_FNumber库存状态stringFStockStatusID.FNumber FMtoNo计划跟踪号stringFMtoNo FEntrynote备注stringFEntrynote FSrcType源单类型stringFSrcType FSrcBillNo源单编号stringFSrcBillNo FSoorDerno订单单号stringFSoorDerno FDiscountRate折扣率%stringFDiscountRate FDiscount折扣额stringFDiscount FPriceDiscount单价折扣stringFPriceDiscount FSOEntryId销售订单EntryIdstringFSOEntryId FB2CORDERDETAILIDB2C订单明细IdstringFB2CORDERDETAILID FThirdEntryId管易订单单号stringFThirdEntryId FETHIRDBILLID第三方单据IDstringFETHIRDBILLID FETHIRDBILLNO第三方单据编号stringFETHIRDBILLNO FGYFINDate管易到账时间stringFGYFINDate Limit最大行数string{{PAGINATION_PAGE_SIZE}} StartRow开始行索引string{{PAGINATION_START_ROW}} TopRowCount返回总行数int FilterString过滤条件stringFApproveDate>='{{LAST_SYNC_TIME dateTime}}' and FSaleOrgId.FNumber ='100' FieldKeys需查询的字段key集合array FormId业务对象表单IdstringSAL_OUTSTOCK

响应参数

旺店通·企业版接口明细

接口：trade_push
接口名称：原始订单新增
接口方法：POST

请求参数

字段名称类型描述 tid原始单号string指商城、官网等平台的订单编号，ERP称之为原始单号，同一个sid下通过本接口新增订单的tid保证唯一。 trade_status平台状态string平台订单状态较多且涉及变更，详情介绍单击这里 pay_status支付状态string平台订单付款状态:0:未付款,1:部分付款,2:已付款 delivery_term发货条件string1:款到发货,2:货到付款(包含部分货到付款),3:分期付款,4:挂账 trade_time下单时间string平台订单创建时间,时间格式：yyyy-MM-dd HH:mm:ss pay_time支付时间string平台订单付款时间,时间格式：yyyy-MM-dd HH:mm:ss，未付款订单为:0000-00-00 00:00:00 fenxiao_type分销类别string0非分销订单 1转供销 2代销 3经销 purchase_id采购单IDstring转供销情况下，采购单ID fenxiao_nick分销商idstring分销订单的分销商id,或转供销时供应商id buyer_nick客户网名string平台买家昵称，注意：一次推送网名相同的订单不能超过30 buyer_email买家emailstring买家email pay_id支付单号string支付单号 pay_account支付账号string支付账号 receiver_name收件人string收件人姓名 receiver_address地址详情string收件人地址详情 receiver_province省份string收件人省份 receiver_city城市string收件人城市 receiver_district区县string收件人区县 receiver_mobile手机string手机号码 receiver_telno电话string电话号码 receiver_zip邮编string收件人邮编 logistics_type物流方式string不传本参数，输入值默认-1，表示由ERP系统策略选择。平台指定订单发货物流可选输入值单击这里 invoice_kind发票类别string0:不需要,1:普通发票,2:增值税普通发票电子,3:增值税普通发票纸质,4:增值税专用发票 invoice_title发票抬头string发票抬头 invoice_content发票内容string常见内容：纳税人识别号、地址、电话、开户银行、银行账户，按照以下格式推送，系统开发票时可解析。 remark_flag客户备注标旗string客户备注标旗，取值0至5对应的标旗颜色依次为灰（无标旗）、红、黄、绿、蓝、紫，不传默认0 buyer_message买家备注string买家下单时填写的订单备注 seller_memo客服备注string商家客服对订单进行的备注内容 seller_flag标旗string客服标旗，取值0至5对应的标旗颜色依次为灰（无标旗）、红、黄、绿、蓝、紫，不传默认0 post_amount邮费string商家收取买家的物流或者快递费用 cod_amount货到付款金额string货到付款金额 ext_cod_fee货到付款买家费用string货到付款买家费用，扣除货到付款订单金额后，卖家仍需支付的货到付款其他金额。这个钱卖家收不回来，是快递公司直接收走，但在快递单里是要打印出来，否则快递收款就错了 other_amount其它收费string其它应从买家收取的服务费，其他费用 paid已付string订单已付金额，paid计算公式：paid = Σ(price * num + adjust_amount -discount – share_discount）+ post_amount+other_amount，所有金额相关字段推送处理办法，单击这里 is_auto_wms自动流转模式string是否为自动流转模式（1：是 0：不是不传默认0），非自动流转模式一定不要传值。自动流转模式处理办法，”自动流转模式处理办法详解”)单击这里 warehouse_no仓库编号stringERP内自定义的仓库编号，查看路径ERP→设置→基本设置→仓库→仓库列表，测试环境仓库编号查看测试环境分配邮件。平台订单需指定ERP内仓库时，传哪个仓库的编号，ERP将为订单选择哪个仓库。 order_list订单货品明细节点array货品明细列表（子订单列表）节点 order_list.oid子订单编号string平台订单货品表主键,子订单唯一标识,同一个sid下通过本接口新增订单的oid（子订单编号）要保证唯一；如果oid重复,ERP生成系统单（递交）时会提示“订单货品数量不一致xxxxxx” order_list.num数量string货品数量，订单推送成功以后本字段值不能更改 order_list.price单价string标价,折扣前的价格,可以推送价格为0的商品。订单推送成功以后本字段值不能更改 order_list.status状态string平台子订单状态，子订单状态可以和主订单不一样，比如其中一个子订单退款完成，其状态是80，但主订单仍然是待发货，可选值同trade_status order_list.refund_status退款状态string0:无退款,1:取消退款,2:已申请退款,3:等待退货,4:等待收货,5:退款成功。本字段在售前退款的时候，根据不同的场景填写不同的值，eg：申请退款值为2，取消退款值为1…… order_list.goods_id平台货品IDstring平台系统货品（SPU）的唯一标识。goods_id不能为空，SPU和SKU概念介绍，单击这里 order_list.spec_id平台规格IDstring平台系统单品（SKU）的的唯一标识，尽量不为空，SPU和SKU概念介绍，单击这里 order_list.goods_no货品编码string平台货品SPU编码，对应ERP货品编号，尽量不为空 order_list.spec_no规格编码string平台货品SKU唯一码，对应ERP商家编码，goods_no和spec_no不能同时为空 order_list.goods_name货品名称string平台货品名称 order_list.spec_name规格名称string平台货品规格名称 order_list.adjust_amount调整string客服调整总金额(大于0加价，小于0减价，是折扣来源的一部分,没有传0) order_list.discount优惠string下单总折扣，客户下单时折扣(比如促销打折，不包含客服调整、分摊折扣，没有传0) order_list.share_discount分摊优惠string分摊总折扣，由总订单分摊而来，一般是付款时产生，如使用优惠券，没有传0。分摊优惠传值注意：例如三个商品，优惠10，分摊优惠可以是：3/3/4，或者3.33/3.33/3.34.即最后一个商品的分摊优惠使用减法计算 order_list.remark备注string货品明细备注推送此字段ERP客户端需升级至V2.3.9.2及以上 order_list.cid类目string平台货品所属类目 order_list.trade_listtrade_liststring0:非严格模式,1:严格模式,默认1。 order_list.shop_noshop_nostring order_list.switchswitchstring

数据对接效果

通过数据集成平台可视化的快速配置调用接口打通金蝶云星空与旺店通·企业版之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。

从金蝶云星空到旺店通·企业版通过接口配置打通数据