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

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

对接系统：旺店通·企业奇门

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

目标系统:金蝶云星辰V1

金蝶云·星辰基于金蝶云·苍穹云原生PaaS平台构建，聚焦小型企业在线经营和数字化管理，提供财务云、税务云、进销存云、零售云、订货商城等SaaS服务，支持企业拓客开源、智能管理、实时决策；金蝶云·星辰还提供轻量级PaaS平台和全面的API接口，广泛连接生态伙伴，为小微企业提供一站式服务，助力企业快速成长

数据对接方案

轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线，所以对接方案的配置极其重要，方案可以选择一键复制，轻易云有海量的对接方案可支持一键复制，复制后直接启动使用（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置，配置只要确认源平台：旺店通·企业奇门的取数逻辑，例如什么时间取什么样的数据。即可完成配置，目标平台：金蝶云星辰V1，把获取的数据组装成目标系统需要的格式进行写入。数据管道ETL：构建一体化的数据融合平台。高级数据转换： 支持公式转换数据格式、支持脚本直接进行数据转换、支持可视化多维度数据处理。高性能实时处理：针对不同数据节点类型提供TB级吞吐量，秒级延迟的增量数据处理能力。自动将旧版web服务转变为基于云端微服务的API，统一接口输出标准。支持接口开放服务，实现内外部能力接入。

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

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

请求参数

字段名称类型 start_time开始时间string status出库单状态string warehouse_no仓库编号string src_order_no上层单据编号string page_size分页大小string page_no页号string end_time结束时间string

响应参数

