当前位置: API文档
purchase_provider_query.php(查询供应商)
| 1.1 接口描述:批量获取旺店通ERP内供应商档案信息。 | 
| 1.2 适用版本:客户端 V2.4.5.0及以上版本。 | 
| 1.3 全量获取:该接口是全量获取数据或按照provider_no获取,无法按照时间段增量获取数据。 | 
| 2.1 暂无 | 
| 环境 | HTTP地址 | 
|---|---|
| 测试环境 | https://sandbox.wangdian.cn/openapi2/purchase_provider_query.php | 
| 正式环境 | https://api.wangdian.cn/openapi2/purchase_provider_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输入参数签名结果,签名算法介绍单击这里 | 
| 名称 | 字段 | 类型 | 长度 | 必须 | 描述 | 
|---|---|---|---|---|---|
| 返回字段 | column | varchar | 否 | 需要返回的字段,多个用‘,’隔开(可选字段:provider_id,provider_no,provider_name,provider_group,contact,telno,mobile,fax,zip,email,qq,wangwang,address,website,remark,is_disabled,deleted,modified,created,account_bank_no,account_bank,collect_name,country,province,city,district,min_purchase_num,purchase_cycle_days,arrive_cycle_days,charge_cycle_days,last_purchase_time)不传默认查全部字段 | |
| 供应商编号 | provider_no | varchar | 否 | 代表供应商所有属性的唯一编码,用于供应商区分,ERP内支持自定义(ERP供应商界面设置),用于获取指定供应商数据信息 | |
| 供应商名称 | provider_name | varchar | 否 | 供应商名称(ERP内自定义的名称) | |
| 分页大小 | page_size | int | 否 | 每页返回的数据条数,输入值范围1~100,不传本参数,输入值默认为40,使用举例 单击这里       | |
| 页号 | page_no | int | 否 | 不传值默认从0页开始 | 
| 名称 | 字段 | 类型 | 长度 | 必须 | 描述 | 
|---|---|---|---|---|---|
| 错误码 | code | int | 40 | 是 | 状态码:0表示成功,其他表示失败 | 
| 错误描述 | message | varchar | 255 | 是 | 错误描述 | 
| 数据条数 | total_count | int | 10 | 否 | 只有,page_no = 0 时才返回的符合条件的数据总条数,用来分页 | 
| 供应商信息列表 | provider_list[] | data | 是 | 供应商信息,详见本接口provider_list附录结构 | 
| 名称 | 字段 | 类型 | 长度 | 必须 | 描述 | 
|---|---|---|---|---|---|
| 供应商ID | provider_id | int | 11 | 是 | 主键 | 
| 供应商编号 | provider_no | varchar | 20 | 是 | 代表供应商所有属性的唯一编码,用于供应商区分,ERP内支持自定义(ERP供应商界面设置),用于获取指定供应商数据信息 | 
| 供应商名称 | provider_name | varchar | 64 | 是 | 供应商名称(ERP内自定义的名称) | 
| 联系人 | contact | varchar | 64 | 是 | ERP中编辑的联系人 | 
| 电话 | telno | varchar | 20 | 是 | 供应商设置中座机信息 | 
| 移动电话 | mobile | varchar | 20 | 是 | 供应商设置中移动电话 | 
| 传真 | fax | varchar | 20 | 是 | 供应商设置中传真 | 
| 邮编 | zip | varchar | 20 | 是 | 供应商设置中邮编 | 
| email | varchar | 64 | 是 | 供应商设置中邮件 | |
| varchar | 20 | 是 | 供应商设置中QQ | ||
| 旺旺账号 | wangwang | varchar | 64 | 是 | 供应商设置中旺旺账号 | 
| 收款银行账户 | account_bank_no | varchar | 40 | 是 | 收款银行账户 | 
| 收款银行 | account_bank | varchar | 40 | 是 | 收款银行 | 
| 收款人 | collect_name | varchar | 40 | 是 | 收款人 | 
| 国家 | country | int | 11 | 是 | 国家编码,默认为0 | 
| 省份 | province | int | 11 | 是 | 省份编码 | 
| 城市 | city | int | 11 | 是 | 城市编码 | 
| 区县 | district | int | 11 | 是 | 区县编码 | 
| 地址 | address | varchar | 128 | 是 | 供应商设置中地址 | 
| 最小采购量 | min_purchase_num | decimal | (19,4) | 是 | 最小采购量 | 
| 网址 | website | varchar | 128 | 是 | 供应商设置中网址 | 
| 采购周期 | purchase_cycle_days | int | 11 | 是 | 采购周期 | 
| 供应商分组 | provider_group | varchar | 64 | 是 | 分组 | 
| 到货周期 | arrive_cycle_days | int | 11 | 是 | 到货周期 | 
| 结算周期 | charge_cycle_days | int | 11 | 是 | 结算周期 | 
| 最后采购日期 | last_purchase_time | datetime | 是 | 最后采购日期 格式:yyyy-MM-dd HH:mm:ss | |
| 备注 | remark | varchar | 256 | 是 | 供应商设置中备注 | 
| 是否禁用 | is_disabled | tinyint | 1 | 是 | 是否禁用:0.否;1.是 | 
| 删除时间戳 | deleted | int | 11 | 是 | 1970年至删除时间的时长 | 
| 最后修改时间 | modified | datetime | 是 | 最后修改时间 格式:yyyy-MM-dd HH:mm:ss | |
| 创建时间 | created | datetime | 是 | 创建时间 格式:yyyy-MM-dd HH:mm:ss | 
6.响应示例
6.1 正常响应示例
6.2 异常响应示例
| JSON | {
    "code": 1007,
    "message": "接口appkey已停用【解决办法:联系商务人员,重新开启接口appkey】 "
} | 
 个人资料
个人资料
		 修改密码
修改密码
		 退出
退出