旺店通·旗舰奇门和金蝶云星空单据接口对接

旺店通·旗舰奇门和金蝶云星空单据接口对接

来源系统:金蝶云星空

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

集成系统:旺店通·旗舰奇门

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

配置集成方案

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

金蝶云星空接口明细

• API：executeBillQuery
• NAME：采购订单查询
• METHOD：POST

请求参数

接口字段字段名称预设值描述 FPOOrderEntry_FEntryIdidFPOOrderEntry_FEntryId FBillNo单据编号FBillNo单据编号 FSourceBillNo源单编号FSourceBillNo源单编号 FBillTypeID_FNumber单据类型FBillTypeID.FNumber单据类型 FBusinessType业务类型FBusinessType下拉列表 FSupplierId_FNumber供应商FSupplierId.FNumber基础资料 FSettleModeId_FNumber结算方式FSettleModeId.FNumber基础资料 FPayConditionId_FNumber付款条件FPayConditionId.FNumber基础资料 FDate采购日期FDate日期 FDocumentStatus单据状态FDocumentStatus单据状态 FPreMatchAmountFor预付已核销金额FPreMatchAmountFor金额 FPayAdvanceBillId_FNumber预付单号FPayAdvanceBillId.FNumber基础资料 FPurchaseOrgId_FNumber采购组织FPurchaseOrgId.FNumber组织 FPurchaseDeptId_FNumber采购部门FPurchaseDeptId.FNumber基础资料 FPurchaserGroupId_FNumber采购组FPurchaserGroupId.FNumber基础资料 FPurchaserId_FNumber采购员FPurchaserId.FNumber基础资料 FProviderId_FNumber供货方FProviderId.FNumber基础资料 FSettleId_FNumber结算方FSettleId.FNumber基础资料 FChargeId_FNumber收款方FChargeId.FNumber基础资料 FCorrespondOrgId_FNumber对应组织FCorrespondOrgId.FNumber组织 FAssignSupplierId_FNumber指定供应商FAssignSupplierId.FNumber基础资料 FMaterialId_FNumber物料编码FMaterialId.FNumber基础资料 FBarcode零售条形码FBarcode文本 FQty采购数量FQty数量 FDeliveryDate交货日期FDeliveryDate长日期 FLocation交货地点FLocation多行文本 FLocationAddress交货地址FLocationAddress多行文本 FPrice单价FPrice单价 FTaxPrice含税单价FTaxPrice单价 FEntryDiscountRate折扣率%FEntryDiscountRate小数 FEntryDiscount折扣额FEntryDiscount折扣额 FEntryTaxRate税率%FEntryTaxRate小数 FEntryTaxAmount税额FEntryTaxAmount金额 FAllAmount价税合计FAllAmount金额 FEntryAmount金额FEntryAmount金额 FRequireOrgId_FNumber需求组织FRequireOrgId.FNumber组织 FRequireDeptId_FNumber需求部门FRequireDeptId.FNumber基础资料 FRequireStaffId_FNumber需求人FRequireStaffId.FNumber基础资料 FReceiveOrgId_FNumber收料组织FReceiveOrgId.FNumber组织 FBranchId_FNumber收货门店FBranchId.FNumber基础资料 FReceiveDeptId_FNumber收料部门FReceiveDeptId.FNumber基础资料 FEntrySettleOrgId_FNumber结算组织FEntrySettleOrgId.FNumber组织 FGiveAway是否赠品FGiveAway复选框 FEntryNote备注FEntryNote多行文本 FSupMatId供应商物料编码FSupMatId文本 FSupMatName供应商物料名称FSupMatName文本 FLot批号FLot批次 FSupplierLot供应商批号FSupplierLot文本 FReceiveQty累计收料数量FReceiveQty数量 FRemainReceiveQty剩余收料数量FRemainReceiveQty数量 FStockInQty累计入库数量FStockInQty数量 FRemainStockINQty剩余入库数量FRemainStockINQty数量 FMrbQty累计退料数量FMrbQty数量 FCHECKRETQTY收料可退数量FCHECKRETQTY数量 FSTOCKRETQTY库存可退数量FSTOCKRETQTY数量 FConsumeSumQty消耗汇总数量FConsumeSumQty数量 FSrcBillTypeId源单类型FSrcBillTypeId源单类型 FSrcBillNo源单编号FSrcBillNo源单编号 FReqTraceNo需求跟踪号FReqTraceNo文本 FMtoNo计划跟踪号FMtoNo文本 FDEMANDTYPE需求来源FDEMANDTYPE下拉列表 FDEMANDBILLNO需求单据编号FDEMANDBILLNO文本 FDEMANDBILLENTRYSEQ需求单据行号FDEMANDBILLENTRYSEQ整数 FCloseStatus关闭状态FCloseStatus整数 FIDFIDFID Limit最大行数{{PAGINATION_PAGE_SIZE}}金蝶的查询分页参数 StartRow开始行索引{{PAGINATION_START_ROW}}金蝶的查询分页参数 TopRowCount返回总行数金蝶的查询分页参数 FilterString过滤条件FApproveDate>='{{LAST_SYNC_TIME dateTime}}' and FBillTypeID.FNumber = 'CGDD02_SYS' and FCloseStatus='A'示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= FieldKeys需查询的字段key集合金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber FormId业务对象表单IdPUR_PurchaseOrder必须填写金蝶的表单ID如😛UR_PurchaseOrder

响应参数

