易仓和金蝶云星空接口打通对接实战

对接系统：易仓

易仓作为一家专门服务于跨境电商行业的纯软件服务商，为了更好的服务跨境电商，易仓旗下服务平台“跨境眼”可以帮助卖家轻松对接到各个仓储物流服务商、同时支持财税业务的对接。

对接目标系统:金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

多系统对接方案配置

异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则，例如取数就要根据查询接口获取易仓的数据，并且根据对应的条件进行取数，目标系统就必须根据目标系统的格式，以及获取的数据进行加工处理后进行写入到金蝶云星空中。轻易云集成平台的可视化配置轻松实现。

易仓接口明细

API：getReceiving
NAME：WMS-查询入库单信息
METHOD：POST

请求参数

接口字段字段名称预设值描述 receiving_code入库单号入库单号,支持多个示例：["R11111111111","R222222222"] reference_no客户参考号客户参考号 tracking_number跟踪号跟踪号 po_code采购单号采购单号 warehouse_id仓库Id仓库Id receiving_type类型5类型： 0标准， 1订单退货， 2指定产品退件， 3中转， 4采购， 5其它， 6借用归还入库， 7初始化库存， 8不良品入库， 9盘盈， 10调拨 11换货， 12同步服务商库存， 13出库单入库， 14同步添加库存， 15赠品入库 receiving_status入库单状态7入库单状态： 0删除， 1草稿， 2确认， 3待审核， 4审核， 5在途， 6收货中， 7收货完成 productBarcode产品代码产品代码 productBarcode_like产品代码产品代码（模糊） receiving_add_user采购员采购员（用户Id） code_like单号单号（入库单、参考号、采购单） supplier供应商ID供应商ID（多个），格式：[1,2,3,4,5] order_by排序方式（多个）格式排序方式（多个）格式：["receiving_add_time desc","receiving_id desc"] searchDateType查询时间类型receiving_update_time查询时间类型: receiving_add_time 创建时间， receiving_update_time 更新时间， expected_date 预期时间 ec_create_time 统计数据报表(创建时间) ec_update_time 统计数据报表(更新时间) dateFor大于等于某个时间类型function DATE_SUB(now(),INTERVAL 5 DAY)大于等于某个时间类型（必须配合 searchDateType 参数使用） dateTo小于等于某个时间类型{{CURRENT_TIME datetime}}小于等于某个时间类型（必须配合 searchDateType 参数使用） pagination分页pagination分页： "pagination":{"page":3,"pageSize":60}, pagination.page当前页_function 11当前页（格式参考pagination） pagination.pageSize每页显示条数_function 50*1每页显示条数（默认为：50）（格式参考pagination）

响应参数

接口字段字段名称预设值描述 receiving_code入库单号入库单号 reference_no客户参考号客户参考号 po_code采购单号采购单号 warehouse_id仓库Id仓库Id tracking_number跟踪号跟踪号 to_warehouse_id目的仓库Id目的仓库Id customer_code客户代码客户代码 receiving_type类型类型： 0标准， 1订单退货， 2指定产品退件， 3中转， 4采购， 5其它， 6借用归还入库， 7初始化库存， 8不良品入库， 9盘盈， 10调拨， 11换货， 12同步服务商库存， 13出库单入库， 14同步添加库存， 15赠品入库 receiving_transfer_status中转状态中转状态： 0草稿， 1待处理， 2处理中， 3处理完成 receiving_status入库单状态入库单状态： 0删除， 1草稿， 2确认， 3待审核， 4审核， 5在途， 6收货中， 7收货完成 receiving_description备注备注 receiving_add_time创建时间创建时间 receiving_update_time更新时间（操作收货/质检/上架时，将更新此时间）更新时间（操作收货/质检/上架时，将更新此时间） receiving_id入库单Id入库单Id expected_date预计到达时间预计到达时间 warehouse仓库仓库 receivingExStatus处理收货异常处理收货异常 purchase_cost采购成本采购成本 transfer_shipping_fee程成本程成本 currency_code币种币种 product_info产品信息产品信息 product_info.product_barcode产品代码产品代码 product_info.product_title产品名称产品名称 product_info.rd_status状态码状态码 product_info.rd_status_string状态名称状态名称 product_info.rd_receiving_qty送货数量送货数量 product_info.rd_received_qty收货数量收货数量 product_info.dif_receive_num收货数量差异收货数量差异 product_info.rd_putaway_qty上架数量上架数量 product_info.is_qc是否质检是否质检 product_info.is_priority优先处理优先处理 product_info.rd_update_time更新时间更新时间 product_info.rd_note备注备注 product_info.complete_time收货完成时间收货完成时间 product_info.putaway_time上架完成时间取值上架完成时间取值 product_info.ec_update_time更新时间更新时间

金蝶云星空接口明细

调用接口：batchSave
接口名称：其他入库新增
方法：POST

请求参数

字段字段名称类型配置值 FBillNo单据编号string{{receiving_code}} FBillTypeID单据类型stringQTRKD03_SYS FStockOrgId库存组织stringfindCollection find warehouseCode from de1387a4-c479-35db-9bcb-c73858fcb2b1 where warehouseId={{warehouse_id}} FStockDirect库存方向string FDate日期string{{complete_time}} FSUPPLIERID供应商string FDEPTID部门stringBM000005 FOwnerTypeIdHead货主类型stringBD_OwnerOrg FOwnerIdHead货主string_findCollection find warehouseCode from de1387a4-c479-35db-9bcb-c73858fcb2b1 where warehouseId={{warehouse_id}} FNOTE备注string FEntity明细信息array FEntity.FInStockType入库类型string FEntity.FMATERIALID物料编码stringfindCollection find FNumber from 32df639a-9c45-3823-8a92-1e2ceb30649e where FOldNumber={{product_info_product_barcode}} FEntity.FCMKBarCode零售条形码string FEntity.FSTOCKID收货仓库string_findCollection find warehouseCode from de1387a4-c479-35db-9bcb-c73858fcb2b1 where warehouseId={{warehouse_id}} FEntity.FStockLocId仓位string FEntity.FLOT批号string FEntity.FQty实收数量string{{product_info_rd_receiving_qty}} FEntity.FPrice成本价string FEntity.FEntryNote备注string FEntity.FSRCBILLNO源单编号string FEntity.FSRCBILLTYPEID源单类型string FEntity.FormId业务对象表单IdstringSTK_MISCELLANEOUS FEntity.IsVerifyBaseDataField验证基础资料boolfalse FEntity.Operation执行的操作stringSave FEntity.IsAutoSubmitAndAudit提交并审核booltrue

系统集成总览

从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通易仓到金蝶云星空之间数据集成；通过API连接各业务系统，复用已有的业务系统能力，让集成架构、服务关系更清晰。使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升复用率和价值。全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+，快速对接各种API接口，实现云上云下的互联互通。将SaaS和本地业务系统联接起来，打破时间与空间界限，打通原有核心数据及SaaS应用，构建可平滑演进的企业IT架构。

易仓和金蝶云星空接口打通对接实战