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

源系统:旺店通·企业奇门

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

集成系统:金蝶云星空

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

系统对接接口配置

在轻易云平台进行集成方案的配置时，为了实现快速搭建，轻易云平台还提供了现有的市场方案进行复制参考。用户可以在创建集成方案的时候在第四步选择引用市场方案，参考市场主流所进行的字段配置完成集成方案的自定义化快速配置，即便是第一次使用轻易云平台的用户也能轻松搭建属于自己的数据同步方案。向导式配置，让配置更加清晰，首先确定该方方案的对接内容，第二歩获取筛选数据源平台的数据，第三步数据源与写入目标形成映射关系配置。完成配置后一键启用

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

接口：wdt.stockout.order.query.return
接口名称：查询采购退货出库单
接口方法：POST

请求参数

字段	名称	类型	描述
start_time	开始时间	string
end_time	结束时间	string	按最后修改时间增量获取数据,end_time作为结束时间，格式：yyyy-MM-dd HH:mm:ss
warehouse_no	仓库编号	string
status	出库单状态	string	出库单状态5：已取消，50：待审核，55：已审核，95：已发货，110：已完成（默认查已发货已完成单据）
page_no	页号	string
page_size	分页大小	string	每页返回的数据条数，输入值范围1~30，不传本参数，输入值默认为30，
src_order_no	上层单据编号	string

响应参数

