当前位置: API文档
api_goods_stock_change_query.php(查询库存同步)
1.1 接口描述:获取变化后的旺店通ERP可销库存,并同步至平台店铺,注:”查询同步库存”与“库存同步回写”两个接口配合使用,完成“库存同步”,仅支持自有/其他平台店铺 |
1.2 适用版本:客户端 V2.4.5.0及以上版本 |
1.3 调用建议:建议间隔时间3~5分钟查询一次,集中获取待同步数据,注意上一次回写完成以后,再从数据池获取待同步的数据。 |
1.4 注意事项:“查询同步库存与“库存同步回写””配合使用,要在平台的库存同步成功后再回写同步成功状态给OMS,如果平台没有成功却回传成功,会导致后续无法再次获取到库存信息。 |
1.5 旺店通ERP配置:(接口调试前需要提前配置好) ①店铺授权,如果店铺授权状态是非授权,设置→基本设置→店铺界面,点击授权按钮(测试环境默认授权) ②开启库存同步开关,旺店通ERP需要勾选系统设置“启用库存同步”,路径:(旧)设置→系统设置→基本设置→启用库存同步 (新)设置→系统设置→订单→订单发货-启用库存同步(测试环境默认开启) ③需设置库存同步策略,路径:设置-策略设置-库存同步。 ④旺店通ERP必须存在对应的平台货品才能查到平台库存,平台货品可以在订单推送到旺店通ERP中时自动创建,也可通过接口提前推送。 ⑤如果没有产生订单需要将旺店通ERP库存同步至平台可通过”创建平台货品接口“,创建旺店通ERP平台货品,然后再设置库存同步策略,这样库存变化后就会生成库存待同步记录。 |
2.1 自研商城、分销系统、全渠道等系统对接 |
环境 | HTTP地址 |
---|---|
测试环境 | https://sandbox.wangdian.cn/openapi2/api_goods_stock_change_query.php |
正式环境 | https://api.wangdian.cn/openapi2/api_goods_stock_change_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输入参数签名结果,签名算法介绍单击这里 |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
店铺编码 | shop_no | varchar | 20 | 否 | 代表店铺所有属性的唯一编码,用于店铺区分,ERP内支持自定义(ERP店铺界面设置),用于获取指定店铺货品待同步库存信息(必须是自有类型的店铺) |
获取数据条数 | limit | int | 11 | 是 | 取值范围:limit大于等于100,小于等于2000,获取的数据通过“库存同步回写”接口响应同步结果后,才可再次获取数据。 注:库存数据获取同步给商城系统后,一定要通过api_goods_stock_change_ack.php回写结果,否则会出现待同步库存数量不能同步到商城的情况。 |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
错误码 | code | int | 11 | 是 | 状态码:0表示成功,其他表示失败 |
错误描述 | message | varchar | 255 | 是 | 错误描述 |
库存信息列表 | stock_change_list | data[ ] | 是 | 响应参数的1级数据节点,包含需要同步库存信息的数据节点,节点下数据字段详见下述“stock_change_list” | |
获得当前同步记录的条数 | current_count | int | 是 | 记录当前获得的记录条数 |
stock_change_list
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
Erp内平台货品表主键id | rec_id | string | 11 | 是 | Erp内平台货品表主键id,用于状态回传接口使用 |
店铺id | shop_id | string | 6 | 是 | 店铺id |
货品ID | goods_id | varchar | 40 | 是 | 外部系统货品主键,外部系统推送订单时使用的,erp只是保存了下外部系统的值 |
规格ID | spec_id | varchar | 40 | 是 | 外部系统货品规格id |
Erp内库存 | sync_stock | int | 11 | 是 | 该库存是通过配置计算出来的,使用该接口注意配置库存同步策略(在erp中可以做试算:货品->平台货品->试算库存同步量(选中货品右键)来核对数量。) |
货品编码 | goods_no | varchar | 40 | 是 | 代表货品(spu)所有属性的唯一编号,SPU概念介绍,单击这里 |
规格编码 | spec_no | varchar | 40 | 是 | 代表单品(sku)所有属性的唯一编码,SKU概念介绍,单击这里 |
erp中货品类型 | erp_spec_type | tinyint | 4 | 是 | 1:单品,2:组合装 |
erp中规格ID | erp_spec_id | 11 | 是 | 规格id | |
库存变化时自增 | stock_change_count | int | 11 | 是 | 库存变化时自增用于状态回传接口使用,状态回传时把该值一并回传即可,不用深究其含义 |
6.响应示例
6.1 正常响应示例
6.2 异常响应示例
JSON | { "code": 1007, "message": "接口appkey已停用【解决办法:联系商务人员,重新开启接口appkey】 " } |