积加ERP对接打通金蝶云星空日期范围报告查询接口与销售退货新增接口
接通系统：积加ERP
积加成立于2017年，是国内知名的跨境电商数字基础设施服务商，专注于为跨境电商卖家提供全闭环的电商解决方案。目前积加研发人员达200+，拥有多年行业技术、经验积累的团队，总部位于深圳，在长沙、广州、东莞、厦门、杭州、宁波等20多个城市均设有运营中心。自成立以来，积加以“懂行业、懂客户”的产品理念，基于对跨境电商行业底层逻辑的深刻理解，打造出业内更贴合卖家需求的产品，现有积加ERP-X版、积加M版。
对接目标系统:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。
多系统对接方案配置
数据集成平台对应的配置积加ERP与金蝶云星空的对接只要三步就能完成两个系统之间的数据对接。第一步根据积加ERP的接口参数要求记录在轻易云集成平台。第二步配置积加ERP与金蝶云星空之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。
积加ERP接口明细
- 接口：api/v2/order/fbaReturns
- 接口名称：日期范围报告查询
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 |
|---|
| pagesize | 每页条数 | string |
| returnStartDate | 开始日期 | string |
| sort | sort | string |
| dateType | 日期类型 returnDate:退货日期（市场时间），returnDateZero：退货日期（零时区） purchaseDate：订购日期 | string |
| page | 页码 | string |
| order | order | string |
| returnEndDate | 结束日期 | string |
响应参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| reason | 退化原因 | string | 退化原因 |
| purchaseDate | 订单日期 | string | 订单日期 |
| fnsku | FNSKU | string | FNSKU |
| orderId | 订单编号 | string | 订单编号 |
| returnDateZero | 退款日期（零时区） | string | 退款日期（零时区） |
| categoryName | 品类名称 | string | 品类名称 |
| productName | 产品名称 | string | 产品名称 |
| tagNames | 标签 | array | 标签 |
| marketId | 站点ID | string | 站点ID |
| customerComments | 买家备注 | string | 买家备注 |
| returnDate | 退款日期 | string | 退款日期 |
| licensePlateNumber | LPN | string | LPN |
| imageUrl | 产品图片 | string | 产品图片 |
| sku | SKU | string | SKU |
| msku | MSKU | string | MSKU |
| quantity | 退款数量 | string | 退款数量 |
| fulfillmentCenterId | 亚马逊配送中心 | string | 亚马逊配送中心 |
| listingTitle | 商品标题 | string | 商品标题 |
| disposition | 退货原因 | string | 退货原因 |
| asin | ASIN | string | ASIN |
| status | 退货状态 | string | 退货状态 |
金蝶云星空接口明细
- 接口：batchSave
- 接口名称：销售退货新增
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 |
|---|
| FEntity.FEntryTaxRate | 税率% | string |
| FEntity.SubHeadEntity.IsVerifyBaseDataField | 验证基础资料 | bool |
| FEntity.SubHeadEntity.Operation | 执行的操作 | string |
| FEntity.FDeliveryDate | 退货日期 | string |
| FEntity.SubHeadEntity.SubSystemId | 系统模块 | string |
| FDate | 日期 | string |
| FEntity.FPrice | 单价 | string |
| FSaledeptid | 销售部门 | string |
| FEntity.FBarcode | 零售条形码 | string |
| FEntity.SubHeadEntity.IsAutoSubmitAndAudit | 提交并审核 | bool |
| FHeadNote | 备注 | string |
| FEntity.FTaxPrice | 含税单价 | string |
| FEntity.SubHeadEntity.FSettleOrgId | 结算组织 | string |
| FEntity.SubHeadEntity | 财务信息 | object |
| FEntity.FNote | 备注 | string |
| FEntity.SubHeadEntity.FormId | 业务对象表单Id | string |
| FEntity.FStockId | 仓库 | string |
| FRetcustId | 退货客户 | string |
| FBillNo | 单据编号 | string |
| FEntity.FRealQty | 实退数量 | string |
| FSaleOrgId | 销售组织 | string |
| FEntity | 明细信息 | array |
| FStockOrgId | 库存组织 | string |
| FEntity.FIsFree | 是否赠品 | string |
| FEntity.FLot | 批号 | string |
| FEntity.FMaterialId | 物料编码 | string |
| FBillTypeID | 单据类型 | string |
系统打通概况
当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。
