管易云与金蝶云星空对接集成调拨单查询连通其他出库单新增完结接口(直接调拨电商出)
接入系统：金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
对接目标系统:管易云
管易云是上海管易云计算软件有限公司旗下的专注提供电商企业管理软件服务的品牌，总部位于中国上海张江高科技产业园区。管易云旗下拥有管易云C-ERP、EC-OMS、EC-WMS、B2C/B2B/BBC/微商城开发、PDA无纸化仓储解决方案、新零售一体化解决方案等产品
数据接口配置
集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：金蝶云星空，源系统 API：调拨单查询，目标系统：管易云，目标系统 API其他出库单新增完结接口。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。
金蝶云星空接口明细
- 调用接口：executeBillQuery
- 接口名称：调拨单查询
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| FBillEntry_FEntryID | FEntryID | string | FBillEntry_FEntryID |
| FID | 实体主键 | string | FID |
| FBillNo | 单据编号 | string | FBillNo |
| FDocumentStatus | 单据状态 | string | FDocumentStatus |
| FStockOrgId_FNumber | 调入库存组织 | string | FStockOrgId.FNumber |
| FDate | 日期 | string | FDate |
| FBillTypeID_FNumber | 单据类型 | string | FBillTypeID.FNumber |
| FTransferBizType | 调拨类型 | string | FTransferBizType |
| FStockOutOrgId_FNumber | 调出库存组织 | string | FStockOutOrgId.FNumber |
| FTransferDirect | 调拨方向 | string | FTransferDirect |
| FNote | 备注 | string | FNote |
| FBizType | 业务类型 | string | FBizType |
| FSaleOrgId_FNumber | 销售组织 | string | FSaleOrgId.FNumber |
| FSettleOrgId_FNumber | 结算组织 | string | FSettleOrgId.FNumber |
| FCustID_FNumber | 对应客户 | string | FCustID.FNumber |
| FSUPPLIERID_FNumber | 对应供应商 | string | FSUPPLIERID.FNumber |
| FThirdSrcId | 第三方源单内码 | string | FThirdSrcId |
| FThirdSrcBillNo | 第三方源单编码 | string | FThirdSrcBillNo |
| FThirdSystem | 第三方系统 | string | FThirdSystem |
| FMaterialId_FNumber | 物料编码 | string | FMaterialId.FNumber |
| FLot_FNumber | 调出批号 | string | FLot.FNumber |
| FSrcStockId_FNumber | 调出仓库 | string | FSrcStockId.FNumber |
| FSrcStockLocId | 调出仓位 | string | FSrcStockLocId |
| FDestStockId_FNumber | 调入仓库 | string | FDestStockId.FNumber |
| FDestStockLocId | 调入仓位 | string | FDestStockLocId |
| FQty | 调拨数量 | string | FQty |
| FPrice | 成本价 | string | FPrice |
| FAmount | 总成本 | string | FAmount |
| FBomId | BOM版本 | string | FBomId |
| FProduceDate | 生产日期 | string | FProduceDate |
| FExpiryDate | 有效期至 | string | FExpiryDate |
| FMtoNo | 计划跟踪号 | string | FMtoNo |
| FSrcStockStatusId | 调出库存状态 | string | FSrcStockStatusId |
| FDestStockStatusId | 调入库存状态 | string | FDestStockStatusId |
| FOwnerId_FNumber | 调入货主 | string | FOwnerId.FNumber |
| FOwnerOutId_FNumber | 调出货主 | string | FOwnerOutId.FNumber |
| FSrcBillTypeId | 源单类型 | string | FSrcBillTypeId |
| FSrcSeq | 源单行号 | string | FSrcSeq |
| FOrderNo | 订单编号 | string | FOrderNo |
| FNoteEntry | 备注 | string | FNoteEntry |
| FSrcBillNo | 源单编号 | string | FSrcBillNo |
| FBFLowId | 业务流程 | string | FBFLowId |
| FConsignPrice | 单价 | string | FConsignPrice |
| FTaxPrice | 含税单价 | string | FTaxPrice |
| FTaxRate | 税率% | string | FTaxRate |
| FDestLot_FNumber | 调入批号 | string | FDestLot.FNumber |
| FQmEntryId | 库存请检单EntryId | string | FQmEntryId |
| FConvertEntryId | 库存状态转换EntryId | string | FConvertEntryId |
| FSOEntryId | 销售订单EntryId | string | FSOEntryId |
| FThirdSrcEntryId | 第三方源单分录编码 | string | FThirdSrcEntryId |
| FISFREE | 赠品 | string | FISFREE |
| FMaterialId_FBARCODE | 条码 | string | FMaterialId.FBARCODE |
| FLot_FInStockDate | 调出批号入库日 | string | FLot.FInStockDate |
| FDestLot_FInStockDate | 调入批号入库日 | string | FDestLot.FInStockDate |
| Limit | 最大行数 | string | {{PAGINATION_PAGE_SIZE}} |
| FieldKeys | 需查询的字段key集合 | array | |
| TopRowCount | 返回总行数 | int | |
| FilterString | 过滤条件 | string | FApproveDate>='{{LAST_SYNC_TIME dateTime}}' AND FDocumentStatus = 'C' AND FSrcStockId.F_ORA_TBDX = 1 and FMaterialId.FIsSalseByNet = 1 and FDestStockId <> FSrcStockId |
| FormId | 业务对象表单Id | string | STK_TransferDirect |
| StartRow | 开始行索引 | string | {{PAGINATION_START_ROW}} |
响应参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| FBillEntry_FEntryID | FEntryID | string | |
| FID | 实体主键 | string | |
| FBillNo | 单据编号 | string | |
| FDocumentStatus | 单据状态 | string | |
| FStockOrgId_FNumber | 调入库存组织 | string | |
| FDate | 日期 | string | |
| FBillTypeID_FNumber | 单据类型 | string | |
| FTransferBizType | 调拨类型 | string | |
| FStockOutOrgId_FNumber | 调出库存组织 | string | |
| FTransferDirect | 调拨方向 | string | |
| FNote | 备注 | string | |
| FBizType | 业务类型 | string | |
| FSaleOrgId_FNumber | 销售组织 | string | |
| FSettleOrgId_FNumber | 结算组织 | string | |
| FCustID_FNumber | 对应客户 | string | |
| FSUPPLIERID_FNumber | 对应供应商 | string | |
| FThirdSrcId | 第三方源单内码 | string | |
| FThirdSrcBillNo | 第三方源单编码 | string | |
| FThirdSystem | 第三方系统 | string | |
| FMaterialId_FNumber | 物料编码 | string | |
| FLot_FNumber | 调出批号 | string | |
| FSrcStockId_FNumber | 调出仓库 | string | |
| FSrcStockLocId | 调出仓位 | string | |
| FDestStockId_FNumber | 调入仓库 | string | |
| FDestStockLocId | 调入仓位 | string | |
| FQty | 调拨数量 | string | |
| FPrice | 成本价 | string | |
| FAmount | 总成本 | string | |
| FBomId | BOM版本 | string | |
| FProduceDate | 生产日期 | string | |
| FExpiryDate | 有效期至 | string | |
| FMtoNo | 计划跟踪号 | string | |
| FSrcStockStatusId | 调出库存状态 | string | |
| FDestStockStatusId | 调入库存状态 | string | |
| FOwnerId_FNumber | 调入货主 | string | |
| FOwnerOutId_FNumber | 调出货主 | string | |
| FSrcBillTypeId | 源单类型 | string | |
| FSrcSeq | 源单行号 | string | |
| FOrderNo | 订单编号 | string | |
| FNoteEntry | 备注 | string | |
| FSrcBillNo | 源单编号 | string | |
| FBFLowId | 业务流程 | string | |
| FConsignPrice | 单价 | string | |
| FTaxPrice | 含税单价 | string | |
| FTaxRate | 税率% | string | |
| FDestLot_FNumber | 调入批号 | string | |
| FQmEntryId | 库存请检单EntryId | string | |
| FConvertEntryId | 库存状态转换EntryId | string | |
| FSOEntryId | 销售订单EntryId | string | |
| FThirdSrcEntryId | 第三方源单分录编码 | string | |
| FISFREE | 赠品 | string | |
| FMaterialId_FBARCODE | 条码 | string | |
| FLot_FInStockDate | 调出批号入库日 | string | |
| FDestLot_FInStockDate | 调入批号入库日 | string | |
管易云接口明细
- 接口：gy.erp.stock.other.out.add
- 接口名称：其他出库单新增完结接口
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| warehouse_code | 仓库代码 | string | 仓库代码 |
| type | 出库类型代码 | string | 出库类型代码 |
| note | 备注 | string | 出库类型代码 |
| wms_bizcode | 第三方系统单号 | string | 第三方系统单号 |
| receiver_name | 收货人 | string | 收货人 |
| receiver_mobile | 收货人手机 | string | 收货人手机 |
| receiver_zip | 收货人邮编 | string | 收货人邮编 |
| receiver_address | 收货人地址 | string | 收货人地址 |
| receiver_province | 收货人省名称 | string | 收货人省名称 |
| receiver_citye | 收货人市名称 | string | 收货人市名称 |
| receiver_district | 收货人区名称 | string | 收货人区名称 |
| details | 出库明细 | array | 出库明细 |
| details.note | 备注 | string | |
| details.item_code | 商品代码 | string | 商品代码与商品条码二者必选其一，当两者都提供时，以商品条码为准 |
| details.sku_code | 规格代码 | string | 有规格的商品此字段必填 |
| details.barcode | 商品条码 | string | 商品条码与商品代码二者必选其一，当两者都提供时，以商品条码为准 |
| details.location_code | 库位代码(库位名称） | string | 只有开启库位库存的仓库必填此字段，未开启库位库存的仓库不开启此字段 |
| details.qty | 数量 | string | |
| details.uniqueCode | 唯一码 | string | 若当前商品为全程唯一码的商品，此参数必填 |
| details.batchNumber | 批次号 | string | 若当前商品为批次商品，此参数必填 |
| details.manufacturingDate | 生产日期 | string | 若当前商品为批次商品，此参数必填 |
| details.shelfLife | 有效期 | string | 若当前商品为批次商品，此参数必填 |
| details.stockDate | 入库日期 | string | 批次商品专用属性，参数选填。不填写时，程序默认当天 |
响应参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| success | 成功与否 | string | 成功与否 |
| errorCode | 错误代码 | string | 错误代码 |
| subErrorCode | 子错误代码 | string | 子错误代码 |
| errorDesc | 错误描述 | string | 错误描述 |
| subErrorDesc | 子错误描述 | string | 子错误描述 |
| requestMethod | 请求方法 | string | 请求方法 |
| code | 其他出库单单据编号 | string | 其他出库单单据编号 |
系统打通概况
从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通金蝶云星空到管易云之间数据集成；通过API连接各业务系统，复用已有的业务系统能力，让集成架构、服务关系更清晰。使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升复用率和价值。全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+，快速对接各种API接口，实现云上云下的互联互通。将SaaS和本地业务系统联接起来，打破时间与空间界限，打通原有核心数据及SaaS应用，构建可平滑演进的企业IT架构。
