查询商品出入库记录

系统相关界面

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

请求地址

环境	服务地址(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-库存调整

系统调整库存

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

操作时间

必填

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-库存调整

系统调整库存

必填

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

系统相关界面​

请求地址​

公共参数​

请求头​

API接口地址​

请求参数​

请求示例​

响应参数​

响应示例​

异常示例​

错误码解释​

系统相关界面

请求地址

公共参数

请求头

API接口地址

请求参数

请求示例

响应参数

响应示例

异常示例

错误码解释