旺店通·企业奇门对接打通金蝶云星空查询采购退货单接口与采购退货新增接口数据源平台:旺店通·企业奇门慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。接通系统：金蝶云星空金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。系统对接接口配置异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则，例如取数就要根据查询接口获取旺店通·企业奇门的数据，并且根据对应的条件进行取数，目标系统就必须根据目标系统的格式，以及获取的数据进行加工处理后进行写入到金蝶云星空中。轻易云集成平台的可视化配置轻松实现。旺店通·企业奇门接口明细接口： wdt.purchase.return.query 接口名称：查询采购退货单接口方法： POST 请求参数字段名称类型描述 start_time 开始时间 datetime 增量获取数据，start_time作为开始时间，格式：yyyy-MM-dd HH:mm:ss end_time 结束时间 datetime 增量获取数据，end_time作为结束时间，格式：yyyy-MM-dd HH:mm:ss status 状态 string 采购退货单状态：10,已取消,20,编辑中,30,待审核,40,已审核,42,待推送,44,推送失败,46,委外待出库,50,部分出库,60,已完成 warehouse_no 仓库编号 string 代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置），用于获取指定仓库单据数据信息(不支持一次推送多个仓库编号) page_size 分页大小 string 每页返回的数据条数，输入值范围1 100，不传本参数，输入值默认为40，使用举例单击这里 page_no 页号 string 不传值默认从0页开始响应参数字段名称类型描述 return_id 采购退货单id string 采购退货单主键id return_no 退货单号 string 退货单号 provider_name 供应商 string 供应商 status 采购单状态 string 采购退货单状态：10,已取消,20,编辑中,30,待审核,40,已审核,42,待推送,44,推送失败,46,委外待出库,50,部分出库,60,已完成 warehouse_no 仓库编号 string 代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置） warehouse_name 仓库 string 系统仓库名称 purchaser_id 采购员id string 采购员id 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 退货出库量 remark 备注 string 采购退货单备注 created 建单时间 string 格式：yyyy-MM-dd HH:mm:ss modified 最后修改时间 string 格式：yyyy-MM-dd HH:mm:ss api_outer_no 外部接口单号 string 外部接口单号 outer_no 外部单号 string 外部单号 prop1 自定义属性1 string 自定义属性1 prop2 自定义属性2 string 自定义属性2 provider_no 供应商编号 string 供应商编号 purchase_no 引用采购单号 string 引用采购单号 creator_id 制单员id string 制单员id creator_name 制单员姓名 string 制单员姓名 type 类型 string 默认为'1'，1退货 flag_id 颜色标记 string 默认为'0'，颜色标记 warehouse_id 出库id string 出库id provider_id 供应商id string 默认为'0'，供应商id contact 联系人姓名 string 供商商联系人姓名 telno 联系电话 string 供应商联系电话 receive_address 退货地址 string 退货地址 check_operator_id 审核人 string 默认为'0'，审核人 check_time 审核时间 string 默认'0000-00-00 00:00:00'，审核时间 note_count 便签条数 string 默认为'0'，便签条数 province 省份 string 默认为''，省份 city 城市 string 默认为''，城市 district 地区 string 默认为''，地区 wms_outer_no 外部仓库的单号 string 默认为''，对应外部仓库的单号 wms_status 处理状态 string 默认为'0'，处理状态 error_info 错误信息 string 默认为''，接口调用错误信息 version_id 版本号 string 默认为'0'，版本号 last_load_purchase_id 最后一次引用的采购单id string 默认为'0'，最后一次引用的采购单id detail_list 采购退货单货品列表节点 array 响应参数的2级数据节点，包含采购退货单货货品明细所有属性信息，节点下数据字段详见下述“detail_list” detail_list.return_id 采购退货单id string 默认为'0'，标记 detail_list.provider_goods_no 供应商货品编号 string 最后修改时间 detail_list.spec_no 商家编码 string 响应参数的2级数据节点，包含采购入库货品明细属性信息,节点下数据字段详见下述“details_list” detail_list.goods_no 货品编码 string 入库单主键id detail_list.goods_name 货品名称 string 入库明细主键 detail_list.spec_name 规格名称 string 上层单据明细主键 detail_list.spec_code 规格码 string 代表单品(sku)所有属性的编码，SKU概念介绍,单击这里 detail_list.num 退货数量 string 货品数量 detail_list.num2 辅助退货量 string 优惠金额 detail_list.unit_id 出库单位 string 单价 detail_list.unit_ratio 单位变换率 string 生产日期，格式：yyyy-MM-dd HH:mm:ss detail_list.base_unit_id 基本单位 string 有效期天数 detail_list.price 单价 string 有效期，格式：yyyy-MM-dd HH:mm:ss detail_list.discount 折扣 string 原价 detail_list.amount 税前金额 string 税后价 detail_list.unit_name 出库单位名称 string 税后金额 detail_list.base_unit_name 基本单位名称 string 税率 detail_list.remark 备注 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 品牌编号 detail_list.modified 最后修改时间 string 品牌名称 detail_list.created 创建时间 string 货品名称 detail_list.stockout_no 出库单号 string 金蝶云星空接口明细 API： batchSave NAME：采购退货新增 METHOD： POST 请求参数接口字段字段名称预设值描述 FBillTypeID 单据类型 FBillNo 单据编号 {{return_no}} 单据编号 FDate 退料日期 {{created}} 日期 FSupplierID 供应商基础资料 FStockOrgId 退料组织组织 FSettleOrgId 结算组织组织 FSETTLETYPEID 结算方式基础资料 FSettleCurrId 结算币别基础资料 FPayOrgId 付款组织组织 FOwnerTypeIdHead 货主类型多类别基础资料列表 FOwnerIdHead 货主 100 多类别基础资料 FPURMRBENTRY 明细信息明细信息 FPURMRBENTRY.FMATERIALID 物料编码 {{detail_list.goods_no}} 基础资料 FPURMRBENTRY.FRMREALQTY 实退数量 {{detail_list.num}} 数量 FPURMRBENTRY.FSTOCKID 仓库 {{warehouse_no}} 基础资料 FPURMRBENTRY.FPrice 单价 {{detail_list.price}} 单价 FPURMRBENTRY.FLot 批号批次 FPURMRBENTRY.FOWNERID 货主 100 多类别基础资料 FPURMRBENTRY.FOWNERTYPEID 货主类型多类别基础资料列表 FPURMRBENTRY.FTAXPRICE 含税单价单价 FPURMRBENTRY.FPURMRBENTRY_Link_FRuleId 转换规则 FPURMRBENTRY.FPURMRBENTRY_Link_FSTableName 源单表 FPURMRBENTRY.FPURMRBENTRY_Link_FSBillId 源单内码 FPURMRBENTRY.FPURMRBENTRY_Link_FSId 源单分录内码 FPURMRBENTRY.FormId 业务对象表单Id PUR_MRB 必须填写金蝶的表单ID如😛UR_PurchaseOrder FPURMRBENTRY.Operation 执行的操作 batchSave FPURMRBENTRY.IsAutoSubmitAndAudit 提交并审核 true FPURMRBENTRY.IsVerifyBaseDataField 验证基础资料 false 是否验证所有的基础资料有效性，布尔类，默认false（非必录） FPURMRBENTRY.SubSystemId 系统模块 21 默认仓库模块数据对接效果数据集成中台设计中心Web界面以“拖拽”式交互设计，使用鼠标即可构建设计多异构系统数据集成流程，低代码平台大大降低流程设计者上手门槛。还有丰富的组件库快速满足复杂业务需求，结合不同模块即可生成不同业务流程，提升流程设计效率。平台支持多种高度灵活部署，高并发、高性能、高可用，可以通过多节点组成集群实现性能的横向扩展。适度集群配置其数据集成处理能力可达GB级/秒，为业务流提供更高数据吞吐量。平台已集成数据回压、优先级队列等能力，保障运行稳定性。完善的企业API运营管理机制帮助您构建“API生产者、API管理者、API消费者”三者结合的统一API数字化生态。支持市面上主流厂家软件如：金蝶、用友、SAP、泛微、蓝凌、旺店通、聚水潭、马帮、小满CRM等等。

