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

接通系统：金蝶云星空

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

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

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

数据对接方案

通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：金蝶云星空，然后选择对应的连接器。选择对应的executeBillQuery作为数据对接来源。然后再写入目标平台配置目标系统为旺店通·企业奇门，并且选择对应连接器（关于旺店通·企业奇门的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的wdt.purchase.return.push接口作为数据写入动作完成第一步的接口配置。

金蝶云星空接口明细

API：executeBillQuery
NAME：退料申请查询
METHOD：POST

请求参数

接口字段字段名称预设值描述 FEntity_FEntryIDFEntity_FEntryIDFEntity_FEntryID FBillNo单据编号FBillNo FIDFIDFID FDocumentStatus单据状态FDocumentStatus FBillTypeID_Fnumber单据类型FBillTypeID.Fnumber FDate申请日期FDate FPURCHASEORGID_Fnumber采购组织FPURCHASEORGID.Fnumber FRMTYPE退料类型FRMTYPE FAPPORGID_Fnumber申请组织FAPPORGID.Fnumber FAPPDEPTID_Fnumber申请部门FAPPDEPTID.Fnumber FRMLOC退料地点FRMLOC FSUPPLIERID_Fnumber供应商FSUPPLIERID.Fnumber FRMMODE退料方式FRMMODE FREPLENISHMODE补料方式FREPLENISHMODE FCreatorId创建人FCreatorId FCreateDate创建日期FCreateDate FModifierId最后修改人FModifierId FModifyDate最后修改日期FModifyDate FAPPROVERID审核人FAPPROVERID FAPPROVEDATE审核日期FAPPROVEDATE FCANCELLERID作废人FCANCELLERID FCANCELDATE作废日期FCANCELDATE FCANCELSTATUS作废状态FCANCELSTATUS FBusinessType业务类型FBusinessType FRemarks备注FRemarks FRMREASON退料原因FRMREASON FRequireOrgId_Fnumber需求组织FRequireOrgId.Fnumber FCorrespondOrgId_Fnumber对应组织FCorrespondOrgId.Fnumber FConfirmerId确认人FConfirmerId FConfirmDate确认日期FConfirmDate FConfirmStatus确认状态FConfirmStatus FMATERIALID_Fnumber物料编码FMATERIALID.Fnumber FMaterialName物料名称FMaterialName FUOM规格型号FUOM FMaterialType存货类别FMaterialType FMRAPPQTY申请退料数量FMRAPPQTY FREPLENISHQTY补料数量FREPLENISHQTY FKEAPAMTQTY扣款数量FKEAPAMTQTY FMRJOINQTY退料关联数量FMRJOINQTY FMRQTY退料数量FMRQTY FNOTE_M备注FNOTE_M FBOMIDBOM版本FBOMID FPRICEQTY_F计价数量FPRICEQTY_F FPRICE_F单价FPRICE_F FPRICECOEFFICIENT_F价格系数FPRICECOEFFICIENT_F FDISCOUNTRATE_F折扣率FDISCOUNTRATE_F FDISCOUNT_F折扣额FDISCOUNT_F FTAXNETPRICE_F净价FTAXNETPRICE_F FAMOUNT_F退料金额FAMOUNT_F FALLAMOUNT_F退料含税金额FALLAMOUNT_F FAPPROVEPRICE_F含税单价FAPPROVEPRICE_F FSRCSEQ源单行号FSRCSEQ FCONTRACTNO合同单号FCONTRACTNO FORDERNO订单单号FORDERNO FREQTRACENO需求跟踪号FREQTRACENO FBASEUNITQTY库存基本数量FBASEUNITQTY FBASEUNITID退料申请基本单位FBASEUNITID FUNITID库存单位FUNITID FPRICEUNITID_F计价单位FPRICEUNITID_F FBASEMRJOINQTY退料关联数量（库存基本）FBASEMRJOINQTY FBASEMRQTY退料数量(基本单位)FBASEMRQTY FAUXPROPID辅助属性FAUXPROPID FSRCBILLNO源单编号FSRCBILLNO FSRCBILLTYPEID源单类型FSRCBILLTYPEID FREPLENISHAMOUNT补料金额FREPLENISHAMOUNT FKEAPAMTAMOUNT扣款金额FKEAPAMTAMOUNT FLot批号FLot FRMREASON_M退料原因FRMREASON_M FBFLowId业务流程FBFLowId FMtoNo计划跟踪号FMtoNo FGiveAway是否赠品FGiveAway FPriceBaseQty计价基本数量FPriceBaseQty FPURUNITID采购单位FPURUNITID FPurQty采购数量FPurQty FPurBaseQty采购基本数量FPurBaseQty FPURBASENUM采购基本分子FPURBASENUM FSTOCKBASEDEN库存基本分母FSTOCKBASEDEN FSRCBIZUNITID携带的主业务单位FSRCBIZUNITID FRETURNSTOCKJNBASEQTY退料关联数量（采购基本）FRETURNSTOCKJNBASEQTY FEntryTaxRate税率%FEntryTaxRate FENTRYPRICELISTID分录价目表FENTRYPRICELISTID FPOORDERENTRYID采购订单分录内码FPOORDERENTRYID FStockId_Fnumber仓库FStockId.Fnumber FISSYNTOTHIRD是否同步管易(GY)FISSYNTOTHIRD FRowType产品类型FRowType FPARENTMATID父项产品FPARENTMATID FPriceDiscount单价折扣FPriceDiscount FSTOCKLOCID仓位FSTOCKLOCID FPriLstEntryId价目表分录idFPriLstEntryId FEntity_Link_FFlowId业务流程图FEntity_Link_FFlowId FEntity_Link_FFlowLineId推进路线FEntity_Link_FFlowLineId FEntity_Link_FRuleId转换规则FEntity_Link_FRuleId FEntity_Link_FSTableId源单表内码FEntity_Link_FSTableId FEntity_Link_FSTableName源单表FEntity_Link_FSTableName FEntity_Link_FSBillId源单内码FEntity_Link_FSBillId FEntity_Link_FSId源单分录内码FEntity_Link_FSId FEntity_Link_FBASEUNITQTYOld原始携带量FEntity_Link_FBASEUNITQTYOld FEntity_Link_FBASEUNITQTY修改携带量FEntity_Link_FBASEUNITQTY FEntity_Link_FPurBaseQtyOld原始携带量FEntity_Link_FPurBaseQtyOld FEntity_Link_FPurBaseQty修改携带量FEntity_Link_FPurBaseQty FEntity_Link_FLnkTrackerId迁移图FEntity_Link_FLnkTrackerId FEntity_Link_FLnkSState上游状态FEntity_Link_FLnkSState FEntity_Link_FLnkAmount数量FLnkFEntity_Link_FLnkAmount F_ORA_FSTOCK_Fnumber退料仓库F_ORA_FSTOCK.Fnumber Limit最大行数{{PAGINATION_PAGE_SIZE}}金蝶的查询分页参数 StartRow开始行索引{{PAGINATION_START_ROW}}金蝶的查询分页参数 TopRowCount返回总行数金蝶的查询分页参数 FilterString过滤条件FApproveDate>='{{LAST_SYNC_TIME dateTime}}' and FDocumentStatus = 'C' and F_ORA_FSTOCK.F_ORA_TBDX=1 and FBillNo not in('123123')示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= FieldKeys需查询的字段key集合金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber FormId业务对象表单IdPUR_MRAPP必须填写金蝶的表单ID如😛UR_PurchaseOrder

