金蝶云星空和管易云单据接口对接数据源平台:管易云管易云是上海管易云计算软件有限公司旗下的专注提供电商企业管理软件服务的品牌，总部位于中国上海张江高科技产业园区。管易云旗下拥有管易云C-ERP、EC-OMS、EC-WMS、B2C/B2B/BBC/微商城开发、PDA无纸化仓储解决方案、新零售一体化解决方案等产品接入系统：金蝶云星空金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。系统对接接口配置数据集成平台对应的配置管易云与金蝶云星空的对接只要三步就能完成两个系统之间的数据对接。第一步根据管易云的接口参数要求记录在轻易云集成平台。第二步配置管易云与金蝶云星空之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。管易云接口明细调用接口： gy.erp.trade.return.get 接口名称：退货单查询方法： POST 请求参数字段字段名称类型配置值 code 单据编号 string start_create 创建时间开始段 datetime end_create 创建时间结束段 datetime in_begin_time 入库时间开始段 datetime {{LAST_SYNC_TIME datetime}} in_end_time 入库时间结束段 datetime {{CURRENT_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 1 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 {{PAGINATION_PAGE_SIZE}} page_no 页号 string {{PAGINATION_START_PAGE}} 响应参数字段字段名称类型配置值 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 单据类型 DSXSTHD FBillNo 单据编号 {{code}} FSaleOrgId 销售组织 100 FDate 日期 {{receive_date}} FStockOrgId 库存组织 100 FRetcustId 退货客户 {{shop_code}} FSaledeptid 销售部门 {{shop_code}} FHeadNote 备注 {{note}} F_ora_platform_code 网上订单号 {{platform_code}} FEntity 明细信息 details FEntity.FMaterialId 物料编码 {{details.item_code}} FEntity.FBarcode 零售条形码 FEntity.FRealQty 实退数量 {{details.real_in}} FEntity.FPrice 单价 FEntity.FTaxPrice 含税单价 FEntity.FIsFree 是否赠品 FEntity.FEntryTaxRate 税率% FEntity.FReturnType 退货类型 FEntity.FStockId 仓库 307 FEntity.FLot 批号 1 FEntity.FDeliveryDate 退货日期 FEntity.FNote 备注 FEntity.FALLAMOUNT 价税合计 {{details.amount_after}} FEntity.SubHeadEntity 财务信息 FEntity.SubHeadEntity.FSettleOrgId 结算组织 100 FEntity.SubHeadEntity.FSettleCurrId 结算币别 PRE001 FEntity.SubHeadEntity.FormId 业务对象表单Id SAL_RETURNSTOCK FEntity.SubHeadEntity.Operation 执行的操作 Save FEntity.SubHeadEntity.IsAutoSubmitAndAudit 提交并审核 false FEntity.SubHeadEntity.IsVerifyBaseDataField 验证基础资料 true FEntity.SubHeadEntity.SubSystemId 相应位置 21 数据对接价值从API服务总线层面解决企业烟囱式业务系统集成现状相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。

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

关一帆qeasy

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

数据源平台:管易云

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

接入系统：金蝶云星空

金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。

系统对接接口配置

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

管易云接口明细

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

请求参数

字段	字段名称	类型	配置值
code	单据编号	string
start_create	创建时间开始段	datetime
end_create	创建时间结束段	datetime
in_begin_time	入库时间开始段	datetime	{{LAST_SYNC_TIME datetime}}
in_end_time	入库时间结束段	datetime	{{CURRENT_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	1
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	{{PAGINATION_PAGE_SIZE}}
page_no	页号	string	{{PAGINATION_START_PAGE}}

响应参数

字段	字段名称	类型
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	单据类型	DSXSTHD
FBillNo	单据编号	{{code}}
FSaleOrgId	销售组织	100
FDate	日期	{{receive_date}}
FStockOrgId	库存组织	100
FRetcustId	退货客户	{{shop_code}}
FSaledeptid	销售部门	{{shop_code}}
FHeadNote	备注	{{note}}
F_ora_platform_code	网上订单号	{{platform_code}}
FEntity	明细信息	details
FEntity.FMaterialId	物料编码	{{details.item_code}}
FEntity.FBarcode	零售条形码
FEntity.FRealQty	实退数量	{{details.real_in}}
FEntity.FPrice	单价
FEntity.FTaxPrice	含税单价
FEntity.FIsFree	是否赠品
FEntity.FEntryTaxRate	税率%
FEntity.FReturnType	退货类型
FEntity.FStockId	仓库	307
FEntity.FLot	批号	1
FEntity.FDeliveryDate	退货日期
FEntity.FNote	备注
FEntity.FALLAMOUNT	价税合计	{{details.amount_after}}
FEntity.SubHeadEntity	财务信息
FEntity.SubHeadEntity.FSettleOrgId	结算组织	100
FEntity.SubHeadEntity.FSettleCurrId	结算币别	PRE001
FEntity.SubHeadEntity.FormId	业务对象表单Id	SAL_RETURNSTOCK
FEntity.SubHeadEntity.Operation	执行的操作	Save
FEntity.SubHeadEntity.IsAutoSubmitAndAudit	提交并审核	false
FEntity.SubHeadEntity.IsVerifyBaseDataField	验证基础资料	true
FEntity.SubHeadEntity.SubSystemId	相应位置	21

数据对接价值

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