金蝶云星空和管易云接口打通对接实战
对接系统金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。
对接目标系统:管易云
金蝶管易云是金蝶集团旗下以电商和新零售为核心业务的子公司，公司于2008年成立，拥有从事电商及新零售业务相关专业知识工作者超过1000人。为伊利、网易有道、东阿阿胶、金龙鱼、海康、科大讯飞等超过110000家企业客户提供专业服务，用户数超过100万人。金蝶管易云与淘宝、天猫、京东、拼多多、抖音等超过150+主流电商平台建立合作关系。
数据接口配置方案
异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则，例如取数就要根据查询接口获取金蝶云星空的数据，并且根据对应的条件进行取数，目标系统就必须根据目标系统的格式，以及获取的数据进行加工处理后进行写入到管易云中。轻易云集成平台的可视化配置轻松实现。
金蝶云星空接口明细
- API：executeBillQuery
- NAME：调拨单查询
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|---|---|---|
| FBillEntry_FEntryID | FEntryID | FBillEntry_FEntryID | |
| FID | 实体主键 | FID | |
| FBillNo | 单据编号 | FBillNo | |
| FDocumentStatus | 单据状态 | FDocumentStatus | |
| FStockOrgId_FNumber | 调入库存组织 | FStockOrgId.FNumber | |
| FDate | 日期 | FDate | |
| FBillTypeID_FNumber | 单据类型 | FBillTypeID.FNumber | |
| FTransferBizType | 调拨类型 | FTransferBizType | |
| FStockOutOrgId_FNumber | 调出库存组织 | FStockOutOrgId.FNumber | |
| FTransferDirect | 调拨方向 | FTransferDirect | |
| FNote | 备注 | FNote | |
| FBizType | 业务类型 | FBizType | |
| FSaleOrgId_FNumber | 销售组织 | FSaleOrgId.FNumber | |
| FSettleOrgId_FNumber | 结算组织 | FSettleOrgId.FNumber | |
| FCustID_FNumber | 对应客户 | FCustID.FNumber | |
| FSUPPLIERID_FNumber | 对应供应商 | FSUPPLIERID.FNumber | |
| FThirdSrcId | 第三方源单内码 | FThirdSrcId | |
| FThirdSrcBillNo | 第三方源单编码 | FThirdSrcBillNo | |
| FThirdSystem | 第三方系统 | FThirdSystem | |
| FMaterialId_FNumber | 物料编码 | FMaterialId.FNumber | |
| FLot | 调出批号 | FLot | |
| FSrcStockId_FNumber | 调出仓库 | FSrcStockId.FNumber | |
| FSrcStockLocId | 调出仓位 | FSrcStockLocId | |
| FDestStockId_FNumber | 调入仓库 | FDestStockId.FNumber | |
| FDestStockLocId | 调入仓位 | FDestStockLocId | |
| FQty | 调拨数量 | FQty | |
| FPrice | 成本价 | FPrice | |
| FAmount | 总成本 | FAmount | |
| FBomId | BOM版本 | FBomId | |
| FProduceDate | 生产日期 | FProduceDate | |
| FExpiryDate | 有效期至 | FExpiryDate | |
| FMtoNo | 计划跟踪号 | FMtoNo | |
| FSrcStockStatusId | 调出库存状态 | FSrcStockStatusId | |
| FDestStockStatusId | 调入库存状态 | FDestStockStatusId | |
| FOwnerId_FNumber | 调入货主 | FOwnerId.FNumber | |
| FOwnerOutId_FNumber | 调出货主 | FOwnerOutId.FNumber | |
| FSrcBillTypeId | 源单类型 | FSrcBillTypeId | |
| FSrcSeq | 源单行号 | FSrcSeq | |
| FOrderNo | 订单编号 | FOrderNo | |
| FNoteEntry | 备注 | FNoteEntry | |
| FSrcBillNo | 源单编号 | FSrcBillNo | |
| FBFLowId | 业务流程 | FBFLowId | |
| FConsignPrice | 单价 | FConsignPrice | |
| FTaxPrice | 含税单价 | FTaxPrice | |
| FTaxRate | 税率% | FTaxRate | |
| FDestLot | 调入批号 | FDestLot | |
| FQmEntryId | 库存请检单EntryId | FQmEntryId | |
| FConvertEntryId | 库存状态转换EntryId | FConvertEntryId | |
| FSOEntryId | 销售订单EntryId | FSOEntryId | |
| FThirdSrcEntryId | 第三方源单分录编码 | FThirdSrcEntryId | |
| FISFREE | 赠品 | FISFREE | |
| Limit | 最大行数 | {{PAGINATION_PAGE_SIZE}} | 金蝶的查询分页参数 |
| FieldKeys | 需查询的字段key集合 | 金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber | |
| TopRowCount | 返回总行数 | 金蝶的查询分页参数 | |
| FilterString | 过滤条件 | FApproveDate>='{{LAST_SYNC_TIME dateTime}}' | 示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= |
| FormId | 业务对象表单Id | STK_TransferDirect | 必须填写金蝶的表单ID如
|
| StartRow | 开始行索引 | {{PAGINATION_START_ROW}} | 金蝶的查询分页参数 |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|---|---|---|
| FBillEntry_FEntryID | FEntryID | ||
| FID | 实体主键 | ||
| FBillNo | 单据编号 | ||
| FDocumentStatus | 单据状态 | ||
| FStockOrgId_FNumber | 调入库存组织 | ||
| FDate | 日期 | ||
| FBillTypeID_FNumber | 单据类型 | ||
| FTransferBizType | 调拨类型 | ||
| FStockOutOrgId_FNumber | 调出库存组织 | ||
| FTransferDirect | 调拨方向 | ||
| FNote | 备注 | ||
| FBizType | 业务类型 | ||
| FSaleOrgId_FNumber | 销售组织 | ||
| FSettleOrgId_FNumber | 结算组织 | ||
| FCustID_FNumber | 对应客户 | ||
| FSUPPLIERID_FNumber | 对应供应商 | ||
| FThirdSrcId | 第三方源单内码 | ||
| FThirdSrcBillNo | 第三方源单编码 | ||
| FThirdSystem | 第三方系统 | ||
| FMaterialId_FNumber | 物料编码 | ||
| FLot | 调出批号 | ||
| FSrcStockId_FNumber | 调出仓库 | ||
| FSrcStockLocId | 调出仓位 | ||
| FDestStockId_FNumber | 调入仓库 | ||
| FDestStockLocId | 调入仓位 | ||
| FQty | 调拨数量 | ||
| FPrice | 成本价 | ||
| FAmount | 总成本 | ||
| FBomId | BOM版本 | ||
| FProduceDate | 生产日期 | ||
| FExpiryDate | 有效期至 | ||
| FMtoNo | 计划跟踪号 | ||
| FSrcStockStatusId | 调出库存状态 | ||
| FDestStockStatusId | 调入库存状态 | ||
| FOwnerId_FNumber | 调入货主 | ||
| FOwnerOutId_FNumber | 调出货主 | ||
| FSrcBillTypeId | 源单类型 | ||
| FSrcSeq | 源单行号 | ||
| FOrderNo | 订单编号 | ||
| FNoteEntry | 备注 | ||
| FSrcBillNo | 源单编号 | ||
| FBFLowId | 业务流程 | ||
| FConsignPrice | 单价 | ||
| FTaxPrice | 含税单价 | ||
| FTaxRate | 税率% | ||
| FDestLot | 调入批号 | ||
| FQmEntryId | 库存请检单EntryId | ||
| FConvertEntryId | 库存状态转换EntryId | ||
| FSOEntryId | 销售订单EntryId | ||
| FThirdSrcEntryId | 第三方源单分录编码 | ||
| FISFREE | 赠品 |
管易云接口明细
- API：gy.erp.stock.other.in.add
- NAME：其他入库单新增完结接口v2
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|---|---|---|
| warehouse_code | 仓库代码 | {{FDestStockId_FNumber}} | |
| type | 入库类型代码 | {{FBillTypeID_FNumber}} | |
| note | 备注 | 金蝶调拨入库{{FBillNo}}{{FDestStockId_FNumber}} | |
| details | 入库明细 | details | |
| details.item_code | 商品代码 | {{FMaterialId_FNumber}} | |
| details.sku_code | 规格代码 | ||
| details.barcode | 商品条码 | ||
| details.qty | 数量 | {{FQty}} | |
| details.uniqueCode | 唯一码 | ||
| details.batchNumber | 批次号 | ||
| details.manufacturingDate | 生产日期 | ||
| details.shelfLife | 有效期 | ||
| details.stockDate | 入库日期 | {{FDate}} | |
| details.wms_bizcode | 第三方系统单号 | {{FBillNo}} |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|---|---|---|
| success | 成功与否 | ||
| errorCode | 错误代码 | ||
| subErrorCode | 子错误代码 | ||
| errorDesc | 错误描述 | ||
| subErrorDesc | 子错误描述 | ||
| requestMethod | 请求方法 | ||
| code | 其他入库单单据编号 |
数据对接效果
通过无代码的数据集成与数据建模的智能数据管道技术，帮助企业将所有应用程序、数据库、事件和文件等数据信息提取到数据仓库中，并快速将分散的数据转化为数据集、API、自动化流程等开箱即用的数据服务。配置接口的模式对接金蝶云星空和管易云，使得单据无缝互通。打造企业内部数据一体化，让企业日常运营管理实现敏捷数据化运营。实现供应链业务信息流的互通，同时支持供应链数据分析流程自动化，结果推送，推进相关供应链问题优化。及时打通供应链孤岛，实现数据驱动供应链协同，进一步提升企业竞争力。
![SQL 错误 [22007]: ERROR: invalid input syntax for type date: ““](https://img-blog.csdnimg.cn/d13f5e3b10724faf986fa97c8952d583.png#pic_center)
