从管易云·奇门到金蝶云星空通过接口配置打通数据对接系统：管易云·奇门金蝶管易云是金蝶集团旗下以电商和新零售为核心业务的子公司，公司于2008年成立，拥有从事电商及新零售业务相关专业知识工作者超过1000人。为伊利、网易有道、东阿阿胶、金龙鱼、海康、科大讯飞等超过110000家企业客户提供专业服务，用户数超过100万人。金蝶管易云与淘宝、天猫、京东、拼多多、抖音等超过150+主流电商平台建立合作关系。接通系统：金蝶云星空金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。配置集成方案集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：管易云·奇门，源系统 API：退货单查询，目标系统：金蝶云星空，目标系统 API销售退货新增。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。管易云·奇门接口明细接口： gy.erp.trade.return.get 接口名称：退货单查询接口方法： POST 请求参数字段名称类型描述 code 单据编号 string start_create 创建时间开始段 datetime end_create 创建时间结束段 datetime in_begin_time 入库时间开始段 datetime in_end_time 入库时间结束段 datetime shop_code 店铺代码 string drp_tenant_name 分销商名称 string platform_code 平台单号 string return_type 退货类型代码 string express_no 快递单号 string vip_name 会员名称 string agree 同意状态 string receive 入库状态 string cancel 作废状态 string no_parcel 是否三无包裹 string receiver_name 退货人姓名 string receiver_phone 退货人手机 string warehousein_code 退入仓库代码 string warehouseout_code 退出仓库代码 string modify_start_date 修改时间开始段 string modify_end_date 修改时间结束段 string page_size 分页大小 string page_no 页号 string 响应参数字段名称类型描述 id id string code 单据编号 string reason 平台退货原因 string create_date 创建时间 string approve_date 审核时间 string approve 审核状态 string receive_date 入库时间 string cancel 取消状态 string shop_name 店铺名称 string shop_code 店铺代码 string platform_code 平台单号 string platform_refund_id 平台退款单号 string sanwu_package 是否三无包裹 string vip_code 会员代码 string warehousein_code 退入仓库代码 string warehouseout_code 退出仓库代码 string location_code 库位代码 string express_code 退入快递公司代码 string express_name 退入快递名称 string express_num 退入快递单号 string receiver_phone 退货人手机 string details 退入商品列表 array details.qty 待入库数 string details.price 实际单价 string details.amount 实际金额 string details.note 备注 string details.oid 子订单号 string details.sku_code 规格代码 string details.item_sku_id 规格ID string details.sku_note 规格备注 string details.item_name 商品名称 string details.amount_after 让利后金额 string details.post_fee 物流费用 string details.item_code 商品代码 string details.item_id 商品ID string details.real_in 实际入库数 string details.discount_fee 让利金额 string details.detail_unique 唯一码列表 string details.detail_batch 批次列表 string details.is_gift 是否赠品 string details.combine_item_code 组合商品代码 string details.other_service_fee 其他服务费 string details.total_cost_price 退款成本 string details.payments 退款明细 array details.payments.payment 退款金额 string details.payments.account 退款账户 string details.payments.pay_type_code 退款方式代码 string details.payments.pay_time 退款时间 string details.payments.refund_phase 售后阶段 string details.payments.refund_type 售后类型 string details.payments.return_type 退货原因代码 string details.payments.receive 入库状态 string details.payments.agree_refuse 同意退货状态 string details.payments.order_code 销售订单号 string details.payments.modify_date 修改时间 string details.payments.business_man 业务员 string details.payments.receiver_name 收货人 string details.payments.receiver_mobile 收货人手机 string details.payments.receiver_zip 收货人邮编 string details.payments.receiver_address 收货人地址 string details.payments.area_name 收货人省市区 string details.payments.drp_tenant_name 分销商名称 string details.payments.drp_tenant_mobile 分销商手机号 string details.payments.cancel_date 作废日期 string details.payments.warehousein_name 退入仓库名称 string details.payments.vip_name 会员名称 string details.payments.platform_status 平台状态 string details.payments.refund_codes 系统退款单号 string 金蝶云星空接口明细 API： batchSave NAME：销售退货新增 METHOD： POST 请求参数接口字段字段名称预设值描述 FBillTypeID 单据类型 XSTHD01_SYS FBillNo 单据编号 {{code}} FSaleOrgId 销售组织 100 FDate 日期 {{create_date}} FStockOrgId 库存组织 100 FRetcustId 退货客户 {{shop_code}} FSaledeptid 销售部门 {{shop_code}} FHeadNote 备注 F_ora_platform_code 网上订单号 {{platform_code}} F_PBLH_Combo 售后类型 {{refund_type}} F_PBLH_Assistant 管易退货/退款原因 {{return_type}} F_PBLH_Text 平台单号 {{platform_code}} FEntity 明细信息 details FEntity.FMaterialId 物料编码 {{sku_code}} FEntity.FBarcode 零售条形码 FEntity.FRealQty 实退数量 {{details.real_in}} FEntity.FPrice 单价 FEntity.FTaxPrice 含税单价 FEntity.FIsFree 是否赠品 FEntity.FEntryTaxRate 税率% FEntity.FReturnType 退货类型 FEntity.FOwnerTypeId 货主类型 FEntity.FOwnerId 货主 FEntity.FStockId 仓库 {{warehousein_code}} FEntity.FStocklocId 仓位 FEntity.FLot 批号 FEntity.FDeliveryDate 退货日期 FEntity.FNote 备注 FEntity.FALLAMOUNT 价税合计 {{details.amount_after}} FEntity.F_PBLH_Decimal2 管易让利后金额对比 {{details.amount_after}} FEntity.SubHeadEntity 财务信息 FEntity.SubHeadEntity.FSettleOrgId 结算组织 100 FEntity.SubHeadEntity.FormId 业务对象表单Id SAL_RETURNSTOCK FEntity.SubHeadEntity.Operation 执行的操作 Save FEntity.SubHeadEntity.IsAutoSubmitAndAudit 提交并审核 true FEntity.SubHeadEntity.IsVerifyBaseDataField 验证基础资料 true 数据对接效果从API服务总线层面解决企业烟囱式业务系统集成现状相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。