旺店通·企业奇门对接打通金蝶云星空查询采购退货单接口与采购退货新增接口

文森特

旺店通·企业奇门对接打通金蝶云星空查询采购退货单接口与采购退货新增接口

数据源平台:旺店通·企业奇门

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

接通系统：金蝶云星空

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

系统对接接口配置

异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则，例如取数就要根据查询接口获取旺店通·企业奇门的数据，并且根据对应的条件进行取数，目标系统就必须根据目标系统的格式，以及获取的数据进行加工处理后进行写入到金蝶云星空中。轻易云集成平台的可视化配置轻松实现。

旺店通·企业奇门接口明细

接口：wdt.purchase.return.query
接口名称：查询采购退货单
接口方法：POST

请求参数

字段	名称	类型	描述
start_time	开始时间	datetime	增量获取数据，start_time作为开始时间，格式：yyyy-MM-dd HH:mm:ss
end_time	结束时间	datetime	增量获取数据，end_time作为结束时间，格式：yyyy-MM-dd HH:mm:ss
status	状态	string	采购退货单状态：10,已取消,20,编辑中,30,待审核,40,已审核,42,待推送,44,推送失败,46,委外待出库,50,部分出库,60,已完成
warehouse_no	仓库编号	string	代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置），用于获取指定仓库单据数据信息(不支持一次推送多个仓库编号)
page_size	分页大小	string	每页返回的数据条数，输入值范围1_{100，不传本参数，输入值默认为40，使用举例单击这里}
page_no	页号	string	不传值默认从0页开始

