系统数据集成方案

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

数据源系统:管易云

写入目标:金蝶云星空

接口方案配置

通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：管易云，然后选择对应的连接器。选择对应的gy.erp.trade.return.get作为数据对接来源。然后再写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器（关于金蝶云星空的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的batchSave接口作为数据写入动作完成第一步的接口配置。

管易云接口明细

• 接口：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	默认为10
page_no	页号	string	默认1

响应参数

字段	名称	类型	描述
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	单据类型
FBillNo	单据编号	string	单据编号
FSaleOrgId	销售组织	string	组织
FDate	日期	string	日期
FStockOrgId	库存组织	string	组织
FRetcustId	退货客户	string	基础资料
FSaledeptid	销售部门	string	基础资料
FSettleCurrId	结算币别	string	基础资料
FBranchId	销售门店	string	基础资料
FReturnReason	退货原因	string	单选辅助资料列表
FCorrespondOrgId	对应组织	string	组织
FStockDeptId	库存部门	string	基础资料
FHeadNote	备注	string	多行文本
FPayCustId	付款方	string	基础资料
FEntity	明细信息	array
FEntity.FMaterialId	物料编码	string	基础资料
FEntity.FBarcode	零售条形码	string	文本
FEntity.FRealQty	实退数量	string	数量
FEntity.FPrice	单价	string	单价
FEntity.FTaxPrice	含税单价	string	单价
FEntity.FIsFree	是否赠品	string	复选框
FEntity.FEntryTaxRate	税率%	string	小数
FEntity.FReturnType	退货类型	string	单选辅助资料列表
FEntity.FOwnerTypeId	货主类型	string	多类别基础资料列表
FEntity.FOwnerId	货主	string	多类别基础资料
FEntity.FStockId	仓库	string	基础资料
FEntity.FLot	批号	string	批次
FEntity.FDeliveryDate	退货日期	string	长日期
FEntity.FNote	备注	string	文本
FEntity.SubHeadEntity	财务信息	object
FEntity.SubHeadEntity.FSettleOrgId	结算组织	string	组织
FEntity.SubHeadEntity.FSettleTypeId	结算方式	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	默认仓库模块

系统对接总览

将传统的统计分析转变为预测分析，从被动分析到主动分析，从非实时分析转变为实时分析，从结构化的数据变成多元化的数据。精准查询数据流同步状况，实时监管队列任务以及数据资产的有序管理。为业务赋能，降本增效，让企业能够更加合理的布局团队；结合业务需求实现与OA，CRM，WMS等系统之间的数据交流与同步，为企业定制自定义的数据管理方案，用技术拓展商业边界，为新业务、新部门提供成长空间。

系统数据对接方案元数据代码