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

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

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

对接目标系统:金蝶云星空

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

数据接口配置

使用系统数据集成平台对应的模块：数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统：旺店通·企业奇门，然后选择对应的连接器。选择对应的查询采购退货出库单作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空,并且选择对应连接器（关于金蝶云星空的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的采购退货新增接口作为数据写入动作，既可以完成第一步的数据对接配置。

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

API：wdt.stockout.order.query.return
NAME：查询采购退货出库单
METHOD：POST

请求参数

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

响应参数

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

金蝶云星空接口明细

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

请求参数

接口字段字段名称预设值描述 FBillTypeID单据类型TLD01_SYS单据编号 FBusinessType业务类型CG业务类型 FBillNo单据编号{{order_no}}-TC单据编号 FDate退料日期{{consign_time}}日期 FStockOrgId退料组织106组织 FPurchaseOrgId采购组织106组织 FSupplierID供应商{{provider_no}}基础资料 FDESCRIPTION备注多行文本 FMRMODE退料方式B多行文本 FDELIVERYNO送货单号文本 FCARRYNO运输单号文本 FTAKEDELIVERYNO提货单号文本 FPURMRBENTRY明细信息details_list明细信息 FPURMRBENTRY.FMATERIALID物料编码{{details_list.spec_no}}基础资料 FPURMRBENTRY.FBarcode零售条形码文本 FPURMRBENTRY.FRMREALQTY实退数量{{details_list.goods_count}}数量 FPURMRBENTRY.FREPLENISHQTY补料数量数量 FPURMRBENTRY.FKEAPAMTQTY扣款数量数量 FPURMRBENTRY.FSTOCKID仓库{{warehouse_no}}基础资料 FPURMRBENTRY.FNOTE备注文本 FPURMRBENTRY.FPrice单价单价 FPURMRBENTRY.FGiveAway是否赠品复选框 FPURMRBENTRY.FLot批号批次 FPURMRBENTRY.FOWNERID货主106多类别基础资料 FPURMRBENTRY.FOWNERTYPEID货主类型BD_OwnerOrg多类别基础资料列表 FPURMRBENTRY.FENTRYTAXRATE税率小数 FPURMRBENTRY.FDISCOUNTRATE折扣率(%)小数 FPURMRBENTRY.FTAXPRICE含税单价findCollection find FAPPROVEPRICE_F from 6b95a3b6-1a26-3668-bc09-ed75e10203f1 where FBillNo={{pr_api_outer_no}} FMATERIALID_Fnumber={{details_list.spec_no}}单价 FPURMRBENTRY.FSRCBillTypeId源单类型PUR_MRAPP文本 FPURMRBENTRY.FSRCBillNo源单编号_findCollection find FBillNo from 6b95a3b6-1a26-3668-bc09-ed75e10203f1 where FBillNo={{pr_api_outer_no}} FMATERIALID_Fnumber={{details_list.spec_no}}文本 FPURMRBENTRY.FORDERNO订单单号findCollection find FORDERNO from 6b95a3b6-1a26-3668-bc09-ed75e10203f1 where FBillNo={{pr_api_outer_no}} FMATERIALID_Fnumber={{details_list.spec_no}}文本 FPURMRBENTRY.FCONTRACTNO合同单号文本 FPURMRBENTRY.FMtoNo计划跟踪号文本 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源单内码_findCollection find FID from 6b95a3b6-1a26-3668-bc09-ed75e10203f1 where FBillNo={{pr_api_outer_no}} FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSId源单分录内码_findCollection find FEntity_FEntryID from 6b95a3b6-1a26-3668-bc09-ed75e10203f1 where FBillNo={{pr_api_outer_no}} FMATERIALID_Fnumber={{details_list.spec_no}} FPURMRBENTRY.FormId业务对象表单IdPUR_MRB必须填写金蝶的表单ID如😛UR_PurchaseOrder FPURMRBENTRY.Operation执行的操作batchSave FPURMRBENTRY.IsAutoSubmitAndAudit提交并审核true FPURMRBENTRY.IsVerifyBaseDataField验证基础资料true是否验证所有的基础资料有效性，布尔类，默认false（非必录） FPURMRBENTRY.SubSystemId系统模块21默认仓库模块

系统打通概况

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

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