金蝶云星空和积加ERP单据接口集成

源系统:积加ERP
积加创始人及核心产品技术团队,深耕于跨境电商技术领域十余年,深刻领悟卖家在Amazon业务运营各环节的核心诉求,结合多年技术管理经验,全面考虑中国卖家的实际需求,开发出最懂亚马逊卖家、最适合中国市场的跨境电商ERP。
对接目标平台:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
接口方案配置
在轻易云平台进行集成方案的配置时,为了实现快速搭建,轻易云平台还提供了现有的市场方案进行复制参考。用户可以在创建集成方案的时候在第四步选择引用市场方案,参考市场主流所进行的字段配置完成集成方案的自定义化快速配置,即便是第一次使用轻易云平台的用户也能轻松搭建属于自己的数据同步方案。向导式配置,让配置更加清晰,首先确定该方方案的对接内容,第二歩获取筛选数据源平台的数据,第三步数据源与写入目标形成映射关系配置。完成配置后一键启用数据管道ETL:构建一体化的数据融合平台。高级数据转换: 支持公式转换数据格式、支持脚本直接进行数据转换、支持可视化多维度数据处理。高性能实时处理:针对不同数据节点类型提供TB级吞吐量,秒级延迟的增量数据处理能力。自动将旧版web服务转变为基于云端微服务的API,统一接口输出标准。支持接口开放服务,实现内外部能力接入。

积加ERP接口明细
- 接口:api/v2/report/dateRangeReports
- 接口名称:日期范围报告查询
- 接口方法:POST
请求参数
字段 | 名称 | 类型 |
orderType | 订单类型 | string |
sort | 排序 | string |
pagesize | 条数 | string |
order | 顺序或逆序 | string |
purchaseStartDate | 起始时间 | string |
sku | sku | string |
page | 页码 | string |
dynamicKey | dynamicKey | string |
dynamicKey1 | dynamicKey1 | string |
purchaseEndDate | 截止时间 | string |
marketIds | 站点集合 | string |
响应参数
字段 | 名称 | 类型 | 描述 |
id | 编号 | string | 38543485 |
baseTotal | baseTotal | string | |
tcscgst | 印度站专有Order-TCS-CGST | string | |
marketId | 站点编号 | string | 21 |
currency | 币种 | string | USD |
tcssgst | 印度站专有Order-TCS-SGST | string | |
tcsigst | 印度站专有Order-TCS-IGST | string | |
currencySymbol | 币种符号 | string | $ |
createDate | 创建时间 | string | Sep 1, 2021 11:32:16 PM PDT |
updateDate | 更新时间 | string | 44502.853761574 |
testOrder | 是否是测评订单 | string | |
standardDate | 标准时间 | string | 44440.980740741 |
testOrderName | 测评订单 | string | |
marketDate | 市场时间 | string | 44440.980740741 |
productName | 产品名称 | string | |
zeroDate | 零时区时间 | string | 44441.272407407 |
settlementId | 结算ID | string | 14700440741 |
countryCode | 国家编号 | string | |
orderType | 订单类型 | string | |
category | 类型 | string | |
categoryId | 类型编号 | string | |
tipoDeConta | 巴西站点专用类型 | string | |
categoryName | 类型名称 | string | |
type | 费用类型 | string | Liquidations |
asin | asin | string | |
orderId | 亚马逊订单编号 | string | 7577843508551 |
variationAsin | variationAsin | string | |
sku | sku | string | X002M2S7BT |
principal | principal | string | |
msku | msku | string | |
product | sku | string | X002M2S7BT |
commission | commission | string | |
feeType | 费用类型 | string | |
description | 费用说明 | string | 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 | 数量 | string | 1 |
marketplace | 市场 | string | |
fulfillment | 配送类型 | string | |
orderCity | 订单收货城市 | string | |
orderState | 订单收货区 | string | |
orderPostal | 邮编 | string | |
taxCollectionModel | 税收征管模式(此字段仅北美地区存在) | string | |
productSales | 订单中商品售价(已经乘以了数量) | string | 0.76 |
productSalesTax | 订单中商品价格税(已经乘以了数量) | string | |
shippingCredits | 订单中买家支付的运费(已经乘以了数量) | string | |
shippingCreditsTax | 订单中买家支付的运费税(已经乘以了数量) | string | |
giftWrapCredits | 订单中买家支付的礼品包装费(已经乘以了数量) | string | |
giftWrapCreditsTax | 订单中买家支付的礼品包装费的税(已经乘以了数量) | string | |
promotionalRebates | 订单中商品的折扣金额(已经乘以了数量) | string | |
promotionalRebatesTax | 折扣金额的税 | string | |
pointsGranted | 积分(订单费用明细中的PointsGranted,目前只有日本市场有此费用项目) | string | |
collectionVat | 征收增值税 | string | |
marketplaceWithheldTax | 市场预扣税 | string | |
sellingFees | 销售佣金 | string | |
fbaFees | 订单中商品的折扣金额(已经乘以了数量) | string | |
otherTransactionFees | 其他交易费用 | string | -0.36 |
other | 其他(含Refund-Goodwill费用) | string | |
total | 总计(前面所有费用合计) | string | 0.4 |
金蝶云星空接口明细
- 接口:batchSave
- 接口名称:其他应收单新增
- 接口方法:POST
请求参数
字段 | 名称 | 类型 |
FACCNTTIMEJUDGETIME | 到期日计算日期 | string |
FEntity | 单据明细 | array |
FPAYORGID | 收款组织 | string |
FEntity.FCREATEINVOICE | 已生成发票 | string |
FPRESETTEXT1 | 预设文本字段1 | string |
FEntity.FSourceBillNo | 源单编号 | string |
FEntity.Operation | 执行的操作 | string |
FEntity.FCOSTID | 费用项目编码 | string |
FEntity.FEntryTaxRate | 税率(%) | string |
FEntity.FIVAmountFor | 已开票金额 | string |
FEntity.FAMOUNTFOR_D | 修改携带量 | string |
FEntity.FCOMMENT | 备注 | string |
FMAINBOOKSTDCURRID | 本位币 | string |
FSETTLEORGID | 结算组织 | string |
FEntity.FNOTAXAMOUNTFOR | 不含税金额 | string |
FCONTACTUNITTYPE | 往来单位类型 | string |
FEntity.IsAutoSubmitAndAudit | 提交并审核 | bool |
FBillTypeID | 单据类型 | string |
FPRESETTEXT2 | 预设文本字段2 | string |
FTAXAMOUNT | 税额本位币 | string |
FAMOUNTFOR | 总金额 | string |
FCONTACTUNIT | 往来单位 | string |
FCancelStatus | 作废状态 | string |
FDATE | 业务日期 | string |
FCURRENCYID | 币别 | string |
FNOTAXAMOUNT | 不含税金额本位币 | string |
FEntity.IsVerifyBaseDataField | 验证基础资料 | bool |
FEntity.FormId | 业务对象表单Id | string |
FBillNo | 单据编号 | string |
FEXCHANGETYPE | 汇率类型 | string |
FEntity.FCOSTDEPARTMENTID | 费用承担部门 | string |
FEntity.FTAXAMOUNTFOR | 税额 | string |
系统对接概况
从API服务总线层面解决企业烟囱式业务系统集成现状 相互连接企业各业务系统,实现流程端到端打通,复用已有的业务系统能力,让集成架构、服务关系更清晰 使用统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升API利用率,发挥业务系统价值,实现企业IT资产的可插拔、可复用、可组成。


