金蝶云星空和管易云单据接口对接|轻易云数据集成平台

金蝶云星空和管易云单据接口对接

源系统:管易云

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

对接目标平台:金蝶云星空

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

数据接口配置方案

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

管易云接口明细

接口：gy.erp.kingdeecloud.tradereturn.orders.querybydate
接口名称：退货单查询2.0
接口方法：POST

请求参数

字段	名称	类型	描述
start_date	创建时间开始段	string
end_date	创建时间结束段	string
page_size	分页大小	string	默认为10
page_no	页号	string	默认1
detailApi	详情查询api	object
detailApi.api	api	string

响应参数

字段	名称	类型	描述
code	单据编号	String
note	备注	String
shop_code	店铺代码	String
warehouse_code	仓库代码	String
create_time	创建时间	String
approve_status	审核状态	String
approve_time	审核时间	String
enter_status	输入状态	String
enter_time	输入时间	String
return_type	返回类型	String
return_reason_code	返回原因代码	String
return_reason	返回原因	String
express_code	退入快递公司代码	String
express_name	退入快递名称	String
express_no	快递单号	String
vip_code	会员代码	String
vip_name	会员名称	String
receiver_name	收货人	String
receiver_phone	退货人手机	String
receiver_mobile	收货人手机	String
receiver_address	收货人地址	String
area_name	收货人省市区	String
listId	列表Id	String
detailApi	详细Api	String
details	退入商品列表	array
details.qty	待入库数	String
details.price	实际单价	String
details.amount	实际金额	String
details.amount_after	让利后金额	String
details.batchs	批次	String
details.sns	社交网络	String
details.goods_id	商品标识	String
details.is_gift	是否赠品	String
details.real_qty	真实数量	String
details.cost_price	成本价	String
details.trade_code	交易代码	String
details.platform_code	平台单号	String
details.memo	备注	String
details.post_fee	物流费用	String

金蝶云星空接口明细

接口：batchSave
接口名称：销售退货新增
接口方法：POST

请求参数

字段	名称	类型	描述
FBillTypeID	单据类型	string	单据类型
FBillNo	单据编号	string	单据编号
FSaleOrgId	销售组织	string	组织
FDate	日期	string	日期
FStockOrgId	库存组织	string	组织
FRetcustId	退货客户	string	基础资料
FSaledeptid	销售部门	string	基础资料
FSettleCurrId	结算币别	string	基础资料
FCorrespondOrgId	对应组织	string	组织
F_ora_platform_code	网上订单号	string	基础资料
FHeadNote	备注	string	多行文本
FEntity	明细信息	array
FEntity.FMaterialId	物料编码	string	基础资料
FEntity.FRealQty	实退数量	string	数量
FEntity.FPrice	单价	string	单价
FEntity.FTaxPrice	含税单价	string	单价
FEntity.FIsFree	是否赠品	string	复选框
FEntity.FEntryTaxRate	税率%	string	小数
FEntity.FReturnType	退货类型	string	单选辅助资料列表
FEntity.FStockId	仓库	string	基础资料
FEntity.FLot	批号	string	批次
FEntity.FALLAMOUNT	价税合计	string	单价
FEntity.FNote	备注	string	文本
FEntity.SubHeadEntity	财务信息	object
FEntity.SubHeadEntity.FSettleOrgId	结算组织	string	组织
FEntity.SubHeadEntity.FSettleTypeId	结算方式	string	基础资料
FEntity.SubHeadEntity.FormId	业务对象表单Id	string	必须填写金蝶的表单ID如:PUR_PurchaseOrder
FEntity.SubHeadEntity.Operation	执行的操作	string
FEntity.SubHeadEntity.IsAutoSubmitAndAudit	提交并审核	bool
FEntity.SubHeadEntity.IsVerifyBaseDataField	验证基础资料	bool	是否验证所有的基础资料有效性，布尔类，默认false（非必录）
FEntity.SubHeadEntity.SubSystemId	系统模块	string	默认仓库模块

系统对接概况

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