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

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

来源系统:金蝶云星空

金蝶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如 UR_PurchaseOrder

响应参数

接口字段	字段名称	预设值	描述
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等系统之间的数据交流与同步，为企业定制自定义的数据管理方案，用技术拓展商业边界，为新业务、新部门提供成长空间。