金蝶云星空与旺店通·企业奇门对接集成销售订单查询打通创建原始订单

数据源平台:金蝶云星空

金蝶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 FCustId_FName客户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_FADDRESS交货地点string FHEADLOCID_FTCONTACT交货地点string FHEADLOCID_FTEL交货地点string FReceiveContact收货方联系人string FNote备注string FSignStatus签收状态string FManualClose是否手工关闭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 FRemainOutQty剩余未出数量（销售）string FBaseInvoiceJoinQty关联开票数量（基本）(作废)string FInvoiceJoinQty关联开票数量(作废)string FBasePurJoinQty关联采购/生产数量（销售基本）string FPurJoinQty关联采购/生产数量string FReceiptOrgId收款组织string FSettleOrgIds结算组织string FAmount金额string FEntryNote备注string FQty销售数量string FLimitDownPrice最低限价string FSysPrice系统定价string FStockOrgId库存组织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 FSrcType源单类型string FSrcBillNo源单编号string FBaseDeliveryMaxQty发货上限（基本）string FBaseDeliveryMinQty发货下限（基本）string FOEMInStockJoinQty关联受托材料入库套数string FBaseOEMInStockJoinQty关联受托材料入库套数(库存基本)string FBaseARJoinQty关联应收数量（计价基本）string FIsReturn物料允许退货属性string FBFLowId业务流程string FIsInventory物料允许库存属性string FARJOINAMOUNT关联应收金额string FBaseRemainOutQty剩余未出数量（销售基本）string FMaterialIsSubContract物料允许委外属性string FCanOutQty可出数量（销售）string FBaseCanOutQty可出数量（销售基本）string FCanReturnQty可退数量（销售）string FBaseCanReturnQty可退数量（销售基本）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 FStockBasePurJoinQty关联采购/生产数量（库存基本）string FSalBaseNum源单基本分子string FStockBaseDen库存基本分母string FSRCBIZUNITID携带主单位string FPurBaseQty采购基本数量string FPurUnitID采购单位string FPurQty采购数量string FSalBaseARJoinQty关联应收数量（销售基本）string FOUTLMTUNIT超发控制单位类型string FOutLmtUnitID超发控制单位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 FTailDiffFlag尾差处理标识string F_ora_Decimal箱数string FBillAllAmount整单价税合计string F_ora_sheng省string F_ora_shi市string F_ora_qu区string F_ora_FADDRESS详细地址string FLINKMAN收货人姓名string FLINKPHONE联系电话string F_ora_Assistant店铺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

请求参数

字段名称类型描述 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

系统对接概况

随着企业数字化业务的深入发展，对于企业的 IT 或者 CIO 来讲，正在面临一个愈发重要的问题——系统的结构太复杂了，尤其是头部企业，至少有十多套系统，这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统，如何整合企业的现有IT资源，使企业中计算机孤岛式的应用向集体协作的方向发展，发挥资源效益的最大化，降低企业成本，正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上，操作统一，以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中，轻易云应用集成平台负责实现异构、分布式系统之间互联互通，实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件，连接现有各孤立应用系统，以图形化、拖拽方式构建集成流程和服务，提高应用系统集成工作效率，降低异构系统集成风险。针对未来可能出现的业务需求变更，在应用集成平台上进行动态调整，实现各应用系统之间的集成策略平滑升级。

金蝶云星空与旺店通·企业奇门对接集成销售订单查询打通创建原始订单