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

数据源系统:金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

对接目标系统:旺店通·旗舰奇门

旺店通是北京掌上先机网络科技有限公司旗下品牌，国内的零售云服务提供商，基于云计算SaaS服务模式，以体系化解决方案，助力零售企业数字化智能化管理升级。为零售电商企业的订单管理及仓储管理提供解决方案，致力于帮助企业实现数字化转型，企业规模化发展

数据接口配置

通过轻易云系统数据集成平台新增创建集成方案，通过轻易云的方案市场可以一键复制，并且可以借鉴其他的方案配置完成方案制作，方案制作只需要两步，第一步先确定好对应的数据来源；源系统：金蝶云星空接口：销售订单查询通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统：旺店通·旗舰奇门接口：原始单推送，通过写入调度者匹配获取到的数据和写入的映射关系，即可自动生成符合目标系统：旺店通·旗舰奇门写入的数据自动产生写入队列，通过运行概况，系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况

金蝶云星空接口明细

API：executeBillQuery
NAME：销售订单查询
METHOD：POST

请求参数

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

响应参数

旺店通·旗舰奇门接口明细

调用接口：sales.RawTrade.pushSelf
接口名称：原始单推送
方法：POST

请求参数

字段字段名称类型配置值 shop_no店铺编号string{{FCustId_FNumber}} rawTradeList原始单信息array rawTradeList.trade_status平台状态string30 rawTradeList.refund_status退款状态string rawTradeList.pay_status付款状态string2 rawTradeList.order_count子订单个数string rawTradeList.tid原始单号string{{FBillNo}}{{FSOStockId_Fnumber}} rawTradeList.process_status处理状态string rawTradeList.goods_count货品总数量string rawTradeList.pay_method支付方式string3 rawTradeList.trade_time下单时间string{{FDate}} rawTradeList.pay_time支付时间string rawTradeList.end_time交易结束时间string{{FDate}} rawTradeList.buyer_nick买家账号string123456 rawTradeList.buyer_message买家备注string rawTradeList.buyer_email买家邮箱string rawTradeList.buyer_area买家地区string rawTradeList.receiver_name收件人姓名string{{FLINKMAN}} rawTradeList.receiver_area省市区string{{FReceiveAddress}} rawTradeList.receiver_address地址string{{FReceiveAddress}} rawTradeList.receiver_zip收件人邮编string rawTradeList.receiver_mobile收件人手机string{{FLINKPHONE}} rawTradeList.receiver_telno收件人电话string rawTradeList.post_amount邮费string rawTradeList.other_amount其他费用string rawTradeList.discount优惠金额string rawTradeList.receivable应收金额string rawTradeList.platform_cost平台费用string rawTradeList.invoice_type发票类别string rawTradeList.invoice_title发票抬头string rawTradeList.invoice_content发票内容string rawTradeList.logistics_type物流类别string-1 rawTradeList.cust_data物流编号string rawTradeList.delivery_term发货条件string1 rawTradeList.pay_id平台支付订单IDstring rawTradeList.remark客服备注string rawTradeList.remark_flag客服备注标记string rawTradeList.cod_amount货到付款金额string rawTradeList.is_auto_wms是否是自流转stringtrue rawTradeList.warehouse_no仓库编号string{{FSOStockId_FNumber}} rawTradeList.pay_account买家支付宝帐号string rawTradeList.to_deliver_time买家要求的送货日期string rawTradeList.received已从平台收款的金额string rawTradeList.consign_interval淘宝新增,物流到货时效，单位天string rawTradeList.rawTradeOrderList原始子单信息array rawTradeList.rawTradeOrderList.tid原始订单号string{{FSOStockId_Fnumber}} rawTradeList.rawTradeOrderList.oid原始子单号string{{details_list.FSaleOrderEntry_FEntryID}} rawTradeList.rawTradeOrderList.status平台的状态string30 rawTradeList.rawTradeOrderList.refund_status退款标记string rawTradeList.rawTradeOrderList.goods_id平台货品IDstring{{details_list.FMaterialId_Fnumber}} rawTradeList.rawTradeOrderList.spec_id平台规格IDstring{{details_list.FMaterialId_Fnumber}} rawTradeList.rawTradeOrderList.goods_no货品编号string{{details_list.FMaterialId_Fnumber}} rawTradeList.rawTradeOrderList.spec_no规格编码string{{details_list.FMaterialId_Fnumber}} rawTradeList.rawTradeOrderList.goods_name货品名称string{{details_list.FMaterialId_Fname}} rawTradeList.rawTradeOrderList.spec_name规格名称string rawTradeList.rawTradeOrderList.order_type子单类型string rawTradeList.rawTradeOrderList.cid平台类目string rawTradeList.rawTradeOrderList.num数量string{{details_list.FQty}} rawTradeList.rawTradeOrderList.price单价string{{details_list.FAllAmount}} rawTradeList.rawTradeOrderList.discount优惠string rawTradeList.rawTradeOrderList.share_discount分摊优惠string rawTradeList.rawTradeOrderList.total_amount总价格string rawTradeList.rawTradeOrderList.adjust_amount手工调整的优惠金额string rawTradeList.rawTradeOrderList.refund_amount退款金额string rawTradeList.rawTradeOrderList.remark备注string rawTradeList.rawTradeOrderList.jsonjson串string

数据对接效果

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

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