字段	名称	类型	描述
stockout_id	出库单主键id	string	出库单主键id
order_no	出库单号	string	系统出库单号，默认为CK开头
src_order_no	源单号	string	该源单号为退货单号
warehouse_no	仓库编号	string	代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置）
status	状态	string	出库状态
consign_time	出库时间	string	出库时间，格式：yyyy-MM-dd HH:mm:ss
order_type	源单据类别	string	源单据类别 1销售订单, 2调拨出库, 3采购退货出库, 4盘亏出库, 5生产出库, 6现款销售出库, 7其他出库, 8多发出库, 9纠错出库,10保修配件出库, 11初始化出库, 12jit拣货出库 13委外出库
order_type_name	源单据类型名称	string	源单据类型名称
subtype	出库子类型	string	出库子类型
goods_total_amount	货品总售价	string	货品总售价
goods_total_cost	货品总成本	string	货品总成本
post_fee	邮费	string	邮费
logistics_no	物流编号	string	代表物流所有属性的唯一编码，用于物流区分，ERP内支持自定义（ERP物流界面设置）
package_fee	包装费	string	包装费
receiver_name	收件人	string	该字段已废弃
receiver_country	国家	string	国家
receiver_province	省份	string	省份
receiver_city	城市	string	城市
receiver_district	地区	string	地区
receiver_address	详细地址	string	该字段已废弃
receiver_mobile	收件人移动电话	string	该字段已废弃
receiver_telno	收件人固定电话	string	该字段已废弃
receiver_zip	邮编	string	邮编
stockout_reason	出库原因	string	出库原因
outer_no	外部单号	string	外部单号
operator_name	操作人	string	操作人
receiver_area	省市区	string	省市区空格分开
return_no	采购退货单号	string	采购退货单号
provider_no	供应商编号	string	代表供应商所有属性的唯一编码，用于供应商区分，ERP内支持自定义（ERP供应商界面设置）
provider_name	供应商名称	string	供应商名称
pr_api_outer_no	采购退货单外部单号	string	采购退货单的外部单号
last_load_purchase_no	最后引用采购单号	string	最后引用采购单号
picklist_print_status	分拣单打印状态	string	默认为'0'，分拣单打印状态 0未打印 1打印中 2已打印 3无需打印
logistics_print_status	物流单打印状态	string	默认为'0'，物流单打印状态，0未打印 1打印中 2已打印 3无需打印
sendbill_print_status	发货单打印状态	string	默认为'0'，发货单打印状态，0未打印 1待打中 2已打印 3无需打印
stockout_no	出库单号	string	出库单号
src_order_id	源单据id	string	源单据id
wms_status	处理状态	string	处理状态 0 待处理 1 推送失败 2 推送成功 3 接口取消成功系统驳回失败 4 服务器正在处理 5 WMS返回发货信息 6 异步标记,推送申请成功
error_info	错误信息	string	接口处理错误信息
warehouse_type	仓库类别	string	默认为'0'，仓库类别 0不限 1普通仓库 2自动流转外部 3京东仓储 4科捷 5百世物流 6 SKU360 7通天晓 8中联网仓 9顺丰仓储 10网仓2号 11奇门仓储 12旺店通仓储 13心怡仓储 14力威仓储 15京东沧海 16云集仓储 127其他
warehouse_id	出库的仓库id	string	出库的仓库id
customer_id	客户id	string	默认为'0'，客户id
freeze_reason	冻结原因	string	默认为'0'，冻结原因
is_allocated	是否分配	string	默认为'0'，是否分配
consign_status	出库状态	string	默认为'0'，出库状态 1验货 2称重 4出库 8物流同步 16分拣 32档口, 64拣货
ebill_status	面单状态	string	默认为'0'，电子面单,获取状态
operator_id	制单人	string	默认为'0'，制单人
goods_type_count	货品种类数量	string	默认为'0'，货品种类数量
md5_str	MD5字符串值	string	默认为''，MD5字符串值,用于单据排序
raw_goods_count	预留字段	string	默认为'0'，预留字段
custom_type	出库类别	string	默认为'0'，其他出库自定义子类别0，1，2，3，4
receiver_ring	接收环	string	默认为''，京东三环内（未使用）
to_deliver_time	配送时间	string	默认为''，配送时间
pre_charge_time	配送中心	string	默认为''，配送中心
logistics_id	物流公司id	string	默认为'0'，物流公司id
unknown_goods_amount	未知成本销售总额	string	默认为'0.0000'，未知成本销售总额
calc_post_cost	预估邮费成本	string	默认为'0.0000'，预估邮费成本
post_cost	邮费成本	string	默认为'0.0000'，邮费成本
calc_weight	预估重量	string	默认为'0.0000'，预估重量
post_weight	快递给的重量	string	默认为'0.0000'，快递给的重量
package_id	包装	string	默认为'0'，包装
package_cost	包装成本	string	默认为'0.0000'，包装成本
has_invoice	是否包含发票	string	默认为'0'，是否包含发票
printer_id	打单员	string	默认为'0'，打单员
pick_error_count	拣货出错次数	string	默认为'0'，拣货出错次数
picker_id	拣货操作员id	string	默认为'0'，拣货操作员id
sorter_id	包裹分拣员id	string	默认为'0'，包裹分拣员id
examiner_id	验货操作员id	string	默认为'0'，验货操作员id
consigner_id	发货人id	string	默认为'0'，发货人id
packager_id	打包员	string	默认为'0'，打包员
pack_score	打包积分	string	默认为'0'，打包积分
pick_score	拣货积分	string	默认为'0'，拣货积分
checkouter_id	签出员工id	string	默认为'0'，签出员工id
watcher_id	监视员	string	默认为'0'，监视员
picklist_no	分拣单编号	string	默认为''，分拣单编号
picklist_seq	分拣单中序号	string	默认为'0'，订单在分拣单中序号
invoice_print_status	发票打印状态	string	默认为'0'，发票打印状态
flag_id	颜色标记	string	默认为'0'，颜色标记
logistics_template_id	物流单模板id	string	默认为'0'，物流单模板id
sendbill_template_id	发货单模板id	string	默认为'0'，发货单模板id
pos_allocate_mode	货位分配方式	string	默认为'0'，货位分配方式：0系统自动分配, 1手动指定货位分配 2手动指定有效期批次货位
note_count	便签条数	string	默认为'0'，便签条数
reason_id	出库原因	string	默认为'0'，其他出库原因
lock_id	锁定策略id	string	默认为'0'，锁定策略id
reserve	保留	string	默认为'0'，保留
block_reason	截停原因	string	默认为'0'，截停原因1申请退款2已退款4地址被修改8发票被修改16物流被修改32仓库变化64备注修改128更换货品256添加货品512放弃抢单1024其他原因2048拦截赠品4096拦截天猫换货8192买家留言变更16384货品平台规格名变更
stock_check_time	出库单审核时间	string	出库单审核时间
details_list	货品列表节点	array	响应参数的2级数据节点，包含的采购退货出库单及其明细的数据节点，节点下数据字段详见下述“detail_list”列表
details_list.stockout_id	出库单主键id	string	出库单主键id
details_list.goods_count	货品数量	string	货品数量
details_list.weight	重量	string	重量
details_list.remark	备注	string	备注
details_list.modified	最后修改时间	string	最后修改时间
details_list.src_order_type	源单据类别	string	默认为'1'，源单据类别 1销售订单2,调拨出库3,采购出库4,生产出库5,盘亏出库6,其他出库
details_list.batch_no	批次号	string	批次号
details_list.rec_id	出库明细主键id	string	出库明细主键id
details_list.spec_no	商家编码	string	代表单品（SKU）所有属性的唯一编号，用于系统单品的区分，SKU概念介绍单击这里
details_list.sell_price	销售价	string	销售价
details_list.brand_no	品牌编号	string	品牌编号
details_list.brand_name	品牌名称	string	品牌名称
details_list.goods_name	货品名称	string	货品名称
details_list.goods_no	货品编号	string	代表SPU所有属性的唯一编号，用于系统货品的区分，SPU概念介绍单击这里
details_list.spec_name	规格名称	string	规格名称
details_list.spec_code	规格编号	string	规格编号
details_list.cost_price	成本价	string	成本价
details_list.total_amount	总货款	string	总货款
details_list.goods_type	货品类别	string	1销售商品 2原材料 3包装 4周转材料5虚拟商品 0其它
details_list.goods_unit	单位名称	string	单位名称
details_list.batch_remark	批次备注	string	批次备注
details_list.expire_date	有效期	string	有效期，格式：yyyy-MM-dd HH:mm:ss
details_list.goods_id	货品id	string	货品id
details_list.spec_id	规格id	string	默认为'0'，规格id
details_list.src_order_detail_id	源单据细节id	string	sales_trade_order表的主键
details_list.base_unit_id	基本单位	string	默认为'0'，基本单位
details_list.unit_id	辅助单位	string	默认为'0'，辅助单位
details_list.unit_ratio	单位换算	string	默认为'1.0000'，单位换算
details_list.num2	辅助数量	string	默认为'0.0000，辅助数量
details_list.num	货品数量	string	货品数量
details_list.price	价格	string	默认为'0.0000，最终价格
details_list.batch_id	出库批次	string	默认为'0'，指定出库批次
details_list.is_examined	是否验货	string	默认为'0'，是否验货，用于挂起，已标记为验货的不需要再验货
details_list.is_package	是否包装	string	默认为'0'，是否包装
details_list.is_zero_cost	是否允许0成本	string	默认为'0'，是否允许0成本
details_list.scan_type	类型	string	默认为'0'，0未验货,1扫描验货,2手工验货
details_list.created	创建时间	string	创建时间
details_list.position_list	货位列表节点	array	响应参数的3级数据节点，节点下数据字段详见下述“position_list”列表
details_list.position_list.position_id	货位ID	string	货位ID
details_list.position_list.position_no	货位编号	string	货位编号
details_list.position_list.position_goods_count	货位出库数量	string	货位出库数量

