轻易云集成平台和金蝶云星空单据接口对接
接通系统：金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
对接目标系统:轻易云集成平台
轻易云集成平台，致力于专业的数据集成、数据运营、数据分析服务领域，使繁杂数字化应用从此变得简单、易用，构建万物互联的数字化企业。目前我们已经为86+原厂软件提供了全场景的系统集成能力，为500+客户提供了稳定高效的集成服务，日数据流量超过150万单
数据接口配置
系统对接前期需要通过调研公司的业务，规划出最便捷，效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地，轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台：金蝶云星空的接口参数设置，以及设定好目标平台：轻易云集成平台的映射，即可启动方案进行测试
金蝶云星空接口明细
- API：executeBillQuery
- NAME：退货通知查询
- 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 | |
| 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 | |
| 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 | 明细信息 | | |
| 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 | 财务信息 | | |
轻易云集成平台接口明细
- API：写入空操作
- NAME：写入空操作
- METHOD：POST
数据对接价值
当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。
