金蝶云星空对接打通巨益OMS采购入库查询接口与库存异动接口
数据源平台:金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
写入目标:巨益OMS
深圳市巨益科技开发有限公司(巨益科技)2013年成立于深圳，专注为中大型零售品牌企业提供全渠道电商中台服务，经过7年多时间的业务沉淀，已助力超过1000+年销售额过亿的行业TOP品牌实现数字化转型，服务口碑获得了客户的一致好评。截至目前，巨益科技服务客户类目涉及服装配饰、数码家电、化妆品、眼镜珠宝、食品保健、母婴用品等十三大行业，并凭借行业领先的中台服务案例先后荣获阿里、京东等平台颁发的“年度十佳服务商”、“京卓越金奖”、“订单压测TOP1”等荣誉奖项。
数据集成方案配置
系统对接前期需要通过调研公司的业务，规划出最便捷，效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地，轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台：金蝶云星空的接口参数设置，以及设定好目标平台：巨益OMS的映射，即可启动方案进行测试数据管道ETL：构建一体化的数据融合平台。高级数据转换： 支持公式转换数据格式、支持脚本直接进行数据转换、支持可视化多维度数据处理。高性能实时处理：针对不同数据节点类型提供TB级吞吐量，秒级延迟的增量数据处理能力。自动将旧版web服务转变为基于云端微服务的API，统一接口输出标准。支持接口开放服务，实现内外部能力接入。
金蝶云星空接口明细
- API：executeBillQuery
- NAME：采购入库查询
- METHOD：POST
请求参数
| 接口字段 | 名称 | 预设值 |
|---|
| FInStockEntry_FEntryId | id | FInStockEntry_FEntryId |
| FID | 实体主键 | FID |
| FBillNo | 单据编号 | FBillNo |
| FDocumentStatus | 单据状态 | FDocumentStatus |
| FStockOrgId_FNumber | 收料组织 | FStockOrgId.FNumber |
| FDate | 入库日期 | FDate |
| FBillTypeID_FNumber | 单据类型 | FBillTypeID.FNumber |
| FOwnerTypeIdHead | 货主类型 | FOwnerTypeIdHead |
| FOwnerIdHead_FNumber | 货主 | FOwnerIdHead.FNumber |
| FDemandOrgId_FNumber | 需求组织 | FDemandOrgId.FNumber |
| FPurchaseOrgId_FNumber | 采购组织 | FPurchaseOrgId.FNumber |
| FSupplierId_FNumber | 供应商 | FSupplierId.FNumber |
| FStockerGroupId_FNumber | 库存组 | FStockerGroupId.FNumber |
| FStockDeptId_FNumber | 收料部门 | FStockDeptId.FNumber |
| FCreateDate | 创建日期 | FCreateDate |
| FCancelDate | 作废日期 | FCancelDate |
| FDeliveryBill | 送货单号 | FDeliveryBill |
| FTakeDeliveryBill | 提货单号 | FTakeDeliveryBill |
| FApproveDate | 审核日期 | FApproveDate |
| FCancelStatus | 作废状态 | FCancelStatus |
| FSupplyId_FNumber | 供货方 | FSupplyId.FNumber |
| FSettleId_FNumber | 结算方 | FSettleId.FNumber |
| FChargeId_FNumber | 收款方 | FChargeId.FNumber |
| FBusinessType | 业务类型 | FBusinessType |
| FSupplyAddress | 供货方地址 | FSupplyAddress |
| FAPSTATUS | 应付状态 | FAPSTATUS |
| FTransferBizType | 跨组织业务类型 | FTransferBizType |
| FDisassemblyFlag | 拆单新单标识 | FDisassemblyFlag |
| FConfirmDate | 确认日期 | FConfirmDate |
| FConfirmStatus | 确认状态 | FConfirmStatus |
| FSplitBillType | 拆单类型 | FSplitBillType |
| FPayOrgId_FNumber | 付款组织 | FPayOrgId.FNumber |
| FSettleOrgId_FNumber | 结算组织 | FSettleOrgId.FNumber |
| FSettleCurrId_FNumber | 结算币别 | FSettleCurrId.FNumber |
| FBillCost | 整单费用 | FBillCost |
| FBillTaxAmount | 税额 | FBillTaxAmount |
| FBillCostAmount | 总成本 | FBillCostAmount |
| FBillAllAmount | 价税合计 | FBillAllAmount |
| FSettleTypeId | 结算方式 | FSettleTypeId |
| FExchangeRate | 汇率 | FExchangeRate |
| FLocalCurrId_FNumber | 本位币 | FLocalCurrId.FNumber |
| FBillAmount | 金额 | FBillAmount |
| FIsIncludedTax | 含税 | FIsIncludedTax |
| FOwnerCustomerID_FNumber | 货主客户 | FOwnerCustomerID.FNumber |
| FSettleSupplierID_FNumber | 结算组织供应商 | FSettleSupplierID.FNumber |
| FISGENFORIOS | 跨组织结算生成 | FISGENFORIOS |
| FISPRICEEXCLUDETAX | 价外税 | FISPRICEEXCLUDETAX |
| FISINVOICEARLIER | 先到票后入库 | FISINVOICEARLIER |
| FMaterialId_FNumber | 物料编码 | FMaterialId.FNumber |
| FMaterialId_FBARCODE | 条码 | FMaterialId.FBARCODE |
| FStockId_FNumber | 仓库 | FStockId.FNumber |
| FProduceDate | 生产日期 | FProduceDate |
| FNote | 备注 | FNote |
| FSupplierLot | 供应商批号 | FSupplierLot |
| FGrossWeight | 毛重 | FGrossWeight |
| FNetWeight | 净重 | FNetWeight |
| FContractlNo | 合同单号 | FContractlNo |
| FReqTraceNo | 需求跟踪号 | FReqTraceNo |
| FMustQty | 应收数量 | FMustQty |
| FRealQty | 实收数量 | FRealQty |
| FSRCRowId | 源单行内码 | FSRCRowId |
| FExpiryDate | 有效期至 | FExpiryDate |
| FIsFree | 免费 | FIsFree |
| FStockStatusId | 库存状态 | FStockStatusId |
| FBOMId | BOM版本 | FBOMId |
| FTaxPrice | 含税单价 | FTaxPrice |
| FCostPrice | 成本价 | FCostPrice |
| FEntryTaxRate | 税率(%) | FEntryTaxRate |
| FEntryTaxAmount | 税额 | FEntryTaxAmount |
| FDiscountRate | 折扣率(%) | FDiscountRate |
| FPriceCoefficient | 价格系数 | FPriceCoefficient |
| FPriceUnitQty | 计价数量 | FPriceUnitQty |
| FTaxNetPrice | 净价 | FTaxNetPrice |
| FEntryCostAmount | 总成本 | FEntryCostAmount |
| FAllAmount | 价税合计 | FAllAmount |
| FStockFlag | 入库库存更新标志 | FStockFlag |
| FPOOrderNo | 订单单号 | FPOOrderNo |
| FEXPUnit | 保质期单位 | FEXPUnit |
| FExpPeriod | 保质期 | FExpPeriod |
| FSRCBILLTYPEID | 源单类型 | FSRCBILLTYPEID |
| FSRCBillNo | 源单编号 | FSRCBillNo |
| FINVOICEDQTY | 已开票数量 | FINVOICEDQTY |
| FBaseAPJoinQty | 关联应付数量（计价基本） | FBaseAPJoinQty |
| FReceiveStockFlag | 收货库存更新标志 | FReceiveStockFlag |
| FProcessFee | 加工费 | FProcessFee |
| FMaterialCosts | 材料成本 | FMaterialCosts |
| FLot_FNumber | 批号 | FLot.FNumber |
| FPrice | 单价 | FPrice |
| FAmount | 金额 | FAmount |
| FDiscount | 折扣额 | FDiscount |
| FReturnJoinQty | 退料关联数量 | FReturnJoinQty |
| FBFLowId | 业务流程 | FBFLowId |
| FGiveAway | 是否赠品 | FGiveAway |
| FWWInType | 入库类型 | FWWInType |
| FRowId | 行标识 | FRowId |
| FStockLocId | FStockLocId | FStockLocId |
| FPriceUnitID_FNumber | FPriceUnitID_FNumber | FPriceUnitID.FNumber |
| Limit | 最大行数 | {{PAGINATION_PAGE_SIZE}} |
| StartRow | 开始行索引 | {{PAGINATION_START_ROW}} |
| TopRowCount | 返回总行数 | |
| FilterString | 过滤条件 | FApproveDate>='{{LAST_SYNC_TIME dateTime}}' AND FMATERIALID.FIsSalseByNet=1 and FStockOrgId.fnumber in ('101','102','118','110') |
| FieldKeys | 需查询的字段key集合 | |
| FormId | 业务对象表单Id | STK_InStock |
响应参数
| 接口字段 | 名称 | 预设值 |
|---|
| FInStockEntry_FEntryId | id | |
| FID | 实体主键 | |
| FBillNo | 单据编号 | |
| FDocumentStatus | 单据状态 | |
| FStockOrgId_FNumber | 收料组织 | |
| FDate | 入库日期 | |
| FBillTypeID_FNumber | 单据类型 | |
| FOwnerTypeIdHead | 货主类型 | |
| FOwnerIdHead_FNumber | 货主 | |
| FDemandOrgId_FNumber | 需求组织 | |
| FPurchaseOrgId_FNumber | 采购组织 | |
| FSupplierId_FNumber | 供应商 | |
| FStockerGroupId_FNumber | 库存组 | |
| FStockDeptId_FNumber | 收料部门 | |
| FCreateDate | 创建日期 | |
| FCancelDate | 作废日期 | |
| FDeliveryBill | 送货单号 | |
| FTakeDeliveryBill | 提货单号 | |
| FApproveDate | 审核日期 | |
| FCancelStatus | 作废状态 | |
| FSupplyId_FNumber | 供货方 | |
| FSettleId_FNumber | 结算方 | |
| FChargeId_FNumber | 收款方 | |
| FBusinessType | 业务类型 | |
| FSupplyAddress | 供货方地址 | |
| FAPSTATUS | 应付状态 | |
| FTransferBizType | 跨组织业务类型 | |
| FDisassemblyFlag | 拆单新单标识 | |
| FConfirmDate | 确认日期 | |
| FConfirmStatus | 确认状态 | |
| FSplitBillType | 拆单类型 | |
| FPayOrgId_FNumber | 付款组织 | |
| FSettleOrgId_FNumber | 结算组织 | |
| FSettleCurrId_FNumber | 结算币别 | |
| FBillCost | 整单费用 | |
| FBillTaxAmount | 税额 | |
| FBillCostAmount | 总成本 | |
| FBillAllAmount | 价税合计 | |
| FSettleTypeId | 结算方式 | |
| FExchangeRate | 汇率 | |
| FLocalCurrId_FNumber | 本位币 | |
| FBillAmount | 金额 | |
| FIsIncludedTax | 含税 | |
| FOwnerCustomerID_FNumber | 货主客户 | |
| FSettleSupplierID_FNumber | 结算组织供应商 | |
| FISGENFORIOS | 跨组织结算生成 | |
| FISPRICEEXCLUDETAX | 价外税 | |
| FISINVOICEARLIER | 先到票后入库 | |
| FMaterialId_FNumber | 物料编码 | |
| FMaterialId_FBARCODE | 条码 | |
| FStockId_FNumber | 仓库 | |
| FProduceDate | 生产日期 | |
| FNote | 备注 | |
| FSupplierLot | 供应商批号 | |
| FGrossWeight | 毛重 | |
| FNetWeight | 净重 | |
| FContractlNo | 合同单号 | |
| FReqTraceNo | 需求跟踪号 | |
| FMustQty | 应收数量 | |
| FRealQty | 实收数量 | |
| FSRCRowId | 源单行内码 | |
| FExpiryDate | 有效期至 | |
| FIsFree | 免费 | |
| FStockStatusId | 库存状态 | |
| FBOMId | BOM版本 | |
| FTaxPrice | 含税单价 | |
| FCostPrice | 成本价 | |
| FEntryTaxRate | 税率(%) | |
| FEntryTaxAmount | 税额 | |
| FDiscountRate | 折扣率(%) | |
| FPriceCoefficient | 价格系数 | |
| FPriceUnitQty | 计价数量 | |
| FTaxNetPrice | 净价 | |
| FEntryCostAmount | 总成本 | |
| FAllAmount | 价税合计 | |
| FStockFlag | 入库库存更新标志 | |
| FPOOrderNo | 订单单号 | |
| FEXPUnit | 保质期单位 | |
| FExpPeriod | 保质期 | |
| FSRCBILLTYPEID | 源单类型 | |
| FSRCBillNo | 源单编号 | |
| FINVOICEDQTY | 已开票数量 | |
| FBaseAPJoinQty | 关联应付数量（计价基本） | |
| FReceiveStockFlag | 收货库存更新标志 | |
| FProcessFee | 加工费 | |
| FMaterialCosts | 材料成本 | |
| FLot_FNumber | 批号 | |
| FPrice | 单价 | |
| FAmount | 金额 | |
| FDiscount | 折扣额 | |
| FReturnJoinQty | 退料关联数量 | |
| FBFLowId | 业务流程 | |
| FGiveAway | 是否赠品 | |
| FWWInType | 入库类型 | |
| FRowId | 行标识 | |
| FStockLocId | FStockLocId | |
| FPriceUnitID_FNumber | FPriceUnitID_FNumber | |
巨益OMS接口明细
- 接口：stockchange.report
- 接口名称：库存异动
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 |
|---|
| items.batchs.isShelfLifeMgmt | isShelfLifeMgmt | string |
| items.batchs.shelfLife | 保质期 | string |
| items.batchs.rejectLifecycle | rejectLifecycle | string |
| items.adventLifecycle | adventLifecycle | string |
| items.batchs.isAreaSale | isAreaSale | string |
| items.batchs.standardPrice | standardPrice | string |
| items.batchs.englishName | englishName | string |
| items.batchs.pricingCategory | pricingCategory | string |
| items.batchs.produceCode | produceCode | string |
| items.batchs.unit | unit | string |
| items | items | array |
| items.barCode | barCode | string |
| items.batchs.size | size | string |
| items.batchs.outBizCode | 外部业务编码 | string |
| items.batchs.retailPrice | retailPrice | string |
| items.batchs.discountPrice | discountPrice | string |
| items.batchs.reason | reason | string |
| items.batchs.purchasePrice | purchasePrice | string |
| items.orderCode | 来源编码 | string |
| items.batchs.itemCode | 商品编码 | string |
| items.amount | amount | string |
| items.batchs.isSNMgmt | isSNMgmt | string |
| items.batchs.ownerCode | 货主编码 | string |
| items.batchs.tempRequirement | tempRequirement | string |
| items.batchs.categoryId | categoryId | string |
| items.batchs.supplierCode | supplierCode | string |
| items.outCode | outCode | string |
| items.batchs.length | length | string |
| items.batchs.exCode | exCode | string |
| items.actualAmount | actualAmount | string |
| items.batchs.orderCode | 来源编码 | string |
| items.batchs.lackQty | lackQty | string |
| items.batchs.isHazardous | isHazardous | string |
| items.approvalNumber | approvalNumber | string |
| items.batchs.stockUnit | stockUnit | string |
| items.batchs.packCode | packCode | string |
| items.batchs.orderType | 单据类型 | string |
| items.batchs.isBatchMgmt | isBatchMgmt | string |
| items.batchs.goodsCode | goodsCode | string |
| items.batchs.itemId | itemId | string |
| items.batchs.brandName | brandName | string |
| items.batchs.grossWeight | grossWeight | string |
| items.batchs.seasonCode | seasonCode | string |
| items.batchs.productDate | productDate | string |
| items.batchs.itemType | itemType | string |
| items.batchs.price | price | string |
| items.batchs.originAddress | originAddress | string |
| items.batchs.stockStatus | stockStatus | string |
| items.batchs.costPrice | costPrice | string |
| items.batchs.productCode | 生产日期 | string |
| items.batchs.batchCode | 批次编号 | string |
| items.batchs.planQty | planQty | string |
| items.ownerCode | 货主编码 | string |
| items.batchs.receiveQty | receiveQty | string |
| items.batchs.outCode | outCode | string |
| items.batchs.actualQty | actualQty | string |
| items.orderType | 单据类型 | string |
| items.batchs.safetyStock | safetyStock | string |
| items.batchs.paperQty | paperQty | string |
| items.batchs.orderLineNo | orderLineNo | string |
| items.batchs.height | height | string |
| items.batchs.referencePrice | referencePrice | string |
| items.batchs.itemName | itemName | string |
| items.batchs.categoryName | categoryName | string |
| items.batchs.manufacturerItemNumber | 仓位 | string |
| items.batchs.warehouseCode | warehouseCode | string |
| items.batchs.shortName | shortName | string |
| items.batchs.changeTime | 异动时间 | string |
| items.batchs.sn | sn | string |
| items.batchs.supplierName | supplierName | string |
| items.batchRemark | batchRemark | string |
| items.batchs.defectiveQty | defectiveQty | string |
| items.batchs.quantity | 数量 | string |
| items.batchs.packageMaterial | packageMaterial | string |
| items.batchs.snCode | snCode | string |
| items.batchs.color | color | string |
| items.batchs.inventoryType | 库存类型 | string |
| items.outBizCode | 外部业务编码 | string |
| items.batchs.warehouseCode | 仓库 | string |
| items.batchs.isSku | isSku | string |
| items.batchs.originCode | originCode | string |
| items.batchs.latestUpdateTime | latestUpdateTime | string |
| items.batchs.quantity | 异动数量 | string |
| items.batchs.width | width | string |
| items.batchs.volume | volume | string |
| items.batchs.extCode | extCode | string |
| items.batchs.pcs | pcs | string |
| items.batchs.isFragile | isFragile | string |
| items.batchs.expireDate | expireDate | string |
| items.batchs.skuProperty | skuProperty | string |
| items.batchs.sourceOrderCode | sourceOrderCode | string |
| items.batchs.lockupLifecycle | lockupLifecycle | string |
| items.batchs.netWeight | netWeight | string |
| items.batchs.diffQuantity | diffQuantity | string |
| items.batchs.channelCode | channelCode | string |
| items.warehouseCode | 仓库 | string |
| items.batchs.subSourceOrderCode | subSourceOrderCode | string |
| items.batchs.tagPrice | tagPrice | string |
| items.batchs.discount | discount | string |
| items.batchs.seasonName | seasonName | string |
| items.batchs.lockQuantity | lockQuantity | string |
| items.batchs.remark | remark | string |
| items.batchs.brandCode | brandCode | string |
| items.batchs | 批次信息 | array |
| items.batchs.normalQty | normalQty | string |
| items.batchs.tareWeight | tareWeight | string |
系统集成总览
基于轻易云的连接器和数据服务能力，轻松实现供应链异构系统的“相互沟通”，通过数据应用自动化业务流程管理，全面管控供应链的每一环节。从要货、销售出库、退货入库、到盘点、调拨，无需人工参与，实时更新，自动化流转。通过快速连接金蝶云星空接口抽取数据后再自动分发到巨益OMS， 解放生产力，自动生成数据、并分发推送到业务应用，数据传递时效性提升10倍以上。
