当前位置： API文档

api_goods_stock_change_query.php（查询库存同步）

¥标准

1.接口说明

1.1 接口描述：获取变化后的旺店通ERP可销库存，并同步至平台店铺,注：”查询同步库存”与“库存同步回写”两个接口配合使用，完成“库存同步”，仅支持自有/其他平台店铺
1.2 适用版本：网页版
1.3 调用建议：建议间隔时间3~5分钟查询一次，集中获取待同步数据，注意上一次回写完成以后，再从数据池获取待同步的数据。

1.4 注意事项：“查询同步库存与“库存同步回写””配合使用，要在平台的库存同步成功后再回写同步成功状态给OMS，如果平台没有成功却回传成功，会导致后续无法再次获取到库存信息。

1.5 旺店通ERP配置：（接口调试前需要提前配置好）

①店铺授权，如果店铺授权状态是非授权，设置→基本设置→店铺界面，点击授权按钮（测试环境默认授权）

②创建平台货品和货品档案，并且保证平台货品和货品档案已经匹配。

③需设置库存同步策略，路径：【仓储】—>【库存管理】—>【库存同步】。点击右侧的“查看同步策略”设置库存同步策略，并且在“店铺同步管理”里面添加对应的店铺。

注：需要在设置库存同步策略后商品有库存变化，接口才能查到数据。

2.调用场景

 2.1 自研商城、分销系统、全渠道等系统对接

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境https://openapi.ali.huice.cc/openapi/api_goods_stock_change_query.php
正式环境https://openapi.huice.com/openapi/api_goods_stock_change_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 业务请求参数

名称字段类型长度必须描述
店铺编码shop_idvarchar20是代表店铺所有属性的唯一编码，用于店铺区分，ERP内支持自定义（ERP店铺界面设置），用于获取指定店铺货品待同步库存信息（必须是自有类型的店铺）
获取数据条数limitint11是

取值范围：limit大于等于100，小于等于2000，获取的数据通过“库存同步回写”接口响应同步结果后，才可再次获取数据。

注：库存数据获取同步给商城系统后，一定要通过api_goods_stock_change_ack.php回写结果，否则会出现待同步库存数量不能同步到商城的情况。

4.响应参数

   4.1 公共响应参数

名称字段类型长度必须描述
错误码codeint11是状态码:0表示成功,其他表示失败
错误描述messagevarchar255是错误描述
库存信息列表stock_change_listdata[ ]
是响应参数的1级数据节点，包含需要同步库存信息的数据节点，节点下数据字段详见下述“stock_change_list”
获得当前同步记录的条数current_countint
是记录当前获得的记录条数

   4.2 业务响应参数

   stock_change_list

名称字段类型长度必须描述
Erp内平台货品表主键idrec_idstring11是Erp内平台货品表主键id，用于状态回传接口使用
店铺idshop_idstring6是店铺id
货品IDgoods_idvarchar40是外部系统货品主键，外部系统推送订单时使用的，erp只是保存了下外部系统的值
规格IDspec_idvarchar40是外部系统货品规格id
Erp内库存sync_stockint11是该库存是通过配置计算出来的，使用该接口注意配置库存同步策略。
库存变化时自增stock_change_countint11是库存变化时自增用于状态回传接口使用，状态回传时把该值一并回传即可，不用深究其含义

5.请求示例

PHP
<?php
    require_once("../WdtClient.php");
    $c = new WdtClient;
    $c->sid = '';
    $c->appkey = '';
    $c->appsecret = "";
    $c->gatewayUrl = 'https://openapi.ali.huice.cc/openapi/api_goods_stock_change_query.php';
    
    $c->putApiParam('shop_id','585');
    $c->putApiParam('limit',1);
    $json = $c->wdtOpenApi();
    var_dump($json);
?>
JAVA
C#
python

6.响应示例

   6.1 正常响应示例 

JSON
{
    "code": 0,
    "message": "",
    "stock_change_list": [
        {
            "rec_id": "2754327482516635662",
            "shop_id": "585",
            "goods_id": "E1222666614528A",
            "spec_id": "34442266254221",
            "sync_stock": 6,
            "stock_change_count": 4
        }
    ],
    "current_count": 1
}

   6.2 异常响应示例

JSON
{
    "code": 2310,
    "message": "店铺编号在系统中不存在或已停用，请检查shop_id是否正确"
}




常用工具