U8C API中心

API中心

库存管理
现存量

指导视频
对接方案模板
工具
游客

现存量查询

接口所在U8C版本:U8 cloud2.7以及更高版本

详细描述:类型为数组的参数，按如下格式输入 ["data"]<br> 默认按全维度展开，若不需要按某项展开，传“N”

API视频讲解API详情补丁列表常见问题参考

接口地址

请求方式

请求参数header

请求参数body

返回类型参数

代码示例

请求参数示例

正确返回示例

错误返回示例

接口地址:http://ip:port/u8cloud/api/ic/onhand/query

参数填写指南

请求方式:POST

请求参数(header):

参数填写指南

参数名	必填	描述	默认值
Content-Type	是	请求体数据类型	application/json
usercode	是	用户
password	是	密码
system	是	系统参数

请求参数(body):

全量参数按存货按批次分组

参数名	是否数组	必填	描述	默认值
batchcode	是	否	批次号
calbody	是	是	库存组织
castunit	是	否	辅单位
corp	否	是	公司
hsl	是	否	换算率
inventory	是	否	存货
isGroupByBatchcode	否	否	按批次号展开	Y
isGroupByCalbody	否	否	按库存组织展开	Y
isGroupByCastunit	否	否	按辅计量展开	Y
isGroupByFreeItem	否	否	按自由项展开	Y
isGroupByHsl	否	否	按换算率展开	Y
isGroupByInv	否	否	按存货展开	Y
isGroupBySpace	否	否	按货位展开	Y
isGroupByVendor	否	否	按供应商展开	Y
isGroupByWarehouse	否	否	按仓库展开	Y
numcondition	否	否	只查询数量大于0传>，只查询数量小于0传<，只查询数量等于0传=，只查询数量不等于0传<>，其他符号不识别，u8c3.1版本
pagenow	否	否	当前页（从1开始）；3.2版本支持
pagesize	否	否	每页条数（最大1000条）；3.2版本支持
space	是	否	货位
vendor	是	否	供应商
warehouse	是	否	仓库

返回类型参数:

参数名	类型	是否数组	必填	描述
onhandnum				现存量数据
ccalbodyid	string	否	否	库存组织
cinventory_code	string	否	否	存货编码
cinventory_name	string	否	否	存货名称
cinventoryid	string	否	否	存货
corp_code	string	否	否	公司编码
corp_name	string	否	否	公司名称
cspace_code	string	否	否	货位编码
cspace_name	string	否	否	货位名称
cspaceid	string	否	否	货位
cvendorid	string	否	否	供应商
cwarehouse_code	string	否	否	仓库编码
cwarehouse_name	string	否	否	仓库名称
cwarehouseid	string	否	否	仓库
dproducedate	string	否	否	生产日期（V5.1开始支持）
dvalidate	string	否	否	失效日期（V5.1开始支持）
hsl	double	否	否	换算率
nastnum	double	否	否	辅数量
nfreezenum	string	否	否	冻结量
nnum	double	否	否	数量
pk_corp	string	否	否	公司
vbatchcode	string	否	否	批次号

代码示例:

Java模板示例下载 C#模板示例下载

请求参数示例:

按存货按批次分组

复制代码

{"calbody":"3101-_-K1001","corp":"3101","inventory":"c1120pc","isGroupByBatchcode":"Y","isGroupByCalbody":"N","isGroupByCastunit":"N","isGroupByHsl":"N","isGroupByInv":"Y","isGroupBySpace":"N","isGroupByVendor":"N","isGroupByWarehouse":"N"}

正确返回示例:

按存货按批次分组

复制代码

{
    "status": "success",
    "data": "{\"allcount\":3,\"retcount\":3,\"datas\":[{\"pk_corp\":\"1012\",\"corp_code\":\"3101\",\"corp_name\":\"cyc交通建设集团有限公司\",\"cinventoryid\":\"1012A2100000000039AC\",\"cinventory_code\":\"c1120pc\",\"cinventory_name\":\"c1120批次\",\"nnum\":9.99,\"nastnum\":0,\"vbatchcode\":\"111111\",\"nfreezenum\":0},{\"pk_corp\":\"1012\",\"corp_code\":\"3101\",\"corp_name\":\"cyc交通建设集团有限公司\",\"cinventoryid\":\"1012A2100000000039AC\",\"cinventory_code\":\"c1120pc\",\"cinventory_name\":\"c1120批次\",\"nnum\":1,\"nastnum\":0,\"vbatchcode\":\"111111111111111111111\",\"nfreezenum\":0,\"dproducedate\":\"2024-01-05\"},{\"pk_corp\":\"1012\",\"corp_code\":\"3101\",\"corp_name\":\"cyc交通建设集团有限公司\",\"cinventoryid\":\"1012A2100000000039AC\",\"cinventory_code\":\"c1120pc\",\"cinventory_name\":\"c1120批次\",\"nnum\":111,\"nastnum\":0,\"vbatchcode\":\"c11291\",\"nfreezenum\":0}]}",
    "taskNumber": "202401050008"
}

错误返回示例:

复制代码

{
    "status": "falied",
    "errorcode": "-32000",
    "errormsg": "下列查询条件必须输入：[corp, calbody]",
    "stacktrace": "u8c.bs.action.query.AbstractQueryAction.convertToConditions(AbstractQueryAction.java:151);u8c.bs.action.query.AbstractQueryAction.doAction(AbstractQueryAction.java:58);u8c.bs.invoke.bp.JSONInvokeBP.invoke(JSONInvokeBP.java:60);u8c.impl.invoke.json.InvokeWithJSonImpl.invoke(Invoke
}