跳到主要内容

查询盘点单明细

系统相关界面

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

请求地址

环境服务地址(HTTP/HTTPS)
V2正式环境https://gw.superboss.cc/router

2022年4月1日以后申请的APP Key,统一使用V2正式环境的请求地址:https://gw.superboss.cc/router

公共参数

调用任何一个API都必须传入的参数,目前支持的公共参数有:

参数名称参数类型是否必须参数描述
methodstringAPI接口名称
appKeystring分配给应用的AppKey
timestampstring时间戳,时区为GMT+8,例如:2020-09-21 16:58:00。API服务端允许客户端请求最大时间误差为10分钟
formatstring响应格式。默认为json格式,可选值:json
versionstringAPI协议版本 可选值:1.0
sign_methodstring签名的摘要算法(默认 hmac),可选值为:hmac,md5,hmac-sha256。
signstring签名
sessionstring授权会话信息 (即access_token,由系统分配)

请求头

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

API接口地址

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

请求参数

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

请求示例

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

响应参数

参数名
类型
描述
必填
total
string
总数
必填
list
object
列表
必填
sheetCode
string
示例:盘点单号
必填
sysItemId
string
示例:商品信息
必填
goodsSectionId
string
示例:货位id
必填
createdId
string
示例:制单人
必填
title
string
示例:名称
必填
afterNum
string
示例:盘点后数量
必填
matchStatus
string
示例:是否匹配(针对于盘点过程中需要绑定的商品) 0/1/2:未匹配/匹配/临时
必填
stockRegionType
string
示例:库区类型(1/2/3:拣货/备货/次品)
必填
taskCode
string
示例:盘点任务单号
必填
differentStatus
string
示例:差异状态(123:未盘/有/无差异/异常(针对计算的时候,实时数据对不上的情况))
必填
inventoryName
string
示例:盘点人
必填
modified
string
示例:修改时间
必填
createdName
string
示例:创建人
必填
inventoryTime
string
示例:盘点时间
必填
id
string
示例:id
必填
stockRegionId
string
示例:库区id
必填
goodsSectionCode
string
示例:货位编码/暂存区编码
必填
beforeNum
string
示例:盘点前数量
必填
containerType
string
示例:货位类型(0/1:货位/暂存区)
必填
created
string
示例:创建时间
必填
inventoryCount
string
示例:盘点次数
必填
propertiesName
string
示例:规格
必填
sysSkuId
string
示例:规格 id
必填
assoGoodsSectionId
string
示例:货位库存id
必填
companyId
string
示例:公司
必填
inventoryId
string
示例:盘点人
必填
outerId
string
示例:主商家编码/sku商家编码,优先sku商家编码
必填
differentAmount
string
示例:差异金额
必填
qualityType
string
示例:质量(0/1:次/良)
必填
inventoryAgain
string
示例:是否有复盘任务
必填
enableStatus
string
示例:状态(0/1:作废/正常)
必填
differentNum
string
示例:盘盈盘亏
必填

响应示例

{
"total": 12345,
"list": [
{
"sheetCode": "zhangsan",
"sysItemId": 12345,
"goodsSectionId": 12345,
"createdId": 12345,
"title": "zhangsan",
"afterNum": 12345,
"matchStatus": 1,
"stockRegionType": 1,
"taskCode": "zhangsan",
"differentStatus": 1,
"inventoryName": "zhangsan",
"modified": "@date",
"createdName": "zhangsan",
"inventoryTime": "@date",
"id": 12345,
"stockRegionId": 12345,
"goodsSectionCode": "zhangsan",
"beforeNum": 12345,
"containerType": 1,
"created": "@date",
"inventoryCount": 1,
"propertiesName": "zhangsan",
"sysSkuId": 12345,
"assoGoodsSectionId": 12345,
"companyId": 12345,
"inventoryId": 12345,
"outerId": "zhangsan",
"differentAmount": 10000,
"qualityType": 1,
"inventoryAgain": true,
"enableStatus": 1,
"differentNum": 12345
}
]
}

异常示例

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

错误码解释

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