旺店通·企业版与金蝶云星空对接集成查询采购退货单连通采购退货新增(WK采购退料同步) 源系统:旺店通·企业版慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。对接系统：金蝶云星空金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。系统对接接口配置数据集成平台对应的配置旺店通·企业版与金蝶云星空的对接只要三步就能完成两个系统之间的数据对接。第一步根据旺店通·企业版的接口参数要求记录在轻易云集成平台。第二步配置旺店通·企业版与金蝶云星空之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。旺店通·企业版接口明细调用接口： purchase_return_query 接口名称：查询采购退货单方法： POST 请求参数字段字段名称类型配置值 start_time 开始时间 datetime {{LAST_SYNC_TIME datetime}} end_time 结束时间 datetime {{CURRENT_TIME datetime}} status 状态 string warehouse_no 仓库编号 string page_size 分页大小 string {{PAGINATION_PAGE_SIZE}} page_no 页号 string {{PAGINATION_START_PAGE}} 响应参数字段字段名称类型配置值 return_no 退货单号 string provider_name 供应商 string status 采购单状态 string warehouse_no 仓库编号 string warehouse_name 仓库 string purchaser_id 采购员id string purchaser_name 采购员名称 string logistics_type 物流类型 string other_fee 其它费用 string post_fee 邮费 string goods_fee 总货款 string goods_count 退货开单量 string goods_type_count 货品种类数 string goods_out_count 退货出库量 string api_outer_no 外部接口单号 string outer_no 外部单号 string prop1 自定义属性1 string prop2 自定义属性2 string provider_no 供应商编号 string purchase_no 引用采购单号 string creator_id 制单员id string creator_name 制单员姓名 string type 类型 string flag_id 颜色标记 string warehouse_id 出库id string provider_id 供应商id string contact 联系人姓名 string telno 联系电话 string receive_address 退货地址 string check_operator_id 审核人 string check_time 审核时间 string note_count 便签条数 string province 省份 string city 城市 string district 地区 string wms_outer_no 外部仓库的单号 string wms_status 处理状态 string error_info 错误信息 string version_id 版本号 string last_load_purchase_id 最后一次引用的采购单id string detail_list 采购退货单货品列表节点 array detail_list.return_id 采购退货单id string detail_list.remark 备注 string detail_list.created 创建时间 string detail_list.modified 最后修改时间 string detail_list.provider_goods_no 供应商货品编号 string detail_list.spec_no 商家编码 string detail_list.goods_no 货品编码 string detail_list.goods_name 货品名称 string detail_list.spec_name 规格名称 string detail_list.spec_code 规格码 string detail_list.num 退货数量 string detail_list.num2 辅助退货量 string detail_list.unit_id 出库单位 string detail_list.unit_ratio 单位变换率 string detail_list.base_unit_id 基本单位 string detail_list.price 单价 string detail_list.discount 折扣 string detail_list.amount 税前金额 string detail_list.unit_name 出库单位名称 string detail_list.base_unit_name 基本单位名称 string detail_list.tax 税率 string detail_list.tax_amount 税后金额 string detail_list.rec_id 明细id string detail_list.spec_id 规格id string detail_list.out_num 退货出库数量 string detail_list.out_amount 退货出库金额 string detail_list.tax_price 税后单价 string 金蝶云星空接口明细 API： batchSave NAME：采购退货新增 METHOD： POST 请求参数接口字段字段名称预设值描述 FBillNo 单据编号 {{return_no}}YY FDate 退料日期 {{check_time datetime 2020-02-01}} FSupplierID 供应商 0003 FStockOrgId 退料组织 100 FMRREASON 退料原因旺店通退料 FRequireOrgId 需求组织 100 FDESCRIPTION 备注 {{warehouse_no}}{{logistics_type}} FSettleOrgId 结算组织 100 FPayOrgId 付款组织 100 FPURMRBENTRY 明细信息 detail_list FPURMRBENTRY.FMATERIALID 物料编码 A01 FPURMRBENTRY.FBarcode 零售条形码 FPURMRBENTRY.FRMREALQTY 实退数量 {{detail_list.num}} FPURMRBENTRY.FPrice 单价 {{detail_list.price}} FPURMRBENTRY.FTAXPRICE 含税单价 {{detail_list.price}} FPURMRBENTRY.FEntryTaxRate 税率 FPURMRBENTRY.FSTOCKID 仓库 CK001 FPURMRBENTRY.FNOTE 备注 WDT{{detail_list.goods_no}} FPURMRBENTRY.FPURMRBENTRY_Link 关联关系表 FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FRuleId 转换规则 PUR_MRAPP-PUR_MRB FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSTableName 源单表 T_PUR_MRAPPENTRY FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSBillId 源单内码 5555 FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSId 源单分录内码 5555 FPURMRBENTRY.FormId 业务对象表单Id PUR_MRB FPURMRBENTRY.Operation 执行的操作 batchSave FPURMRBENTRY.IsAutoSubmitAndAudit 提交并审核 true FPURMRBENTRY.IsVerifyBaseDataField 验证基础资料 false 数据对接价值全新的API数据集成模式，赋能企业业务创新传统企业集成主要采用点对点或ESB集成方式，基于全新API战略中台的API新型集成方式通过解耦系统资源，降低系统间对接难度，实现快速业务需求响应，提升对接效率，助力企业满足快速业务交付需求，实现业务创新。通过构建API生态，助力能力开放与共享基于API战略中台梳理并整合内部API资源与IT资产，可实现内部资源共享，满足内部开发人员资源使用需求，例如：金蝶云星空与旺店通·企业版之间数据集成；并将API资源对外可控开放，打造面向开发者的生态服务，为您打通自身和上下游合作伙伴，创造共赢价值链。开展API战略中台，重塑IT 帮助您基于内部资源构建不同业务能力中心，打造企业统一API战略中台，赋能企业发展，实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时，无需从“零”组建各业务模块，提升开发效率，重塑IT组织及交付能力。

