文档
测试

查询商品出入库记录

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
application/x-www-form-urlencoded;charset=UTF-8
必填

API接口地址

参数名
类型
描述
必填
method
string
erp.item.stock.in.out.list
必填

请求参数

参数名
类型
描述
必填
orderType
integer
单据类型 0-库存调整|系统调整库存|系统调整出入库 1-采购入库 2-系统订单 3-销退入库|采退入库 4-采退出库 5-库存加工 6-维修出库 7-暂存区清零 8-暂存区平移 9-采退取消 10-覆盖导入 11-增量导入 12-出库导入 13-销退收货 14-销退取消收货 18-清零货位库存 19-调拨出库 20-调拨入库 21-撤销发货 29-次品上架 30-次品下架
可选
31-快速上架 32-混放上架 33-库存下架 34-库存盘点 37-订单拣选 38-订单发货 39-拣选归还 41-补货拣选 42-补货上架 43-采退拣选 44-移库上架 45-移库下架46-自由拣选 47-批发配货出库 48-批发配货拣选 49-库存加工 50-收货单打回 53-其它入库 54-其他出库 55-调拨拣选 59-其它上架 60-暂存区上架 61-波次下架 65-移箱上架 70-档口配货出库 71-档口配货拣选 75-质检出库 76-质检入库 80-移箱下架 87-按箱下架 88-拆箱下架
可选
outerId
string
平台商家编码
可选
warehouseId
long
仓库ID
可选
operateTimeBegin
string
操作开始时间 格式为:yyyy-MM-dd HH:mm:ss
可选
operateTimeEnd
string
操作结束时间 格式为:yyyy-MM-dd HH:mm:ss
可选
pageSize
integer
分页数量
必填
pageNo
integer
当前页
必填
orderNumber
string
单据编号
可选

请求示例

示例一: ----------------- ```` { "pageSize": integer, "pageNo": integer } ````

响应参数

参数名
类型
描述
msg
string
返回消息
traceId
string
流水id
total
long
返回总数
code
string
返回码
stockInOutRecordVos
array
数据列表
orderType
string
单据类型
orderNumber
string
单据编号
customType
string
自定义出入库类型,可在快麦中维护
outerId
string
平台商家编码
title
string
商品标题
propertiesAlias
string
规格属性别名
propertiesName
string
规格真正的属性,以逗号分隔
barcode
string
条形码
boxCode
string
箱码
brand
string
品牌名称
remark
string
备注
sysItemId
long
系统主商品ID
sysSkuId
long
系统商品规格ID
warehouseId
long
仓库ID
warehouseName
string
仓库名称
code
string
仓库编码
goodsAllocation
string
货位编码
beforeStockNum
long
操作前总库存
afterStockNum
long
操作后总库存
stockChange
long
数量变化, 对于入库(type=1)为正数,表示增加的数量,对于出库(type=2)的系统订单为正数,表示减少的数量,对于库存调整(type=0)正数表示增加负数表示减少
content
string
操作详情
operateTime
date
操作时间
id
long
记录id
inOutWarehouseType
integer
进出仓类型 -1-无对应关系 0-默认类型 1-暂存调入 2-暂存调出 3-盘点 4-暂存盘点 5-加工进仓 6-加工出仓 7-采退出仓 8-其他入仓 9-其他出仓 10-销售出仓 11-调拨入仓 12-调拨出仓13-维修出仓 14-采购进仓 15-销退入仓 17-质检出仓 18-质检入仓 21-移库上架 22-移库下架
type
integer
单据类型 0-库存调整|系统调整库存|系统调整出入库 1-采购入库 2-系统订单 3-销退入库|采退入库 4-采退出库 5-库存加工 6-维修出库 7-暂存区清零 8-暂存区平移 9-采退取消 10-覆盖导入 11-增量导入 12-出库导入 13-销退收货 14-销退取消收货 18-清零货位库存 19-调拨出库 20-调拨入库 21-撤销发货 29-次品上架 30-次品下架
31-快速上架 32-混放上架 33-库存下架 34-库存盘点 37-订单拣选 38-订单发货 39-拣选归还 41-补货拣选 42-补货上架 43-采退拣选 44-移库上架 45-移库下架46-自由拣选 47-批发配货出库 48-批发配货拣选 49-库存加工 50-收货单打回 53-其它入库 54-其他出库 55-调拨拣选 59-其它上架 60-暂存区上架 61-波次下架 65-移箱上架 70-档口配货出库 71-档口配货拣选 75-质检出库 76-质检入库 80-移箱下架 87-按箱下架 88-拆箱下架
itemType
integer
1 良品操作, 0 次品操作
singleItem
integer
是否查询单个的商品,0:false,1:true
stockChangeMultiple
array
货位对应数量;示例:[-3,-2] ;goodsAllocation字段为:1库,2库

响应示例

``` { "msg": "zhangsan", "traceId": "zhangsan", "total": 12345, "code": "zhangsan", "stockInOutRecordVos": [ { "orderType": "zhangsan", "orderNumber": 10000, "customType": 12345, "outerId": 12345, "title": "zhangsan", "propertiesAlias": "zhangsan", "propertiesName": "zhangsan", "barcode": 12345, "boxCode": 10000, "brand": "zhangsan", "remark": 12345 ... } ] } ```

异常示例

```` { "code": "25", "msg": "服务方法(erp.item.stock.in.out.list:1.0)的签名无效", "success": false, "trace_id": "3553483395423660" } ````

错误码解释

| 错误码 |错误信息|解决方案| |-|-|-| |50|单据类型不合法|请按文档描述的类型填写| |20001|页码为空或不符合规定|页码的值不能为空,且不能小于1| |20002|页数为空或不符合规定|页数的值不能为空,且不能小于1| |20305|仓库ID不能小于0!|仓库ID不能小于0!| |20314|单据编号最多支持20组!|单据编号最多支持20组!|