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

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

源系统:管易云·奇门

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

接通系统：金蝶云星空

金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。

系统对接接口配置

集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：管易云·奇门，源系统 API：历史发货单查询，目标系统：金蝶云星空，目标系统 API销售出库新增。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。

管易云·奇门接口明细

• 接口：gy.erp.trade.deliverys.history.get
• 接口名称：历史发货单查询
• 接口方法：POST

请求参数

字段名称类型描述 start_delivery_date发货时间开始段string与end_delivery_date搭配使用，时间跨度不能超过24小时 end_delivery_date发货时间结束段string与start_delivery_date搭配使用，时间跨度不能超过24小时 shop_code店铺代码string提供此参数则发货时间参数可不填 code单据编号string提供此参数则发货时间参数可不填 sync_status数据同步状态string1:同步失败 0:未同步 1:已同步不传，不检查该状态 page_no页号string默认1 page_size分页大小string默认为10

响应参数

字段名称类型描述 create_date制单时间string sync_memo数据同步备注string1:同步失败0：未同步1：已同步 picture_bill是否多包裹stringtrue：多包裹false：单包裹 sync_status数据同步状态string0:未同步1:已同步 code单据编号string qty商品总数string amount总金额string payment已付金额string pay_time支付时间string cod是否货到付款string refund是否退款string0:无退款1:有退款 invoiceDate确认开票时间string platform_code平台单号string unpaid_amount未付金额string post_fee物流费用string cod_fee货到付款服务费string discount_fee优惠金额string post_cost物流成本string plan_delivery_date预计发货时间string buyer_memo买家留言string seller_memo卖家备注string receiver_name收货人姓名string receiver_phone收货人电话string receiver_mobile收货人手机string receiver_zip收货邮编string receiver_address收货地址string create_name制单人string express_no快递单号string vip_name会员名称string shop_name店铺名称string area_name收货地区string warehouse_name仓库名称string express_code快递公司代码string express_name快递公司名称string tag_name订单标记名称string seller_memo_late二次备注string shelf_no库位代码string details商品列表array details.qty商品数量string details.price实际单价string details.amount商品总价string details.memo备注string details.picUrl图片地址string details.trade_code销售订单号string details.item_id商品IDstring details.item_sku_id规格IDstring details.item_code商品代码string details.item_name商品名称string details.sku_code规格代码string details.sku_name规格名称string details.sku_note商品的规格备注string details.discount_fee让利金额string details.amount_after让利后金额string details.post_fee物流费用string details.order_type订单类型string details.platform_flag平台旗帜string details.detail_unique唯一码列表string details.detail_batch批次列表string details.businessman_name业务员string details.is_gift是否赠品string0:不是1:是 details.platform_code平台单号string details.tax_rate税率string details.tax_amount税额string details.other_service_fee其他服务费string details.gift_source_view赠品来源string details.currency_code币别代码string details.currency_name币别名称string details.vip_code会员代码string details.warehouse_code仓库代码string details.shop_code店铺代码string details.vip_real_name真实姓名string details.vip_id_card身份证号码string

金蝶云星空接口明细

• 接口：batchSave
• 接口名称：销售出库新增
• 接口方法：POST

请求参数

字段名称类型描述 FBillTypeID单据类型string单据类型 FBillNo单据编号string单据编号 FDate日期string日期 FSaleOrgId销售组织string组织 FCustomerID客户string基础资料 FSaleDeptID销售部门string基础资料 FStockOrgId发货组织string组织 FNote备注string多行文本 F_abc_Assistant物流公司string FOwnerIdHead货主string多类别基础资料 FEntity明细信息array FEntity.FCustMatID客户物料编码string基础资料 FEntity.FMaterialID物料编码string基础资料 FEntity.FBarcode零售条形码string文本 FEntity.FRealQty实发数量string数量 FEntity.FPrice单价string单价 FEntity.FTaxPrice含税单价string单价 FEntity.FIsFree是否赠品string复选框 FEntity.FLot批号string批次 FEntity.FProduceDate生产日期string日期 FEntity.FExpiryDate有效期至string日期 FEntity.FEntryTaxRate税率%string小数 FEntity.FEntryTaxAmount税额string金额 FEntity.FAmount金额string金额 FEntity.FAllAmount价税合计string金额 FEntity.FStockID仓库string基础资料 FEntity.FStockLocID仓位string维度关联字段 FEntity.FStockStatusID库存状态string基础资料 FEntity.FMtoNo计划跟踪号string文本 FEntity.FEntrynote备注string文本 FEntity.FSoorDerno订单单号string文本 FEntity.FDiscountRate折扣率%string小数 FEntity.FormId业务对象表单Idstring必须填写金蝶的表单ID如😛UR_PurchaseOrder FEntity.Operation执行的操作string FEntity.IsAutoSubmitAndAudit提交并审核bool FEntity.IsVerifyBaseDataField验证基础资料bool是否验证所有的基础资料有效性，布尔类，默认false（非必录） FEntity.SubSystemId系统模块string默认仓库模块

系统数据集成价值

当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。