系统数据集成方案

金蝶云星空和网店管家·奇门单据接口对接

对接系统网店管家·奇门

目标系统:金蝶云星空

数据接口配置方案

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

网店管家·奇门接口明细

• 接口：wdgj.sellbacknosensitiveinfo.list.get
• 接口名称：查询管家中产生的退换订单
• 接口方法：POST

请求参数

字段	名称	类型	描述
pageno	页码	String	页码
pagesize	每页条数	String	每页条数，取值范围 1 ~ 100
begintime	查询开始时间	String	查询开始时间 YYYY-MM-DD HH:mm:ss
endtime	查询结束时间	String	查询结束时间 YYYY-MM-DD HH:mm:ss
timetype	时间类型	String	时间类型（1：表示登记时间，2：表示收货时间, 3：表示结算时间 不填或者填写其他值默认为登记时间）
searchstatus	searchstatus	String	0 待收货 1 待结算 2 被取消 3 已完成 4 待审核 默认所有
searchno	退换单号	String	退换单号
relationno	关联单号	String	关联单号（管家订单号）
querymarkup	单据查询标记	String	单据查询标记

响应参数

字段	名称	类型	描述
tradeid	退换单ID	String	退换单ID
tradeno	退换单号	String	退换单号
rawno	原始单号	String	原始单号
oldno	管家原关联订单号	String	管家原关联订单号
newno	换货管家关联订单号	String	换货管家关联订单号
tradestatus	退换单状态	String	退换单状态 0 待收货 1 待结算 2 被取消 3 已完成 4 待审核
shopname	原店铺名	String	原店铺名
shopno	原店铺编号	String	原店铺编号
shopname2	换货店铺名	String	换货店铺名
chargetime	结算时间	String	结算时间
regtime	登记时间	String	登记时间
rcvtime	收货时间	String	收货时间
seller	业务员	String	业务员
tradetype	原订单类型	String	原订单类型
warehouseid	退货仓库id	String	退货仓库id
warehouseno	退货仓库编号	String	退货仓库编号
warehousename	退货仓库名	String	退货仓库名
warehouseid2	换货仓库id	String	换货仓库id
warehouseno2	换货仓库编号	String	换货仓库编号
warehousename2	换货仓库名	String	换货仓库名
logisticid	物流id	String	物流id
logisticno	物流编号	String	物流编号
logisticname	物流名	String	物流名
postid	快递单号	String	快递单号
postagetotal	应收邮资	String	应收邮资
totalrcv	换货金额	String	换货金额
totalpay	退货金额	String	退货金额
returntotal	应退合计	String	应退合计
recvtotal	结算金额	String	结算金额
reason	取消原因	String	取消原因
remark	卖家备注	String	卖家备注
customerid	会员id	String	会员id
shoptype	原店铺类别	String	原店铺类别
shoptype2	换货店铺类别	String	换货店铺类别
zip	邮编	String	邮编
returntype	类型	String	类型“退”只有退货；“换”有换货
goodslist	退货商品明细	array	退货商品明细
goodslist.goodsid	货品ID	String	货品ID
goodslist.specid	规格ID	String	规格ID，单规格为0
goodslist.goodsno	货品编号	String	货品编号
goodslist.goodsname	品名	String	品名
goodslist.unit	单位	String	单位
goodslist.specname	规格名	String	规格名
goodslist.price	单价	String	单价
goodslist.goodscount	数量	String	数量
goodslist.goodsmoney	金额	String	金额
goodslist.barcode	条码	String	条码 （条码+附加码）
goodslist.remark	备注	String	备注
goodslist.bgift	是否赠品	String	是否赠品 True/False（换货没有这个字段）
goodslist.bfit	是否组合装	String	是否组合装 True/False
goodslist.recid	记录id	String	记录id（唯一）
goodslist.goodslist2	换货商品明细	array	换货商品明细
goodslist.goodslist2.goodsid	货品ID	String	货品ID
goodslist.goodslist2.stockinno	退换单关联入库单号	String	退换单关联入库单号
goodslist.goodslist2.shopno2	换货店铺编号	String	换货店铺编号
goodslist.goodslist2.country	国家	String	国家
goodslist.goodslist2.province	省	String	省
goodslist.goodslist2.city	市	String	市
goodslist.goodslist2.town	区县	String	区县
goodslist.goodslist2.returnspreferential	退货优惠	String	退货优惠
goodslist.goodslist2.exchangepreferential	换货优惠	String	换货优惠
goodslist.goodslist2.orderpreferential	订单优惠	String	订单优惠
goodslist.goodslist2.nickname	网名	String	网名
goodslist.goodslist2.sndto	收件人	String	收件人
goodslist.goodslist2.adr	地址	String	地址
goodslist.goodslist2.orderadr	原订单的地址	String	原订单的地址
goodslist.goodslist2.tel	电话	String	电话
goodslist.goodslist2.specid	规格ID	String	规格ID，单规格为0
goodslist.goodslist2.goodsno	货品编号	String	货品编号
goodslist.goodslist2.goodsname	品名	String	品名
goodslist.goodslist2.unit	单位	String	单位
goodslist.goodslist2.specname	规格名	String	规格名
goodslist.goodslist2.price	单价	String	单价
goodslist.goodslist2.goodscount	数量	String	数量
goodslist.goodslist2.goodsmoney	金额	String	金额
goodslist.goodslist2.barcode	条码	String	条码 （条码+附加码）
goodslist.goodslist2.remark	备注	String	备注
goodslist.goodslist2.bgift	是否赠品	String	是否赠品 True/False（换货没有这个字段）
goodslist.goodslist2.bfit	是否组合装	String	是否组合装 True/False
goodslist.goodslist2.recid	记录id（唯一）	String	记录id（唯一）

金蝶云星空接口明细

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

请求参数

字段	名称	类型	描述
FBillTypeID	单据类型	string	单据类型
FBillNo	单据编号	string	单据编号
FSaleOrgId	销售组织	string	组织
FDate	日期	string	日期
FStockOrgId	库存组织	string	组织
FRetcustId	退货客户	string	基础资料
FHeadNote	备注	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.FStockId	仓库	string	基础资料
FEntity.FNote	备注	string	文本
FEntity.SubHeadEntity	财务信息	object
FEntity.SubHeadEntity.FSettleOrgId	结算组织	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	默认仓库模块

系统数据对接

全新的API数据集成模式，赋能企业业务创新 传统企业集成主要采用点对点或ESB集成方式，基于全新API战略中台的API新型集成方式通过解耦系统资源，降低系统间对接难度，实现快速业务需求响应，提升对接效率，助力企业满足快速业务交付需求，实现业务创新。通过构建API生态，助力能力开放与共享 基于API战略中台梳理并整合内部API资源与IT资产，可实现内部资源共享，满足内部开发人员资源使用需求，例如：金蝶云星空与网店管家·奇门之间数据集成；并将API资源对外可控开放，打造面向开发者的生态服务，为您打通自身和上下游合作伙伴，创造共赢价值链。开展API战略中台，重塑IT 帮助您基于内部资源构建不同业务能力中心，打造企业统一API战略中台，赋能企业发展，实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时，无需从“零”组建各业务模块，提升开发效率，重塑IT组织及交付能力。

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