当前位置： API文档

provider_goods_query.php(查询供应商货品接口)

1.接口说明

1.1 接口描述：获取旺店通ERP供应商货品信息
1.2 适用版本：
1.3 注意事项：

2.调用场景

2.1 举例说明：线下erp、SRM、SCM等系统对接

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境https://openapi.ali.huice.cc/openapi/provider_goods_query.php
正式环境

https://openapi.huice.com/openapi/provider_goods_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 业务请求参数

名称字段类型长度必须描述
供应商编号provider_novarchar40否供应商编号
货品编码goods_novarchar255否货品编码
商家编码spec_novarchar255否商家编码
供应商货号provider_goods_novarchar64否供应商货号
货品名称goods_namevarchar255否货品名称
主条码barcodevarchar50否主条码
分页大小page_sizeint10否每页返回条数，输入值范围1~100，不传默认40
页号page_noint10否页号，不传值默认从0页开始

4.响应参数


名称字段类型长度必须描述
错误码codeint11是状态码:0表示成功,其他表示失败
错误描述messagevarchar255是错误描述
数据条数total_countint10否符合条件的数据条数，用来分页 当page_no = 0时返回
供应商货品节点provider_goods_listdata[]
否响应参数的1级数据节点，节点下数据字段详见下述"provider_goods_list"


名称字段类型长度必须描述
供应商货品主键rec_idbigint
是供应商货品主键
供应商编号provider_novarchar64是供应商编号
供应商名称provider_namevarchar64是供应商名称
商家编码spec_novarchar255是商家编码
规格名称spec_namevarchar255是规格名称
货品名称goods_namevarchar255是货品名称
货品简称short_namevarchar255是货品简称
货品编号goods_novarchar255是货品编号
规格码spec_codevarchar255是规格码
分类名称class_namevarchar255是分类名称
品牌名称brand_namevarchar64是品牌名称
是否是默认供应商is_default_providerboolean
是是否是默认供应商
基本单位unit_namevarchar64是商品档案基础单位名称
供应商货号provider_goods_novarchar64是供应商货号
默认折扣default_discountdecimal(19,4)是默认折扣
采购价pricedecimal(19,4)是采购价
商品档案零售价retail_pricedecimal(19,4)是商品档案零售价
上一次成交价last_pricedecimal(19,4)是上一次成交价
最低成交价lowest_pricedecimal(19,4)是最低成交价
最小起订量min_purchase_numdecimal(19,4)是最小起订量
商品档案-税率tax_ratedecimal(19,4)是商品档案-税率
状态statustinyint
是0：生效，1：失效
单品自定义属性 1prop1varchar255是单品自定义属性 1
单品自定义属性 2prop2varchar255是单品自定义属性 2
单品自定义属性 3prop3varchar255是单品自定义属性 3
单品自定义属性 4prop4varchar255是单品自定义属性 4
单品自定义属性 5prop5varchar255是单品自定义属性 5
单品自定义属性 6prop6varchar255是单品自定义属性 6
备注remarkvarchar255是备注

5.请求示例

PHP
<php
    require_once("../WdtClient.php");
    $c = new WdtClient;
    $c->sid = '';
    $c->appkey = '';
    $c->appsecret = '';
    $c->gatewayUrl = 'https://openapi.ali.huice.cc/openapi/provider_goods_query.php';

    //添加查询参数
    $c->putApiParam('provider_no','S9107');
    $c->putApiParam('spec_no','provider88shangjiabianma');
    $json = $c->wdtOpenApi();
    var_dump($json);
    
?>
JAVA
C#
CURL

6.响应示例

   6.1 正常响应示例 

JSON
{
    "code": 0,
    "message": "",
    "total_count": 1,
    "provider_goods_list": [
        {
            "rec_id": "2862394043768242197",
            "provider_no": "S9107",
            "provider_name": "dx_LGBY",
            "spec_no": "provider88shangjiabianma",
            "spec_name": "provider88guigemingc",
            "goods_name": "provider88huopinmingcheng",
            "short_name": "provider88jiancheng",
            "goods_no": "provider88huopinbianm",
            "spec_code": "provider88",
            "class_name": "大鸡腿",
            "brand_name": "海天",
            "is_default_provider": false,
            "unit_name": "册",
            "provider_goods_no": "provider88hoh",
            "default_discount": "1",
            "price": "88",
            "retail_price": "88",
            "last_price": "0",
            "lowest_price": "0",
            "min_purchase_num": "8",
            "tax_rate": "77",
            "status": 0,
            "prop1": "8",
            "prop2": "8",
            "prop3": "3",
            "prop4": "4",
            "prop5": "5",
            "prop6": "6",
            "remark": "8"
        }
    ]
}

   6.2 异常响应示例

JSON
{
    "code": 1020,
    "message": "系统异常"
}

常用工具