从管易云·奇门到金蝶云星空通过接口配置打通数据

庄颜_qeasy

从管易云·奇门到金蝶云星空通过接口配置打通数据

对接系统：管易云·奇门

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

接通系统：金蝶云星空

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

配置集成方案

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

管易云·奇门接口明细

接口：gy.erp.trade.return.get
接口名称：退货单查询
接口方法：POST

请求参数

字段	名称	类型
code	单据编号	string
start_create	创建时间开始段	datetime
end_create	创建时间结束段	datetime
in_begin_time	入库时间开始段	datetime
in_end_time	入库时间结束段	datetime
shop_code	店铺代码	string
drp_tenant_name	分销商名称	string
platform_code	平台单号	string
return_type	退货类型代码	string
express_no	快递单号	string
vip_name	会员名称	string
agree	同意状态	string
receive	入库状态	string
cancel	作废状态	string
no_parcel	是否三无包裹	string
receiver_name	退货人姓名	string
receiver_phone	退货人手机	string
warehousein_code	退入仓库代码	string
warehouseout_code	退出仓库代码	string
modify_start_date	修改时间开始段	string
modify_end_date	修改时间结束段	string
page_size	分页大小	string
page_no	页号	string

响应参数

字段	名称	类型
id	id	string
code	单据编号	string
reason	平台退货原因	string
create_date	创建时间	string
approve_date	审核时间	string
approve	审核状态	string
receive_date	入库时间	string
cancel	取消状态	string
shop_name	店铺名称	string
shop_code	店铺代码	string
platform_code	平台单号	string
platform_refund_id	平台退款单号	string
sanwu_package	是否三无包裹	string
vip_code	会员代码	string
warehousein_code	退入仓库代码	string
warehouseout_code	退出仓库代码	string
location_code	库位代码	string
express_code	退入快递公司代码	string
express_name	退入快递名称	string
express_num	退入快递单号	string
receiver_phone	退货人手机	string
details	退入商品列表	array
details.qty	待入库数	string
details.price	实际单价	string
details.amount	实际金额	string
details.note	备注	string
details.oid	子订单号	string
details.sku_code	规格代码	string
details.item_sku_id	规格ID	string
details.sku_note	规格备注	string
details.item_name	商品名称	string
details.amount_after	让利后金额	string
details.post_fee	物流费用	string
details.item_code	商品代码	string
details.item_id	商品ID	string
details.real_in	实际入库数	string
details.discount_fee	让利金额	string
details.detail_unique	唯一码列表	string
details.detail_batch	批次列表	string
details.is_gift	是否赠品	string
details.combine_item_code	组合商品代码	string
details.other_service_fee	其他服务费	string
details.total_cost_price	退款成本	string
details.payments	退款明细	array
details.payments.payment	退款金额	string
details.payments.account	退款账户	string
details.payments.pay_type_code	退款方式代码	string
details.payments.pay_time	退款时间	string
details.payments.refund_phase	售后阶段	string
details.payments.refund_type	售后类型	string
details.payments.return_type	退货原因代码	string
details.payments.receive	入库状态	string
details.payments.agree_refuse	同意退货状态	string
details.payments.order_code	销售订单号	string
details.payments.modify_date	修改时间	string
details.payments.business_man	业务员	string
details.payments.receiver_name	收货人	string
details.payments.receiver_mobile	收货人手机	string
details.payments.receiver_zip	收货人邮编	string
details.payments.receiver_address	收货人地址	string
details.payments.area_name	收货人省市区	string
details.payments.drp_tenant_name	分销商名称	string
details.payments.drp_tenant_mobile	分销商手机号	string
details.payments.cancel_date	作废日期	string
details.payments.warehousein_name	退入仓库名称	string
details.payments.vip_name	会员名称	string
details.payments.platform_status	平台状态	string
details.payments.refund_codes	系统退款单号	string