金蝶云星空接口明细

接口：batchSave
接口名称：采购退货新增
接口方法：POST

请求参数

字段	名称	类型	描述
FBillTypeID	单据类型	string	单据编号
FBusinessType	业务类型	string	业务类型
FBillNo	单据编号	string	单据编号
FDate	退料日期	string	日期
FStockOrgId	退料组织	string	组织
FPurchaseOrgId	采购组织	string	组织
FSupplierID	供应商	string	基础资料
FDESCRIPTION	备注	string	多行文本
FMRMODE	退料方式	string	多行文本
FDELIVERYNO	送货单号	string	文本
FCARRYNO	运输单号	string	文本
FTAKEDELIVERYNO	提货单号	string	文本
FPURMRBENTRY	明细信息	array	明细信息
FPURMRBENTRY.FMATERIALID	物料编码	string	基础资料
FPURMRBENTRY.FBarcode	零售条形码	string	文本
FPURMRBENTRY.FRMREALQTY	实退数量	string	数量
FPURMRBENTRY.FREPLENISHQTY	补料数量	string	数量
FPURMRBENTRY.FKEAPAMTQTY	扣款数量	string	数量
FPURMRBENTRY.FSTOCKID	仓库	string	基础资料
FPURMRBENTRY.FNOTE	备注	string	文本
FPURMRBENTRY.FPrice	单价	string	单价
FPURMRBENTRY.FGiveAway	是否赠品	string	复选框
FPURMRBENTRY.FLot	批号	string	批次
FPURMRBENTRY.FOWNERID	货主	string	多类别基础资料
FPURMRBENTRY.FOWNERTYPEID	货主类型	string	多类别基础资料列表
FPURMRBENTRY.FENTRYTAXRATE	税率	string	小数
FPURMRBENTRY.FDISCOUNTRATE	折扣率(%)	string	小数
FPURMRBENTRY.FTAXPRICE	含税单价	string	单价
FPURMRBENTRY.FSRCBillTypeId	源单类型	string	文本
FPURMRBENTRY.FSRCBillNo	源单编号	string	文本
FPURMRBENTRY.FORDERNO	订单单号	string	文本
FPURMRBENTRY.FCONTRACTNO	合同单号	string	文本
FPURMRBENTRY.FMtoNo	计划跟踪号	string	文本
FPURMRBENTRY.FPURMRBENTRY_Link	关联关系表	array
FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FRuleId	转换规则	string
FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSTableName	源单表	string
FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSBillId	源单内码	string
FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSId	源单分录内码	string
FPURMRBENTRY.FormId	业务对象表单Id	string	必须填写金蝶的表单ID如:PUR_PurchaseOrder
FPURMRBENTRY.Operation	执行的操作	string
FPURMRBENTRY.IsAutoSubmitAndAudit	提交并审核	bool
FPURMRBENTRY.IsVerifyBaseDataField	验证基础资料	bool	是否验证所有的基础资料有效性，布尔类，默认false（非必录）
FPURMRBENTRY.SubSystemId	系统模块	string	默认仓库模块

数据对接效果

异构系统都具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。采用“轻易云集成方案”的解决方案，可以满足客户的实际业务需求，推动软件工程的规范化，使开发人员遵循统一的概要设计开发实现，降低系统实现的风险，做到系统设计资料的规范性与全面性，以利于系统的实现、测试、维护、版本升级等。通过轻易云系统集成平台完美结合：打破企业内部数据孤岛，无需繁琐的处理工序，与数据集成服务完美结合，让数据真正通起来。资源互补：汇集各种行业解决方案，资源互补，企业管理融合提升。

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