管易云·奇门对接打通金蝶云星空退货单查询接口与销售退货新增接口数据源系统:管易云·奇门管易云是金蝶旗下专注提供电商企业管理软件服务的子品牌，先后开发了C-ERP、EC-OMS、EC-WMS、E店管家、BBC、B2B、B2C商城网站建设等产品和服务，涵盖电商业务全流程。写入目标:金蝶云星空金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。多系统对接方案配置轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线，所以对接方案的配置极其重要，方案可以选择一键复制，轻易云有海量的对接方案可支持一键复制，复制后直接启动使用（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置，配置只要确认源平台：管易云·奇门的取数逻辑，例如什么时间取什么样的数据。即可完成配置，目标平台：金蝶云星空，把获取的数据组装成目标系统需要的格式进行写入。管易云·奇门接口明细接口： 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_no 页码 string 默认为1 page_size 每页大小 string 默认为10 响应参数字段名称类型描述 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 日期 {{receive_date}} FStockOrgId 库存组织 100 FRetcustId 退货客户 {{shop_code}} FHeadNote 备注 FEntity 明细信息 details FEntity.FMaterialId 物料编码 {{details.item_code}} FEntity.FBarcode 零售条形码 FEntity.FRealQty 实退数量 {{details.real_in}} FEntity.FPrice 单价 {{details.amount_after}} FEntity.FAllAmount 价税合计 {{details.amount_after}} FEntity.FIsFree 是否赠品 FEntity.FEntryTaxRate 税率% FEntity.FReturnType 退货类型 FEntity.FOwnerTypeId 货主类型 FEntity.FOwnerId 货主 FEntity.FStockId 仓库 {{warehousein_code}} FEntity.FStocklocId 仓位 FEntity.FLot 批号 FEntity.FDeliveryDate 退货日期 FEntity.FNote 备注 FEntity.SubHeadEntity 财务信息 FEntity.SubHeadEntity.FSettleOrgId 结算组织 100 FEntity.SubHeadEntity.FormId 业务对象表单Id SAL_RETURNSTOCK FEntity.SubHeadEntity.Operation 执行的操作 Save FEntity.SubHeadEntity.IsAutoSubmitAndAudit 提交并审核 true FEntity.SubHeadEntity.IsVerifyBaseDataField 验证基础资料 false FEntity.SubHeadEntity.SubSystemId 相应位置 21 系统数据对接当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。

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

刘培强qeasy

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

数据源系统:管易云·奇门

管易云是金蝶旗下专注提供电商企业管理软件服务的子品牌，先后开发了C-ERP、EC-OMS、EC-WMS、E店管家、BBC、B2B、B2C商城网站建设等产品和服务，涵盖电商业务全流程。

写入目标:金蝶云星空

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

多系统对接方案配置

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

管易云·奇门接口明细

接口：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_no	页码	string	默认为1
page_size	每页大小	string	默认为10

响应参数

字段	名称	类型
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	日期	{{receive_date}}
FStockOrgId	库存组织	100
FRetcustId	退货客户	{{shop_code}}
FHeadNote	备注
FEntity	明细信息	details
FEntity.FMaterialId	物料编码	{{details.item_code}}
FEntity.FBarcode	零售条形码
FEntity.FRealQty	实退数量	{{details.real_in}}
FEntity.FPrice	单价	{{details.amount_after}}
FEntity.FAllAmount	价税合计	{{details.amount_after}}
FEntity.FIsFree	是否赠品
FEntity.FEntryTaxRate	税率%
FEntity.FReturnType	退货类型
FEntity.FOwnerTypeId	货主类型
FEntity.FOwnerId	货主
FEntity.FStockId	仓库	{{warehousein_code}}
FEntity.FStocklocId	仓位
FEntity.FLot	批号
FEntity.FDeliveryDate	退货日期
FEntity.FNote	备注
FEntity.SubHeadEntity	财务信息
FEntity.SubHeadEntity.FSettleOrgId	结算组织	100
FEntity.SubHeadEntity.FormId	业务对象表单Id	SAL_RETURNSTOCK
FEntity.SubHeadEntity.Operation	执行的操作	Save
FEntity.SubHeadEntity.IsAutoSubmitAndAudit	提交并审核	true
FEntity.SubHeadEntity.IsVerifyBaseDataField	验证基础资料	false
FEntity.SubHeadEntity.SubSystemId	相应位置	21

系统数据对接

当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。