易仓对接打通金蝶云星空eb-查询订单列表接口与销售出库新增接口
易仓对接打通金蝶云星空eb-查询订单列表接口与销售出库新增接口
数据源平台:易仓
圳市易仓科技有限公司一直致力于研发高效可控的跨境管理模式。精研跨境电商ERP、国际物流TMS、海外仓WMS和跨境分销M2B等管理系统。汇集目前国内强大的IT团队,创始人和开发巨匠均在跨境B2C、海外仓、国际物流等领域有5-12年研发经验,易仓目前已和国内外众多跨境卖家、海外仓服务商和国际物流等跨境巨头合作。
接通系统:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
系统对接接口配置
系统对接前期需要通过调研公司的业务,规划出最便捷,效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地,轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台:易仓的接口参数设置,以及设定好目标平台:金蝶云星空的映射,即可启动方案进行测试
易仓接口明细
- 接口:getOrderList
- 接口名称:eb-查询订单列表
- 接口方法:POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
| page | 页数 | int | |
| pageSize | 页码 | int | |
| getDetail | 是否返回订单明细数据 | string | 1:返回,0:不返回 |
| getAddress | 是否返回订单地址数据 | string | 1:返回,0:不返回 |
| getCustomOrderType | 是否返回自定义订单类型 | string | 1:返回,0:不返回 |
| year | 按年份查询订单 | string | 传年份:2019 |
| condition | 查询条件 | object | Request.condition |
| condition.status | 订单状态 | string | 0:已废弃,1:付款未完成,2:待发货审核,3:待发货,4:已发货,5:冻结中,6:缺货,7:问题件,8:未付款 |
| condition.processAgains | 待发货下的处理状态 | string | 如:["1","2"] |
| condition.createdDateAfter | 最早创建时间(原单等于平台创建时间。拆分、合并后的订单等于易仓系统创建时间) | string | |
| condition.createdDateBefore | 最晚创建时间 | string | |
| condition.updateDateAfter | 最早更新时间 | string | |
| condition.updateDateBefore | 最晚更新时间 | string | |
| condition.shipDateFrom | 最早发货时间 | string | |
| condition.shipDateEnd | 最晚发货时间 | string | |
| condition.refNos | 参考号列表 | string | 如:["CODE1","CODE2","CODE3"] |
| condition.saleOrderCodes | 销售单号 | string | 如:["CODE1","CODE2","CODE3"] |
| condition.platformShipDateFrom | 平台发货时间始 | string | |
| condition.platformShipDateEnd | 平台发货时间尾 | string | |
| condition.warehouseOrderCodes | 仓库单号 | string | 如:["CODE1","CODE2","CODE3"] |
| condition.warehouseShipDateFrom | 仓库发货时间始 | string | |
| condition.productSku | 仓库sku | string | 如:["CODE1","CODE2","CODE3"] |
| condition.warehouseShipDateEnd | 仓库发货时间尾 | string | |
| condition.userAccounts | 平台账号 | string | 如:["CODE1","CODE2","CODE3"] |
| condition.datePaidPlatformMin | 平台付款时间始 | string | |
| condition.shippingMethod | 运输方式代码 | string | 如:["CODE1","CODE2","CODE3"] |
| condition.datePaidPlatformMax | 平台付款时间尾 | string | |
| condition.warehouseIds | 仓库ID | string | 如:["45","78","62"] |
| condition.dateCreatePlatformFrom | 平台创建时间始(订单列表显示的创建时间(amazon订单为付款时间) | string | 拆分订单取原单平台创建时间。合并订单 随机取一个原单的平台创建时间) |
| condition.dateCreatePlatformEnd | 平台创建时间尾 | string | |
| condition.dateCreateSysFrom | 易仓系统创建时间始 | string | |
| condition.dateCreateSysEnd | 易仓系统创建时间尾 | string | |
| condition.buyerName | 买家名称 | string | |
| condition.platform | 平台代码 | string | (订单进入易仓系统数据库时间-2020年9月之后的订单才这个字段才有数据-之前订单数据为 aliexpresscn为1688采购单 |
| condition.idDesc | 是否按id 降序 0:升序 1:降序 | string | |
| condition.customOrderType | 自定义订单类型名称 | string | |
| condition.isMark | 订单标记状态 0:未标记 1:已标记 | string | |
| condition.createType | 创建类型:api下载的订单 | string | upload批量上传订单 |
| condition.isCod | 是否是货到付款订单(COD) 0 不是 1 是 | string |
响应参数
| 字段 | 名称 | 类型 | 描述 |
| order_id | 订单ID | string | (易仓系统主键id 。 |
| orderDetails | 订单明细 | array | getDetail=1时返回 |
| orderDetails.op_id | 主键 | string | |
| orderDetails.productSku | 销售sku | string | |
| orderDetails.sku | 仓库sku对应关系 :sku | string | |
| orderDetails.warehouseSku | 仓库sku | string | |
| orderDetails.warehouseSkuQty | 仓库sku*数量 | string | |
| orderDetails.warehouseSkuList | 仓库sku和数量组成Object | string | |
| orderDetails.unitPrice | 单价 | string | |
| orderDetails.itemPrice | Amazon订单商品原单价 | string | |
| orderDetails.originalUnitPrice | Amazon订单商品原单价 | string | |
| orderDetails.qty | 数量 | string | |
| orderDetails.productTitle | 产品名称 | string | |
| orderDetails.pic | 产品封面图片 | string | |
| orderDetails.opSite | 产品站点 | string | |
| orderDetails.productUrl | 产品url | string | |
| orderDetails.refItemId | 跟踪明细id,产品明细唯一标识 | string | |
| orderDetails.opRefItemLocation | ebay Item产地,Amazon商品ASIN值 | string | |
| orderDetails.unitFinalValueFee | 单个交易费 | string | |
| orderDetails.transactionPrice | 单个手续费 | string | |
| orderDetails.operTime | 最后更新时间 | string | |
| orderDetails.action | 产品是否发货 0:发 1:不发 | string | |
| orderDetails.saleOrderCodeOrg | 平台原始订单号 | string | |
| orderDetails.opRefTnx | 产品明细对应TransactionID | string | |
| orderDetails.productSkuOrg | 原平台销售SKU | string | |
| orderDetails.qtyOrg | 原平台销售SKU数量 | string | |
| orderDetails.remark | 产品备注 | string | |
| orderDetails.promotionIdList | 商品促销编码列表 | string | |
| orderDetails.orderAddress | 订单地址 | string | getAddress=1时返回 |
| orderDetails.platform | 平台代码 | string | |
| orderDetails.orderType | 订单类型 | string | ,sale:正常销售订单,resend:重发订单,line:线下订单 |
| orderDetails.customOrderType | 自定义订单类型 | string | |
| orderDetails.createType | 创建类型 | string | api下载的订单,upload批量上传订单,hand手工创建订单 |
| orderDetails.isMark | 订单标记状态 0:未标记 1:已标记 | string | 0:未标记 1:已标记 |
| orderDetails.customerServiceNote | 客服备注 | string | |
| orderDetails.status | 订单状态 | string | 0:已废弃,1:付款未完成,2:待发货审核,3:待发货,4:已发货,5:冻结中,6:缺货,7:问题件,8:未付款 |
| orderDetails.processAgain | 待发货下的处理状态 | string | 1:已处理,2:未处理,3:处理异常 |
| orderDetails.discount_val | 折扣 | string | |
| orderDetails.refNo | 参考单号 | string | |
| orderDetails.paypalAccount | paypal收款帐户 | string | (如果存在多个以;隔开显示) |
| orderDetails.dateCreateSys | 系统创建时间 | string | 订单进入易仓系统数据库时间-2010年9月之后的订单才这个字段才有数据-之前订单数据为 |
| orderDetails.trackStatus | 包裹状态 | string | 0 待查询 1 额度不足 2 排除查询 3查询中 4查询不到 5运输途中 6到达待取 7成功签收 8运输过久 9可能异常 10投递失败 |
| orderDetails.isBusinessOrder | 是否B2B订单 | string | |
| orderDetails.trackDeliveredTime | 签收时间 | string | |
| orderDetails.buyerTaxRegistrationId | 收税人税号 | string | |
| orderDetails.saleOrderCode | 销售单号 | string | 此值 对应 易仓订单系统-》 各平台 订单列表中的 订单号 — 订单系统的 唯一值 |
| orderDetails.SystemTagEn | 系统标记-英文 | string | |
| orderDetails.sysOrderCode | 系统单号 | string | |
| orderDetails.SystemTagZh | 系统标记-中文 | string | |
| orderDetails.warehouseOrderCode | 仓库单号 | string | |
| orderDetails.companyCode | 公司代码 | string | |
| orderDetails.CustomTagEn | 自定义标记-英文 | string | |
| orderDetails.CustomTagZh | 自定义标记-中文 | string | |
| orderDetails.userAccount | 账号 | string | |
| orderDetails.platformUserName | 账号别名 | string | |
| orderDetails.outboundBatchCarrier | 总单承运商 | string | |
| orderDetails.shippingMethod | 仓库运输方式代码 | string | |
| orderDetails.outboundBatchTrackingNo | 总单跟踪号 | string | |
| orderDetails.createrUserCode | 订单创建人系统登录账户 | string | |
| orderDetails.shippingMethodNo | 跟踪号 | string | |
| orderDetails.shippingMethodPlatform | 平台运输方式代码 | string | |
| orderDetails.createrUserName | 订单创建人中文姓名 | string | |
| orderDetails.warehouseId | 仓库id | string | |
| orderDetails.createrUserNameEn | 订单创建人英文姓名 | string | |
| orderDetails.systemNote | 系统备注 | string | |
| orderDetails.warehouseCode | 仓库代码 | string | |
| orderDetails.billNo | 账单号 | string | |
| orderDetails.createdDate | 创建时间 | string | (原单等于平台创建时间。拆分、合并后的订单等于易仓系统创建时间) |
| orderDetails.isReplacementOrder | 是否为Amazon换货单 | string | |
| orderDetails.updateDate | 更新时间 | string | |
| orderDetails.datePaidPlatform | 平台付款时间 | string | |
| orderDetails.fbaFee | FBA费用 | string | |
| orderDetails.dateCreatePlatform | 平台创建时间 | string | |
| orderDetails.sellerRebate | 平台补贴费 | string | |
| orderDetails.fbaShippingDate | FBA订单发货时间 | string | |
| orderDetails.platformShipStatus | 平台发货状态 | string | 0:未发货,1:已发货 |
| orderDetails.platformShipTime | 平台发货时间 | string | |
| orderDetails.overstock | 仅在Teapplix平台下订单来源为supplieroasis的订单才会返回overstock单号。 | string | |
| orderDetails.dateWarehouseShipping | 仓库发货时间 | string | |
| orderDetails.isCod | 是否是cod订单 0 不是 1是 | string | |
| orderDetails.fulfillmentType | 订单发货类型 0:自发货订单 1:平台海外仓发货订单 | string | |
| orderDetails.dateLatestShip | 最晚发货时间 | string | |
| orderDetails.currency | 币种 | string | |
| orderDetails.amountpaid | 总金额 | string | |
| orderDetails.subtotal | 销售额 | string | |
| orderDetails.shipFee | 运费 | string | |
| orderDetails.platformFeeTotal | 总手续费 | string | |
| orderDetails.finalvaluefeeTotal | 总交易费 | string | |
| orderDetails.otherFee | 其他费用 | string | |
| orderDetails.costShipFee | 试算运费 | string | |
| orderDetails.buyerId | 买家ID | string | |
| orderDetails.buyerName | 买家名称 | string | |
| orderDetails.buyerMail | 买家邮箱 | string | |
| orderDetails.site | 订单站点 | string | |
| orderDetails.countryCode | 收件人国家二字码 | string | |
| orderDetails.productCount | 订单出库数量 | string | |
| orderDetails.orderWeight | 订单重量 | string | |
| orderDetails.orderDesc | 买家留言 | string | |
| orderDetails.paypalTransactionId | paypal交易号 | string | |
| orderDetails.paymentMethod | 付款方式/支付方式 | string | (仅Shopee、daraz、aliexpress、lazada、magento平台可用) |
| orderDetails.abnormalType | 异常类型 | string | 1:换地址,2:退货取消,3:换SKU,4:其他,5:同步服务商失败,6:断货,7:SKU未找到, 11:无门牌号, 12:计费失败, 21:账户未设置FBA/FBC订单分配规则,22:表示仓库缺货的问题类型,23:表示仓库未找到SKU信息的问题类型,30:仓库拦截中 |
| orderDetails.abnormalReason | 异常信息 | string | |
| orderDetails.orderConfigDatas | 原始订单数据, | string |
金蝶云星空接口明细
- 接口:batchSave
- 接口名称:销售出库新增
- 接口方法:POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
| FBillTypeID | 单据类型 | string | 单据类型 |
| FBillNo | 单据编号 | string | 单据编号 |
| FDate | 日期 | string | 日期 |
| FSaleOrgId | 销售组织 | string | 组织 |
| FCustomerID | 客户 | string | 基础资料 |
| FStockOrgId | 发货组织 | string | 组织 |
| FCarriageNO | 运输单号 | string | 文本 |
| FLinkPhone | 联系电话 | string | 文本 |
| FLinkMan | 收货人姓名 | string | 文本 |
| FReceiveAddress | 收货方地址 | string | 文本 |
| SubHeadEntity | 财务信息 | object | |
| SubHeadEntity.FReceiverAddress | 收货人地址 | string | 文本 |
| SubHeadEntity.FReceiverName | 收货人 | string | 文本 |
| SubHeadEntity.FReceiverMobile | 收货人手机 | string | 文本 |
| SubHeadEntity.FEntity | 明细信息 | array | |
| SubHeadEntity.FEntity.FMaterialID | 物料编码 | string | 基础资料 |
| SubHeadEntity.FEntity.FRealQty | 实发数量 | string | 数量 |
| SubHeadEntity.FEntity.FTaxPrice | 含税单价 | string | 单价 |
| SubHeadEntity.FEntity.FStockID | 仓库 | string | 基础资料 |
| SubHeadEntity.FEntity.FEOwnerSupplierId | 明细货主供应商 | string | |
| SubHeadEntity.FEntity.FESettleCustomerId | 明细结算组织客户 | string | |
| SubHeadEntity.FEntity.F_ABCD_Text1 | 参考号 | string | |
| SubHeadEntity.FEntity.F_ABCD_zhm | 组合名 | string | |
| SubHeadEntity.FEntity.F_ABCD_zhmsl | 组合品数量 | string | |
| SubHeadEntity.FEntity.F_ABCD_Text | 仓库配送 | string | |
| SubHeadEntity.FEntity.F_ABCD_Text2 | 跟踪号 | string | |
| SubHeadEntity.FEntity.F_ABCD_Decimal | 手续费 | string | |
| SubHeadEntity.FEntity.FormId | 业务对象表单Id | string | 必须填写金蝶的表单ID如:PUR_PurchaseOrder |
| SubHeadEntity.FEntity.Operation | 执行的操作 | string | |
| SubHeadEntity.FEntity.IsAutoSubmitAndAudit | 提交并审核 | bool | |
| SubHeadEntity.FEntity.IsVerifyBaseDataField | 验证基础资料 | bool | 是否验证所有的基础资料有效性,布尔类,默认false(非必录) |
| SubHeadEntity.FEntity.SubSystemId | 系统模块 | string | 默认仓库模块 |
数据对接效果
通过数据集成平台可视化的快速配置调用接口打通易仓与金蝶云星空之间的数据接口,使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具,基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎,通过可视化配置,快速实现客户灵活多变的动态集成需求,让集成开发简单、执行过程可靠、问题风险可控。
版权声明
该文章 《易仓对接打通金蝶云星空eb-查询订单列表接口与销售出库新增接口》 为原创内容,版权归 广东轻亿云软件科技有限公司 所有。欢迎转载,但转载时必须在显著位置注明文章出处(包括原文链接)等信息,以尊重版权。