字段名称类型描述 stockout_id出库单主键idstring出库单主键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_count货品数量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邮编 weight重量string重量 remark备注string备注 stockout_reason出库原因string出库原因 outer_no外部单号string外部单号 operator_name操作人string操作人 receiver_area省市区string省市区空格分开 return_no采购退货单号string采购退货单号 provider_no供应商编号string代表供应商所有属性的唯一编码，用于供应商区分，ERP内支持自定义（ERP供应商界面设置） provider_name供应商名称string供应商名称 modified出库单更新时间string出库单的最后更新时间，格式：YYYY-MM-DD HH:MM:SS 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_type源单据类别string源单据类别 1销售订单, 2调拨出库, 3采购退货出库, 4盘亏出库, 5生产出库, 6现款销售出库, 7其他出库, 8多发出库, 9纠错出库,10保修配件出库, 11初始化出库, 12jit拣货出库 13委外出库' src_order_id源单据idstring源单据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出库的仓库idstring出库的仓库id customer_id客户idstring默认为'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_strMD5字符串值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物流公司idstring默认为'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拣货操作员idstring默认为'0'，拣货操作员id sorter_id包裹分拣员idstring默认为'0'，包裹分拣员id examiner_id验货操作员idstring默认为'0'，验货操作员id consigner_id发货人idstring默认为'0'，发货人id packager_id打包员string默认为'0'，打包员 pack_score打包积分string默认为'0'，打包积分 pick_score拣货积分string默认为'0'，拣货积分 checkouter_id签出员工idstring默认为'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物流单模板idstring默认为'0'， 物流单模板id sendbill_template_id发货单模板idstring默认为'0'，发货单模板id pos_allocate_mode货位分配方式string默认为'0'，货位分配方式：0系统自动分配, 1手动指定货位分配 2手动指定有效期批次货位 note_count便签条数string默认为'0'，便签条数 reason_id出库原因string默认为'0'，其他出库原因 lock_id锁定策略idstring默认为'0'，锁定策略id reserve保留string默认为'0'，保留 block_reason截停原因string默认为'0'，截停原因1申请退款2已退款4地址被修改8发票被修改16物流被修改32仓库变化64备注修改128更换货品256添加货品512放弃抢单1024其他原因2048拦截赠品4096拦截天猫换货8192买家留言变更16384货品平台规格名变更 batch_no打印批次string默认为''，打印批次 stock_check_time出库单审核时间string出库单审核时间 detail_list货品列表节点array响应参数的2级数据节点，包含的采购退货出库单及其明细的数据节点，节点下数据字段详见下述“detail_list”列表 detail_list.rec_id出库明细主键idstring出库明细主键id detail_list.stockout_id出库单主键idstring出库单主键id detail_list.spec_no商家编码string代表单品（SKU）所有属性的唯一编号，用于系统单品的区分，SKU概念介绍单击这里 detail_list.goods_count货品数量string货品数量 detail_list.sell_price销售价string销售价 detail_list.brand_no品牌编号string品牌编号 detail_list.brand_name品牌名称string品牌名称 detail_list.goods_name货品名称string货品名称 detail_list.goods_no货品编号string代表SPU所有属性的唯一编号，用于系统货品的区分，SPU概念介绍单击这里 detail_list.spec_name规格名称string规格名称 detail_list.spec_code规格编号string规格编号 detail_list.cost_price成本价string成本价 detail_list.total_amount总货款string总货款 detail_list.weight重量string重量 detail_list.goods_type货品类别string1销售商品 2原材料 3包装 4周转材料5虚拟商品 0其它 detail_list.goods_unit单位名称string单位名称 detail_list.batch_no批次号string批次号 detail_list.batch_remark批次备注string批次备注 detail_list.expire_date有效期string有效期，格式：yyyy-MM-dd HH:mm:ss detail_list.remark备注string备注 detail_list.goods_id货品idstring货品id detail_list.spec_id规格idstring默认为'0'，规格id detail_list.position_id货位string默认为'0'，货位，指出库货位 detail_list.src_order_type源单据类别string默认为'1'，源单据类别 1销售订单2,调拨出库3,采购出库4,生产出库5,盘亏出库6,其他出库 detail_list.src_order_detail_id源单据细节idstringsales_trade_order表的主键 detail_list.base_unit_id基本单位string默认为'0'，基本单位 detail_list.unit_id辅助单位string默认为'0'，辅助单位 detail_list.unit_ratio单位换算string默认为'1.0000'，单位换算 detail_list.num2辅助数量string默认为'0.0000，辅助数量 detail_list.num货品数量string货品数量 detail_list.price价格string默认为'0.0000，最终价格 detail_list.batch_id出库批次string默认为'0'，指定出库批次 detail_list.is_examined是否验货string默认为'0'，是否验货，用于挂起，已标记为验货的不需要再验货 detail_list.is_package是否包装string默认为'0'，是否包装 detail_list.is_zero_cost是否允许0成本string默认为'0'，是否允许0成本 detail_list.scan_type类型string默认为'0'，0未验货,1扫描验货,2手工验货 detail_list.modified最后修改时间string最后修改时间 detail_list.created创建时间string创建时间 detail_list.position_list货位列表节点array响应参数的3级数据节点，节点下数据字段详见下述“position_list”列表 detail_list.position_list.position_id货位IDstring货位ID detail_list.position_list.position_no货位编号string货位编号 detail_list.position_list.position_goods_count货位出库数量string货位出库数量

金蝶云星辰V1接口明细

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

请求参数

字段名称类型 material_entity.price单价string billno单据编码string material_entity.materialid_number商品numberstring material_entity.auxunitid_id辅助单位idstring material_entity.stockid_id仓库string supplierid_number供应商string material_entity.qty数量string material_entity.unit_id单位string material_entity.materialid_id商品string supplierid_id供应商string material_entity.stockid_number仓库numberstring billdate单据日期string material_entity.auxqty辅助数量string material_entity商品分录array material_entity.auxpropid_id辅助属性string currencyid_id币别string

数据对接效果

采集并引入全业务、多终端、多形态的数据，经过处理以及对应平台接口的数据结构适配，形成以业务核心为对象为中心的连接和标签体系。配合企业根据自身的实际情况以及业务需求完成方案的规划、部署与实施，将沉淀的业务数据进入到平台进行体系化的加工，再以服务化的方式支持业务平台上的应用。达成高效支持业务敏捷创新的高质量和标准化的数据服务组合。