金蝶云星空对接打通金蝶云星空销售退货查询接口与[旺店通][销售退货单标准新增]-v1接口
接通系统:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上,提供了标准的管理模式;通过标准的业务架构:多会计准则、多币别、多地点、多组织、多税制应用框架等,有效支持企业的运营管理;K/3Cloud提供了标准的业务建模:35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合,288个业务服务构件,让企业及伙伴可快速构建出行业化及个性化的应用。
对接系统:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践,面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司,提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于:集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
多系统对接方案配置
通过轻易云系统数据集成平台新增创建集成方案,然后在数据源平台中选择对应的源平台为:金蝶云星空,并且选择对应的连接器(关于金蝶云星空的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息)。选择对应的销售退货查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空,并且选择对应连接器。选择对应的[旺店通][销售退货单标准新增]-v1接口作为数据写入动作,既可以完成第一步的数据对接配置;打破跨系统连接,让数据轻易互通成为现实。
金蝶云星空接口明细
- 接口:executeBillQuery
- 接口名称:销售退货查询
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
FID | 实体主键 | String | |
FBillNo | 单据编号 | String | |
FDocumentStatus | 单据状态 | String | |
FSaleOrgId | 销售组织 | String | |
FDate | 日期 | String | |
FStockOrgId | 库存组织 | String | |
FRetcustId | 退货客户 | String | |
FStockerGroupId | 库存组 | String | |
FStockerId | 仓管员 | String | |
FStockDeptId | 库存部门 | String | |
FSaleGroupId | 销售组 | String | |
FSaledeptid | 销售部门 | String | |
FSalesManId | 销售员 | String | |
FSettleCustId | 结算方 | String | |
FPayCustId | 付款方 | String | |
FCreatorId | 创建人 | String | |
FCreateDate | 创建日期 | String | |
FModifierId | 最后修改人 | String | |
FModifyDate | 最后修改日期 | String | |
FApproverId | 审核人 | String | |
FApproveDate | 审核日期 | String | |
FCancellerId | 作废人 | String | |
FCancelDate | 作废日期 | String | |
FCancelStatus | 作废状态 | String | |
FBillTypeID | 单据类型 | String | |
FReceiveCustId | 收货方 | String | |
FOwnerTypeIdHead | 货主类型 | String | |
FOwnerIdHead | 货主 | String | |
FBussinessType | 业务类型 | String | |
FReturnReason | 退货原因 | String | |
FReceiveAddress | 收货方地址 | String | |
FHeadLocId | 交货地点 | String | |
FCreditCheckResult | 信用检查结果 | String | |
FTransferBizType | 跨组织业务类型 | String | |
FCorrespondOrgId | 对应组织 | String | |
FReceiveCusContact | 收货方联系人 | String | |
FIsInterLegalPerson | 组织间结算跨法人标识 | String | |
FHeadNote | 备注 | String | |
FIsTotalServiceOrCost | 整单服务标识 | String | |
FGenFromPOS_CMK | 零售单日结生成 | String | |
FBranchId | 销售门店 | String | |
FSHOPNUMBER | 网店编码 | String | |
FGYDATE | 管易退货日期 | String | |
FSALECHANNEL | 销售渠道 | String | |
FGYExpressNo | 管易物流单号 | String | |
Fentity | 明细信息 | Array | |
Fentity.FENTRYID | 实体主键 | String | |
Fentity.FMaterialId | 物料编码 | String | |
Fentity.FMaterialName | 物料名称 | String | |
Fentity.FMaterialModel | 规格型号 | String | |
Fentity.FMaterialType | 物料类别 | String | |
Fentity.FUnitID | 库存单位 | String | |
Fentity.FMustqty | 应退数量 | String | |
Fentity.FRealQty | 实退数量 | String | |
Fentity.FStockId | 仓库 | String | |
Fentity.FStockstatusId | 库存状态 | String | |
Fentity.FOwnerTypeId | 货主类型 | String | |
Fentity.FOwnerId | 货主 | String | |
Fentity.FKeeperTypeId | 保管者类型 | String | |
Fentity.FKeeperId | 保管者 | String | |
Fentity.FBOMId | BOM版本 | String | |
Fentity.FAuxpropId | 辅助属性 | String | |
Fentity.FProduceDate | 生产日期 | String | |
Fentity.FExpiryDate | 有效期至 | String | |
Fentity.FBaseunitId | 基本单位 | String | |
Fentity.FBaseunitQty | 库存基本数量 | String | |
Fentity.FAuxUnitId | 库存辅单位 | String | |
Fentity.FAuxUnitQty | 库存辅单位数量 | String | |
Fentity.FCostPrice | 成本价(本位币) | String | |
Fentity.FEntryCostAmount | 总成本 | String | |
Fentity.FOrderNo | 订单单号 | String | |
Fentity.FNote | 备注 | String | |
Fentity.FInvoicedQty | 关联应收数量(计价) | String | |
Fentity.FBaseInvoicedQty | (作废)关联开票数量(基本单位) | String | |
Fentity.FSumInvoicedQty | 累计应收数量(销售) | String | |
Fentity.FSumInvoicedAmt | (作废)累计开票金额 | String | |
Fentity.FSumRecievedAmt | 累计收款金额 | String | |
Fentity.FStockFlag | 库存更新标示 | String | |
Fentity.FSrcBillTypeID | 源单类型 | String | |
Fentity.FExpUnit | 保质期单位 | String | |
Fentity.FExpPeriod | 保质期 | String | |
Fentity.FStocklocId | 仓位 | String | |
Fentity.FF100001 | 仓位 | String | |
Fentity.FMapId | 客户物料编码 | String | |
Fentity.FMapName | 客户物料名称 | String | |
Fentity.FLot | 批号 | String | |
Fentity.FReturnType | 退货类型 | String | |
Fentity.FBaseSumInvoicedQty | (作废)累计开票数量(基本单位) | String | |
Fentity.FCostAmount_LC | 总成本(本位币) | String | |
Fentity.FPriceUnitId | 计价单位 | String | |
Fentity.FPriceUnitQty | 计价数量 | String | |
Fentity.FPrice | 单价 | String | |
Fentity.FTaxPrice | 含税单价 | String | |
Fentity.FTaxCombination | 税组合 | String | |
Fentity.FEntryTaxRate | 税率% | String | |
Fentity.FPriceCoefficient | 价格系数 | String | |
Fentity.FSysPrice | 系统定价 | String | |
Fentity.FLimitDownPrice | 最低限价 | String | |
Fentity.FBefDisAmt | 折前金额 | String | |
Fentity.FBefDisAllAmt | 折前价税合计 | String | |
Fentity.FDiscountRate | 折扣率% | String | |
Fentity.FDiscount | 折扣额 | String | |
Fentity.FAmount | 金额 | String | |
Fentity.FAmount_LC | 金额(本位币) | String | |
Fentity.FEntryTaxAmount | 税额 | String | |
Fentity.FTaxAmount_LC | 税额(本位币) | String | |
Fentity.FAllAmount | 价税合计 | String | |
Fentity.FAllAmount_LC | 价税合计(本位币) | String | |
Fentity.FIsFree | 是否赠品 | String | |
Fentity.FTaxNetPrice | 净价 | String | |
Fentity.FDeliveryDate | 退货日期 | String | |
Fentity.FBaseARJoinQty | 关联应收数量(计价基本) | String | |
Fentity.FBFLowId | 业务流程 | String | |
Fentity.FBASEARQTY | 累计应收数量(销售基本) | String | |
Fentity.FARJOINAMOUNT | 关联应收金额 | String | |
Fentity.FARAMOUNT | 累计应收金额 | String | |
Fentity.FSalCostPrice | 销售成本价 | String | |
Fentity.FSrcBillNo | 源单编号 | String | |
Fentity.FSOBILLTYPEID | 订单类型 | String | |
Fentity.FSNUnitID | 序列号单位 | String | |
Fentity.FSNQty | 序列号单位数量 | String | |
Fentity.FMtoNo | 计划跟踪号 | String | |
Fentity.FProjectNo | 项目编号 | String | |
Fentity.FRefuseFlag | 拒收标志 | String | |
Fentity.FISCONSUMESUM | 消耗汇总 | String | |
Fentity.FExtAuxUnitId | 辅单位 | String | |
Fentity.FExtAuxUnitQty | 实退数量(辅单位) | String | |
Fentity.FInventoryQty | 当前库存 | String | |
Fentity.FPriceBaseQty | 计价基本数量 | String | |
Fentity.FSalUnitID | 销售单位 | String | |
Fentity.FSalUnitQty | 销售数量 | String | |
Fentity.FSalBaseQty | 销售基本数量 | String | |
Fentity.FQualifyType | 质量类型 | String | |
Fentity.FSalBaseNum | 销售基本分子 | String | |
Fentity.FStockBaseDen | 库存基本分母 | String | |
Fentity.FStockBaseARJoinQty | 关联应收数量(库存基本) | String | |
Fentity.FSRCBIZUNITID | 携带的主业务单位 | String | |
Fentity.FEOwnerSupplierId | 明细货主供应商 | String | |
Fentity.FIsOverLegalOrg | 组织间结算跨法人标识 | String | |
Fentity.FESettleCustomerId | 明细结算组织客户 | String | |
Fentity.FSalBaseARJoinQty | 关联应收数量(销售基本) | String | |
Fentity.FPriceListEntry | 行价目表 | String | |
Fentity.FARNOTJOINQTY | 未关联应收数量(计价单位) | String | |
Fentity.FSOEntryId | 销售订单EntryId | String | |
Fentity.FIsReturnCheck | 退货检验 | String | |
Fentity.FRowType | 产品类型 | String | |
Fentity.FParentMatId | 父项产品 | String | |
Fentity.FRowId | 行标识 | String | |
Fentity.FParentRowId | 父行标识 | String | |
Fentity.FThirdEntryId | 管易订单单号 | String | |
Fentity.FETHIRDBILLID | 第三方单据ID | String | |
Fentity.FETHIRDBILLNO | 第三方单据编号 | String | |
Fentity.FServiceContext | 服务上下文 | String | |
Fentity.FProPrice | 门店供货价 | String | |
Fentity.FProAmount | 供货金额 | String | |
Fentity.FBarcode | 零售条形码 | String | |
Fentity.FGYFINSTATUS | 管易是否到账 | String | |
Fentity.FGYFINDate | 管易到账时间 | String | |
Fentity.FPriceDiscount | 单价折扣 | String | |
Fentity.FTailDiffFlag | 尾差处理标识 | String | |
Fentity.FWRITEOFFPRICEBASEQTY | 冲销数量(计价基本) | String | |
Fentity.FWRITEOFFSALEBASEQTY | 冲销数量(销售基本) | String | |
Fentity.FWRITEOFFSTOCKBASEQTY | 冲销数量(库存基本) | String | |
Fentity.FWRITEOFFAMOUNT | 冲销金额 | String | |
Fentity.FSettleBySon | 按子项结算 | String | |
Fentity.FBOMEntryId | BOM分录内码 | String | |
Fentity.F_out_id | 外部ID | String | |
Fentity.F_out_no | 外部编码 | String | |
Fentity.F_out_type | 外部业务类型 | String | |
Fentity.F_ZHHB_Text | 开户单号 | String | |
Fentity.Limit | 最大行数 | string | 金蝶的查询分页参数 |
Fentity.StartRow | 开始行索引 | string | 金蝶的查询分页参数 |
Fentity.TopRowCount | 返回总行数 | int | 金蝶的查询分页参数 |
Fentity.FilterString | 过滤条件 | string | 示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= |
Fentity.FieldKeys | 需查询的字段key集合 | array | 金蝶分录主键ID格式:FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber |
Fentity.FormId | 业务对象表单Id | string | 必须填写金蝶的表单ID如:PUR_PurchaseOrder |
响应参数
字段 | 名称 | 类型 | 描述 |
FID | 实体主键 | String | |
FBillNo | 单据编号 | String | |
FDocumentStatus | 单据状态 | String | |
FSaleOrgId | 销售组织 | String | |
FDate | 日期 | String | |
FStockOrgId | 库存组织 | String | |
FRetcustId | 退货客户 | String | |
FStockerGroupId | 库存组 | String | |
FStockerId | 仓管员 | String | |
FStockDeptId | 库存部门 | String | |
FSaleGroupId | 销售组 | String | |
FSaledeptid | 销售部门 | String | |
FSalesManId | 销售员 | String | |
FSettleCustId | 结算方 | String | |
FPayCustId | 付款方 | String | |
FCreatorId | 创建人 | String | |
FCreateDate | 创建日期 | String | |
FModifierId | 最后修改人 | String | |
FModifyDate | 最后修改日期 | String | |
FApproverId | 审核人 | String | |
FApproveDate | 审核日期 | String | |
FCancellerId | 作废人 | String | |
FCancelDate | 作废日期 | String | |
FCancelStatus | 作废状态 | String | |
FBillTypeID | 单据类型 | String | |
FReceiveCustId | 收货方 | String | |
FOwnerTypeIdHead | 货主类型 | String | |
FOwnerIdHead | 货主 | String | |
FBussinessType | 业务类型 | String | |
FReturnReason | 退货原因 | String | |
FReceiveAddress | 收货方地址 | String | |
FHeadLocId | 交货地点 | String | |
FCreditCheckResult | 信用检查结果 | String | |
FTransferBizType | 跨组织业务类型 | String | |
FCorrespondOrgId | 对应组织 | String | |
FReceiveCusContact | 收货方联系人 | String | |
FIsInterLegalPerson | 组织间结算跨法人标识 | String | |
FHeadNote | 备注 | String | |
FIsTotalServiceOrCost | 整单服务标识 | String | |
FGenFromPOS_CMK | 零售单日结生成 | String | |
FBranchId | 销售门店 | String | |
FSHOPNUMBER | 网店编码 | String | |
FGYDATE | 管易退货日期 | String | |
FSALECHANNEL | 销售渠道 | String | |
FGYExpressNo | 管易物流单号 | String | |
Fentity | 明细信息 | Array | |
FENTRYID | 实体主键 | String | |
FMaterialId | 物料编码 | String | |
FMaterialName | 物料名称 | String | |
FMaterialModel | 规格型号 | String | |
FMaterialType | 物料类别 | String | |
FUnitID | 库存单位 | String | |
FMustqty | 应退数量 | String | |
FRealQty | 实退数量 | String | |
FStockId | 仓库 | String | |
FStockstatusId | 库存状态 | String | |
FOwnerTypeId | 货主类型 | String | |
FOwnerId | 货主 | String | |
FKeeperTypeId | 保管者类型 | String | |
FKeeperId | 保管者 | String | |
FBOMId | BOM版本 | String | |
FAuxpropId | 辅助属性 | String | |
FProduceDate | 生产日期 | String | |
FExpiryDate | 有效期至 | String | |
FBaseunitId | 基本单位 | String | |
FBaseunitQty | 库存基本数量 | String | |
FAuxUnitId | 库存辅单位 | String | |
FAuxUnitQty | 库存辅单位数量 | String | |
FCostPrice | 成本价(本位币) | String | |
FEntryCostAmount | 总成本 | String | |
FOrderNo | 订单单号 | String | |
FNote | 备注 | String | |
FInvoicedQty | 关联应收数量(计价) | String | |
FBaseInvoicedQty | (作废)关联开票数量(基本单位) | String | |
FSumInvoicedQty | 累计应收数量(销售) | String | |
FSumInvoicedAmt | (作废)累计开票金额 | String | |
FSumRecievedAmt | 累计收款金额 | String | |
FStockFlag | 库存更新标示 | String | |
FSrcBillTypeID | 源单类型 | String | |
FExpUnit | 保质期单位 | String | |
FExpPeriod | 保质期 | String | |
FStocklocId | 仓位 | String | |
FF100001 | 仓位 | String | |
FMapId | 客户物料编码 | String | |
FMapName | 客户物料名称 | String | |
FLot | 批号 | String | |
FReturnType | 退货类型 | String | |
FBaseSumInvoicedQty | (作废)累计开票数量(基本单位) | String | |
FCostAmount_LC | 总成本(本位币) | String | |
FPriceUnitId | 计价单位 | String | |
FPriceUnitQty | 计价数量 | String | |
FPrice | 单价 | String | |
FTaxPrice | 含税单价 | String | |
FTaxCombination | 税组合 | String | |
FEntryTaxRate | 税率% | String | |
FPriceCoefficient | 价格系数 | String | |
FSysPrice | 系统定价 | String | |
FLimitDownPrice | 最低限价 | String | |
FBefDisAmt | 折前金额 | String | |
FBefDisAllAmt | 折前价税合计 | String | |
FDiscountRate | 折扣率% | String | |
FDiscount | 折扣额 | String | |
FAmount | 金额 | String | |
FAmount_LC | 金额(本位币) | String | |
FEntryTaxAmount | 税额 | String | |
FTaxAmount_LC | 税额(本位币) | String | |
FAllAmount | 价税合计 | String | |
FAllAmount_LC | 价税合计(本位币) | String | |
FIsFree | 是否赠品 | String | |
FTaxNetPrice | 净价 | String | |
FDeliveryDate | 退货日期 | String | |
FBaseARJoinQty | 关联应收数量(计价基本) | String | |
FBFLowId | 业务流程 | String | |
FBASEARQTY | 累计应收数量(销售基本) | String | |
FARJOINAMOUNT | 关联应收金额 | String | |
FARAMOUNT | 累计应收金额 | String | |
FSalCostPrice | 销售成本价 | String | |
FSrcBillNo | 源单编号 | String | |
FSOBILLTYPEID | 订单类型 | String | |
FSNUnitID | 序列号单位 | String | |
FSNQty | 序列号单位数量 | String | |
FMtoNo | 计划跟踪号 | String | |
FProjectNo | 项目编号 | String | |
FRefuseFlag | 拒收标志 | String | |
FISCONSUMESUM | 消耗汇总 | String | |
FExtAuxUnitId | 辅单位 | String | |
FExtAuxUnitQty | 实退数量(辅单位) | String | |
FInventoryQty | 当前库存 | String | |
FPriceBaseQty | 计价基本数量 | String | |
FSalUnitID | 销售单位 | String | |
FSalUnitQty | 销售数量 | String | |
FSalBaseQty | 销售基本数量 | String | |
FQualifyType | 质量类型 | String | |
FSalBaseNum | 销售基本分子 | String | |
FStockBaseDen | 库存基本分母 | String | |
FStockBaseARJoinQty | 关联应收数量(库存基本) | String | |
FSRCBIZUNITID | 携带的主业务单位 | String | |
FEOwnerSupplierId | 明细货主供应商 | String | |
FIsOverLegalOrg | 组织间结算跨法人标识 | String | |
FESettleCustomerId | 明细结算组织客户 | String | |
FSalBaseARJoinQty | 关联应收数量(销售基本) | String | |
FPriceListEntry | 行价目表 | String | |
FARNOTJOINQTY | 未关联应收数量(计价单位) | String | |
FSOEntryId | 销售订单EntryId | String | |
FIsReturnCheck | 退货检验 | String | |
FRowType | 产品类型 | String | |
FParentMatId | 父项产品 | String | |
FRowId | 行标识 | String | |
FParentRowId | 父行标识 | String | |
FThirdEntryId | 管易订单单号 | String | |
FETHIRDBILLID | 第三方单据ID | String | |
FETHIRDBILLNO | 第三方单据编号 | String | |
FServiceContext | 服务上下文 | String | |
FProPrice | 门店供货价 | String | |
FProAmount | 供货金额 | String | |
FBarcode | 零售条形码 | String | |
FGYFINSTATUS | 管易是否到账 | String | |
FGYFINDate | 管易到账时间 | String | |
FPriceDiscount | 单价折扣 | String | |
FTailDiffFlag | 尾差处理标识 | String | |
FWRITEOFFPRICEBASEQTY | 冲销数量(计价基本) | String | |
FWRITEOFFSALEBASEQTY | 冲销数量(销售基本) | String | |
FWRITEOFFSTOCKBASEQTY | 冲销数量(库存基本) | String | |
FWRITEOFFAMOUNT | 冲销金额 | String | |
FSettleBySon | 按子项结算 | String | |
FBOMEntryId | BOM分录内码 | String | |
F_out_id | 外部ID | String | |
F_out_no | 外部编码 | String | |
F_out_type | 外部业务类型 | String | |
F_ZHHB_Text | 开户单号 | String | |
金蝶云星空接口明细
- 接口:batchSave
- 接口名称:[旺店通][销售退货单标准新增]-v1
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
FBillTypeID | 单据类型 | string | 单据类型 |
FBillNo | 单据编号 | string | 单据编号 |
FSaleOrgId | 销售组织 | string | 组织 |
FDate | 日期 | string | 日期 |
FStockOrgId | 库存组织 | string | 组织 |
FRetcustId | 退货客户 | string | 基础资料 |
FHeadNote | 备注 | string | 多行文本 |
FEntity | 明细信息 | array | |
FEntity.FMaterialId | 物料编码 | string | 基础资料 |
FEntity.FRealQty | 实退数量 | string | 数量 |
FEntity.FTaxPrice | 含税单价 | string | 单价 |
FEntity.FStockId | 仓库 | string | 基础资料 |
FEntity.FNote | 备注 | string | 文本 |
FEntity.SubHeadEntity | 财务信息 | object | |
FEntity.SubHeadEntity.FSettleOrgId | 结算组织 | string | 组织 |
FEntity.SubHeadEntity.FormId | 业务对象表单Id | string | 必须填写金蝶的表单ID如:PUR_PurchaseOrder |
FEntity.SubHeadEntity.Operation | 执行的操作 | string | |
FEntity.SubHeadEntity.IsAutoSubmitAndAudit | 提交并审核 | bool | |
FEntity.SubHeadEntity.IsVerifyBaseDataField | 验证基础资料 | bool | 是否验证所有的基础资料有效性,布尔类,默认false(非必录) |
FEntity.SubHeadEntity.SubSystemId | 系统模块 | string | |
系统数据集成价值
随着企业数字化业务的深入发展,对于企业的 IT 或者 CIO 来讲,正在面临一个愈发重要的问题——系统的结构太复杂了,尤其是头部企业,至少有十多套系统,这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统,如何整合企业的现有IT资源,使企业中计算机孤岛式的应用向集体协作的方向发展,发挥资源效益的最大化,降低企业成本,正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上,操作统一,以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中,轻易云应用集成平台负责实现异构、分布式系统之间互联互通,实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件,连接现有各孤立应用系统,以图形化、拖拽方式构建集成流程和服务,提高应用系统集成工作效率,降低异构系统集成风险。针对未来可能出现的业务需求变更,在应用集成平台上进行动态调整,实现各应用系统之间的集成策略平滑升级。
系统数据对接方案元数据代码