金蝶云星空接口明细

API：batchSave
NAME：销售退货新增
METHOD：POST

请求参数

接口字段	字段名称	预设值
FBillTypeID	单据类型	XSTHD01_SYS
FBillNo	单据编号	{{code}}
FSaleOrgId	销售组织	100
FDate	日期	{{create_date}}
FStockOrgId	库存组织	100
FRetcustId	退货客户	{{shop_code}}
FSaledeptid	销售部门	{{shop_code}}
FHeadNote	备注
F_ora_platform_code	网上订单号	{{platform_code}}
F_PBLH_Combo	售后类型	{{refund_type}}
F_PBLH_Assistant	管易退货/退款原因	{{return_type}}
F_PBLH_Text	平台单号	{{platform_code}}
FEntity	明细信息	details
FEntity.FMaterialId	物料编码	{{sku_code}}
FEntity.FBarcode	零售条形码
FEntity.FRealQty	实退数量	{{details.real_in}}
FEntity.FPrice	单价
FEntity.FTaxPrice	含税单价
FEntity.FIsFree	是否赠品
FEntity.FEntryTaxRate	税率%
FEntity.FReturnType	退货类型
FEntity.FOwnerTypeId	货主类型
FEntity.FOwnerId	货主
FEntity.FStockId	仓库	{{warehousein_code}}
FEntity.FStocklocId	仓位
FEntity.FLot	批号
FEntity.FDeliveryDate	退货日期
FEntity.FNote	备注
FEntity.FALLAMOUNT	价税合计	{{details.amount_after}}
FEntity.F_PBLH_Decimal2	管易让利后金额对比	{{details.amount_after}}
FEntity.SubHeadEntity	财务信息
FEntity.SubHeadEntity.FSettleOrgId	结算组织	100
FEntity.SubHeadEntity.FormId	业务对象表单Id	SAL_RETURNSTOCK
FEntity.SubHeadEntity.Operation	执行的操作	Save
FEntity.SubHeadEntity.IsAutoSubmitAndAudit	提交并审核	true
FEntity.SubHeadEntity.IsVerifyBaseDataField	验证基础资料	true

数据对接效果

从API服务总线层面解决企业烟囱式业务系统集成现状相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。