金蝶云星空和轻易云集成平台接口打通对接实战
数据源系统:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。
目标系统:轻易云集成平台
从API服务总线层面解决企业烟囱式业务系统集成现状相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成
数据接口配置方案
数据集成平台对应的配置金蝶云星空与轻易云集成平台的对接只要三步就能完成两个系统之间的数据对接。第一步根据金蝶云星空的接口参数要求记录在轻易云集成平台。第二步配置金蝶云星空与轻易云集成平台之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。
金蝶云星空接口明细
- 调用接口：executeBillQuery
- 接口名称：生产退料查询-V1
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| FBillHead | 单据头 | string | FBillHead |
| FID | 实体主键 | string | FID |
| FBillNo | 单据编号 | string | FBillNo |
| FDocumentStatus | 单据状态 | string | FDocumentStatus |
| FApproverId | 审核人 | string | FApproverId |
| FApproveDate | 审核日期 | string | FApproveDate |
| FModifierId | 修改人 | string | FModifierId |
| FCreateDate | 创建日期 | string | FCreateDate |
| FCreatorId | 创建人 | string | FCreatorId |
| FModifyDate | 修改日期 | string | FModifyDate |
| FCancelDate | 作废日期 | string | FCancelDate |
| FCanceler | 作废人 | string | FCanceler |
| FCancelStatus | 作废状态 | string | FCancelStatus |
| FDescription | 备注 | string | FDescription |
| FPrdOrgId(必填项) | 生产组织 | string | FPrdOrgId(必填项) |
| FStockOrgId(必填项) | 收料组织 | string | FStockOrgId(必填项) |
| FDate(必填项) | 日期 | string | FDate(必填项) |
| FWorkShopId | 生产车间 | string | FWorkShopId |
| FStockId0 | FStockId0 | string | FStockId0 |
| FBillType(必填项) | 单据类型 | string | FBillType(必填项) |
| FOwnerId0 | FOwnerId0 | string | FOwnerId0 |
| FOwnerTypeId0 | FOwnerTypeId0 | string | FOwnerTypeId0 |
| FCurrId | 本位币 | string | FCurrId |
| FTransferBizType | 跨组织业务类型 | string | FTransferBizType |
| FSTOCKERID | 仓管员 | string | FSTOCKERID |
| FReturnerId | 退料人 | string | FReturnerId |
| FIsCrossTrade | 跨法人交易 | string | FIsCrossTrade |
| FVmiBusiness | VMI业务 | string | FVmiBusiness |
| FScanBox | 序列号上传 | string | FScanBox |
| FSourceType | 倒冲来源 | string | FSourceType |
| FIsOwnerTInclOrg | 货主含组织 | string | FIsOwnerTInclOrg |
| FEntity | 明细 | string | FEntity |
| FEntryID | 明细实体主键 | string | FEntryID |
| FPPBOMEntryId | 用料清单分录ID | string | FPPBOMEntryId |
| FMaterialId(必填项) | 物料编码 | string | FMaterialId(必填项) |
| FMaterialName | 物料名称 | string | FMaterialName |
| FSpecification | 规格型号 | string | FSpecification |
| FUnitID(必填项) | 单位 | string | FUnitID(必填项) |
| FAPPQty | 申请数量 | string | FAPPQty |
| FQty | 实退数量 | string | FQty |
| FReturnType(必填项) | 退料类型 | string | FReturnType(必填项) |
| FStockId(必填项) | 仓库 | string | FStockId(必填项) |
| FMoId | 生产订单ID | string | FMoId |
| FMoBillNo | 生产订单编号 | string | FMoBillNo |
| FMoEntryId | 生产订单分录ID | string | FMoEntryId |
| FMoEntrySeq | 生产订单行号 | string | FMoEntrySeq |
| FAuxPropId | 辅助属性 | string | FAuxPropId |
| FBaseAppQty | 基本单位申请数量 | string | FBaseAppQty |
| FStockUnitId | 主库存单位 | string | FStockUnitId |
| FStockAppQty | 主库存申请数量 | string | FStockAppQty |
| FSecUnitId | 辅库存单位 | string | FSecUnitId |
| FSecStockQty | 辅库存实退数量 | string | FSecStockQty |
| FStockQty | 主库存实退数量 | string | FStockQty |
| FBaseQty | 基本单位实退数量 | string | FBaseQty |
| FMtoNo | 计划跟踪号 | string | FMtoNo |
| FProjectNo | 项目编号 | string | FProjectNo |
| FLot | 批号 | string | FLot |
| FStockStatusId(必填项) | 库存状态 | string | FStockStatusId(必填项) |
| FExpUnit | 保质期单位 | string | FExpUnit |
| FExpPeriod | 保质期 | string | FExpPeriod |
| FKeeperTypeId(必填项) | 保管者类型 | string | FKeeperTypeId(必填项) |
| FKeeperId(必填项) | 保管者 | string | FKeeperId(必填项) |
| FOperId | 工序号 | string | FOperId |
| FPrice | 成本价 | string | FPrice |
| FAmount | 总成本 | string | FAmount |
| FBomId | BOM版本 | string | FBomId |
| FStockLocId | 仓位 | string | FStockLocId |
| FProcessId | 作业 | string | FProcessId |
| FSrcBillType(必填项) | 系统源单类型 | string | FSrcBillType(必填项) |
| FSrcBillNo | 系统源单编号 | string | FSrcBillNo |
| FSelRePickedQty | 补料选单数 | string | FSelRePickedQty |
| FBaseSelRePickedQty | 基本单位补料选单数 | string | FBaseSelRePickedQty |
| FBaseUnitId | 基本单位 | string | FBaseUnitId |
| FStockFlag | 更新库存标志位 | string | FStockFlag |
| FOwnerTypeId(必填项) | 货主类型 | string | FOwnerTypeId(必填项) |
| FOwnerId(必填项) | 货主 | string | FOwnerId(必填项) |
| FEntrySrcInterId | 系统源单内码 | string | FEntrySrcInterId |
| FEntrySrcEnteryId | 系统源单分录内码 | string | FEntrySrcEnteryId |
| FEntrySrcEntrySeq | 系统源单行号 | string | FEntrySrcEntrySeq |
| FProduceDate | 生产日期 | string | FProduceDate |
| FExpiryDate | 有效期至 | string | FExpiryDate |
| FPPBomBillNo | 用料清单编号 | string | FPPBomBillNo |
| FWorkShopId1 | 车间 | string | FWorkShopId1 |
| FReturnReason | 退料原因 | string | FReturnReason |
| FEntrtyMemo | 备注1 | string | FEntrtyMemo |
| FParentOwnerTypeId | 产品货主类型 | string | FParentOwnerTypeId |
| FParentOwnerId | 产品货主 | string | FParentOwnerId |
| FBFLowId | 业务流程 | string | FBFLowId |
| FParentMaterialId | 产品编码 | string | FParentMaterialId |
| FSrcBizBillType | 业务源单类型 | string | FSrcBizBillType |
| FSrcBizBillNo | 业务源单编号 | string | FSrcBizBillNo |
| FSrcBizInterId | 业务源单内码 | string | FSrcBizInterId |
| FSrcBizEntryId | 业务源单分录内码 | string | FSrcBizEntryId |
| FSrcBizEntrySeq | 业务源单行号 | string | FSrcBizEntrySeq |
| FSNUnitID | 序列号单位 | string | FSNUnitID |
| FSNQty | 序列号单位数量 | string | FSNQty |
| FReserveType | 预留类型 | string | FReserveType |
| FBASESTOCKQTY | 主库存基本单位实退数量 | string | FBASESTOCKQTY |
| FConsome | 消耗汇总 | string | FConsome |
| FEntryVmiBusiness | VMI业务1 | string | FEntryVmiBusiness |
| FOptQueue | 工序序列 | string | FOptQueue |
| FOptPlanBillNo | 工序计划单编号 | string | FOptPlanBillNo |
| FOptPlanBillId | 工序计划单内码 | string | FOptPlanBillId |
| FWorkCenterId | 工作中心 | string | FWorkCenterId |
| FOptDetailId | 工序计划工序内码 | string | FOptDetailId |
| FReqSrc | 需求来源 | string | FReqSrc |
| FReqBillNo | 需求单据 | string | FReqBillNo |
| FReqBillId | 需求单据内码 | string | FReqBillId |
| FReqEntrySeq | 需求单据行号 | string | FReqEntrySeq |
| FReqEntryId | 需求单据分录内码 | string | FReqEntryId |
| FEquipmentId | 设备 | string | FEquipmentId |
| FSerialSubEntity | 序列号子单据体 | string | FSerialSubEntity |
| FDetailID | 序列号实体主键 | string | FDetailID |
| FSerialNo | 序列号 | string | FSerialNo |
| FSerialId | 序列号id | string | FSerialId |
| FSerialNote | 备注2 | string | FSerialNote |
| Limit | 最大行数 | string | {{PAGINATION_PAGE_SIZE}} |
| StartRow | 开始行索引 | string | {{PAGINATION_START_ROW}} |
| TopRowCount | 返回总行数 | int | |
| FilterString | 过滤条件 | string | FApproveDate>='{{LAST_SYNC_TIME dateTime}}' |
| FieldKeys | 需查询的字段key集合 | array | |
| FormId | 业务对象表单Id | string | PRD_ReturnMtrl |
响应参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| FBillHead | 单据头 | string | |
| FID | 实体主键 | string | |
| FBillNo | 单据编号 | string | |
| FDocumentStatus | 单据状态 | string | |
| FApproverId | 审核人 | string | |
| FApproveDate | 审核日期 | string | |
| FModifierId | 修改人 | string | |
| FCreateDate | 创建日期 | string | |
| FCreatorId | 创建人 | string | |
| FModifyDate | 修改日期 | string | |
| FCancelDate | 作废日期 | string | |
| FCanceler | 作废人 | string | |
| FCancelStatus | 作废状态 | string | |
| FDescription | 备注 | string | |
| FPrdOrgId(必填项) | 生产组织 | string | |
| FStockOrgId(必填项) | 收料组织 | string | |
| FDate(必填项) | 日期 | string | |
| FWorkShopId | 生产车间 | string | |
| FStockId0 | FStockId0 | string | |
| FBillType(必填项) | 单据类型 | string | |
| FOwnerId0 | FOwnerId0 | string | |
| FOwnerTypeId0 | FOwnerTypeId0 | string | |
| FCurrId | 本位币 | string | |
| FTransferBizType | 跨组织业务类型 | string | |
| FSTOCKERID | 仓管员 | string | |
| FReturnerId | 退料人 | string | |
| FIsCrossTrade | 跨法人交易 | string | |
| FVmiBusiness | VMI业务 | string | |
| FScanBox | 序列号上传 | string | |
| FSourceType | 倒冲来源 | string | |
| FIsOwnerTInclOrg | 货主含组织 | string | |
| FEntity | 明细 | string | |
| FEntryID | 明细实体主键 | string | |
| FPPBOMEntryId | 用料清单分录ID | string | |
| FMaterialId(必填项) | 物料编码 | string | |
| FMaterialName | 物料名称 | string | |
| FSpecification | 规格型号 | string | |
| FUnitID(必填项) | 单位 | string | |
| FAPPQty | 申请数量 | string | |
| FQty | 实退数量 | string | |
| FReturnType(必填项) | 退料类型 | string | |
| FStockId(必填项) | 仓库 | string | |
| FMoId | 生产订单ID | string | |
| FMoBillNo | 生产订单编号 | string | |
| FMoEntryId | 生产订单分录ID | string | |
| FMoEntrySeq | 生产订单行号 | string | |
| FAuxPropId | 辅助属性 | string | |
| FBaseAppQty | 基本单位申请数量 | string | |
| FStockUnitId | 主库存单位 | string | |
| FStockAppQty | 主库存申请数量 | string | |
| FSecUnitId | 辅库存单位 | string | |
| FSecStockQty | 辅库存实退数量 | string | |
| FStockQty | 主库存实退数量 | string | |
| FBaseQty | 基本单位实退数量 | string | |
| FMtoNo | 计划跟踪号 | string | |
| FProjectNo | 项目编号 | string | |
| FLot | 批号 | string | |
| FStockStatusId(必填项) | 库存状态 | string | |
| FExpUnit | 保质期单位 | string | |
| FExpPeriod | 保质期 | string | |
| FKeeperTypeId(必填项) | 保管者类型 | string | |
| FKeeperId(必填项) | 保管者 | string | |
| FOperId | 工序号 | string | |
| FPrice | 成本价 | string | |
| FAmount | 总成本 | string | |
| FBomId | BOM版本 | string | |
| FStockLocId | 仓位 | string | |
| FProcessId | 作业 | string | |
| FSrcBillType(必填项) | 系统源单类型 | string | |
| FSrcBillNo | 系统源单编号 | string | |
| FSelRePickedQty | 补料选单数 | string | |
| FBaseSelRePickedQty | 基本单位补料选单数 | string | |
| FBaseUnitId | 基本单位 | string | |
| FStockFlag | 更新库存标志位 | string | |
| FOwnerTypeId(必填项) | 货主类型 | string | |
| FOwnerId(必填项) | 货主 | string | |
| FEntrySrcInterId | 系统源单内码 | string | |
| FEntrySrcEnteryId | 系统源单分录内码 | string | |
| FEntrySrcEntrySeq | 系统源单行号 | string | |
| FProduceDate | 生产日期 | string | |
| FExpiryDate | 有效期至 | string | |
| FPPBomBillNo | 用料清单编号 | string | |
| FWorkShopId1 | 车间 | string | |
| FReturnReason | 退料原因 | string | |
| FEntrtyMemo | 备注1 | string | |
| FParentOwnerTypeId | 产品货主类型 | string | |
| FParentOwnerId | 产品货主 | string | |
| FBFLowId | 业务流程 | string | |
| FParentMaterialId | 产品编码 | string | |
| FSrcBizBillType | 业务源单类型 | string | |
| FSrcBizBillNo | 业务源单编号 | string | |
| FSrcBizInterId | 业务源单内码 | string | |
| FSrcBizEntryId | 业务源单分录内码 | string | |
| FSrcBizEntrySeq | 业务源单行号 | string | |
| FSNUnitID | 序列号单位 | string | |
| FSNQty | 序列号单位数量 | string | |
| FReserveType | 预留类型 | string | |
| FBASESTOCKQTY | 主库存基本单位实退数量 | string | |
| FConsome | 消耗汇总 | string | |
| FEntryVmiBusiness | VMI业务1 | string | |
| FOptQueue | 工序序列 | string | |
| FOptPlanBillNo | 工序计划单编号 | string | |
| FOptPlanBillId | 工序计划单内码 | string | |
| FWorkCenterId | 工作中心 | string | |
| FOptDetailId | 工序计划工序内码 | string | |
| FReqSrc | 需求来源 | string | |
| FReqBillNo | 需求单据 | string | |
| FReqBillId | 需求单据内码 | string | |
| FReqEntrySeq | 需求单据行号 | string | |
| FReqEntryId | 需求单据分录内码 | string | |
| FEquipmentId | 设备 | string | |
| FSerialSubEntity | 序列号子单据体 | string | |
| FDetailID | 序列号实体主键 | string | |
| FSerialNo | 序列号 | string | |
| FSerialId | 序列号id | string | |
| FSerialNote | 备注2 | string | |
轻易云集成平台接口明细
- 调用接口：写入空操作
- 接口名称：写入空操作
- 方法：POST
系统对接概况
通过数据集成平台可视化的快速配置调用接口打通金蝶云星空与轻易云集成平台之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。
