金蝶云星空和旺店通·企业奇门接口打通对接实战

金蝶云星空和旺店通·企业奇门接口打通对接实战

对接系统：金蝶云星空

金蝶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}}' FieldKeys需查询的字段key集合array FormId业务对象表单IdstringSAL_OUTSTOCK

响应参数

字段字段名称类型配置值 FBillTypeID_FNumber单据类型string FBillNo单据编号string FDate日期string FSaleOrgId_FNumber销售组织string FCustomerID_FNumber客户string FBranchId_FNumber销售门店string FSaleDeptID_FNumber销售部门string FHeadLocationId_FNumber交货地点string FCorrespondOrgId_FNumber对应组织string FCarrierID_FNumber承运商string FCarriageNO运输单号string FSalesGroupID_FNumber销售组string FSalesManID_FNumber销售员string FThirdBillNo第三方单据编号string FStockOrgId_FNumber发货组织string FDeliveryDeptID_FNumber发货部门string FThirdBillId第三方单据平台单号string FLinkPhone联系电话string FLinkMan收货人姓名string FThirdSrcType第三方系统来源string FStockerID_FNumber仓管员string FBussinessType业务类型string FDocumentStatus单据状态string FNote备注string FReceiverID_FNumber收货方string FReceiveAddress收货方地址string FSettleID_FNumber结算方string FReceiverContactID_FNumber收货方联系人string FPayerID_FNumber付款方string FSettleOrgID_FNumber结算组织string FSettleTypeID_FNumber结算方式string FReceiptConditionID_FNumber收款条件string FOwnerIdHead_FNumber货主string FBuyerNick会员名称string FReceiverAddress收货人地址string FReceiverName收货人string FReceiverMobile收货人手机string FReceiverCountry收货人国家string FReceiverState收货人省份string FReceiverCity收货人城市string FReceiverDistrict收货人地区string FReceiverPhone收货人电话string FSHOPNUMBER网店编码string FSALECHANNEL销售渠道string FVIPCODE会员编码string FCustMatID_FNumber客户物料编码string FMaterialID_FNumber物料编码string FBarcode零售条形码string FMustQty应发数量string FRealQty实发数量string FPrice单价string FTaxPrice含税单价string FIsFree是否赠品string FLot批号string FProduceDate生产日期string FExpiryDate有效期至string FEntryTaxRate税率%string FEntryTaxAmount税额string FAmount金额string FAllAmount价税合计string FStockID_FNumber仓库string FStockStatusID_FNumber库存状态string FMtoNo计划跟踪号string FEntrynote备注string FSrcType源单类型string FSrcBillNo源单编号string FSoorDerno订单单号string FDiscountRate折扣率%string FDiscount折扣额string FPriceDiscount单价折扣string FSOEntryId销售订单EntryIdstring FB2CORDERDETAILIDB2C订单明细Idstring FThirdEntryId管易订单单号string FETHIRDBILLID第三方单据IDstring FETHIRDBILLNO第三方单据编号string FGYFINDate管易到账时间string FReceiverName收货人string

旺店通·企业奇门接口明细

• API：wdt.trade.push
• NAME：创建原始订单
• METHOD：POST

请求参数

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

系统打通概况

大部分的企业都可能只用一套系统组织架构复杂，业务流程繁琐，内部同时有OA系统、BI系统、ERP系统......且各个系统都需要独立登陆，造成IT部门数据监管困难！如何在同一套中台系统上关联多管理系统呢？系统集成平台，就可以无缝集成各个业务系统，主数不统一、交易数据来回导出导入、业务融合等问题。通过轻易云系统集成平台完美结合：打破企业内部数据孤岛，无需繁琐的处理工序，与数据集成服务完美结合，让数据真正通起来。 资源互补：汇集各种行业解决方案，资源互补，企业管理融合提升。让对接开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。