当前位置: API文档
Y_stock_query.php(查询库存成本 可用库存数据)
1.1 接口描述:获取旺店通ERP查询库存成本 可用库存数据 |
1.2 适用版本:网页版 |
1.3 注意事项:①按照ERP退货入库单的最后修改时间增量获取数据,请求时输入start_time和end_time作为时间跨度的筛选条件。 ②start_time和end_time最大跨度为30天,开始时间和结束时间取值范围为闭区间取值, 例如2018-11-01 00:00:00至2018-11-30 23:59:59,建议根据获取数据量的多少适当减小时间跨度。 |
2.1举例说明:财务系统、SAP、数据分析等系统的对接 |
环境 | HTTP地址 |
---|---|
测试环境 | https://openapitest.huice.com/openapi/stock_query.php |
正式环境 | https://openapi.huice.com/openapi/stock_query.php |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
卖家账号 | sid | String | 是 | 购买ERP时由旺店通分配给ERP购买方,请从ERP购买方获取。 | |
接口账号 | appkey | String | 是 | ||
时间戳 | timestamp | int | 是 | 北京时间1970-01-01 08:00:00起至现在的总秒数,10位int值,旺店通网页 API服务端允许请求最大时间误差为5min, date.timezone = Asia/Shanghai。 | |
签名 | sign | String | 是 | API输入参数签名结果,签名算法介绍单击这里 |
名称 字段 类型 长度 必须 描述 开始时间 start_time datetime 否 按时间增量获取数据,start_time作为开始时间,格式:yyyy-MM-dd HH:mm:ss 结束时间 end_time datetime 否 按时间增量获取数据,end_time作为结束时间,格式:yyyy-MM-dd HH:mm:ss 商家编码 spec_no string 否 商家编码(新),商家编码和开始结束时间必传一项
4.1公共响应参数
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
错误码 | code | int | 40 | 是 | 状态码:0表示成功,其他表示失败 |
错误描述 | message | varchar | 255 | 是 | 错误描述 |
数据条数 | total_count | int | 10 | 否 | 符合条件的数据条数,用来分页 当page_no = 0时返回 |
入库单详情 | stocks | data[] | 否 | 库存节点数据 |
4.1业务响应参数
stocks
字段名称 | Y 字段code | Y类型 | Y枚举 | 是否必须 | 默认值 | 是否可变更 |
单品主键id | spec_id | bigint(20) | 是 | 否 | ||
仓库主键id | warehouse_id | int(11) | 是 | 否 | ||
ERP库存id | rec_id | bigint(20) | 是 | 否 | ||
货品编号 | goods_no | string | 是 | 是 | ||
品牌编号 | brand_no | string | 是 | 是 | ||
品牌名称 | brand_name | string | 是 | 是 | ||
货品名称 | goods_name | string | 是 | 是 | ||
商家编码 | spec_no | string | 是 | 是 | ||
规格名称 | spec_name | string | 是 | 是 | ||
规格码 | spec_code | string | 是 | 是 | ||
条形码 | barcode | string | 是 | 是 | ||
库存量 | stock_num | decimal(21, 6) | 写入默认值100 | 是 | 是 | |
可用库存 | available_num | decimal(21, 6) | 是 | 是 | ||
状态 | status | tinyint(4) | 0未启用1启用2停用 | 是 | 是 | |
辅助单位 | unit | string | 是 | 是 | ||
备注 | remark | string | 是 | 是 | ||
是否残次品 | defect | tinyint(4) | 0否 1是 都是0 | 是 | 是 | |
ERP创建时间 | created | datetime | 是 | 否 | ||
ERP更新时间 | modified | datetime | 是 | 是 |