管易云和金蝶云星空接口打通对接实战来源系统:管易云金蝶管易云是金蝶集团旗下以电商和新零售为核心业务的子公司，公司于2008年成立，拥有从事电商及新零售业务相关专业知识工作者超过1000人。为伊利、网易有道、东阿阿胶、金龙鱼、海康、科大讯飞等超过110000家企业客户提供专业服务，用户数超过100万人。金蝶管易云与淘宝、天猫、京东、拼多多、抖音等超过150+主流电商平台建立合作关系。对接系统：金蝶云星空金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。接口方案配置数据集成平台对应的配置管易云与金蝶云星空的对接只要三步就能完成两个系统之间的数据对接。第一步根据管易云的接口参数要求记录在轻易云集成平台。第二步配置管易云与金蝶云星空之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。管易云接口明细接口： 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 金蝶云星空接口明细调用接口： batchSave 接口名称：销售退货新增方法： POST 请求参数字段字段名称类型配置值 FBillTypeID 单据类型 string XSTHD01_SYS FBillNo 单据编号 string {{code}} FSaleOrgId 销售组织 string 100 FDate 日期 string {{receive_date}} FStockOrgId 库存组织 string 100 FRetcustId 退货客户 string {{shop_code}} F_ora_Base 项目 string {{shop_code}} FSaledeptid 销售部门 string {{shop_code}} FHeadNote 备注 string F_ora_platform_code 网上订单号 string {{platform_code}} FEntity 明细信息 array details FEntity.FMaterialId 物料编码 string {{details.item_code}} FEntity.FBarcode 零售条形码 string FEntity.FRealQty 实退数量 string {{details.real_in}} FEntity.FPrice 单价 string FEntity.FTaxPrice 含税单价 string FEntity.FIsFree 是否赠品 string _function case '{{details.amount_after}}' when '0' then true else false end FEntity.FEntryTaxRate 税率% string FEntity.FReturnType 退货类型 string FEntity.FOwnerTypeId 货主类型 string FEntity.FOwnerId 货主 string FEntity.FStockId 仓库 string {{warehousein_code}} FEntity.FStocklocId 仓位 string FEntity.FLot 批号 string 1 FEntity.FDeliveryDate 退货日期 string FEntity.FNote 备注 string FEntity.FALLAMOUNT 价税合计 string {{details.amount_after}} FEntity.SubHeadEntity 财务信息 object FEntity.SubHeadEntity.FSettleOrgId 结算组织 string 100 FEntity.SubHeadEntity.FormId 业务对象表单Id string SAL_RETURNSTOCK FEntity.SubHeadEntity.Operation 执行的操作 string Save FEntity.SubHeadEntity.IsAutoSubmitAndAudit 提交并审核 bool true FEntity.SubHeadEntity.IsVerifyBaseDataField 验证基础资料 bool true 系统对接总览全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系。API低代码开发平台能够实现低代码或零代码一键发布API服务，很好地解决企业用户上面的问题。轻易云应用集成主要解决已有应用系统的无序蔓延现象，减少各业务系统间的维护成本，减少各应用系统的操作系统、开发语言、访问协议、通信技术多而杂、整合难度大的问题，将企业数据平滑对接，减少信息竖井。

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

汪淼_轻易云

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

来源系统:管易云

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

对接系统：金蝶云星空

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

接口方案配置

数据集成平台对应的配置管易云与金蝶云星空的对接只要三步就能完成两个系统之间的数据对接。第一步根据管易云的接口参数要求记录在轻易云集成平台。第二步配置管易云与金蝶云星空之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。

管易云接口明细

接口：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

金蝶云星空接口明细

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

请求参数

字段	字段名称	类型	配置值
FBillTypeID	单据类型	string	XSTHD01_SYS
FBillNo	单据编号	string	{{code}}
FSaleOrgId	销售组织	string	100
FDate	日期	string	{{receive_date}}
FStockOrgId	库存组织	string	100
FRetcustId	退货客户	string	{{shop_code}}
F_ora_Base	项目	string	{{shop_code}}
FSaledeptid	销售部门	string	{{shop_code}}
FHeadNote	备注	string
F_ora_platform_code	网上订单号	string	{{platform_code}}
FEntity	明细信息	array	details
FEntity.FMaterialId	物料编码	string	{{details.item_code}}
FEntity.FBarcode	零售条形码	string
FEntity.FRealQty	实退数量	string	{{details.real_in}}
FEntity.FPrice	单价	string
FEntity.FTaxPrice	含税单价	string
FEntity.FIsFree	是否赠品	string	_function case '{{details.amount_after}}' when '0' then true else false end
FEntity.FEntryTaxRate	税率%	string
FEntity.FReturnType	退货类型	string
FEntity.FOwnerTypeId	货主类型	string
FEntity.FOwnerId	货主	string
FEntity.FStockId	仓库	string	{{warehousein_code}}
FEntity.FStocklocId	仓位	string
FEntity.FLot	批号	string	1
FEntity.FDeliveryDate	退货日期	string
FEntity.FNote	备注	string
FEntity.FALLAMOUNT	价税合计	string	{{details.amount_after}}
FEntity.SubHeadEntity	财务信息	object
FEntity.SubHeadEntity.FSettleOrgId	结算组织	string	100
FEntity.SubHeadEntity.FormId	业务对象表单Id	string	SAL_RETURNSTOCK
FEntity.SubHeadEntity.Operation	执行的操作	string	Save
FEntity.SubHeadEntity.IsAutoSubmitAndAudit	提交并审核	bool	true
FEntity.SubHeadEntity.IsVerifyBaseDataField	验证基础资料	bool	true

系统对接总览

全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系。API低代码开发平台能够实现低代码或零代码一键发布API服务，很好地解决企业用户上面的问题。轻易云应用集成主要解决已有应用系统的无序蔓延现象，减少各业务系统间的维护成本，减少各应用系统的操作系统、开发语言、访问协议、通信技术多而杂、整合难度大的问题，将企业数据平滑对接，减少信息竖井。