响应参数

字段	名称	类型	描述
return_id	采购退货单id	string	采购退货单主键id
return_no	退货单号	string	退货单号
provider_name	供应商	string	供应商
status	采购单状态	string	采购退货单状态：10,已取消,20,编辑中,30,待审核,40,已审核,42,待推送,44,推送失败,46,委外待出库,50,部分出库,60,已完成
warehouse_no	仓库编号	string	代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置）
warehouse_name	仓库	string	系统仓库名称
purchaser_id	采购员id	string	采购员id
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	退货出库量
remark	备注	string	采购退货单备注
created	建单时间	string	格式：yyyy-MM-dd HH:mm:ss
modified	最后修改时间	string	格式：yyyy-MM-dd HH:mm:ss
api_outer_no	外部接口单号	string	外部接口单号
outer_no	外部单号	string	外部单号
prop1	自定义属性1	string	自定义属性1
prop2	自定义属性2	string	自定义属性2
provider_no	供应商编号	string	供应商编号
purchase_no	引用采购单号	string	引用采购单号
creator_id	制单员id	string	制单员id
creator_name	制单员姓名	string	制单员姓名
type	类型	string	默认为'1'，1退货
flag_id	颜色标记	string	默认为'0'，颜色标记
warehouse_id	出库id	string	出库id
provider_id	供应商id	string	默认为'0'，供应商id
contact	联系人姓名	string	供商商联系人姓名
telno	联系电话	string	供应商联系电话
receive_address	退货地址	string	退货地址
check_operator_id	审核人	string	默认为'0'，审核人
check_time	审核时间	string	默认'0000-00-00 00:00:00'，审核时间
note_count	便签条数	string	默认为'0'，便签条数
province	省份	string	默认为''，省份
city	城市	string	默认为''，城市
district	地区	string	默认为''，地区
wms_outer_no	外部仓库的单号	string	默认为''，对应外部仓库的单号
wms_status	处理状态	string	默认为'0'，处理状态
error_info	错误信息	string	默认为''，接口调用错误信息
version_id	版本号	string	默认为'0'，版本号
last_load_purchase_id	最后一次引用的采购单id	string	默认为'0'，最后一次引用的采购单id
detail_list	采购退货单货品列表节点	array	响应参数的2级数据节点，包含采购退货单货货品明细所有属性信息，节点下数据字段详见下述“detail_list”
detail_list.return_id	采购退货单id	string	默认为'0'，标记
detail_list.provider_goods_no	供应商货品编号	string	最后修改时间
detail_list.spec_no	商家编码	string	响应参数的2级数据节点，包含采购入库货品明细属性信息,节点下数据字段详见下述“details_list”
detail_list.goods_no	货品编码	string	入库单主键id
detail_list.goods_name	货品名称	string	入库明细主键
detail_list.spec_name	规格名称	string	上层单据明细主键
detail_list.spec_code	规格码	string	代表单品(sku)所有属性的编码，SKU概念介绍,单击这里
detail_list.num	退货数量	string	货品数量
detail_list.num2	辅助退货量	string	优惠金额
detail_list.unit_id	出库单位	string	单价
detail_list.unit_ratio	单位变换率	string	生产日期，格式：yyyy-MM-dd HH:mm:ss
detail_list.base_unit_id	基本单位	string	有效期天数
detail_list.price	单价	string	有效期，格式：yyyy-MM-dd HH:mm:ss
detail_list.discount	折扣	string	原价
detail_list.amount	税前金额	string	税后价
detail_list.unit_name	出库单位名称	string	税后金额
detail_list.base_unit_name	基本单位名称	string	税率
detail_list.remark	备注	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	品牌编号
detail_list.modified	最后修改时间	string	品牌名称
detail_list.created	创建时间	string	货品名称
detail_list.stockout_no	出库单号	string