接口字段字段名称预设值描述 FPOOrderEntry_FEntryIdid FBillNo单据编号单据编号 FSourceBillNo源单编号源单编号 FBillTypeID_FNumber单据类型单据类型 FBusinessType业务类型下拉列表 FSupplierId_FNumber供应商基础资料 FSettleModeId_FNumber结算方式基础资料 FPayConditionId_FNumber付款条件基础资料 FDate采购日期日期 FDocumentStatus单据状态单据状态 FPreMatchAmountFor预付已核销金额金额 FPayAdvanceBillId_FNumber预付单号基础资料 FPurchaseOrgId_FNumber采购组织组织 FPurchaseDeptId_FNumber采购部门基础资料 FPurchaserGroupId_FNumber采购组基础资料 FPurchaserId_FNumber采购员基础资料 FProviderId_FNumber供货方基础资料 FSettleId_FNumber结算方基础资料 FChargeId_FNumber收款方基础资料 FCorrespondOrgId_FNumber对应组织组织 FAssignSupplierId_FNumber指定供应商基础资料 FMaterialId_FNumber物料编码基础资料 FBarcode零售条形码文本 FQty采购数量数量 FDeliveryDate交货日期长日期 FLocation交货地点多行文本 FLocationAddress交货地址多行文本 FPrice单价单价 FTaxPrice含税单价单价 FEntryDiscountRate折扣率%小数 FEntryDiscount折扣额折扣额 FEntryTaxRate税率%小数 FEntryTaxAmount税额金额 FAllAmount价税合计金额 FEntryAmount金额金额 FRequireOrgId_FNumber需求组织组织 FRequireDeptId_FNumber需求部门基础资料 FRequireStaffId_FNumber需求人基础资料 FReceiveOrgId_FNumber收料组织组织 FBranchId_FNumber收货门店基础资料 FReceiveDeptId_FNumber收料部门基础资料 FEntrySettleOrgId_FNumber结算组织组织 FGiveAway是否赠品复选框 FEntryNote备注多行文本 FSupMatId供应商物料编码文本 FSupMatName供应商物料名称文本 FLot批号批次 FSupplierLot供应商批号文本 FReceiveQty累计收料数量数量 FRemainReceiveQty剩余收料数量数量 FStockInQty累计入库数量数量 FRemainStockINQty剩余入库数量数量 FMrbQty累计退料数量数量 FCHECKRETQTY收料可退数量数量 FSTOCKRETQTY库存可退数量数量 FConsumeSumQty消耗汇总数量数量 FSrcBillTypeId源单类型源单类型 FSrcBillNo源单编号源单编号 FReqTraceNo需求跟踪号文本 FMtoNo计划跟踪号文本 FDEMANDTYPE需求来源下拉列表 FDEMANDBILLNO需求单据编号文本 FDEMANDBILLENTRYSEQ需求单据行号整数 FCloseStatus关闭状态整数 FIDFIDFID

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

• API：wdt.purchase.purchaseorder.createorder
• NAME：新增采购订单
• METHOD：POST

请求参数

接口字段字段名称预设值描述 purchase_no采购单编号{{FBillNo}}采购单编号 provider_no供应商编号{{FSupplierId_FNumber}}供应商编号 remark备注备注 receive_warehouse_nos收货仓编号CK001收货仓编号 expect_warehouse_no预计入库仓库编号CK001预计入库仓库编号 prop1采购单自定义属性1{{FPurchaserId_FNumber}}采购单自定义属性1 prop2采购单自定义属性2采购单自定义属性2 purchaser_name采购员金蝶云实施测试账户采购员 is_check是否要审核true不传默认为false receive_address收货地址{{FProviderAddress}}收货地址 contact联系人{{FProviderContactId_FName}}联系人 telno电话电话 logistics_name物流名称物流名称,参考附录物流名称表 flag_name标记名称标记名称 expect_time预计到货时间{{FDeliveryDate datetime}}预计到货时间 created创建时间不传或为空,则为当前时间 pay_type付款方式11:现付 2:到付 postfee_pay_type运费支付方式0 无 1 现付 2 到付 3 包邮 post_fee邮费邮费 other_fee其他费用其他费用 purchase_details采购单详情POOrderEntry采购单详情 purchase_details.spec_no商家编码{{POOrderEntry.FMaterialId_FNumber}}商家编码 purchase_details.num采购数量{{POOrderEntry.FQty}}采购数量 purchase_details.purchase_unit_name采购单位采购单位 purchase_details.price税前单价{{POOrderEntry.FPrice}}税前单价 purchase_details.discount折扣折扣 purchase_details.tax_rate税率税率 purchase_details.objectKey数据对象params

系统对接总览

随着企业数字化业务的深入发展，对于企业的 IT 或者 CIO 来讲，正在面临一个愈发重要的问题——系统的结构太复杂了，尤其是头部企业，至少有十多套系统，这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统，如何整合企业的现有IT资源，使企业中计算机孤岛式的应用向集体协作的方向发展，发挥资源效益的最大化，降低企业成本，正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上，操作统一，以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中，轻易云应用集成平台负责实现异构、分布式系统之间互联互通，实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件，连接现有各孤立应用系统，以图形化、拖拽方式构建集成流程和服务，提高应用系统集成工作效率，降低异构系统集成风险。针对未来可能出现的业务需求变更，在应用集成平台上进行动态调整，实现各应用系统之间的集成策略平滑升级。