金蝶云星空与轻易云集成平台对接集成退货通知查询-V1连通写入空操作(退货通知查询测试V1)
数据源系统:金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
对接系统：轻易云集成平台
从API服务总线层面解决企业烟囱式业务系统集成现状相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成
系统对接接口配置
异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则，例如取数就要根据查询接口获取金蝶云星空的数据，并且根据对应的条件进行取数，目标系统就必须根据目标系统的格式，以及获取的数据进行加工处理后进行写入到轻易云集成平台中。轻易云集成平台的可视化配置轻松实现。
金蝶云星空接口明细
- API：executeBillQuery
- NAME：退货通知查询-V1
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| FBillHead | 基本信息 | FBillHead | |
| FID | 实体主键 | FID | |
| FBillNo | 单据编号 | FBillNo | |
| FDocumentStatus | 单据状态 | FDocumentStatus | |
| FSaleOrgId(必填项) | 销售组织 | FSaleOrgId(必填项) | |
| FDate(必填项) | 日期 | FDate(必填项) | |
| FSalesManId | 销售员 | FSalesManId | |
| FRetorgId(必填项) | 库存组织 | FRetorgId(必填项) | |
| FSaledeptid | 销售部门 | FSaledeptid | |
| FSaleGroupId | 销售组 | FSaleGroupId | |
| FRetDeptId | 库存部门 | FRetDeptId | |
| FStockerId | 仓管员 | FStockerId | |
| FStockerGroupId | 库存组 | FStockerGroupId | |
| FRetcustId(必填项) | 退货客户 | FRetcustId(必填项) | |
| FPayCusId | 付款方 | FPayCusId | |
| FSettleCusId | 结算方 | FSettleCusId | |
| FReceiveCusId | 收货方 | FReceiveCusId | |
| FCreatorId | 创建人 | FCreatorId | |
| FCancelDate | 作废日期 | FCancelDate | |
| FCancelStatus | 作废状态 | FCancelStatus | |
| FModifyDate | 最后修改日期 | FModifyDate | |
| FApproveDate | 审核日期 | FApproveDate | |
| FCreateDate | 创建日期 | FCreateDate | |
| FApproverId | 审核人 | FApproverId | |
| FCancellerId | 作废人 | FCancellerId | |
| FModifierId | 最后修改人 | FModifierId | |
| FBillTypeID(必填项) | 单据类型 | FBillTypeID(必填项) | |
| FOwnerTypeIdHead | 货主类型 | FOwnerTypeIdHead | |
| FOwnerIdHead | 货主 | FOwnerIdHead | |
| FBussinessType | 业务类型 | FBussinessType | |
| FReturnReason | 退货原因 | FReturnReason | |
| FReceiveAddress | 收货方地址 | FReceiveAddress | |
| FHeadLocId | 交货地点 | FHeadLocId | |
| FCreditCheckResult | 信用检查结果 | FCreditCheckResult | |
| FCorrespondOrgId | 对应组织 | FCorrespondOrgId | |
| FReceiveCusContact | 收货方联系人 | FReceiveCusContact | |
| FDescription | 基本信息备注 | FDescription | |
| FEntity | 明细信息 | FEntity | |
| FEntity_FENTRYID | 明细实体主键 | FENTRYID | |
| FMaterialId(必填项) | 物料编码 | FMaterialId(必填项) | |
| FMaterialName | 物料名称 | FMaterialName | |
| FMaterialModel | 规格型号 | FMaterialModel | |
| FMaterialType | 物料类别 | FMaterialType | |
| FQty | 销售数量 | FQty | |
| FBOMId | BOM版本 | FBOMId | |
| FExpiryDate | 有效期至 | FExpiryDate | |
| FASEUNITID(必填项) | 基本单位 | FASEUNITID(必填项) | |
| FBaseUnitQty | 销售基本数量 | FBaseUnitQty | |
| FEntryDescription | 明细备注 | FEntryDescription | |
| FOrderNo | 订单单号 | FOrderNo | |
| FJoinRetQty | 关联退货数量 | FJoinRetQty | |
| FBaseJoinretQty | 关联退货数量（基本单位） | FBaseJoinretQty | |
| FUnitID(必填项) | 销售单位 | FUnitID(必填项) | |
| FAuxpropId | 辅助属性 | FAuxpropId | |
| FBaseSumRetQty | 累计退货数量（基本单位） | FBaseSumRetQty | |
| FSumRetQty | 累计退货数量 | FSumRetQty | |
| FSrcType | 源单类型 | FSrcType | |
| FPRODUCEDATE | 生产日期 | FPRODUCEDATE | |
| FExpUnit | 保质期单位 | FExpUnit | |
| FExpPeriod | 保质期 | FExpPeriod | |
| FMapId | 客户物料编码 | FMapId | |
| FMapName | 客户物料名称 | FMapName | |
| FLot | 批号 | FLot | |
| FRmType(必填项) | 退货类型 | FRmType(必填项) | |
| FPriceUnitId | 计价单位 | FPriceUnitId | |
| FPriceUnitQty | 计价数量 | FPriceUnitQty | |
| FPrice | 单价 | FPrice | |
| FTaxPrice | 含税单价 | FTaxPrice | |
| FTaxCombination | 税组合 | FTaxCombination | |
| FEntryTaxRate | 税率% | FEntryTaxRate | |
| FPriceCoefficient | 价格系数 | FPriceCoefficient | |
| FSysPrice | 系统定价 | FSysPrice | |
| FLimitDownPrice | 最低限价 | FLimitDownPrice | |
| FBefDisAmt | 折前金额 | FBefDisAmt | |
| FBefDisAllAmt | 折前价税合计 | FBefDisAllAmt | |
| FDiscountRate | 折扣率% | FDiscountRate | |
| FDiscount | 折扣额 | FDiscount | |
| FAmount | 金额 | FAmount | |
| FAmount_LC | 金额（本位币） | FAmount_LC | |
| FEntryTaxAmount | 税额 | FEntryTaxAmount | |
| FTaxAmount_LC | 明细税额（本位币） | FTaxAmount_LC | |
| FAllAmount | 价税合计 | FAllAmount | |
| FAllAmount_LC | 价税合计（本位币） | FAllAmount_LC | |
| FIsFree | 是否赠品 | FIsFree | |
| FTaxNetPrice | 净价 | FTaxNetPrice | |
| FDeliverydate(必填项) | 退货日期 | FDeliverydate(必填项) | |
| FIsInventory | 物料允许库存属性 | FIsInventory | |
| FBFLowId | 业务流程 | FBFLowId | |
| FSrcBillNo | 源单编号 | FSrcBillNo | |
| FStockId | 仓库 | FStockId | |
| FSOBILLTYPEID | 订单类型 | FSOBILLTYPEID | |
| FMtoNo | 计划跟踪号 | FMtoNo | |
| FInventoryQty | 当前库存 | FInventoryQty | |
| FPriceBaseQty | 计价基本数量 | FPriceBaseQty | |
| FCheckQty | 已检验数量 | FCheckQty | |
| FBaseCheckQty | 已检验数量(基本单位) | FBaseCheckQty | |
| FQualifiedQty | 合格判退数量 | FQualifiedQty | |
| FBaseQualifiedQty | 合格判退数量(基本单位) | FBaseQualifiedQty | |
| FUnqualifiedQty | 不合格判退数量 | FUnqualifiedQty | |
| FBaseUnqualifiedQty | 不合格判退数量(基本单位) | FBaseUnqualifiedQty | |
| FJunkedQty | 报废判退数量 | FJunkedQty | |
| FBaseJunkedQty | 报废判退数量(基本单位) | FBaseJunkedQty | |
| FJoinCheckQty | 关联检验数量 | FJoinCheckQty | |
| FBaseJoinCheckQty | 关联检验数量(基本单位) | FBaseJoinCheckQty | |
| FJoinQualifiedQty | 关联合格判退数量 | FJoinQualifiedQty | |
| FBaseJoinQualifiedQty | 关联合格判退数量(基本单位) | FBaseJoinQualifiedQty | |
| FJoinJunkedQty | 关联报废判退数量 | FJoinJunkedQty | |
| FBaseJoinJunkedQty | 关联报废判退数量(基本单位) | FBaseJoinJunkedQty | |
| FJoinUnqualifiedQty | 关联不合格判退数量 | FJoinUnqualifiedQty | |
| FBaseJoinUnqualifiedQty | 关联不合格判退数量(基本单位) | FBaseJoinUnqualifiedQty | |
| FStockUnitID | 库存单位 | FStockUnitID | |
| FStockQty | 库存数量 | FStockQty | |
| FStockBaseQty | 库存基本数量 | FStockBaseQty | |
| FStockBaseJoinRetQty | 关联退货数量（库存基本） | FStockBaseJoinRetQty | |
| FStockBaseSumRetQty | 累计退货数量（库存基本） | FStockBaseSumRetQty | |
| FSalBaseNum | 销售基本分子 | FSalBaseNum | |
| FStockBaseDen | 库存基本分母 | FStockBaseDen | |
| FSRCBIZUNITID | 携带的主业务单位 | FSRCBIZUNITID | |
| FOwnerTypeID | 明细货主类型 | FOwnerTypeID | |
| FOwnerID(必填项) | 明细货主 | FOwnerID(必填项) | |
| FRefuseFlag | 拒收标志 | FRefuseFlag | |
| FSOEntryId | 销售订单EntryId | FSOEntryId | |
| FIsReturnCheck | 退货检验 | FIsReturnCheck | |
| FRowType | 产品类型 | FRowType | |
| FParentMatId | 父项产品 | FParentMatId | |
| FRowId | 行标识 | FRowId | |
| FParentRowId | 父行标识 | FParentRowId | |
| FPriceDiscount | 单价折扣 | FPriceDiscount | |
| SubHeadEntity | 财务信息 | SubHeadEntity | |
| SubHeadEntity_FEntryId | 财务实体主键 | FEntryId | |
| FSettleOrgId(必填项) | 结算组织 | FSettleOrgId(必填项) | |
| FChageCondition | 收款条件 | FChageCondition | |
| FSettleTypeId | 结算方式 | FSettleTypeId | |
| FSettleCurrId(必填项) | 结算币别 | FSettleCurrId(必填项) | |
| FExchangeTypeId | 汇率类型 | FExchangeTypeId | |
| FExchangeRate | 汇率 | FExchangeRate | |
| FLocalCurrId | 本位币 | FLocalCurrId | |
| FDiscountListId | 折扣表 | FDiscountListId | |
| FBillAllAmount | 明细价税合计 | FBillAllAmount | |
| FBillAmount | 明细金额 | FBillAmount | |
| FBillTaxAmount | 明细税额 | FBillTaxAmount | |
| FBillAmount_LC | 明细金额（本位币） | FBillAmount_LC | |
| FBillAllAmount_LC | 明细价税合计（本位币） | FBillAllAmount_LC | |
| FIsIncludedTax | 是否含税 | FIsIncludedTax | |
| FBillTaxAmount_LC | 税务税额（本位币） | FBillTaxAmount_LC | |
| FPriceListId | 价目表 | FPriceListId | |
| FIsPriceExcludeTax | 价外税 | FIsPriceExcludeTax | |
| FTaxDetailSubEntity | 税务明细 | FTaxDetailSubEntity | |
| FDetailID | 税务实体主键 | FDetailID | |
| FTaxRateId | 税率名称 | FTaxRateId | |
| FTaxRate | 税务税率% | FTaxRate | |
| FTaxAmount | 税务税额 | FTaxAmount | |
| FCostPercent | 计入成本比例% | FCostPercent | |
| FCostAmount | 计入成本金额 | FCostAmount | |
| FVAT | 增值税 | FVAT | |
| FSellerWithholding | 卖方代扣代缴 | FSellerWithholding | |
| FBuyerWithholding | 买方代扣代缴 | FBuyerWithholding | |
| Limit | 最大行数 | {{PAGINATION_PAGE_SIZE}} | 金蝶的查询分页参数 |
| StartRow | 开始行索引 | {{PAGINATION_START_ROW}} | 金蝶的查询分页参数 |
| TopRowCount | 返回总行数 | | 金蝶的查询分页参数 |
| FilterString | 过滤条件 | FApproveDate>='{{LAST_SYNC_TIME dateTime}}' | 示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= |
| FieldKeys | 需查询的字段key集合 | | 金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber |
| FormId | 业务对象表单Id | SAL_RETURNNOTICE | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| FBillHead | 基本信息 | | |
| FID | 实体主键 | | |
| FBillNo | 单据编号 | | |
| FDocumentStatus | 单据状态 | | |
| FSaleOrgId(必填项) | 销售组织 | | |
| FDate(必填项) | 日期 | | |
| FSalesManId | 销售员 | | |
| FRetorgId(必填项) | 库存组织 | | |
| FSaledeptid | 销售部门 | | |
| FSaleGroupId | 销售组 | | |
| FRetDeptId | 库存部门 | | |
| FStockerId | 仓管员 | | |
| FStockerGroupId | 库存组 | | |
| FRetcustId(必填项) | 退货客户 | | |
| FPayCusId | 付款方 | | |
| FSettleCusId | 结算方 | | |
| FReceiveCusId | 收货方 | | |
| FCreatorId | 创建人 | | |
| FCancelDate | 作废日期 | | |
| FCancelStatus | 作废状态 | | |
| FModifyDate | 最后修改日期 | | |
| FApproveDate | 审核日期 | | |
| FCreateDate | 创建日期 | | |
| FApproverId | 审核人 | | |
| FCancellerId | 作废人 | | |
| FModifierId | 最后修改人 | | |
| FBillTypeID(必填项) | 单据类型 | | |
| FOwnerTypeIdHead | 货主类型 | | |
| FOwnerIdHead | 货主 | | |
| FBussinessType | 业务类型 | | |
| FReturnReason | 退货原因 | | |
| FReceiveAddress | 收货方地址 | | |
| FHeadLocId | 交货地点 | | |
| FCreditCheckResult | 信用检查结果 | | |
| FCorrespondOrgId | 对应组织 | | |
| FReceiveCusContact | 收货方联系人 | | |
| FDescription | 基本信息备注 | | |
| FEntity | 明细信息 | | |
| FEntity_FENTRYID | 明细实体主键 | | |
| FMaterialId(必填项) | 物料编码 | | |
| FMaterialName | 物料名称 | | |
| FMaterialModel | 规格型号 | | |
| FMaterialType | 物料类别 | | |
| FQty | 销售数量 | | |
| FBOMId | BOM版本 | | |
| FExpiryDate | 有效期至 | | |
| FASEUNITID(必填项) | 基本单位 | | |
| FBaseUnitQty | 销售基本数量 | | |
| FEntryDescription | 明细备注 | | |
| FOrderNo | 订单单号 | | |
| FJoinRetQty | 关联退货数量 | | |
| FBaseJoinretQty | 关联退货数量（基本单位） | | |
| FUnitID(必填项) | 销售单位 | | |
| FAuxpropId | 辅助属性 | | |
| FBaseSumRetQty | 累计退货数量（基本单位） | | |
| FSumRetQty | 累计退货数量 | | |
| FSrcType | 源单类型 | | |
| FPRODUCEDATE | 生产日期 | | |
| FExpUnit | 保质期单位 | | |
| FExpPeriod | 保质期 | | |
| FMapId | 客户物料编码 | | |
| FMapName | 客户物料名称 | | |
| FLot | 批号 | | |
| FRmType(必填项) | 退货类型 | | |
| FPriceUnitId | 计价单位 | | |
| FPriceUnitQty | 计价数量 | | |
| FPrice | 单价 | | |
| FTaxPrice | 含税单价 | | |
| FTaxCombination | 税组合 | | |
| FEntryTaxRate | 税率% | | |
| FPriceCoefficient | 价格系数 | | |
| FSysPrice | 系统定价 | | |
| FLimitDownPrice | 最低限价 | | |
| FBefDisAmt | 折前金额 | | |
| FBefDisAllAmt | 折前价税合计 | | |
| FDiscountRate | 折扣率% | | |
| FDiscount | 折扣额 | | |
| FAmount | 金额 | | |
| FAmount_LC | 金额（本位币） | | |
| FEntryTaxAmount | 税额 | | |
| FTaxAmount_LC | 明细税额（本位币） | | |
| FAllAmount | 价税合计 | | |
| FAllAmount_LC | 价税合计（本位币） | | |
| FIsFree | 是否赠品 | | |
| FTaxNetPrice | 净价 | | |
| FDeliverydate(必填项) | 退货日期 | | |
| FIsInventory | 物料允许库存属性 | | |
| FBFLowId | 业务流程 | | |
| FSrcBillNo | 源单编号 | | |
| FStockId | 仓库 | | |
| FSOBILLTYPEID | 订单类型 | | |
| FMtoNo | 计划跟踪号 | | |
| FInventoryQty | 当前库存 | | |
| FPriceBaseQty | 计价基本数量 | | |
| FCheckQty | 已检验数量 | | |
| FBaseCheckQty | 已检验数量(基本单位) | | |
| FQualifiedQty | 合格判退数量 | | |
| FBaseQualifiedQty | 合格判退数量(基本单位) | | |
| FUnqualifiedQty | 不合格判退数量 | | |
| FBaseUnqualifiedQty | 不合格判退数量(基本单位) | | |
| FJunkedQty | 报废判退数量 | | |
| FBaseJunkedQty | 报废判退数量(基本单位) | | |
| FJoinCheckQty | 关联检验数量 | | |
| FBaseJoinCheckQty | 关联检验数量(基本单位) | | |
| FJoinQualifiedQty | 关联合格判退数量 | | |
| FBaseJoinQualifiedQty | 关联合格判退数量(基本单位) | | |
| FJoinJunkedQty | 关联报废判退数量 | | |
| FBaseJoinJunkedQty | 关联报废判退数量(基本单位) | | |
| FJoinUnqualifiedQty | 关联不合格判退数量 | | |
| FBaseJoinUnqualifiedQty | 关联不合格判退数量(基本单位) | | |
| FStockUnitID | 库存单位 | | |
| FStockQty | 库存数量 | | |
| FStockBaseQty | 库存基本数量 | | |
| FStockBaseJoinRetQty | 关联退货数量（库存基本） | | |
| FStockBaseSumRetQty | 累计退货数量（库存基本） | | |
| FSalBaseNum | 销售基本分子 | | |
| FStockBaseDen | 库存基本分母 | | |
| FSRCBIZUNITID | 携带的主业务单位 | | |
| FOwnerTypeID | 明细货主类型 | | |
| FOwnerID(必填项) | 明细货主 | | |
| FRefuseFlag | 拒收标志 | | |
| FSOEntryId | 销售订单EntryId | | |
| FIsReturnCheck | 退货检验 | | |
| FRowType | 产品类型 | | |
| FParentMatId | 父项产品 | | |
| FRowId | 行标识 | | |
| FParentRowId | 父行标识 | | |
| FPriceDiscount | 单价折扣 | | |
| SubHeadEntity | 财务信息 | | |
| SubHeadEntity_FEntryId | 财务实体主键 | | |
| FSettleOrgId(必填项) | 结算组织 | | |
| FChageCondition | 收款条件 | | |
| FSettleTypeId | 结算方式 | | |
| FSettleCurrId(必填项) | 结算币别 | | |
| FExchangeTypeId | 汇率类型 | | |
| FExchangeRate | 汇率 | | |
| FLocalCurrId | 本位币 | | |
| FDiscountListId | 折扣表 | | |
| FBillAllAmount | 明细价税合计 | | |
| FBillAmount | 明细金额 | | |
| FBillTaxAmount | 明细税额 | | |
| FBillAmount_LC | 明细金额（本位币） | | |
| FBillAllAmount_LC | 明细价税合计（本位币） | | |
| FIsIncludedTax | 是否含税 | | |
| FBillTaxAmount_LC | 税务税额（本位币） | | |
| FPriceListId | 价目表 | | |
| FIsPriceExcludeTax | 价外税 | | |
| FTaxDetailSubEntity | 税务明细 | | |
| FDetailID | 税务实体主键 | | |
| FTaxRateId | 税率名称 | | |
| FTaxRate | 税务税率% | | |
| FTaxAmount | 税务税额 | | |
| FCostPercent | 计入成本比例% | | |
| FCostAmount | 计入成本金额 | | |
| FVAT | 增值税 | | |
| FSellerWithholding | 卖方代扣代缴 | | |
| FBuyerWithholding | 买方代扣代缴 | | |
轻易云集成平台接口明细
- 调用接口：写入空操作
- 接口名称：写入空操作
- 方法：POST
数据对接效果
将传统的统计分析转变为预测分析，从被动分析到主动分析，从非实时分析转变为实时分析，从结构化的数据变成多元化的数据。精准查询数据流同步状况，实时监管队列任务以及数据资产的有序管理。为业务赋能，降本增效，让企业能够更加合理的布局团队；结合业务需求实现与OA，CRM，WMS等系统之间的数据交流与同步，为企业定制自定义的数据管理方案，用技术拓展商业边界，为新业务、新部门提供成长空间。
