文档
测试

查询盘点单列表

POST
请求地址/router

系统相关界面

"界面路径:【仓储】----【盘点单管理】----【查询】"

请求地址

|环境|服务地址(HTTP/HTTPS)| |-|-| |V2正式环境| https://gw.superboss.cc/router| **2022年4月1日**以后申请的APP Key,统一使用V2正式环境的请求地址:**https://gw.superboss.cc/router**

公共参数

调用任何一个API都必须传入的参数,目前支持的公共参数有: | 参数名称 | 参数类型 | 是否必须 | 参数描述 | | --- | --- | --- | --- | | method | string | 是 | API接口名称 | | appKey | string | 是 | 分配给应用的AppKey | | timestamp | string | 是 | 时间戳,时区为GMT+8,例如:2020-09-21 16:58:00。API服务端允许客户端请求最大时间误差为10分钟 | | format | string | 否 | 响应格式。默认为json格式,可选值:json | | version | string | 是 | API协议版本 可选值:1.0 | | sign\_method | string | 否 | 签名的摘要算法(默认 hmac),可选值为:hmac,md5,hmac-sha256。 | | sign | string | 是 | 签名 | | session | string | 是 | 授权会话信息 (即access_token,由系统分配) |

请求头

参数名
类型
描述
必填
Content-Type
string
multipart/form-data
必填

API接口地址

参数名
类型
描述
必填
method
string
inventory.sheet.query
必填

请求参数

参数名
类型
描述
必填
pageNo
integer
示例:页码 取值范围:大于零的整数。默认值为1
可选
startModified
string
示例:起始时间 格式:yyyy-MM-dd HH:mm:ss(修改时间)
可选
pageSize
integer
示例:每页条数 取值范围:大于零的整数;最大值:200;默认值:40
可选
endModified
string
示例:结束时间 格式:yyyy-MM-dd HH:mm:ss(修改时间)
可选
status
string
示例:盘点状态
可选
code
string
单据号
可选

请求示例

```json { "code": "string", "pageNo": "integer", "startModified": "string", "pageSize": "integer", "endModified": "string", "fields": "string" } ````

响应参数

参数名
类型
描述
total
string
总数
list
object
列表
code
string
示例:编码
created
string
示例:创建时间
createdId
string
示例:制单人
remark
string
示例:备注
type
string
示例:类型,12:普通/即时盘点
warehouseName
string
示例:仓库名称
submitName
string
示例:提交人
companyId
string
示例:公司
submitted
string
示例:提交时间
pdaShowStock
string
示例:pda显示库存(12/显示/不显示)
warehouseId
string
示例:仓库
audditId
string
示例:审核人
audditName
string
示例:审核人
modified
string
示例:修改时间
notInventoryToZero
string
示例:未盘商品操作:(12:盘0/不动)
createdName
string
示例:创建人名称
id
string
示例:id
auddited
string
示例:审核时间
status
string
示例:状态(1234 草稿/盘点中/盘点完成/作废)
submitId
string
示例:提交人

响应示例

```json { "total": 12345, "list": [ { "code": "zhangsan", "created": "@date", "createdId": 12345, "remark": "zhangsan", "type": 1, "warehouseName": "zhangsan", "submitName": "zhangsan", "companyId": 12345, "submitted": "@date", "pdaShowStock": 1, "warehouseId": 12345, "audditId": 12345, "audditName": "zhangsan", "modified": "@date", "notInventoryToZero": 1, "createdName": "zhangsan", "id": 12345, "auddited": "@date", "status": 1, "submitId": 12345 } ] } ```

异常示例

```` { "code": "25", "msg": "服务方法(inventory.sheet.query:1.0)的签名无效", "success": false, "trace_id": "3553483395423660" } ````

错误码解释

| 错误码 |错误信息|解决方案| |-|-|-| |25|服务方法(inventory.sheet.query:1.0)的签名无效|签名参数错误|