从金蝶云星空到旺店通·企业奇门通过接口集成数据

数据源系统:金蝶云星空

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

接入系统：旺店通·企业奇门

慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。

多系统对接方案配置

数据集成平台对应的配置金蝶云星空与旺店通·企业奇门的对接只要三步就能完成两个系统之间的数据对接。第一步根据金蝶云星空的接口参数要求记录在轻易云集成平台。第二步配置金蝶云星空与旺店通·企业奇门之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。

金蝶云星空接口明细

API：executeBillQuery
NAME：销售出库单查询
METHOD：POST

请求参数

接口字段字段名称预设值描述 FBillTypeID_FNumber单据类型FBillTypeID.FNumber单据类型 FBillNo单据编号FBillNo单据编号 FDate日期FDate日期 FSaleOrgId_FNumber销售组织FSaleOrgId.FNumber组织 FCustomerID_FNumber客户编码FCustomerID.FNumber基础资料 FCustomerID_FName客户名称FCustomerID.FName基础资料 FCarriageNO运输单号FCarriageNO文本 FStockOrgId_FNumber发货组织FStockOrgId.FNumber组织 FLinkPhone联系电话FLinkPhone文本 FLinkMan收货人姓名FLinkMan文本 FReceiveAddress收货方地址FReceiveAddress文本 FSettleTypeID_FNumber结算方式FSettleTypeID.FNumber基础资料 FReceiverAddress收货人地址FReceiverAddress文本 FReceiverMobile收货人手机FReceiverMobile文本 FReceiverCountry收货人国家FReceiverCountry文本 FReceiverState收货人省份FReceiverState文本 FReceiverCity收货人城市FReceiverCity文本 FReceiverDistrict收货人地区FReceiverDistrict文本 FReceiverPhone收货人电话FReceiverPhone文本 FSHOPNUMBER网店编码FSHOPNUMBER文本 FSALECHANNEL销售渠道FSALECHANNEL文本 FVIPCODE会员编码FVIPCODE文本 FCustMatID_FNumber客户物料编码FCustMatID.FNumber基础资料 FMaterialID_FNumber物料编码FMaterialID.FNumber基础资料 FBarcode零售条形码FBarcode文本 FMustQty应发数量FMustQty数量 FRealQty实发数量FRealQty数量 FPrice单价FPrice单价 FTaxPrice含税单价FTaxPrice单价 FIsFree是否赠品FIsFree复选框 FLot批号FLot批次 FProduceDate生产日期FProduceDate日期 FExpiryDate有效期至FExpiryDate日期 FEntryTaxRate税率%FEntryTaxRate小数 FEntryTaxAmount税额FEntryTaxAmount金额 FAmount金额FAmount金额 FAllAmount价税合计FAllAmount金额 FStockID_FNumber仓库FStockID.FNumber基础资料 FStockStatusID_FNumber库存状态FStockStatusID.FNumber基础资料 FMtoNo计划跟踪号FMtoNo文本 FEntrynote备注FEntrynote文本 FSrcType源单类型FSrcType源单类型 FSrcBillNo源单编号FSrcBillNo源单编号 FSoorDerno订单单号FSoorDerno文本 FDiscountRate折扣率%FDiscountRate小数 FDiscount折扣额FDiscount折扣额 FPriceDiscount单价折扣FPriceDiscount单价 FSOEntryId销售订单EntryIdFSOEntryId整数 FB2CORDERDETAILIDB2C订单明细IdFB2CORDERDETAILID整数 FThirdEntryId管易订单单号FThirdEntryId文本 FETHIRDBILLID第三方单据IDFETHIRDBILLID文本 FETHIRDBILLNO第三方单据编号FETHIRDBILLNO文本 FGYFINDate管易到账时间FGYFINDate长日期 F_VTRK_Text10是否完成同步F_VTRK_Text10 F_VTRK_Text6旺店通名称FMaterialID.F_VTRK_Text1 F_VTRK_Text9外机物料编码F_VTRK_Text9 F_VTRK_Text合同号F_VTRK_Text F_VTRK_Text1收货联系人F_VTRK_Text1 F_VTRK_Text2收货电话F_VTRK_Text2 F_VTRK_Text3收货地点F_VTRK_Text3 F_VTRK_Text4物流单号F_VTRK_Text4 F_VTRK_Text5旺店通出库单号F_VTRK_Text5 F_VTRK_Text11省F_VTRK_Text11 F_VTRK_Text12市F_VTRK_Text12 F_VTRK_Text13区F_VTRK_Text13 F_VTRK_Text8旺店通编码FMaterialID.F_VTRK_Text FMaterialName物料名称FMaterialName FID主键IDFID FEntity_FENTRYID明细idFEntity_FENTRYID F_VTRK_Assistant项目F_VTRK_Assistant.FNumber F_VTRK_Text14空调外机名称FMaterialID.F_VTRK_Text3 Limit最大行数{{PAGINATION_PAGE_SIZE}}金蝶的查询分页参数 StartRow开始行索引{{PAGINATION_START_ROW}}金蝶的查询分页参数 TopRowCount返回总行数金蝶的查询分页参数 FilterString过滤条件FApproveDate>='{{LAST_SYNC_TIME datetime}}' and FSaleOrgId.FNumber='103' and F_VTRK_Assistant <> '024' and F_VTRK_Assistant <> '' and F_VTRK_Text11 <> '' and F_VTRK_Text12 <> '' and F_VTRK_Text13 <> ''示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= FieldKeys需查询的字段key集合金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber FormId业务对象表单IdSAL_OUTSTOCK必须填写金蝶的表单ID如😛UR_PurchaseOrder

