金蝶云星空和旺店通·企业奇门接口打通对接实战|轻易云数据集成平台

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

对接系统：金蝶云星空

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

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

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

接口方案配置

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

金蝶云星空接口明细

接口：executeBillQuery
接口名称：退料申请查询
接口方法：POST

请求参数

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

响应参数

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

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

接口：wdt.purchase.return.push
接口名称：创建采购退料单
接口方法：POST

请求参数

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

系统数据对接

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