旺店通·旗舰奇门和金蝶云星空单据接口对接
来源系统:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
接入系统：旺店通·旗舰奇门
慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。
数据对接方案
异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则，例如取数就要根据查询接口获取金蝶云星空的数据，并且根据对应的条件进行取数，目标系统就必须根据目标系统的格式，以及获取的数据进行加工处理后进行写入到旺店通·旗舰奇门中。轻易云集成平台的可视化配置轻松实现。
金蝶云星空接口明细
- API：executeBillQuery
- NAME：采购退料查询
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|---|---|---|
| FPURMRBENTRY_FEntryID | 明细信息ID | FPURMRBENTRY_FEntryID | |
| FID | 实体主键 | FID | |
| FBillNo | 单据编号 | FBillNo | |
| FDocumentStatus | 单据状态 | FDocumentStatus | |
| FStockOrgId_FNumber | 退料组织 | FStockOrgId.FNumber | |
| FDate | 退料日期 | FDate | |
| FBillTypeID_FNumber | 单据类型 | FBillTypeID.FNumber | |
| FTAKEDELIVERYNO | 提货单号 | FTAKEDELIVERYNO | |
| FSupplierID_FNumber | 供应商 | FSupplierID.FNumber | |
| FDESCRIPTION | 备注 | FDESCRIPTION | |
| FCarrierID_FNumber | 承运商 | FCarrierID.FNumber | |
| FDELIVERYNO | 送货单号 | FDELIVERYNO | |
| FPurchaseOrgId_FNumber | 采购组织 | FPurchaseOrgId.FNumber | |
| FMRTYPE | 退料类型 | FMRTYPE | |
| FMRMODE | 退料方式 | FMRMODE | |
| FMRREASON | 退料原因 | FMRREASON | |
| FREPLENISHMODE | 补料方式 | FREPLENISHMODE | |
| FCreateDate | 创建日期 | FCreateDate | |
| FModifyDate | 最后修改日期 | FModifyDate | |
| FApproveDate | 审核日期 | FApproveDate | |
| FCreatorId | 创建人 | FCreatorId | |
| FApproverId | 审核人 | FApproverId | |
| FCancelerId | 作废人 | FCancelerId | |
| FCancelDate | 作废日期 | FCancelDate | |
| FCARRYNO | 运输单号 | FCARRYNO | |
| FCancelStatus | 作废状态 | FCancelStatus | |
| FACCEPTORID_FNumber | 接收方 | FACCEPTORID.FNumber | |
| FSettleId_FNumber | 结算方 | FSettleId.FNumber | |
| FBusinessType | 业务类型 | FBusinessType | |
| FAcceptAddress | 接收方地址 | FAcceptAddress | |
| FCHARGEID_FNumber | 收款方 | FCHARGEID.FNumber | |
| FAPSTATUS | 应付状态 | FAPSTATUS | |
| FTransferBizType | 跨组织业务类型 | FTransferBizType | |
| FCorrespondOrgId_FNumber | 对应组织 | FCorrespondOrgId.FNumber | |
| FSupplyOrderNo | 订单号 | FSupplyOrderNo | |
| FPayOrgId_FNumber | 付款组织 | FPayOrgId.FNumber | |
| FSettleOrgId_FNumber | 结算组织 | FSettleOrgId.FNumber | |
| FSETTLETYPEID_FNumber | 结算方式 | FSETTLETYPEID.FNumber | |
| FPAYCONDITIONID_FNumber | 付款条件 | FPAYCONDITIONID.FNumber | |
| FSettleCurrId_FNumber | 结算币别 | FSettleCurrId.FNumber | |
| FBILLTAXAMOUNT | 税额 | FBILLTAXAMOUNT | |
| FBILLCOSTAMOUNT | 总成本 | FBILLCOSTAMOUNT | |
| FBILLALLAMOUNT | 价税合计 | FBILLALLAMOUNT | |
| FEXCHANGETYPEID_FNumber | 汇率类型 | FEXCHANGETYPEID.FNumber | |
| FIsIncludedTax | 含税 | FIsIncludedTax | |
| FBillAmount | 金额 | FBillAmount | |
| FISGENFORIOS | 跨组织结算生成 | FISGENFORIOS | |
| FSettleSupplierID_FNumber | 结算组织供应商 | FSettleSupplierID.FNumber | |
| FISPRICEEXCLUDETAX | 价外税 | FISPRICEEXCLUDETAX | |
| FISINVOICEARLIER | 先到票后入库 | FISINVOICEARLIER | |
| FTHIRDSRCTYPE | 第三方来源 | FTHIRDSRCTYPE | |
| FTHIRDBILLID | 第三方单据ID | FTHIRDBILLID | |
| FTHIRDBILLNO | 第三方单据编号 | FTHIRDBILLNO | |
| FMATERIALID_FNumber | 物料编码 | FMATERIALID.FNumber | |
| FREPLENISHQTY | 补料数量 | FREPLENISHQTY | |
| FKEAPAMTQTY | 扣款数量 | FKEAPAMTQTY | |
| FSTOCKID_FNumber | 仓库 | FSTOCKID.FNumber | |
| FStockStatusId | 库存状态 | FStockStatusId | |
| FNOTE | 备注 | FNOTE | |
| FProduceDate | 生产日期 | FProduceDate | |
| FEXPIRYDATE | 到期日 | FEXPIRYDATE | |
| FCONTRACTNO | 合同单号 | FCONTRACTNO | |
| FREQTRACENO | 需求跟踪号 | FREQTRACENO | |
| FORDERNO | 订单单号 | FORDERNO | |
| FPRICEUNITQTY | 计价数量 | FPRICEUNITQTY | |
| FCostPrice | 成本价 | FCostPrice | |
| FTAXPRICE | 含税单价 | FTAXPRICE | |
| FDISCOUNTRATE | 折扣率(%) | FDISCOUNTRATE | |
| FTAXNETPRICE | 净价 | FTAXNETPRICE | |
| FENTRYCOSTAMOUNT | 总成本 | FENTRYCOSTAMOUNT | |
| FENTRYTAXRATE | 税率 | FENTRYTAXRATE | |
| FENTRYTAXAMOUNT | 税额 | FENTRYTAXAMOUNT | |
| FALLAMOUNT | 价税合计 | FALLAMOUNT | |
| FOWNERID_FNumber | 货主 | FOWNERID.FNumber | |
| FJOINQTY | 关联数量 | FJOINQTY | |
| FRMREALQTY | 实退数量 | FRMREALQTY | |
| FRMMUSTQTY | 应退数量 | FRMMUSTQTY | |
| FSTOCKLOCID | 仓位 | FSTOCKLOCID | |
| FSRCBillTypeId | 源单类型 | FSRCBillTypeId | |
| FSRCBillNo | 源单编号 | FSRCBillNo | |
| FLot | 批号 | FLot | |
| FPrice | 单价 | FPrice | |
| FAmount | 金额 | FAmount | |
| FDiscount | 折扣额 | FDiscount | |
| FBFLowId | 业务流程 | FBFLowId | |
| FSRCSeq | 源单行号 | FSRCSeq | |
| FMtoNo | 计划跟踪号 | FMtoNo | |
| FIsStock | 是否可库存 | FIsStock | |
| FGiveAway | 是否赠品 | FGiveAway | |
| FRowId | 行标识 | FRowId | |
| FParentRowId | 父行标识 | FParentRowId | |
| FBarcode | 零售条形码 | FBarcode | |
| FPRICEUNITID | 计价单位 | FPRICEUNITID | |
| FUnitID | 库存单位 | FUnitID | |
| FCarryUnitId | 采购单位 | FCarryUnitId | |
| FCarryQty | 采购数量 | FCarryQty | |
| Limit | 最大行数 | {{PAGINATION_PAGE_SIZE}} | 金蝶的查询分页参数 |
| StartRow | 开始行索引 | {{PAGINATION_START_ROW}} | 金蝶的查询分页参数 |
| TopRowCount | 返回总行数 | 金蝶的查询分页参数 | |
| FilterString | 过滤条件 | FApproveDate>='{{LAST_SYNC_TIME dateTime}}' and FBillTypeID.FNumber = 'TLD04_SYS' | 示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= |
| FieldKeys | 需查询的字段key集合 | 金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber | |
| FormId | 业务对象表单Id | PUR_MRB | 必须填写金蝶的表单ID如
|
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|---|---|---|
| FPURMRBENTRY_FEntryID | 明细信息ID | ||
| FID | 实体主键 | ||
| FBillNo | 单据编号 | ||
| FDocumentStatus | 单据状态 | ||
| FStockOrgId_FNumber | 退料组织 | ||
| FDate | 退料日期 | ||
| FBillTypeID_FNumber | 单据类型 | ||
| FTAKEDELIVERYNO | 提货单号 | ||
| FSupplierID_FNumber | 供应商 | ||
| FDESCRIPTION | 备注 | ||
| FCarrierID_FNumber | 承运商 | ||
| FDELIVERYNO | 送货单号 | ||
| FPurchaseOrgId_FNumber | 采购组织 | ||
| FMRTYPE | 退料类型 | ||
| FMRMODE | 退料方式 | ||
| FMRREASON | 退料原因 | ||
| FREPLENISHMODE | 补料方式 | ||
| FCreateDate | 创建日期 | ||
| FModifyDate | 最后修改日期 | ||
| FApproveDate | 审核日期 | ||
| FCreatorId | 创建人 | ||
| FApproverId | 审核人 | ||
| FCancelerId | 作废人 | ||
| FCancelDate | 作废日期 | ||
| FCARRYNO | 运输单号 | ||
| FCancelStatus | 作废状态 | ||
| FACCEPTORID_FNumber | 接收方 | ||
| FSettleId_FNumber | 结算方 | ||
| FBusinessType | 业务类型 | ||
| FAcceptAddress | 接收方地址 | ||
| FCHARGEID_FNumber | 收款方 | ||
| FAPSTATUS | 应付状态 | ||
| FTransferBizType | 跨组织业务类型 | ||
| FCorrespondOrgId_FNumber | 对应组织 | ||
| FSupplyOrderNo | 订单号 | ||
| FPayOrgId_FNumber | 付款组织 | ||
| FSettleOrgId_FNumber | 结算组织 | ||
| FSETTLETYPEID_FNumber | 结算方式 | ||
| FPAYCONDITIONID_FNumber | 付款条件 | ||
| FSettleCurrId_FNumber | 结算币别 | ||
| FBILLTAXAMOUNT | 税额 | ||
| FBILLCOSTAMOUNT | 总成本 | ||
| FBILLALLAMOUNT | 价税合计 | ||
| FEXCHANGETYPEID_FNumber | 汇率类型 | ||
| FIsIncludedTax | 含税 | ||
| FBillAmount | 金额 | ||
| FISGENFORIOS | 跨组织结算生成 | ||
| FSettleSupplierID_FNumber | 结算组织供应商 | ||
| FISPRICEEXCLUDETAX | 价外税 | ||
| FISINVOICEARLIER | 先到票后入库 | ||
| FTHIRDSRCTYPE | 第三方来源 | ||
| FTHIRDBILLID | 第三方单据ID | ||
| FTHIRDBILLNO | 第三方单据编号 | ||
| FMATERIALID_FNumber | 物料编码 | ||
| FREPLENISHQTY | 补料数量 | ||
| FKEAPAMTQTY | 扣款数量 | ||
| FSTOCKID_FNumber | 仓库 | ||
| FStockStatusId | 库存状态 | ||
| FNOTE | 备注 | ||
| FProduceDate | 生产日期 | ||
| FEXPIRYDATE | 到期日 | ||
| FCONTRACTNO | 合同单号 | ||
| FREQTRACENO | 需求跟踪号 | ||
| FORDERNO | 订单单号 | ||
| FPRICEUNITQTY | 计价数量 | ||
| FCostPrice | 成本价 | ||
| FTAXPRICE | 含税单价 | ||
| FDISCOUNTRATE | 折扣率(%) | ||
| FTAXNETPRICE | 净价 | ||
| FENTRYCOSTAMOUNT | 总成本 | ||
| FENTRYTAXRATE | 税率 | ||
| FENTRYTAXAMOUNT | 税额 | ||
| FALLAMOUNT | 价税合计 | ||
| FOWNERID_FNumber | 货主 | ||
| FJOINQTY | 关联数量 | ||
| FRMREALQTY | 实退数量 | ||
| FRMMUSTQTY | 应退数量 | ||
| FSTOCKLOCID | 仓位 | ||
| FSRCBillTypeId | 源单类型 | ||
| FSRCBillNo | 源单编号 | ||
| FLot | 批号 | ||
| FPrice | 单价 | ||
| FAmount | 金额 | ||
| FDiscount | 折扣额 | ||
| FBFLowId | 业务流程 | ||
| FSRCSeq | 源单行号 | ||
| FMtoNo | 计划跟踪号 | ||
| FIsStock | 是否可库存 | ||
| FGiveAway | 是否赠品 | ||
| FRowId | 行标识 | ||
| FParentRowId | 父行标识 | ||
| FBarcode | 零售条形码 | ||
| FPRICEUNITID | 计价单位 | ||
| FUnitID | 库存单位 | ||
| FCarryUnitId | 采购单位 | ||
| FCarryQty | 采购数量 |
旺店通·旗舰奇门接口明细
- API：wdt.purchase.purchasereturn.createorder
- NAME：采购退货单新建
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|---|---|---|
| orderInfo | 采购退货单单据信息 | 采购退货单单据信息 | |
| orderInfo.outer_no | 外部单号 | {{FBillNo}}{{FSTOCKID_FNumber}} | 外部单号 |
| orderInfo.warehouse_no | 仓库编码 | {{FSTOCKID_FNumber}} | 仓库编码 |
| orderInfo.provider_no | 供应商编号 | {{FSupplierID_FNumber}} | 供应商编号 |
| orderInfo.post_fee | 邮费 | 邮费 | |
| orderInfo.other_fee | 其他费用 | 其他费用 | |
| orderInfo.contact | 联系人 | 联系人（若未传该参数，使用供应商默认的联系人） | |
| orderInfo.telno | 联系电话 | 联系电话（若未传该参数，使用供应商默认的电话） | |
| orderInfo.receive_address | 收件地址 | 收件地址（当省份、城市、区域、地址字段皆为空时，默认使用供应商的省市区及地址信息） | |
| orderInfo.receive_province | 省 | 省编码，可以查看城市代码表 | |
| orderInfo.receive_city | 市 | 市编码，可以查看城市代码表 | |
| orderInfo.receive_district | 区 | 区编码，可以查看城市代码表 | |
| orderInfo.goods_count | 货品数量 | ||
| orderInfo.remark | 备注 | {{FDESCRIPTION}} | |
| orderInfo.timestamp | 建单时间 | {{details.FCreateDate}} | |
| orderInfo.detailList | 采购退货单明细信息 | details | 采购退货单明细信息 |
| orderInfo.detailList.spec_no | 单品信息 | {{details.FMATERIALID_FNumber}} | 单品信息 |
| orderInfo.detailList.num | 退货数量 | {{details.FKEAPAMTQTY}} | 退货数量 |
| orderInfo.detailList.discount | 折扣 | 折扣，不传为默认值1 | |
| orderInfo.detailList.tax_rate | 税率 | 税率，不传默认值0 | |
| orderInfo.detailList.price | 金额 | {{details.FPrice}} | 金额，不传为默认值0 |
| orderInfo.detailList.unit_name | 基本单位 | 基本单位 | |
| orderInfo.detailList.defect | 是否残次品 | _function case '{{FStockStatusId_FNumber}}' when 'KCZT01_SYS' then 'false' else 'true' end | 是否残次品true:残次品false:正品 |
| orderInfo.detailList.is_check | 是否审核 | true | 是否审核 |
系统数据集成价值
将传统的统计分析转变为预测分析，从被动分析到主动分析，从非实时分析转变为实时分析，从结构化的数据变成多元化的数据。精准查询数据流同步状况，实时监管队列任务以及数据资产的有序管理。为业务赋能，降本增效，让企业能够更加合理的布局团队；结合业务需求实现与OA，CRM，WMS等系统之间的数据交流与同步，为企业定制自定义的数据管理方案，用技术拓展商业边界，为新业务、新部门提供成长空间。