响应参数

接口字段字段名称预设值描述 FEntity_FEntryIDFEntity_FEntryID FBillNo单据编号 FIDFID FDocumentStatus单据状态 FBillTypeID_Fnumber单据类型 FDate申请日期 FPURCHASEORGID_Fnumber采购组织 FRMTYPE退料类型 FAPPORGID_Fnumber申请组织 FAPPDEPTID_Fnumber申请部门 FRMLOC退料地点 FSUPPLIERID_Fnumber供应商 FRMMODE退料方式 FREPLENISHMODE补料方式 FCreatorId创建人 FCreateDate创建日期 FModifierId最后修改人 FModifyDate最后修改日期 FAPPROVERID审核人 FAPPROVEDATE审核日期 FCANCELLERID作废人 FCANCELDATE作废日期 FCANCELSTATUS作废状态 FBusinessType业务类型 FRemarks备注 FRMREASON退料原因 FRequireOrgId_Fnumber需求组织 FCorrespondOrgId_Fnumber对应组织 FConfirmerId确认人 FConfirmDate确认日期 FConfirmStatus确认状态 FMATERIALID_Fnumber物料编码 FMaterialName物料名称 FUOM规格型号 FMaterialType存货类别 FMRAPPQTY申请退料数量 FREPLENISHQTY补料数量 FKEAPAMTQTY扣款数量 FMRJOINQTY退料关联数量 FMRQTY退料数量 FNOTE_M备注 FBOMIDBOM版本 FPRICEQTY_F计价数量 FPRICE_F单价 FPRICECOEFFICIENT_F价格系数 FDISCOUNTRATE_F折扣率 FDISCOUNT_F折扣额 FTAXNETPRICE_F净价 FAMOUNT_F退料金额 FALLAMOUNT_F退料含税金额 FAPPROVEPRICE_F含税单价 FSRCSEQ源单行号 FCONTRACTNO合同单号 FORDERNO订单单号 FREQTRACENO需求跟踪号 FBASEUNITQTY库存基本数量 FBASEUNITID退料申请基本单位 FUNITID库存单位 FPRICEUNITID_F计价单位 FBASEMRJOINQTY退料关联数量（库存基本） FBASEMRQTY退料数量(基本单位) FAUXPROPID辅助属性 FSRCBILLNO源单编号 FSRCBILLTYPEID源单类型 FREPLENISHAMOUNT补料金额 FKEAPAMTAMOUNT扣款金额 FLot批号 FRMREASON_M退料原因 FBFLowId业务流程 FMtoNo计划跟踪号 FGiveAway是否赠品 FPriceBaseQty计价基本数量 FPURUNITID采购单位 FPurQty采购数量 FPurBaseQty采购基本数量 FPURBASENUM采购基本分子 FSTOCKBASEDEN库存基本分母 FSRCBIZUNITID携带的主业务单位 FRETURNSTOCKJNBASEQTY退料关联数量（采购基本） FEntryTaxRate税率% FENTRYPRICELISTID分录价目表 FPOORDERENTRYID采购订单分录内码 FStockId_Fnumber仓库 FISSYNTOTHIRD是否同步管易(GY) FRowType产品类型 FPARENTMATID父项产品 FPriceDiscount单价折扣 FSTOCKLOCID仓位 FPriLstEntryId价目表分录id FEntity_Link_FFlowId业务流程图 FEntity_Link_FFlowLineId推进路线 FEntity_Link_FRuleId转换规则 FEntity_Link_FSTableId源单表内码 FEntity_Link_FSTableName源单表 FEntity_Link_FSBillId源单内码 FEntity_Link_FSId源单分录内码 FEntity_Link_FBASEUNITQTYOld原始携带量 FEntity_Link_FBASEUNITQTY修改携带量 FEntity_Link_FPurBaseQtyOld原始携带量 FEntity_Link_FPurBaseQty修改携带量 FEntity_Link_FLnkTrackerId迁移图 FEntity_Link_FLnkSState上游状态 FEntity_Link_FLnkAmount数量FLnk F_ORA_FSTOCK_Fnumber退料仓库

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

