当前位置: 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://openapitest.huice.com/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,  0:只返回未删除货品    1:返回未删除和已删除货品
分页大小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供应商名称


常用工具