跳到主要内容

查询商品出入库记录

系统相关界面​

"界面路径：【库存】----【出入库记录】"

请求地址​

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

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

公共参数​

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

参数名称参数类型是否必须参数描述
methodstring是API接口名称
appKeystring是分配给应用的AppKey
timestampstring是时间戳，时区为GMT+8，例如：2020-09-21 16:58:00。API服务端允许客户端请求最大时间误差为10分钟
formatstring否响应格式。默认为json格式，可选值：json
versionstring是API协议版本 可选值：1.0
sign_methodstring否签名的摘要算法(默认 hmac)，可选值为：hmac，md5，hmac-sha256。
signstring是签名
sessionstring是授权会话信息 （即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-库存调整
系统调整库存
0-库存调整
系统调整库存
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
操作后总库存
必填
staffName
string
操作人名称
必填｜
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-库存调整
系统调整库存
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库
必填
batchNo
string
批次
必填
productTime
string
生产日期
必填

响应示例​

{
  "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组!