聚水潭采购退货查询V3.0API接口文档
所属平台：
聚水潭
类型：
WebAPI
作用：
QUERY
接口版本：
1.0
适配器：
\Adapter\Jushuitan\V2\JstQueryAdapter
描述：
更新日期：
2023-06-09 18:17:29
采购退货查询V3.0
接口地址：/open/purchaseout/query
请求方法： POST
加工厂： {"operation":{"method":"none"}}
接口请求参数
| 序号 | 字段 | 名称 | 类型 | 默认值 | 描述 | 是否必要 |
|---|---|---|---|---|---|---|
| 1 | page_index | 第几页 | string | 1 | 第几页，从第一页开始，默认1 | 否 |
| 2 | page_size | 每页多少条 | string | 30 | 每页多少条，默认30，最大50 | 否 |
| 3 | modified_begin | 修改起始时间 | string | {{LAST_SYNC_TIME|datetime}} | 修改起始时间，和结束时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空 | 否 |
| 4 | modified_end | 修改结束时间 | string | {{CURRENT_TIME|datetime}} | 修改结束时间，和起始时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空 | 否 |
| 5 | so_ids | 指定线上订单号 | string | 指定线上订单号，和时间段不能同时为空 | 否 | |
| 6 | status | 单据状态 | string | Confirmed | 单据状态，Confirmed=生效，WaitConfirm待审核，Creating=草拟，Archive=归档，Cancelled=作废 | 否 |
| 7 | io_ids | 采购退货单号列表 | string | 最大30 | 否 |
接口响应参数
| 序号 | 字段 | 名称 | 类型 | 默认值 | 描述 | 是否必要 |
|---|---|---|---|---|---|---|
| 1 | io_id | 退货单号 | string | 退货单号 | 否 | |
| 2 | io_date | 退货日期 | string | 退货日期 | 否 | |
| 3 | status | 状态 | string | Confirmed:生效，WaitConfirm:待审核，Creating:草拟，Cancelled:作废,OuterConfirming:外部确认中，Delete:取消 | 否 | |
| 4 | so_id | 线上单号 | string | 线上单号 | 否 | |
| 5 | f_status | 财务状态 | string | WaitConfirm=待审核，Confirmed=待审核 | 否 | |
| 6 | warehouse | 仓库名 | string | 仓库名 | 否 | |
| 7 | receiver_name | 收货人/供应商名称 | string | 收货人/供应商名称 | 否 | |
| 8 | receiver_mobile | 收货电话 | string | 收货电话 | 否 | |
| 9 | receiver_state | 收件人省 | string | 收件人省 | 否 | |
| 10 | receiver_city | 收件人市 | string | 收件人市 | 否 | |
| 11 | receiver_district | 收件人区 | string | 收件人区 | 否 | |
| 12 | receiver_address | 收件人省地址 | string | 收件人省地址 | 否 | |
| 13 | wh_id | 仓库编号 | string | 1=主仓，2=销退仓，3=进货仓，4=次品仓 | 否 | |
| 14 | remark | 备注 | string | 备注 | 否 | |
| 15 | modified | 修改时间 | string | 修改时间 | 否 | |
| 16 | po_id | 采购单号 | string | 采购单号 | 否 | |
| 17 | wms_co_id | 分仓编号 | string | 分仓编号 | 否 | |
| 18 | seller_id | 供应商ID | string | 供应商ID | 否 | |
| 19 | labels | 标记|多标签 | string | 标记|多标签 | 否 | |
| 20 | logistics_company | 物流公司 | string | 物流公司 | 否 | |
| 21 | lc_id | 物流公司编号 | string | 物流公司编号 | 否 | |
| 22 | l_id | 物流单号 | string | 物流单号 | 否 | |
| 23 | archived | 财务审核日期 | string | 财务审核日期 | 否 | |
| 24 | creator_name | 创建人 | string | 创建人 | 否 | |
| 25 | lock_wh_id | 虚拟仓编号 | string | 虚拟仓编号 | 否 | |
| 26 | lock_wh_name | 虚拟仓名称 | string | 虚拟仓名称 | 否 | |
| 27 | items | 商品集合 | array | 商品集合 | 否 | |
| 27.1 | ioi_id | 明细id | string | 明细id | 否 | |
| 27.2 | sku_id | 商品编码 | string | 商品编码 | 否 | |
| 27.3 | name | 商品名称 | string | 商品名称 | 否 | |
| 27.4 | properties_value | 属性 | string | 属性 | 否 | |
| 27.5 | qty | 数量 | string | 数量 | 否 | |
| 27.6 | cost_price | 单价 | string | 单价 | 否 | |
| 27.7 | cost_amount | 金额 | string | 金额 | 否 | |
| 27.8 | i_id | 款式编码 | string | 款式编码 | 否 | |
| 27.9 | remark | 备注 | string | 备注 | 否 | |
| 27.10 | io_id | 退货单号 | string | 退货单号 | 否 | |
| 27.11 | co_id | 公司编号 | string | 公司编号 | 否 | |
| 27.12 | batch_no | 批次号 | string | 系统中相关业务项需配置 | 否 | |
| 28 | batchs | 批次集合 | array | 获取该节点系统中相关业务项需配置 | 否 | |
| 28.1 | batch_no | 批次号 | string | 批次号 | 否 | |
| 28.2 | sku_id | 商品编码 | string | 商品编码 | 否 | |
| 28.3 | qty | 数量 | string | 数量 | 否 | |
| 28.4 | product_date | 批次日期 | string | 批次日期 | 否 | |
| 28.5 | supplier_id | 供应商编号 | string | 供应商编号 | 否 | |
| 28.6 | supplier_name | 供应商名称 | string | 供应商名称 | 否 | |
| 29 | sns | 唯一码集合 | array | 唯一码集合 | 否 | |
| 29.1 | sku_id | 商品编码 | string | 商品编码 | 否 | |
| 29.2 | sn | 唯一码 | string | 唯一码 | 否 |
聚水潭的接口：采购退货查询V3.0（/open/purchaseout/query），由轻易云数据集成平台API资产管理模块整理收纳，并且根据聚水潭版本更新同步实时更新。API资产管理平台提供了丰富的API开发和测试工具，支持API的快速迭代和创新，加速产品的上市速度，提升企业的市场竞争力。
