管易云和金蝶云星空集成接口设计

源系统:管易云

金蝶管易云是金蝶集团旗下以电商和新零售为核心业务的子公司，公司于2008年成立，拥有从事电商及新零售业务相关专业知识工作者超过1000人。为伊利、网易有道、东阿阿胶、金龙鱼、海康、科大讯飞等超过110000家企业客户提供专业服务，用户数超过100万人。金蝶管易云与淘宝、天猫、京东、拼多多、抖音等超过150+主流电商平台建立合作关系。

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

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

数据集成方案配置

轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线，所以对接方案的配置极其重要，方案可以选择一键复制，轻易云有海量的对接方案可支持一键复制，复制后直接启动使用（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置，配置只要确认源平台：管易云的取数逻辑，例如什么时间取什么样的数据。即可完成配置，目标平台：金蝶云星空，把获取的数据组装成目标系统需要的格式进行写入。

管易云接口明细

API：gy.erp.purchase.return.get
NAME：采购退货单查询
METHOD：POST

请求参数

接口字段名称预设值 page_no页码 page_size每页大小 start_create创建时间开始段 end_create创建时间结束段 start_approve审核时间开始段 end_approve审核时间结束段 start_modify_date开始修改时间 end_modify_date结束修改时间 warehouse_code仓库代码 supplier_code供应商代码 code单据编号 status订单状态 page_size分页大小{{PAGINATION_PAGE_SIZE}} page_no页号{{PAGINATION_START_PAGE}}

响应参数

接口字段名称预设值 idid code单据编号 create_date创建时间 approve_date审核时间 account_date记账日期 modify_date修改日期 out_warehouse_date出库日期 warehouse_code仓库代码 supplier_code供应商代码 supplier_name供应商名称 status订单状态 details采购退货明细 details.qty数量 details.price实际进价 details.amount实际金额 details.note备注 details.item_id商品iD details.item_sku_id规格ID details.item_code商品代码 details.sku_code规格代码 details.sku_note规格备注 details.sku_name规格名称 details.detail_unique唯一码列表 details.detail_batch批次列表 details.detail_batch.batchNumber批次号 details.detail_batch.warehousing_time入库日期 details.detail_batch.production_time生产日期 details.detail_batch.shelf_life保质期 details.detail_batch.valid_time有效日期 details.create_name制单人 details.delete_date作废日期 details.delete_status作废状态 details.out_warehouse_status出库状态 details.account_status记账状态

金蝶云星空接口明细

调用接口：batchSave
接口名称：采购退货新增
方法：POST

请求参数

字段字段名称类型配置值 FBillNo单据编号string FDate退料日期string FSupplierID供应商string FMRTYPE退料类型string FMRMODE退料方式string FStockOrgId退料组织string FMRDeptId退料部门string FREPLENISHMODE补料方式string FMRREASON退料原因string FDESCRIPTION备注string FSettleId结算方string FCHARGEID收款方string FDELIVERYNO送货单号string FCARRYNO运输单号string FTAKEDELIVERYNO提货单号string FSettleOrgId结算组织string FSETTLETYPEID结算方式string FSettleCurrId结算币别string FPayOrgId付款组织string FPAYCONDITIONID付款条件string FOwnerTypeIdHead货主类型string FOwnerIdHead货主string FPURMRBENTRY明细信息array FPURMRBENTRY.FMATERIALID物料编码string FPURMRBENTRY.FBarcode零售条形码string FPURMRBENTRY.FRMREALQTY实退数量string FPURMRBENTRY.FREPLENISHQTY补料数量string FPURMRBENTRY.FKEAPAMTQTY扣款数量string FPURMRBENTRY.FSTOCKID仓库string FPURMRBENTRY.FSTOCKLOCID仓位string FPURMRBENTRY.FNOTE备注string FPURMRBENTRY.FPrice单价string FPURMRBENTRY.FGiveAway是否赠品string FPURMRBENTRY.FLot批号string FPURMRBENTRY.FOWNERID货主string FPURMRBENTRY.FOWNERTYPEID货主类型string FPURMRBENTRY.FENTRYTAXRATE税率string FPURMRBENTRY.FDISCOUNTRATE折扣率(%)string FPURMRBENTRY.FTAXPRICE含税单价string FPURMRBENTRY.FORDERNO订单单号string FPURMRBENTRY.FCONTRACTNO合同单号string FPURMRBENTRY.FMtoNo计划跟踪号string FPURMRBENTRY.FPURMRBENTRY_Link关联关系表array FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FRuleId转换规则string FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSTableName源单表string FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSBillId源单内码string FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSId源单分录内码string FPURMRBENTRY.FormId业务对象表单IdstringPUR_MRB FPURMRBENTRY.Operation执行的操作stringbatchSave FPURMRBENTRY.IsAutoSubmitAndAudit提交并审核booltrue FPURMRBENTRY.IsVerifyBaseDataField验证基础资料boolfalse

系统对接总览

全新的API数据集成模式，赋能企业业务创新传统企业集成主要采用点对点或ESB集成方式，基于全新API战略中台的API新型集成方式通过解耦系统资源，降低系统间对接难度，实现快速业务需求响应，提升对接效率，助力企业满足快速业务交付需求，实现业务创新。通过构建API生态，助力能力开放与共享基于API战略中台梳理并整合内部API资源与IT资产，可实现内部资源共享，满足内部开发人员资源使用需求，例如：金蝶云星空与管易云之间数据集成；并将API资源对外可控开放，打造面向开发者的生态服务，为您打通自身和上下游合作伙伴，创造共赢价值链。开展API战略中台，重塑IT 帮助您基于内部资源构建不同业务能力中心，打造企业统一API战略中台，赋能企业发展，实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时，无需从“零”组建各业务模块，提升开发效率，重塑IT组织及交付能力。

管易云和金蝶云星空集成接口设计