API：wdt.purchase.return.push
NAME：创建采购退料单
METHOD：POST

请求参数

接口字段字段名称预设值描述 provider_no供应商编号{{FSUPPLIERID_Fnumber}}供应商编号 outer_no外部单号{{FBillNo}}外部单号 is_check是否审核11：自动审核0：不自动审核默认0 warehouse_no出库仓库编号{{F_ORA_FSTOCK_Fnumber}}代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置） purchaser_no关联采购员编号关联采购员编号 logistics_code货运方式货运方式，物流公司编号 receiver_province省份省份 receiver_city城市城市 receiver_district地区地区 contact联系人联系人 telno联系电话联系电话 address详细地址详细地址 post_fee邮资邮资 remark备注备注 prop1自定义属性1自定义属性1 prop2自定义属性2自定义属性2 detail_list明细列表节点details_list请求参数的2级数据节点，包含采购退货单所有货品明细属性信息的数据节点，节点下数据字段详见下述“detail_list”列表 detail_list.spec_no商家编码{{details_list.FMATERIALID_Fnumber}}代表所单品（sku）所有属性的唯一编码，用于获取系统单品的数据，SKU概念介绍，单击这里 detail_list.num退货数量{{details_list.FMRAPPQTY}}退货数量 detail_list.price单价{{details_list.FAPPROVEPRICE_F}}单价 detail_list.discount折扣折扣 detail_list.detail_remark备注{{details_list.FNOTE_M}}备注 detail_list.return_info采购退货单列表节点请求参数的1级数据节点，包含采购退货单所有属性信息的数据节点，节点下数据字段详见下述“return_info”列表

数据对接效果

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

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