旺店通·企业奇门和金蝶云星空单据接口对接

接通系统：金蝶云星空

金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。

对接目标系统:旺店通·企业奇门

慧策最先以旺店通ERP切入商家核心管理痛点——订单管理，之后围绕电商经营管理中的核心管理诉求，先后布局流量获取、会员管理、仓库管理等其他重要经营模块。慧策的产品线从旺店通ERP起步，向前向后延伸，全面布局零售企业经营，整体构建一体化智能零售解决方案，打破数据孤岛，AI植入系统，实现智能决策，助力零售企业智能化转型。当前旗下拥有店+小程序、数智门店POS、旺店通ERP、旺店通WMS、卡米全渠道、客优CRM、云筹大数据等多个PssS、SaaS产品，从前端吸引流量到后端集约化管理，助力企业智慧决策

系统对接接口配置

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

金蝶云星空接口明细

接口：executeBillQuery
接口名称：销售订单查询
接口方法：POST

请求参数

字段名称类型描述 FSaleOrderEntry_FEntryIDFSaleOrderEntry_FEntryIDstring FIDFIDstring FBillNo单据编号string FDocumentStatus单据状态string FSaleOrgId_FNumber销售组织string FDate日期string FCustId_FNumber客户string FSaleDeptId_Fnumber销售部门string FSaleGroupId销售组string FSalerId销售员string FReceiveId收货方string FSettleId结算方string FSettleAddress结算方地址string FChargeId付款方string FCreatorId创建人string FCreateDate创建日期string FModifierId最后修改人string FModifyDate最后修改日期string FApproverId审核人string FApproveDate审核日期string FCloseStatus关闭状态string FCloserId关闭人string FCloseDate关闭日期string FCancelStatus作废状态string FCancellerId作废人string FCancelDate作废日期string FVersionNo版本号string FChangerId变更人string FChangeDate变更日期string FChangeReason变更原因string FBillTypeID_Fnumber单据类型string FBusinessType业务类型string FHeadDeliveryWay交货方式string FReceiveAddress收货方地址string FHEADLOCID交货地点string FCreditCheckResult信用检查结果string FReceiveContact收货方联系人string FNetOrderBillNo移动销售订单编号string FNetOrderBillId移动销售订单IDstring FOppID商机内码array FSalePhaseID销售阶段string FISINIT是否期初单据string FNote备注string FSignStatus签收状态string FManualClose是否手工关闭string FLinkMan收货人姓名string FLinkPhone联系电话string FSOFrom订单来源string FMaterialId_Fnumber物料编码string FMaterialName物料名称string FMaterialModel规格型号string FMaterialType物料类别string FUnitID_Fnumber销售单位string FPrice单价string FTaxPrice含税单价string FBomIdBOM版本string FPriceUnitId计价单位string FPriceUnitQty计价数量string FPriceCoefficient价格系数string FDiscountRate折扣率%string FDiscount折扣额string FEntryTaxRate税率%string FEntryTaxAmount税额string FAllAmount价税合计string FTaxNetPrice净价string FBaseUnitQty销售基本数量string FDeliveryControl控制发货数量string FDeliveryMaxQty发货上限string FDeliveryMinQty发货下限string FTransportLeadTime1运输提前期string FBefDisAllAmt折前价税合计string FBefDisAmt折前金额string FTaxAmount_LC税额（本位币）string FAmount_LC金额（本位币）string FAllAmount_LC价税合计（本位币）string FMrpCloseStatus业务关闭string FMrpFreezeStatus业务冻结string FFreezerId冻结人string FFreezeDate冻结日期string FMrpTerminateStatus业务终止string FTerminaterId终止人string FTerminateDate终止日期string FBaseDeliJoinQty（代码有用）关联发货通知数量（销售基本）string FDeliQty累计发货通知数量string FStockOutQty累计出库数量string FRetNoticeQty累计退货通知数量（销售）string FReturnQty累计退货数量（销售）string FRemainOutQty剩余未出数量（销售）string FBaseInvoiceJoinQty关联开票数量（基本）(作废)string FInvoiceJoinQty关联开票数量(作废)string FInvoiceQty累计开票数量(作废)string FInvoiceAmount累计开票金额(作废)string FReceiveAmount累计收款金额string FBasePurJoinQty关联采购/生产数量（销售基本）string FPurJoinQty关联采购/生产数量string FPurReqQty累计采购申请数量string FPurOrderQty累计采购订单数量string FReceiptOrgId收款组织string FSettleOrgIds结算组织string FAmount金额string FEntryNote备注string FQty销售数量string FLimitDownPrice最低限价string FSysPrice系统定价string FStockOrgId库存组织string FBaseStockOutQty累计出库数量（销售基本）string FBaseDeliQty累计发货通知数量（销售基本）string FBaseRetNoticeQty累计退货通知数量（销售基本）string FBaseReturnQty累计退货数量（销售基本）string FBasePurReqQty累计采购申请数量（销售基本）string FBasePurOrderQty累计采购订单数量（销售基本）string FBaseUnitId基本单位string FChangeFlag变更标志string FMapId客户物料编码string FOwnerTypeId货主类型string FOwnerId货主string FIsFree是否赠品string FLOCKQTY锁库/预留数量(库存单位)string FLOCKFLAG锁库/预留标识string FProduceDate生产日期string FExpiryDate有效期至string FExpUnit保质期单位string FExpPeriod保质期string FMaterialIsProduce物料允许生产属性string FTaxCombination税组合string FLot批号string FMapName客户物料名称string FAuxPropId辅助属性string FReturnType退补类型string FDeliveryDate要货日期string FTransJoinQty累计调拨数量string FBaseTransJoinQty累计调拨数量(销售基本)string FSrcType源单类型string FSrcBillNo源单编号string FBaseDeliveryMaxQty发货上限（基本）string FBaseDeliveryMinQty发货下限（基本）string FOEMInStockJoinQty关联受托材料入库套数string FBaseOEMInStockJoinQty关联受托材料入库套数(库存基本)string FBaseARJoinQty关联应收数量（计价基本）string FIsReturn物料允许退货属性string FBFLowId业务流程string FIsInventory物料允许库存属性string FBASEARQTY累计应收数量（销售基本）string FARJOINAMOUNT关联应收金额string FARAMOUNT累计应收金额string FBaseRemainOutQty剩余未出数量（销售基本）string FReBackQty累计退货补货数量（销售）string FBaseReBackQty累计退货补货数量（销售基本）string FARQTY累计应收数量（销售）string FMaterialIsSubContract物料允许委外属性string FCanOutQty可出数量（销售）string FBaseCanOutQty可出数量（销售基本）string FCanReturnQty可退数量（销售）string FBaseCanReturnQty可退数量（销售基本）string FBASEAPQTY累计应付数量(基本单位)string FAPAMOUNT累计应付金额string FMtoNo计划跟踪号string FPriority需求优先级string FReserveType预留类型string FMinPlanDeliveryDate计划交货日期string FDeliveryStatus发货状态string FOldQty原数量string FPromotionMatchType促销匹配类型string FPriceListEntry行价目表string FSupplyOrgId供应组织string FNetOrderEntryId供应商协同平台订单分录IDstring FPriceBaseQty计价基本数量string FSetPriceUnitID定价单位string FStockUnitID库存单位string FStockQty库存数量string FStockBaseQty库存基本数量string FStockBaseCanOutQty可出数量（库存基本）string FStockBaseCanReturnQty可退数量（库存基本）string FStockBaseARJoinQty关联应收数量（库存基本）string FStockBaseTransJoinQty累计调拨数量（库存基本）string FStockBasePurJoinQty关联采购/生产数量（库存基本）string FSalBaseNum源单基本分子string FStockBaseDen库存基本分母string FSRCBIZUNITID携带主单位string FPurBaseQty采购基本数量string FPurUnitID采购单位string FPurQty采购数量string FSalBaseARJoinQty关联应收数量（销售基本）string FSTOCKBASESTOCKOUTQTY累计出库数量（库存基本）string FSTOCKBASEREBACKQTY累计退货补货数量（库存基本）string FOUTLMTUNIT超发控制单位类型string FOutLmtUnitID超发控制单位string FTRANSRETURNQTY累计调拨退货数量string FTRANSRETURNBASEQTY累计调拨退货数量（销售基本）string FCONSIGNSETTQTY寄售结算数量string FCONSIGNSETTBASEQTY寄售结算数量（销售基本）string FLeftQty待锁库/待预留数量(库存单位)string FRowType产品类型string FParentMatId父项产品string FRowId行标识string FParentRowId父行标识string FInStockPrice最新采购入库价string FSOStockId_Fnumber仓库string FSOStockLocalId仓位string FPurPriceUnitId采购计价单位string FISMRP已计划运算string FBarcode零售条形码string FBranchId发货门店string FRetailSaleProm是否零售促销string FBASEFINARQTY先开票数量（计价基本）string FSALBASEFINARQTY先开票数量（销售基本）string FEntryDiscountList行折扣表string FPriceDiscount单价折扣string FZHJStockQty智慧记上报库存string FSPMENTRYID促销政策IDstring FSPMANDRPMCONTENT促销内容string FTransReturnStockBaseQty累计调拨退货数量（库存基本）string FTailDiffFlag尾差处理标识string F_ora_Decimal箱数string Limit最大行数string金蝶的查询分页参数 StartRow开始行索引string金蝶的查询分页参数 TopRowCount返回总行数int金蝶的查询分页参数 FilterString过滤条件string示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= FieldKeys需查询的字段key集合array金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber FormId业务对象表单Idstring必须填写金蝶的表单ID如😛UR_PurchaseOrder

响应参数

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

接口：wdt.trade.push
接口名称：创建原始订单
接口方法：POST

请求参数

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

数据对接价值

使用全界面可视化配置集成流，快速应对企业的集成需求使得金蝶云星空与旺店通·企业奇门之间的数据接口一站式的快速集成能力，构建企业数据通道，解决数据孤岛问题。快速构建企业元数据标准、主数据标准、业财数据标准，完成数据的采集、统一、分发、清洗、归集等，帮助企业建立高质量的数据中台。目前轻易云平台已经支持300+系统，同时具备快速适配新系统的能力，集成海量接口数据。无论是对接ERP还是MES、OA、CRM、WMS、OMS等等系统，都可以通过接口相互集成。

旺店通·企业奇门和金蝶云星空单据接口对接