从积加ERP到金蝶云星空通过接口集成数据
源系统:积加ERP
积加成立于2017年，是国内知名的跨境电商数字基础设施服务商，专注于为跨境电商卖家提供全闭环的电商解决方案。目前积加研发人员达200+，拥有多年行业技术、经验积累的团队，总部位于深圳，在长沙、广州、东莞、厦门、杭州、宁波等20多个城市均设有运营中心。自成立以来，积加以“懂行业、懂客户”的产品理念，基于对跨境电商行业底层逻辑的深刻理解，打造出业内更贴合卖家需求的产品，现有积加ERP-X版、积加M版。
对接目标平台:金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
数据接口配置
集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：积加ERP，源系统 API：采购计划查询，目标系统：金蝶云星空，目标系统 API预测单新增。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。
积加ERP接口明细
- 接口：api/v2/purchase/plan
- 接口名称：采购计划查询
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 |
|---|
| page | 页码 | string |
| invoicesStateList | 单据状态集 | string |
| arrivalWarehouseId | 目的仓库 | string |
| code | 计划单号 | string |
| pagesize | 条数 | string |
| transport | 物流方式 | string |
| order | 顺序或逆序 | string |
| sort | 排序 | string |
| createdEndDate | 创建时间止 | string |
| createdStartDate | 创建时间起 | string |
响应参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| id | 采购计划主键id | string | |
| code | 计划单号 | string | |
| arrivalWarehouseId | 目的仓库 | string | |
| arrivalWarehouseName | 目的仓库名称 | string | |
| arrivalMarketId | 亚马逊站点 | string | |
| arrivalMarketName | 目的站点名称 | string | |
| transferMarketName | 中转站点名称 | string | |
| transferWarehouseId | 中转仓 | string | |
| transferWarehouseName | 中转仓名称 | string | |
| procurementMethod | 采购方式 | string | |
| procurementMethodName | 采购方式名称 | string | |
| invoicesState | 单据状态 | string | |
| invoicesStateName | 单据状态名称 | string | |
| totalQuantity | 总数量 | string | |
| totalNum | 产品种类 | string | |
| totalPurchaseCost | 总采购成本 | string | |
| baseCurrencySymbol | 本位币 | string | |
| transport | 采购计划物流方式 | string | |
| transportName | 运输方式名称 | string | |
| memo | 备注 | string | |
| processState | 跟单状态 | string | |
| processStateName | 跟单状态名称 | string | |
| purchaseOrderCode | 关联采购单号 | string | |
| reviewerId | 审单人 | string | |
| reviewerName | 审单人名称 | string | |
| reviewerTime | 审单时间 | string | |
| createrId | 创建人 | string | |
| createrName | 创建人名称 | string | |
| createdAt | 创建时间 | string | |
| uuid | 审批流关联字段 | string | |
| totalExpectPrice | 预估货值 | string | |
| planItemVoList | 采购计划明细集合 | string | |
| fbaWarehouse | 是否为FBA仓库 | string | |
| turnover | 库周转 | string | |
| shippedTurnover | 途周转 | string | |
| totalTurnover | 总周转 | string | |
| attachmentIds | 附件ID集合 | string | |
| attachmentVOList | 附件集合 | string | |
| attachmentVOList.filename | 附件名称 | string | |
| attachmentVOList.filePath | 附件存储路径 | string | |
金蝶云星空接口明细
- API：batchSave
- NAME：预测单新增
- METHOD：POST
请求参数
| 接口字段 | 名称 | 预设值 |
|---|
| FForeOrgId | 预测组织 | 100 |
| FBillTypeID | 单据类型 | YCD01_SYS |
| FDate | 日期 | {{createdAt}} |
| FDescription | 备注 | |
| FEntity | 单据明细 | |
| FEntity.FSupplyOrgId | 供应组织 | |
| FEntity.FCustID | 客户名称 | |
| FEntity.FProductType | 产品类型 | |
| FEntity.FMaterialID | 物料编码 | |
| FEntity.FMapId | 客户物料编码 | |
| FEntity.FBomID | BOM版本 | |
| FEntity.FUnitID | 单位 | |
| FEntity.FQty | 数量 | |
| FEntity.FParentMtrlId | 父项物料 | |
| FEntity.FStartDate | 预测开始日期 | |
| FEntity.FEndDate | 预测结束日期 | |
| FEntity.FAuxPropId | 辅助属性 | |
| FEntity.FMtoNo | 计划跟踪号 | |
| FEntity.FBaseUnitID | 基本计量单位 | |
| FEntity.FBaseQty | 基本单位数量 | |
| FEntity.FBaseOrderQty | 基本单位关联数量 | |
| FEntity.FBaseWriteOffQty | 基本单位执行数量 | |
| FEntity.FBaseSelPrdQty | 基本单位关联生产委外数量 | |
| FEntity.FAVERATYPE | 均化类型 | N |
| FEntity.FAveraCycle | 均化周期 | |
| FEntity.FStockOrgId | 库存组织 | |
| FEntity.FOwnerTypeId | 货主类型 | BD_OwnerOrg |
| FEntity.FOwnerId | 货主 | |
| FEntity.FReserveType | 预留类型 | |
| FEntity.FPriority | 需求优先级 | |
| FEntity.FWriteOffQty | 执行数量 | |
| FEntity.FOrderQty | 关联数量 | |
| FEntity.FSelPrdQty | 关联生产委外数量 | |
| FEntity.FRemark | 备注 | |
| FEntity.FormId | 业务对象表单Id | PLN_FORECAST |
| FEntity.Operation | 执行的操作 | BatchSave |
| FEntity.IsAutoSubmitAndAudit | 提交并审核 | true |
| FEntity.IsVerifyBaseDataField | 验证基础资料 | true |
系统数据对接
通过无代码的数据集成与数据建模的智能数据管道技术，帮助企业将所有应用程序、数据库、事件和文件等数据信息提取到数据仓库中，并快速将分散的数据转化为数据集、API、自动化流程等开箱即用的数据服务。配置接口的模式对接积加ERP和金蝶云星空，使得单据无缝互通。打造企业内部数据一体化，让企业日常运营管理实现敏捷数据化运营。实现供应链业务信息流的互通，同时支持供应链数据分析流程自动化，结果推送，推进相关供应链问题优化。及时打通供应链孤岛，实现数据驱动供应链协同，进一步提升企业竞争力。