旺店通·企业版与金蝶云星空对接集成查询采购退货单连通采购退货新增(WK采购退料同步)

汪淼_轻易云

旺店通·企业版与金蝶云星空对接集成查询采购退货单连通采购退货新增(WK采购退料同步)

源系统:旺店通·企业版

慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。

对接系统：金蝶云星空

金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。

系统对接接口配置

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

旺店通·企业版接口明细

调用接口：purchase_return_query
接口名称：查询采购退货单
方法：POST

请求参数

字段	字段名称	类型	配置值
start_time	开始时间	datetime	{{LAST_SYNC_TIME datetime}}
end_time	结束时间	datetime	{{CURRENT_TIME datetime}}
status	状态	string
warehouse_no	仓库编号	string
page_size	分页大小	string	{{PAGINATION_PAGE_SIZE}}
page_no	页号	string	{{PAGINATION_START_PAGE}}

响应参数

字段	字段名称	类型
return_no	退货单号	string
provider_name	供应商	string
status	采购单状态	string
warehouse_no	仓库编号	string
warehouse_name	仓库	string
purchaser_id	采购员id	string
purchaser_name	采购员名称	string
logistics_type	物流类型	string
other_fee	其它费用	string
post_fee	邮费	string
goods_fee	总货款	string
goods_count	退货开单量	string
goods_type_count	货品种类数	string
goods_out_count	退货出库量	string
api_outer_no	外部接口单号	string
outer_no	外部单号	string
prop1	自定义属性1	string
prop2	自定义属性2	string
provider_no	供应商编号	string
purchase_no	引用采购单号	string
creator_id	制单员id	string
creator_name	制单员姓名	string
type	类型	string
flag_id	颜色标记	string
warehouse_id	出库id	string
provider_id	供应商id	string
contact	联系人姓名	string
telno	联系电话	string
receive_address	退货地址	string
check_operator_id	审核人	string
check_time	审核时间	string
note_count	便签条数	string
province	省份	string
city	城市	string
district	地区	string
wms_outer_no	外部仓库的单号	string
wms_status	处理状态	string
error_info	错误信息	string
version_id	版本号	string
last_load_purchase_id	最后一次引用的采购单id	string
detail_list	采购退货单货品列表节点	array
detail_list.return_id	采购退货单id	string
detail_list.remark	备注	string
detail_list.created	创建时间	string
detail_list.modified	最后修改时间	string
detail_list.provider_goods_no	供应商货品编号	string
detail_list.spec_no	商家编码	string
detail_list.goods_no	货品编码	string
detail_list.goods_name	货品名称	string
detail_list.spec_name	规格名称	string
detail_list.spec_code	规格码	string
detail_list.num	退货数量	string
detail_list.num2	辅助退货量	string
detail_list.unit_id	出库单位	string
detail_list.unit_ratio	单位变换率	string
detail_list.base_unit_id	基本单位	string
detail_list.price	单价	string
detail_list.discount	折扣	string
detail_list.amount	税前金额	string
detail_list.unit_name	出库单位名称	string
detail_list.base_unit_name	基本单位名称	string
detail_list.tax	税率	string
detail_list.tax_amount	税后金额	string
detail_list.rec_id	明细id	string
detail_list.spec_id	规格id	string
detail_list.out_num	退货出库数量	string
detail_list.out_amount	退货出库金额	string
detail_list.tax_price	税后单价	string

金蝶云星空接口明细

API：batchSave
NAME：采购退货新增
METHOD：POST

请求参数

接口字段	字段名称	预设值
FBillNo	单据编号	{{return_no}}YY
FDate	退料日期	{{check_time datetime 2020-02-01}}
FSupplierID	供应商	0003
FStockOrgId	退料组织	100
FMRREASON	退料原因	旺店通退料
FRequireOrgId	需求组织	100
FDESCRIPTION	备注	{{warehouse_no}}{{logistics_type}}
FSettleOrgId	结算组织	100
FPayOrgId	付款组织	100
FPURMRBENTRY	明细信息	detail_list
FPURMRBENTRY.FMATERIALID	物料编码	A01
FPURMRBENTRY.FBarcode	零售条形码
FPURMRBENTRY.FRMREALQTY	实退数量	{{detail_list.num}}
FPURMRBENTRY.FPrice	单价	{{detail_list.price}}
FPURMRBENTRY.FTAXPRICE	含税单价	{{detail_list.price}}
FPURMRBENTRY.FEntryTaxRate	税率
FPURMRBENTRY.FSTOCKID	仓库	CK001
FPURMRBENTRY.FNOTE	备注	WDT{{detail_list.goods_no}}
FPURMRBENTRY.FPURMRBENTRY_Link	关联关系表
FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FRuleId	转换规则	PUR_MRAPP-PUR_MRB
FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSTableName	源单表	T_PUR_MRAPPENTRY
FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSBillId	源单内码	5555
FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSId	源单分录内码	5555
FPURMRBENTRY.FormId	业务对象表单Id	PUR_MRB
FPURMRBENTRY.Operation	执行的操作	batchSave
FPURMRBENTRY.IsAutoSubmitAndAudit	提交并审核	true
FPURMRBENTRY.IsVerifyBaseDataField	验证基础资料	false

数据对接价值

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