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

汪淼_轻易云

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

对接系统：金蝶云星空

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

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

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

数据对接方案

使用轻易云系统数据集成平台对应的模块：数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统：金蝶云星空，然后选择对应的连接器。选择对应的销售出库单查询作为数据对接来源。然后再通过写入目标平台配置目标系统为旺店通·企业奇门,并且选择对应连接器（关于旺店通·企业奇门的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的创建原始订单接口作为数据写入动作，既可以完成第一步的数据对接配置。

金蝶云星空接口明细

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

请求参数

字段字段名称类型配置值 FBillTypeID_FNumber单据类型stringFBillTypeID.FNumber FBillNo单据编号stringFBillNo FDate日期stringFDate FSaleOrgId_FNumber销售组织stringFSaleOrgId.FNumber FCustomerID_FNumber客户编码stringFCustomerID.FNumber FCustomerID_FName客户名称stringFCustomerID.FName 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 F_VTRK_Text10是否完成同步stringF_VTRK_Text10 F_VTRK_Text6旺店通名称stringFMaterialID.F_VTRK_Text1 F_VTRK_Text9外机物料编码stringF_VTRK_Text9 F_VTRK_Text合同号stringF_VTRK_Text F_VTRK_Text1收货联系人stringF_VTRK_Text1 F_VTRK_Text2收货电话stringF_VTRK_Text2 F_VTRK_Text3收货地点stringF_VTRK_Text3 F_VTRK_Text4物流单号stringF_VTRK_Text4 F_VTRK_Text5旺店通出库单号stringF_VTRK_Text5 F_VTRK_Text11省stringF_VTRK_Text11 F_VTRK_Text12市stringF_VTRK_Text12 F_VTRK_Text13区stringF_VTRK_Text13 F_VTRK_Text8旺店通编码stringFMaterialID.F_VTRK_Text FMaterialName物料名称stringFMaterialName FID主键IDstringFID FEntity_FENTRYID明细idstringFEntity_FENTRYID F_VTRK_Assistant项目stringF_VTRK_Assistant.FNumber F_VTRK_Text14空调外机名称stringFMaterialID.F_VTRK_Text3 Limit最大行数string{{PAGINATION_PAGE_SIZE}} StartRow开始行索引string{{PAGINATION_START_ROW}} TopRowCount返回总行数int FilterString过滤条件stringFApproveDate>='{{LAST_SYNC_TIME datetime}}' and FSaleOrgId.FNumber='100' and F_VTRK_Assistant = '007' FieldKeys需查询的字段key集合array FormId业务对象表单IdstringSAL_OUTSTOCK

响应参数

字段字段名称类型配置值 FBillTypeID_FNumber单据类型stringFBillTypeID.FNumber FBillNo单据编号stringFBillNo FDate日期stringFDate FSaleOrgId_FNumber销售组织stringFSaleOrgId.FNumber FCustomerID_FNumber客户编码stringFCustomerID.FNumber FCustomerID_FName客户名称string 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 F_VTRK_Text10是否完成同步stringF_VTRK_Text10 F_VTRK_Text6旺店通编码stringF_VTRK_Text6 F_VTRK_Text9外机物料编码stringF_VTRK_Text9 F_VTRK_Text合同号stringF_VTRK_Text F_VTRK_Text1收货联系人stringF_VTRK_Text1 F_VTRK_Text2收货电话stringF_VTRK_Text2 F_VTRK_Text3收货地点stringF_VTRK_Text3 F_VTRK_Text4物流单号stringF_VTRK_Text4 F_VTRK_Text5旺店通出库单号stringF_VTRK_Text5 F_VTRK_Text11省stringF_VTRK_Text11 F_VTRK_Text12市stringF_VTRK_Text12 F_VTRK_Text13区stringF_VTRK_Text13 F_VTRK_Text8旺店通编码stringF_VTRK_Text8 FMaterialName物料名称stringFMaterialName FID主键IDstringFID FEntity_FENTRYID明细idstringFEntity_FENTRYID F_VTRK_Assistant项目string F_VTRK_Text14空调外机名称string FEntry外机数组array FEntry.FMaterialID_FNumber物料编码string FEntry.FRealQty数量string FEntry.FMaterialName物料名称string

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

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

请求参数

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

响应参数

接口字段字段名称预设值描述 primaryWritebackprimaryWriteback primaryWriteback.errorcodeId{{errorcode}} primaryWriteback.callBackStrategy回写方案 primaryWriteback.callBackStrategy.strategyId方案ID40ae579d-f55c-39d1-8abd-b3e2cd665b88 primaryWriteback.callBackStrategy.FBillNo单据编号{{FBillNo}} primaryWriteback.callBackStrategy.FID单据编号{{FID}}

数据对接价值

通过轻易云集成平台系列产品线可以协助企业轻易快捷的构建基于微服务架构的新一代企业服务总线，传统基于SOA架构的ESB产品主要解决的数据集成和协议转换等基础功能，已完全不能满足基于微服务架构、混合云集成架构、跨组织、跨单位的总线解决方案。而轻易云集成平台的每个产品线都是新一代的按照最新的互联网架构模式进行研发的产品线，能快速协助企业从传统的SOA架构转向微服务架构的服务总线解决方案。