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

对接系统管易云

管易云是上海管易云计算软件有限公司旗下的专注提供电商企业管理软件服务的品牌，总部位于中国上海张江高科技产业园区。管易云旗下拥有管易云C-ERP、EC-OMS、EC-WMS、B2C/B2B/BBC/微商城开发、PDA无纸化仓储解决方案、新零售一体化解决方案等产品

目标系统:金蝶云星空

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

数据集成方案配置

通过数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：管易云，并且选择对应的连接器（关于管易云的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的发货单查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器。选择对应的调拨单新增接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。

管易云接口明细

API：gy.erp.trade.deliverys.get
NAME：发货单查询
METHOD：POST

请求参数

接口字段字段名称预设值描述 start_create创建时间开始段 end_create创建时间结束段 start_delivery_date发货时间开始段{{LAST_SYNC_TIME datetime}} end_delivery_date发货时间结束段{{CURRENT_TIME datetime}} start_ modify_date修改时间开始段 end_ modify_date修改时间结束段 del返回是否作废的单据 delivery发货状态1 page_size分页大小{{PAGINATION_PAGE_SIZE}} page_no页号{{PAGINATION_START_PAGE}}

响应参数

接口字段字段名称预设值描述 idid code单据编号 warehouse_code仓库代码 shop_code店铺代码 outer_code平台单号 print打印状态 scan扫描状态 delivery发货状态 cod货到付款状态 vip_name会员名称 create_date制单时间 modify_date修改时间 delivery_date发货时间 cancel取消状态 payment已付金额 pay_time支付时间 invoiceDate确认开票时间 bigchar大头笔 unpaid_amount未付金额 cod_fee货到付款服务费 post_cost物流成本 plan_delivery_date预计发货时间 buyer_memo买家留言 seller_memo卖家备注 receiver_name收货人姓名 receiver_phone收货人电话 receiver_mobile收货人手机 receiver_zip收货邮编 receiver_address收货地址 create_name制单人 express_no快递单号 shop_name店铺名称 area_name收货地区 warehouse_name仓库名称 location_code库位代码 express_code快递公司代码 express_name快递公司名称 tag_name订单标记名称 seller_memo_late二次备注 shelf_no格子号 details商品列表 details.qty商品数量 details.price实际单价 details.amount商品总价 details.refund退款状态 details.itemCategoryName商品类别名称 details.itemUnitName商品单位 details.barcode商品条码 details.tariff关税 details.memo备注 details.picUrl图片地址 details.oid子订单号 details.trade_code销售订单号 details.item_id商品ID details.item_sku_id规格ID details.item_code商品代码 details.item_name商品名称 details.sku_code规格代码 details.sku_name规格名称 details.sku_note商品的规格备注 details.discount_fee让利金额 details.amount_after让利后金额 details.post_fee物流费用 details.order_type订单类型 details.platform_flag平台旗帜 details.detail_unique唯一码列表 details.detail_batch批次列表 details.is_gift是否赠品 details.businessman_name业务员 details.platform_code平台单号 details.tax_rate税率 details.tax_amount税额 details.tax_no税号 details.other_service_fee其他服务费 details.gift_source_view赠品来源 details.currency_code币别代码 details.currency_name币别名称 details.detail_batch批次列表 details.detail_batch.batchNumber批次号 details.detail_batch.qty数量 details.detail_batch.productionTime生产日期 details.detail_batch.validTime有效日期 details.detail_batch.delivery_statusInfo单据状态信息 details.detail_batch.delivery_statusInfo.delivery_date发货时间 details.detail_batch.delivery_statusInfo.invoices发票列表 details.detail_batch.delivery_statusInfo.vip_code会员代码 details.detail_batch.delivery_statusInfo.vip_real_name真实姓名 details.detail_batch.delivery_statusInfo.vip_id_card身份证号码 details.detail_batch.delivery_statusInfo.package_center_code集包地代码 details.detail_batch.delivery_statusInfo.package_center_name集包地名称 details.detail_batch.delivery_statusInfo.sync_status数据同步状态 details.detail_batch.delivery_statusInfo.sync_memo数据同步备注 details.detail_batch.delivery_statusInfo.picture_bill是否多包裹 details.detail_batch.delivery_statusInfo.drp_tenant_name分销商名称 details.detail_batch.delivery_statusInfo.drp_tenant_mobile分销商手机号

金蝶云星空接口明细

API：batchSave
NAME：调拨单新增
METHOD：POST

请求参数

接口字段字段名称预设值描述 FBillNo单据编号{{code}}单据编号 FBillTypeID单据类型ZJDB01_SYS单据类型 FBillNo单据编号{{code}}单据编号 FBizType业务类型NORMAL下拉列表 FTransferDirect调拨方向GENERAL下拉列表 FTransferBizType调拨类型InnerOrgTransfer下拉列表 FSaleOrgId销售组织组织 FSettleOrgId结算组织组织 FStockOutOrgId调出库存组织组织 FOwnerTypeOutIdHead调出货主类型多类别基础资料列表 FOwnerOutIdHead调出货主多类别基础资料 FStockOrgId调入库存组织组织 FSETTLECURRID结算币别基础资料 FDate日期{{modify_date}}日期 FNote备注多行文本 F_ora_Text表头网上订单号{{platform_code}}多行文本 FBillEntry明细信息details1 FBillEntry.FMaterialId物料编码{{details.item_code}}基础资料 FBillEntry.FCMKBarCode零售条形码文本 FBillEntry.FQty调拨数量{{details.qty}}数量 FBillEntry.FSrcStockId调出仓库CK001基础资料 FBillEntry.FDestStockId调入仓库CK004基础资料 FBillEntry.FNoteEntry备注多行文本 FBillEntry.FISFREE赠品复选框 FBillEntry.FormId业务对象表单IdSTK_TransferDirect必须填写金蝶的表单ID如😛UR_PurchaseOrder FBillEntry.IsAutoSubmitAndAudit提交并审核false FBillEntry.IsVerifyBaseDataField验证基础资料false是否验证所有的基础资料有效性，布尔类，默认false（非必录） FBillEntry.Operation执行的操作Save

系统对接概况

全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系。API低代码开发平台能够实现低代码或零代码一键发布API服务，很好地解决企业用户上面的问题。轻易云应用集成主要解决已有应用系统的无序蔓延现象，减少各业务系统间的维护成本，减少各应用系统的操作系统、开发语言、访问协议、通信技术多而杂、整合难度大的问题，将企业数据平滑对接，减少信息竖井。

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