当前位置： API文档

purchase_provider_query.php（查询供应商）

¥标准    

1.接口说明    

1.1 接口描述：批量获取旺店通ERP内供应商信息。                
1.2 适用版本：网页版
1.3 增量获取： 按照旺店通ERP内供应商最后修改时间增量获取数据，请求时输入start_time和end_time作为时间跨度的筛选条件，返回的结果不包含在旺店通ERP已经删除的供应商数据.                         


2.调用场景 

  2.1 自研商城、SCM、SRM、财务系统、SAP等系统的对接                            

3.请求参数说明        

  3.1 请求地址  

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

   3.2 公共请求参数

名称字段类型长度必须描述

卖家账号 

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输入参数签名结果，签名算法介绍单击这里 

  3.3 业务请求参数

名称字段类型长度必须描述
供应商编码provider_novarchar64否供应商编码
供应商idprovider_idlong
否供应商在erp数据库内的主键id
供应商名称provider_namevarchar64否供应商名称
开始时间start_timedatetime
是按最后修改时间增量查询数据，start_time作为开始时间，格式：yyyy-MM-dd HH:mm:ss
结束时间end_timedatetime
是按最后修改时间增量查询数据，end_time作为结束时间，格式：yyyy-MM-dd HH:mm:ss
是否隐藏已删除供应商hide_deletedtinyint4否目前无实际作用，传0或者不传
分页大小page_sizeint
否每页返回的数据条数，输入值范围1~100，不传本参数，输入值默认为100
页号page_noint
否页号，从0页开始

4.响应参数

  4.1公共响应参数

名称字段类型长度必须描述
错误码codeint11是状态码:0表示成功,其他表示失败
错误描述messagevarchar255是错误描述
数据条数total_countint11是符合条件的数据条数，用来分页
供应商节点provider_listdata[]
是

   4.2 业务响应参数

provider_list

名称字段类型长度必须描述
供应商idprovider_idlong11是供应商表主键
供应商编号provider_novarchar64是供应商编号
供应商名称provider_namevarchar64是供应商名称
联系人contactvarchar64是供应商联系人
电话

telno

varchar20是移动电话/联系电话
开户银行bank_namevarchar50是开户银行名称
收款人

payee_name

varchar20是收款人名称
银行账号

bank_account

varchar40是银行账号（国际最长34位）
地址

address

varchar128是供应商详细地址
备注

remark

varchar256是供应商备注信息
启用状态

is_disabled

int11是是否停用：false 表示启用，true表示停用
更新时间

modify_date

datetime
是

更新时间，格式：yyyy-MM-dd HH:mm:ss

创建时间

create_date

datetime
是创建时间，格式：yyyy-MM-dd HH:mm:ss

5.请求示例

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

$c->putApiParam('start_time', '2025-12-10 13:00:44');
$c->putApiParam('end_time', '2026-12-30 13:59:44');
$c->putApiParam('page_no', 0);
$c->putApiParam('page_size', 1);

$json = $c->wdtOpenApi();
var_dump($json);
?>
JAVA
C#
python

6.响应示例

   6.1 正常响应示例 

JSON
{
    "code": 0,
    "message": "",
    "total_count": 494,
    "provider_list": [
        {
            "tenantId": "haijun",
            "provider_id": "2812715471357345805",
            "provider_no": "8477",
            "provider_name": "SPE20260805001"
        }
    ]
}

   6.2 异常响应示例

JSON
{
    "code": 2220,
    "message": "page_size为正整数，请检查page_size是否为有效值"
}




常用工具