金蝶云星空接口明细

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

请求参数

接口字段	字段名称	预设值	描述
FBillTypeID	单据类型
FBillNo	单据编号	{{return_no}}	单据编号
FDate	退料日期	{{created}}	日期
FSupplierID	供应商		基础资料
FStockOrgId	退料组织		组织
FSettleOrgId	结算组织		组织
FSETTLETYPEID	结算方式		基础资料
FSettleCurrId	结算币别		基础资料
FPayOrgId	付款组织		组织
FOwnerTypeIdHead	货主类型		多类别基础资料列表
FOwnerIdHead	货主	100	多类别基础资料
FPURMRBENTRY	明细信息		明细信息
FPURMRBENTRY.FMATERIALID	物料编码	{{detail_list.goods_no}}	基础资料
FPURMRBENTRY.FRMREALQTY	实退数量	{{detail_list.num}}	数量
FPURMRBENTRY.FSTOCKID	仓库	{{warehouse_no}}	基础资料
FPURMRBENTRY.FPrice	单价	{{detail_list.price}}	单价
FPURMRBENTRY.FLot	批号		批次
FPURMRBENTRY.FOWNERID	货主	100	多类别基础资料
FPURMRBENTRY.FOWNERTYPEID	货主类型		多类别基础资料列表
FPURMRBENTRY.FTAXPRICE	含税单价		单价
FPURMRBENTRY.FPURMRBENTRY_Link_FRuleId	转换规则
FPURMRBENTRY.FPURMRBENTRY_Link_FSTableName	源单表
FPURMRBENTRY.FPURMRBENTRY_Link_FSBillId	源单内码
FPURMRBENTRY.FPURMRBENTRY_Link_FSId	源单分录内码
FPURMRBENTRY.FormId	业务对象表单Id	PUR_MRB	必须填写金蝶的表单ID如😛UR_PurchaseOrder
FPURMRBENTRY.Operation	执行的操作	batchSave
FPURMRBENTRY.IsAutoSubmitAndAudit	提交并审核	true
FPURMRBENTRY.IsVerifyBaseDataField	验证基础资料	false	是否验证所有的基础资料有效性，布尔类，默认false（非必录）
FPURMRBENTRY.SubSystemId	系统模块	21	默认仓库模块

数据对接效果

数据集成中台设计中心Web界面以“拖拽”式交互设计，使用鼠标即可构建设计多异构系统数据集成流程，低代码平台大大降低流程设计者上手门槛。还有丰富的组件库快速满足复杂业务需求，结合不同模块即可生成不同业务流程，提升流程设计效率。平台支持多种高度灵活部署，高并发、高性能、高可用，可以通过多节点组成集群实现性能的横向扩展。适度集群配置其数据集成处理能力可达GB级/秒，为业务流提供更高数据吞吐量。平台已集成数据回压、优先级队列等能力，保障运行稳定性。完善的企业API运营管理机制帮助您构建“API生产者、API管理者、API消费者”三者结合的统一API数字化生态。支持市面上主流厂家软件如：金蝶、用友、SAP、泛微、蓝凌、旺店通、聚水潭、马帮、小满CRM等等。