当前位置: API文档
setting.strategy.VirtualWarehouse.stockSearch(虚拟仓库存查询)
¥标准
1.1 接口描述:获取ERP虚拟仓库存信息 |
1.2 适用版本:客户端 V1.3.8.3及以上版本 |
1.3 增量获取:支持 |
1.4 时间跨度:start_time与end_time时间跨度不超过30天 |
1.5注意事项:权限校验:【仓库和虚拟仓权限】 |
2.1 举例说明:自研商城、SCM、SRM、财务系统、SAP等系统的对接 |
环境 | HTTP地址 |
---|---|
测试环境 | http://47.92.239.46/openapi |
正式环境 | http://wdt.wangdian.cn/openapi |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
卖家账号 | sid | String | 是 | 卖家账号, 由旺店通分配 | |
接口账号 | key | String | 是 | 由旺店通分配appkey, 在发送的数据中对应 key 字段,获取方式点击这里 | |
盐 | salt | String | 是 | 由旺店通分配appsecret,是由两部分构成, 冒号前面的部分是secret, 冒号后面的部分是salt. 例如一个appsecret是testsecret:testsalt, 那么secret为testsecret, salt为testsalt. | |
接口名称 | method | String | 是 | 调用的接口名称 | |
版本号 | v | String | 是 | 1.0 | |
秒级时间戳 | timestamp | Int | 是 | 秒级时间戳, 当前时间戳减去 2012-01-01 00:00:00(1325347200), 时间与服务器时间差120s内即合法。 | |
签名 | sign | String | 是 | 签名 | |
分页大小 | page_size | Int | 否 | 分页大小,分页查询必传 | |
分页编号 | page_no | Int | 否 | 分页编号,分页查询必传,标准接口page_no从0开始 | |
是否计算查询结果的总条数 | calc_total | Int | 否 | 是否计算查询结果的总条数, 需要计算则1, 否则填0 |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
查询参数 | params | Map<String, Object> | 是 | 查询参数 | |
分页 | pager | Pager | 是 | 分页 |
params
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
开始时间 | start_time | String | 40 | 否 | 修改时间, yyyy-MM-dd HH:mm:ss格式 |
结束时间 | end_time | String | 40 | 否 | yyyy-MM-dd HH:mm:ss格式 |
商家编码 | spec_nos | String | 否 | 英文逗号分割,最多500个; 不填时间条件时必填 | |
虚拟仓编号 | virtual_warehouse_no | String | 否 | 虚拟仓编号 | |
实体仓编号 | warehouse_no | String | 否 | 实体仓编号 |
pager
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
分页大小 | page_size | Int | 4 | 否 | 分页大小 |
页号 | page_no | Int | 4 | 否 | 从0开始 |
返回值为一个Map<String, Object>
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
状态码 | status | Int | 是 | 状态码,0表示正常 | |
错误信息 | message | String | 是 | 无错误信息不返回 | |
单据信息 | data | Map<String, Object> | 是 | 单据信息 |
data
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
数据 | detail_list | List<Map<String, Object>> | 是 | 明细数据 | |
总数 | total_count | Int | 11 | 是 | 查询条件总单据数 |
detail_list
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
最小警戒库存 | alarm_num | Decimal(19,4) | 是 | 最小警戒库存 | |
已分配数 | assigned_num | Decimal(19,4) | 是 | 已分配数 | |
公有仓可用数 | avaliable_num | Decimal(19,4) | 是 | 公有仓可用数 | |
可发数 | can_use_lock_num | Decimal(19,4) | 是 | 可发数 | |
可用数 | can_use_num | Decimal(19,4) | 是 | 可用数 | |
自定义数量 | factory_num | Decimal(19,4) | 是 | 自定义数量 | |
虚拟仓警戒库存 | lock_num | Decimal(19,4) | 是 | 虚拟仓警戒库存 | |
货品名称 | goods_name | String | 是 | 货品名称 | |
货品编号 | goods_no | String | 是 | 货品编号 | |
当前锁定数(入库数量) | now_lock_num | Decimal(19,4) | 是 | 当前锁定数(入库数量) | |
14天销量 | num_14days | Decimal(19,4) | 是 | 14天销量 | |
7天销量 | num_7days | Decimal(19,4) | 是 | 7天销量 | |
今日销量 | num_day | Decimal(19,4) | 是 | 今日销量 | |
月销量 | num_month | Decimal(19,4) | 是 | 月销量 | |
昨日销量 | num_yesterday | Decimal(19,4) | 是 | 昨日销量 | |
已出库数 | out_num | Decimal(19,4) | 是 | 已出库数 | |
总锁定数 | sum_lock_num | Decimal(19,4) | 是 | 总锁定数 | |
明细id | rec_id | Int | 是 | 唯一键 | |
商家编码 | spec_no | String | 是 | 商家编码 | |
规格名称 | spec_name | String | 是 | 规格名称 | |
虚拟仓名称 | vir_warehouse_name | String | 是 | 虚拟仓名称 | |
虚拟仓编号 | vir_warehouse_no | String | 是 | 虚拟仓编号 | |
仓库名称 | warehouse_name | String | 是 | 仓库名称 | |
仓库编号 | warehouse_no | String | 是 | 仓库编号 | |
仓库id | warehouse_id | Int | 是 | 仓库id | |
采购在途量 | purchase_num | String | 是 | 采购在途量 (开启客户端系统配置:开启虚拟仓锁定预售库存功能,返回对应值,未开通下返回0) | |
单品id | spec_id | int | 是 | 单品id(系统单品主键) | |
虚拟仓id | vir_warehouse_id | int | 是 | 虚拟仓id |
JSON |