聚水潭采购入库查询V3.0API接口文档
所属平台：
聚水潭
类型：
WebAPI
作用：
QUERY
接口版本：
1.0
适配器：
\Adapter\Jushuitan\V2\JstQueryAdapter
描述：
更新日期：
2023-06-09 17:39:09
采购入库查询V3.0
接口地址：/open/purchasein/query
请求方法： POST
加工厂： {"operation":{"method":"none"}}
接口请求参数
| 序号 | 字段 | 名称 | 类型 | 默认值 | 描述 | 是否必要 |
|---|---|---|---|---|---|---|
| 1 | page_index | 第几页 | int | 1 | 从1开始 | 否 |
| 2 | page_size | 每页数量 | int | 30 | 最大不超过50 | 否 |
| 3 | modified_begin | 修改起始时间 | string | {{LAST_SYNC_TIME|datetime}} | 起始时间和结束时间必须同时存在，时间间隔不能超过七天，与采购单号不能同时为空 | 否 |
| 4 | modified_end | 修改结束时间 | string | {{CURRENT_TIME|datetime}} | 起始时间和结束时间必须同时存在，时间间隔不能超过七天，与采购单号不能同时为空 | 否 |
| 5 | po_ids | 采购单号列表 | string | 与修改时间不能同时为空.采购单号最大不能超过30条 | 否 | |
| 6 | io_ids | 采购入库单号列表 | string | 与修改时间不能同时为空.采购入库单号最大不能超过30条 | 否 | |
| 7 | so_ids | 线上单号 | string | 与修改时间不能同时为空 | 否 |
接口响应参数
| 序号 | 字段 | 名称 | 类型 | 默认值 | 描述 | 是否必要 |
|---|---|---|---|---|---|---|
| 1 | io_id | 入库单号 | string | 入库单号 | 否 | |
| 2 | warehouse | 仓库名称 | string | 仓库名称 | 否 | |
| 3 | po_id | 采购单号 | string | 采购单号 | 否 | |
| 4 | supplier_id | 供应商编号 | string | 供应商编号 | 否 | |
| 5 | supplier_name | 供应商名称 | string | 供应商名称 | 否 | |
| 6 | modified | 修改时间 | string | 修改时间 | 否 | |
| 7 | so_id | 线上单号 | string | 对应采购入库页面的线上单号(且对应采购入库上传的external_id) | 否 | |
| 8 | out_oi_id | 外部单号 | string | 外部单号 | 否 | |
| 9 | status | 状态 | string | (WaitConfirm待入库;Confirmed已入库;Cancelled取消) | 否 | |
| 10 | io_date | 入库日期 | string | 入库日期 | 否 | |
| 11 | wh_id | 仓库编号 | string | 主仓=1，销退仓=2，进货仓=3，次品仓=4，自定义1仓=6，自定义2仓=7，自定义3仓=8 | 否 | |
| 12 | wms_co_id | 分仓编号 | string | 分仓编号 | 否 | |
| 13 | remark | 备注 | string | 备注 | 否 | |
| 14 | tax_rate | 税率 | string | 税率 | 否 | |
| 15 | labels | 标签 | string | 标签 | 否 | |
| 16 | archived | 财务审核日期 | string | 财务审核日期 | 否 | |
| 17 | merge_so_id | 预约单号 | string | 预约单号 | 否 | |
| 18 | type | 进仓类型 | string | 进仓类型 | 否 | |
| 19 | creator_name | 制单人 | string | 制单人 | 否 | |
| 20 | f_status | 财审状态 | string | WaitConfirm=待审核;Confirmed=已审核 | 否 | |
| 21 | l_id | 物流单号 | string | 物流单号 | 否 | |
| 22 | items | 商品集合 | array | 商品集合 | 否 | |
| 22.1 | ioi_id | 入库子单号 | string | 入库子单号 | 否 | |
| 22.2 | sku_id | 商品编码 | string | 商品编码 | 否 | |
| 22.3 | i_id | 款式编码 | string | 款式编码 | 否 | |
| 22.4 | unit | 单位 | string | 单位 | 否 | |
| 22.5 | name | 商品名称 | string | 商品名称 | 否 | |
| 22.6 | qty | 入库数量 | string | 入库数量 | 否 | |
| 22.7 | io_id | 入库单号 | string | 入库单号 | 否 | |
| 22.8 | cost_price | 单价 | string | 单价 | 否 | |
| 22.9 | cost_amount | 金额 | string | 金额 | 否 | |
| 22.10 | remark | 商品明细备注 | string | 商品明细备注 | 否 | |
| 22.11 | batch_no | 批次号 | string | 需开启相关业务配置 | 否 | |
| 22.12 | tax_rate | 税率 | string | 税率 | 否 | |
| 23 | batchs | 批次集合 | array | 获取该节点系统中相关业务项需配置 | 否 | |
| 23.1 | batch_no | 批次号 | string | 批次号 | 否 | |
| 23.2 | sku_id | 商品编码 | string | 商品编码 | 否 | |
| 23.3 | qty | 数量 | string | 数量 | 否 | |
| 23.4 | product_date | 批次日期 | string | 批次日期 | 否 | |
| 23.5 | supplier_id | 供应商编号 | string | 供应商编号 | 否 | |
| 23.6 | supplier_name | 供应商名称 | string | 供应商名称 | 否 | |
| 23.7 | expiration_date | 有效期至 | string | 有效期至 | 否 | |
| 24 | sns | 唯一码集合 | array | 唯一码集合 | 否 | |
| 24.1 | sku_id | 商品编码 | string | 商品编码 | 否 | |
| 24.2 | sn | 唯一码 | string | 唯一码 | 否 |
聚水潭的接口：采购入库查询V3.0（/open/purchasein/query），由轻易云数据集成平台API资产管理模块整理收纳，并且根据聚水潭版本更新同步实时更新。轻易云数据集成平台的API资产管理功能，通过统一的视图和控制台，帮助企业全面掌握API资产的使用情况，实现资源的高效利用和优化配置。
