管易云对接打通金蝶云星空退货单查询2.0接口与销售退货新增接口|轻易云数据集成平台

管易云对接打通金蝶云星空退货单查询2.0接口与销售退货新增接口

对接源平台:管易云

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

集成系统:金蝶云星空

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

数据集成方案配置

通过轻易云系统数据集成平台新增创建集成方案，通过轻易云的方案市场可以一键复制，并且可以借鉴其他的方案配置完成方案制作，方案制作只需要两步，第一步先确定好对应的数据来源；源系统：管易云接口：退货单查询2.0通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统：金蝶云星空接口：销售退货新增，通过写入调度者匹配获取到的数据和写入的映射关系，即可自动生成符合目标系统：金蝶云星空写入的数据自动产生写入队列，通过运行概况，系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况

管易云接口明细

接口：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.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_Base	项目	string	基础资料
FHeadNote	备注	string	多行文本
F_ora_platform_code	网上订单号	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.FormId	业务对象表单Id	string	必须填写金蝶的表单ID如:PUR_PurchaseOrder
FEntity.SubHeadEntity.Operation	执行的操作	string
FEntity.SubHeadEntity.IsAutoSubmitAndAudit	提交并审核	bool
FEntity.SubHeadEntity.IsVerifyBaseDataField	验证基础资料	bool	是否验证所有的基础资料有效性，布尔类，默认false（非必录）
FEntity.SubHeadEntity.SubSystemId	系统模块	string	默认仓库模块

数据对接价值

异构系统都具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。采用“轻易云集成方案”的解决方案，可以满足客户的实际业务需求，推动软件工程的规范化，使开发人员遵循统一的概要设计开发实现，降低系统实现的风险，做到系统设计资料的规范性与全面性，以利于系统的实现、测试、维护、版本升级等。通过轻易云系统集成平台完美结合：打破企业内部数据孤岛，无需繁琐的处理工序，与数据集成服务完美结合，让数据真正通起来。资源互补：汇集各种行业解决方案，资源互补，企业管理融合提升。