积加ERP和金蝶云星空接口打通对接实战
接通系统：积加ERP
积加成立于2017年，是国内知名的跨境电商数字基础设施服务商，专注于为跨境电商卖家提供全闭环的电商解决方案。目前积加研发人员达200+，拥有多年行业技术、经验积累的团队，总部位于深圳，在长沙、广州、东莞、厦门、杭州、宁波等20多个城市均设有运营中心。自成立以来，积加以“懂行业、懂客户”的产品理念，基于对跨境电商行业底层逻辑的深刻理解，打造出业内更贴合卖家需求的产品，现有积加ERP-X版、积加M版。
对接系统：金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。
数据接口配置
集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：积加ERP，源系统 API：日期范围报告查询，目标系统：金蝶云星空，目标系统 API销售出库新增。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。
积加ERP接口明细
- API：api/v2/report/dateRangeReports
- NAME：日期范围报告查询
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|---|---|---|
| page | 页码 | 1 | 1 |
| pagesize | 条数 | 20 | 20 |
| sort | 排序 | zeroDate | |
| order | 顺序或逆序 | descend/ascend | |
| purchaseStartDate | 起始时间 | 2022-05-02 | 44440 |
| purchaseEndDate | 截止时间 | 2022-05-23 | 44442 |
| dynamicKey | dynamicKey | sku | |
| dynamicKey1 | dynamicKey1 | descriptionLike | |
| sku | sku | X002M2S7BT | |
| marketIds | 站点集合 | 21 | |
| orderType | 订单类型 |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|---|---|---|
| id | 编号 | 38543485 | |
| baseTotal | baseTotal | ||
| tcscgst | 印度站专有Order-TCS-CGST | ||
| marketId | 站点编号 | 21 | |
| currency | 币种 | USD | |
| tcssgst | 印度站专有Order-TCS-SGST | ||
| tcsigst | 印度站专有Order-TCS-IGST | ||
| currencySymbol | 币种符号 | $ | |
| createDate | 创建时间 | Sep 1, 2021 11:32:16 PM PDT | |
| updateDate | 更新时间 | 44502.853761574 | |
| testOrder | 是否是测评订单 | ||
| standardDate | 标准时间 | 44440.980740741 | |
| testOrderName | 测评订单 | ||
| marketDate | 市场时间 | 44440.980740741 | |
| productName | 产品名称 | ||
| zeroDate | 零时区时间 | 44441.272407407 | |
| settlementId | 结算ID | 14700440741 | |
| countryCode | 国家编号 | ||
| orderType | 订单类型 | ||
| category | 类型 | ||
| categoryId | 类型编号 | ||
| tipoDeConta | 巴西站点专用类型 | ||
| categoryName | 类型名称 | ||
| type | 费用类型 | Liquidations | |
| asin | asin | ||
| orderId | 亚马逊订单编号 | 7577843508551 | |
| variationAsin | variationAsin | ||
| sku | sku | X002M2S7BT | |
| principal | principal | ||
| msku | msku | ||
| product | sku | X002M2S7BT | |
| commission | commission | ||
| feeType | 费用类型 | ||
| description | 费用说明 | Aunote iPhone 12 Pro Case, iPhone 12 Pro Phone Case, Slim Flip/Folio Cover – Wallet Style: Made of PU Leather Shell (Lightweight, Feels Good) and TPU Inner - Full Protection. Blue | |
| quantity | 数量 | 1 | |
| marketplace | 市场 | ||
| fulfillment | 配送类型 | ||
| orderCity | 订单收货城市 | ||
| orderState | 订单收货区 | ||
| orderPostal | 邮编 | ||
| taxCollectionModel | 税收征管模式（此字段仅北美地区存在） | ||
| productSales | 订单中商品售价（已经乘以了数量） | 0.76 | |
| productSalesTax | 订单中商品价格税（已经乘以了数量） | ||
| shippingCredits | 订单中买家支付的运费（已经乘以了数量） | ||
| shippingCreditsTax | 订单中买家支付的运费税（已经乘以了数量） | ||
| giftWrapCredits | 订单中买家支付的礼品包装费（已经乘以了数量） | ||
| giftWrapCreditsTax | 订单中买家支付的礼品包装费的税（已经乘以了数量） | ||
| promotionalRebates | 订单中商品的折扣金额（已经乘以了数量） | ||
| promotionalRebatesTax | 折扣金额的税 | ||
| pointsGranted | 积分（订单费用明细中的PointsGranted，目前只有日本市场有此费用项目） | ||
| collectionVat | 征收增值税 | ||
| marketplaceWithheldTax | 市场预扣税 | ||
| sellingFees | 销售佣金 | ||
| fbaFees | 订单中商品的折扣金额（已经乘以了数量） | ||
| otherTransactionFees | 其他交易费用 | -0.36 | |
| other | 其他（含Refund-Goodwill费用） | ||
| total | 总计（前面所有费用合计） | 0.4 |
金蝶云星空接口明细
- 调用接口：batchSave
- 接口名称：销售出库新增
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|---|---|---|
| FBillTypeID | 单据类型 | string | XSCKD01_SYS |
| FBillNo | 单据编号 | string | |
| FDate | 日期 | string | |
| FSaleOrgId | 销售组织 | string | |
| FCustomerID | 客户 | string | |
| FBranchId | 销售门店 | string | |
| FSaleDeptID | 销售部门 | string | |
| FCorrespondOrgId | 对应组织 | string | |
| FCarrierID | 承运商 | string | |
| FCarriageNO | 运输单号 | string | |
| FSalesGroupID | 销售组 | string | |
| FSalesManID | 销售员 | string | |
| FStockOrgId | 发货组织 | string | |
| FDeliveryDeptID | 发货部门 | string | |
| FLinkPhone | 联系电话 | string | |
| FLinkMan | 收货人姓名 | string | |
| FStockerID | 仓管员 | string | |
| FNote | 备注 | string | |
| FReceiverID | 收货方 | string | |
| FReceiveAddress | 收货方地址 | string | |
| FSettleID | 结算方 | string | |
| FReceiverContactID | 收货方联系人 | string | |
| FPayerID | 付款方 | string | |
| FOwnerTypeIdHead | 货主类型 | string | |
| FSHOPNUMBER | 网店编码 | string | |
| FSALECHANNEL | 销售渠道 | string | |
| FOwnerIdHead | 货主 | string | |
| SubHeadEntity | 财务信息 | object | |
| SubHeadEntity.FSettleOrgID | 结算组织 | string | |
| SubHeadEntity.FSettleTypeID | 结算方式 | string | |
| SubHeadEntity.FReceiptConditionID | 收款条件 | string | |
| SubHeadEntity.FBuyerNick | 会员名称 | string | |
| SubHeadEntity.FReceiverAddress | 收货人地址 | string | |
| SubHeadEntity.FReceiverName | 收货人 | string | |
| SubHeadEntity.FReceiverMobile | 收货人手机 | string | |
| SubHeadEntity.FReceiverCountry | 收货人国家 | string | |
| SubHeadEntity.FReceiverState | 收货人省份 | string | |
| SubHeadEntity.FReceiverCity | 收货人城市 | string | |
| SubHeadEntity.FReceiverDistrict | 收货人地区 | string | |
| SubHeadEntity.FReceiverPhone | 收货人电话 | string | |
| SubHeadEntity.FVIPCODE | 会员编码 | string | |
| SubHeadEntity.FEntity | 明细信息 | array | |
| SubHeadEntity.FEntity.FCustMatID | 客户物料编码 | string | |
| SubHeadEntity.FEntity.FMaterialID | 物料编码 | string | |
| SubHeadEntity.FEntity.FBarcode | 零售条形码 | string | |
| SubHeadEntity.FEntity.FRealQty | 实发数量 | string | |
| SubHeadEntity.FEntity.FPrice | 单价 | string | |
| SubHeadEntity.FEntity.FTaxPrice | 含税单价 | string | |
| SubHeadEntity.FEntity.FIsFree | 是否赠品 | string | |
| SubHeadEntity.FEntity.FLot | 批号 | string | |
| SubHeadEntity.FEntity.FProduceDate | 生产日期 | string | |
| SubHeadEntity.FEntity.FExpiryDate | 有效期至 | string | |
| SubHeadEntity.FEntity.FEntryTaxRate | 税率% | string | |
| SubHeadEntity.FEntity.FEntryTaxAmount | 税额 | string | |
| SubHeadEntity.FEntity.FAmount | 金额 | string | |
| SubHeadEntity.FEntity.FAllAmount | 价税合计 | string | |
| SubHeadEntity.FEntity.FStockID | 仓库 | string | |
| SubHeadEntity.FEntity.FStockLocID | 仓位 | string | |
| SubHeadEntity.FEntity.FStockStatusID | 库存状态 | string | |
| SubHeadEntity.FEntity.FMtoNo | 计划跟踪号 | string | |
| SubHeadEntity.FEntity.FEntrynote | 备注 | string | |
| SubHeadEntity.FEntity.FSoorDerno | 订单单号 | string | |
| SubHeadEntity.FEntity.FDiscountRate | 折扣率% | string | |
| SubHeadEntity.FEntity.FEntity_Link | 关联关系表 | array | |
| SubHeadEntity.FEntity.FEntity_Link_FRuleId | 转换规则 | string | |
| SubHeadEntity.FEntity.FEntity_Link_FSTableName | 源单表 | string | |
| SubHeadEntity.FEntity.FEntity_Link_FSBillId | 源单内码 | string | |
| SubHeadEntity.FEntity.FEntity_Link_FSId | 源单分录内码 | string | |
| SubHeadEntity.FEntity.FormId | 业务对象表单Id | string | SAL_OUTSTOCK |
| SubHeadEntity.FEntity.Operation | 执行的操作 | string | Save |
| SubHeadEntity.FEntity.IsAutoSubmitAndAudit | 提交并审核 | bool | true |
| SubHeadEntity.FEntity.IsVerifyBaseDataField | 验证基础资料 | bool | false |
| SubHeadEntity.FEntity.SubSystemId | 系统模块 | string | 21 |
系统对接概况
可视化配置，即便是普通业务人员也可以快速轻松对接多个平台，解决企业面临的数据孤岛，数据混乱等问题，实现数据可见、可用、可运营。进行统一化，模块化，标准化的服务能力和输出，实现对业务端数据需求的精准满足和高效响应，也可以在业务数据需求的不断增加下，让企业有整套的可复用的api资产以更换，支持业务的正常运转，节省开发成本。在不同的着重点和应用上解决数据共享，实现平台之间的独立管理。
