当前位置: API文档

Y_stock_query.php(查询库存成本 可用库存数据)

¥标准

1.接口说明

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.调用场景

2.1举例说明:财务系统、SAP、数据分析等系统的对接

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境https://openapitest.huice.com/openapi/stock_query.php
正式环境https://openapi.huice.com/openapi/stock_query.php

   3.2 公共请求参数

名称字段类型长度必须描述
卖家账号sidString
购买ERP时由旺店通分配给ERP购买方,请从ERP购买方获取。
接口账号appkeyString

时间戳timestampint

北京时间1970-01-01 08:00:00起至现在的总秒数,10位int值,旺店通网页

API服务端允许请求最大时间误差为5min,

date.timezone = Asia/Shanghai。
签名signString
API输入参数签名结果,签名算法介绍单击这里


 3.3 业务请求参数

名称字段类型长度必须描述
开始时间start_timedatetime                 
按时间增量获取数据,start_time作为开始时间,格式:yyyy-MM-dd HH:mm:ss
结束时间end_timedatetime
按时间增量获取数据,end_time作为结束时间,格式:yyyy-MM-dd HH:mm:ss
商家编码spec_nostring
商家编码(新),商家编码和开始结束时间必传一项

4.响应参数

 4.1公共响应参数

名称字段类型长度必须描述
错误码codeint40状态码:0表示成功,其他表示失败
错误描述messagevarchar255错误描述
数据条数total_countint10符合条件的数据条数,用来分页 当page_no = 0时返回
入库单详情stocksdata[]
库存节点数据


 4.1业务响应参数

stocks

字段名称Y 字段codeY类型Y枚举是否必须默认值是否可变更
单品主键idspec_idbigint(20)

仓库主键idwarehouse_idint(11)

ERP库存idrec_idbigint(20)

货品编号goods_nostring

品牌编号brand_nostring

品牌名称brand_namestring

货品名称goods_namestring

商家编码spec_nostring

规格名称spec_namestring

规格码spec_codestring

条形码barcodestring

库存量stock_numdecimal(21, 6)写入默认值100
可用库存available_numdecimal(21, 6)

状态statustinyint(4)0未启用1启用2停用
辅助单位unitstring

备注remarkstring

是否残次品defecttinyint(4)0否 1是 都是0
ERP创建时间createddatetime

ERP更新时间modifieddatetime



常用工具