易仓对接打通金蝶云星空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	默认仓库模块

数据对接效果

通过数据集成平台可视化的快速配置调用接口打通易仓与金蝶云星空之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。