响应参数

接口字段字段名称预设值描述 FBillTypeID_FNumber单据类型FBillTypeID.FNumber单据类型 FBillNo单据编号FBillNo单据编号 FDate日期FDate日期 FSaleOrgId_FNumber销售组织FSaleOrgId.FNumber组织 FCustomerID_FNumber客户编码FCustomerID.FNumber基础资料 FCustomerID_FName客户名称基础资料 FCarriageNO运输单号FCarriageNO文本 FStockOrgId_FNumber发货组织FStockOrgId.FNumber组织 FLinkPhone联系电话FLinkPhone文本 FLinkMan收货人姓名FLinkMan文本 FReceiveAddress收货方地址FReceiveAddress文本 FSettleTypeID_FNumber结算方式FSettleTypeID.FNumber基础资料 FReceiverAddress收货人地址FReceiverAddress文本 FReceiverMobile收货人手机FReceiverMobile文本 FReceiverCountry收货人国家FReceiverCountry文本 FReceiverState收货人省份FReceiverState文本 FReceiverCity收货人城市FReceiverCity文本 FReceiverDistrict收货人地区FReceiverDistrict文本 FReceiverPhone收货人电话FReceiverPhone文本 FSHOPNUMBER网店编码FSHOPNUMBER文本 FSALECHANNEL销售渠道FSALECHANNEL文本 FVIPCODE会员编码FVIPCODE文本 FCustMatID_FNumber客户物料编码FCustMatID.FNumber基础资料 FMaterialID_FNumber物料编码FMaterialID.FNumber基础资料 FBarcode零售条形码FBarcode文本 FMustQty应发数量FMustQty数量 FRealQty实发数量FRealQty数量 FPrice单价FPrice单价 FTaxPrice含税单价FTaxPrice单价 FIsFree是否赠品FIsFree复选框 FLot批号FLot批次 FProduceDate生产日期FProduceDate日期 FExpiryDate有效期至FExpiryDate日期 FEntryTaxRate税率%FEntryTaxRate小数 FEntryTaxAmount税额FEntryTaxAmount金额 FAmount金额FAmount金额 FAllAmount价税合计FAllAmount金额 FStockID_FNumber仓库FStockID.FNumber基础资料 FStockStatusID_FNumber库存状态FStockStatusID.FNumber基础资料 FMtoNo计划跟踪号FMtoNo文本 FEntrynote备注FEntrynote文本 FSrcType源单类型FSrcType源单类型 FSrcBillNo源单编号FSrcBillNo源单编号 FSoorDerno订单单号FSoorDerno文本 FDiscountRate折扣率%FDiscountRate小数 FDiscount折扣额FDiscount折扣额 FPriceDiscount单价折扣FPriceDiscount单价 FSOEntryId销售订单EntryIdFSOEntryId整数 FB2CORDERDETAILIDB2C订单明细IdFB2CORDERDETAILID整数 FThirdEntryId管易订单单号FThirdEntryId文本 FETHIRDBILLID第三方单据IDFETHIRDBILLID文本 FETHIRDBILLNO第三方单据编号FETHIRDBILLNO文本 FGYFINDate管易到账时间FGYFINDate长日期 F_VTRK_Text10是否完成同步F_VTRK_Text10 F_VTRK_Text6旺店通编码F_VTRK_Text6 F_VTRK_Text9外机物料编码F_VTRK_Text9 F_VTRK_Text合同号F_VTRK_Text F_VTRK_Text1收货联系人F_VTRK_Text1 F_VTRK_Text2收货电话F_VTRK_Text2 F_VTRK_Text3收货地点F_VTRK_Text3 F_VTRK_Text4物流单号F_VTRK_Text4 F_VTRK_Text5旺店通出库单号F_VTRK_Text5 F_VTRK_Text11省F_VTRK_Text11 F_VTRK_Text12市F_VTRK_Text12 F_VTRK_Text13区F_VTRK_Text13 F_VTRK_Text8旺店通编码F_VTRK_Text8 FMaterialName物料名称FMaterialName FID主键IDFID FEntity_FENTRYID明细idFEntity_FENTRYID F_VTRK_Assistant项目 F_VTRK_Text14空调外机名称 FEntry外机数组货位节点列表 FEntry.FMaterialID_FNumber物料编码货位ID FEntry.FRealQty数量货位编号 FEntry.FMaterialName物料名称货位主键id

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

接口：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

响应参数

字段名称类型描述 primaryWritebackprimaryWritebackobject primaryWriteback.errorcodeIdstring primaryWriteback.callBackStrategy回写方案object primaryWriteback.callBackStrategy.strategyId方案IDstring primaryWriteback.callBackStrategy.FBillNo单据编号string primaryWriteback.callBackStrategy.FID单据编号string

系统数据对接

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

从金蝶云星空到旺店通·企业奇门通过接口集成数据