易仓和金蝶云星空接口打通对接实战对接系统：易仓易仓作为一家专门服务于跨境电商行业的纯软件服务商，为了更好的服务跨境电商，易仓旗下服务平台“跨境眼”可以帮助卖家轻松对接到各个仓储物流服务商、同时支持财税业务的对接。对接目标系统:金蝶云星空金蝶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 1 1 当前页（格式参考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 单据类型 string QTRKD03_SYS FStockOrgId 库存组织 string findCollection find warehouseCode from de1387a4-c479-35db-9bcb-c73858fcb2b1 where warehouseId={{warehouse_id}} FStockDirect 库存方向 string FDate 日期 string {{complete_time}} FSUPPLIERID 供应商 string FDEPTID 部门 string BM000005 FOwnerTypeIdHead 货主类型 string BD_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 物料编码 string findCollection 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 业务对象表单Id string STK_MISCELLANEOUS FEntity.IsVerifyBaseDataField 验证基础资料 bool false FEntity.Operation 执行的操作 string Save FEntity.IsAutoSubmitAndAudit 提交并审核 bool true 系统集成总览从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通易仓到金蝶云星空之间数据集成；通过API连接各业务系统，复用已有的业务系统能力，让集成架构、服务关系更清晰。使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升复用率和价值。全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+，快速对接各种API接口，实现云上云下的互联互通。将SaaS和本地业务系统联接起来，打破时间与空间界限，打通原有核心数据及SaaS应用，构建可平滑演进的企业IT架构。

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

汪淼_轻易云

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

对接系统：易仓

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

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

金蝶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	单据类型	string	QTRKD03_SYS
FStockOrgId	库存组织	string	findCollection find warehouseCode from de1387a4-c479-35db-9bcb-c73858fcb2b1 where warehouseId={{warehouse_id}}
FStockDirect	库存方向	string
FDate	日期	string	{{complete_time}}
FSUPPLIERID	供应商	string
FDEPTID	部门	string	BM000005
FOwnerTypeIdHead	货主类型	string	BD_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	物料编码	string	findCollection 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	业务对象表单Id	string	STK_MISCELLANEOUS
FEntity.IsVerifyBaseDataField	验证基础资料	bool	false
FEntity.Operation	执行的操作	string	Save
FEntity.IsAutoSubmitAndAudit	提交并审核	bool	true

系统集成总览

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