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

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

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

慧策最先以旺店通ERP切入商家核心管理痛点——订单管理，之后围绕电商经营管理中的核心管理诉求，先后布局流量获取、会员管理、仓库管理等其他重要经营模块。慧策的产品线从旺店通ERP起步，向前向后延伸，全面布局零售企业经营，整体构建一体化智能零售解决方案，打破数据孤岛，AI植入系统，实现智能决策，助力零售企业智能化转型。当前旗下拥有店+小程序、数智门店POS、旺店通ERP、旺店通WMS、卡米全渠道、客优CRM、云筹大数据等多个PssS、SaaS产品，从前端吸引流量到后端集约化管理，助力企业智慧决策

写入目标:金蝶云星辰V1

金蝶云·星辰聚焦小微企业在线经营和数字化管理，以“新生产、新零售、新商贸、新财税、新生态”五大特性赋能企业，以财税智能化、门店数字化、供应链流程化、业财税一体化、订货在线化、营销社交化、需求个性化、决策实时化、办公移动化等九大价值赋能企业，助力企业实现数字化、智能化转型升级。

系统对接接口配置

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

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

• 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_ROW}} 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_count货品数量1货品数量 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邮编邮编 weight重量重量 remark备注备注 stockout_reason出库原因出库原因 outer_no外部单号外部单号 operator_name操作人操作人 receiver_area省市区省市区空格分开 return_no采购退货单号采购退货单号 provider_no供应商编号代表供应商所有属性的唯一编码，用于供应商区分，ERP内支持自定义（ERP供应商界面设置） provider_name供应商名称供应商名称 modified出库单更新时间出库单的最后更新时间，格式：YYYY-MM-DD HH:MM:SS 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_type源单据类别源单据类别 1销售订单, 2调拨出库, 3采购退货出库, 4盘亏出库, 5生产出库, 6现款销售出库, 7其他出库, 8多发出库, 9纠错出库,10保修配件出库, 11初始化出库, 12jit拣货出库 13委外出库' 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货品平台规格名变更 batch_no打印批次默认为''，打印批次 stock_check_time出库单审核时间出库单审核时间 detail_list货品列表节点响应参数的2级数据节点，包含的采购退货出库单及其明细的数据节点，节点下数据字段详见下述“detail_list”列表 detail_list.rec_id出库明细主键id出库明细主键id detail_list.stockout_id出库单主键id出库单主键id detail_list.spec_no商家编码代表单品（SKU）所有属性的唯一编号，用于系统单品的区分，SKU概念介绍单击这里 detail_list.goods_count货品数量货品数量 detail_list.sell_price销售价销售价 detail_list.brand_no品牌编号品牌编号 detail_list.brand_name品牌名称品牌名称 detail_list.goods_name货品名称货品名称 detail_list.goods_no货品编号代表SPU所有属性的唯一编号，用于系统货品的区分，SPU概念介绍单击这里 detail_list.spec_name规格名称规格名称 detail_list.spec_code规格编号规格编号 detail_list.cost_price成本价成本价 detail_list.total_amount总货款总货款 detail_list.weight重量重量 detail_list.goods_type货品类别1销售商品 2原材料 3包装 4周转材料5虚拟商品 0其它 detail_list.goods_unit单位名称单位名称 detail_list.batch_no批次号批次号 detail_list.batch_remark批次备注批次备注 detail_list.expire_date有效期有效期，格式：yyyy-MM-dd HH:mm:ss detail_list.remark备注备注 detail_list.goods_id货品id货品id detail_list.spec_id规格id默认为'0'，规格id detail_list.position_id货位默认为'0'，货位，指出库货位 detail_list.src_order_type源单据类别默认为'1'，源单据类别 1销售订单2,调拨出库3,采购出库4,生产出库5,盘亏出库6,其他出库 detail_list.src_order_detail_id源单据细节idsales_trade_order表的主键 detail_list.base_unit_id基本单位默认为'0'，基本单位 detail_list.unit_id辅助单位默认为'0'，辅助单位 detail_list.unit_ratio单位换算默认为'1.0000'，单位换算 detail_list.num2辅助数量默认为'0.0000，辅助数量 detail_list.num货品数量货品数量 detail_list.price价格默认为'0.0000，最终价格 detail_list.batch_id出库批次默认为'0'，指定出库批次 detail_list.is_examined是否验货默认为'0'，是否验货，用于挂起，已标记为验货的不需要再验货 detail_list.is_package是否包装默认为'0'，是否包装 detail_list.is_zero_cost是否允许0成本默认为'0'，是否允许0成本 detail_list.scan_type类型默认为'0'，0未验货,1扫描验货,2手工验货 detail_list.modified最后修改时间最后修改时间 detail_list.created创建时间创建时间 detail_list.position_list货位列表节点响应参数的3级数据节点，节点下数据字段详见下述“position_list”列表 detail_list.position_list.position_id货位ID货位ID detail_list.position_list.position_no货位编号货位编号 detail_list.position_list.position_goods_count货位出库数量货位出库数量

金蝶云星辰V1接口明细

• 调用接口：jdy/pur/pur_rtn_save
• 接口名称：采购退货单保存新增
• 方法：POST

请求参数

字段字段名称类型配置值 billno单据编码string{{order_no}} billdate单据日期string{{consign_time date}} deptid_id部门string deptid_number部门numberstring empid_id业务员string empid_number业务员numberstring supplierid_id供应商stringfindCollection find id from 9278fe4a-f123-3198-94b2-69703d296326 where number={{provider_no}} remark备注string alldebt应付余额string lastdebt上次欠款string returnreason原因string contact_info联系信息string bill_dis_amount整单折扣额string bill_dis_rate整单折扣率string totalamount本次应退账款string totalinsamount退款合计string totalunsettleamount本单未退string material_entity商品分录arraydetails_list material_entity.materialid_id商品string_findCollection find id from b36e2f56-3e1b-3d60-9748-c59ec4c9d95f where number={{detail_list.spec_no}} material_entity.stockid_id仓库stringfindCollection find id from dfb624bb-d6b8-33fc-a971-c3df53cf9288 where number={{warehouse_no}} material_entity.qty数量string{{detail_list.goods_count}} material_entity.barcode条形码string material_entity.batchno批次号string material_entity.proplace产地string material_entity.proregno注册证号string material_entity.prolicense生产许可证号string material_entity.snlistid序列号流转idstring material_entity.sn_list序列号string material_entity.price单价string_function CASE when {{detail_list.sell_price}}> 0 then {{detail_list.sell_price}} else 0.01 end material_entity.comment行备注string material_entity.srcbillno源单编码string material_entity.srcbilltypeid_id源单类型string material_entity.srcinterid源单内码string material_entity.src_billdate源单日期string material_entity.srcseq源单行号string material_entity.srcentryid源单分录内码string

系统数据对接

基于轻易云的连接器和数据服务能力，轻松实现供应链异构系统的“相互沟通”，通过数据应用自动化业务流程管理，全面管控供应链的每一环节。从要货、销售出库、退货入库、到盘点、调拨，无需人工参与，实时更新，自动化流转。通过快速连接旺店通·企业奇门接口抽取数据后再自动分发到金蝶云星辰V1， 解放生产力，自动生成数据、并分发推送到业务应用，数据传递时效性提升10倍以上。